证件照处理

概述

用途

把用户本人提供的真实照片处理成符合各类报名、办证、签证要求的标准证件照：换底色、改尺寸、批量排版冲印、导出合规 JPG。覆盖国内一寸/二寸/护照/身份证、各国签证，以及国考/教资/法考/注会/医师/考研等网上报名照规格。

合规边界（必须严格遵守）：本技能只处理用户提供的真实照片，调用平台的抠图与图像处理能力完成换底、缩放、排版。绝不生成合成证件照（不允许凭空生成人脸照片），以免被利用于伪造证件。

何时使用

当用户提出以下任一类请求时启用：换证件照底色、改证件照尺寸、制作签证/护照照片、证件照排版冲印、询问某用途的证件照规格。

工作流程

1. 解析目标规格

先确定用途对应的尺寸、底色、像素、文件大小限制。两种方式：

• 直接读取 references/specs.md（人类可读权威表，含国内尺寸、各国签证、冲印纸、质量清单）；
• 或调用脚本查询：python scripts/specs.py resolve "<用途>"（如 resolve 一寸、resolve 美国签证），返回 JSON（含 px_w/px_h、rgb、文件大小 kb_min/kb_max、头部高度区间、strict 固定像素标记）。

常见映射：一寸→295×413（白/蓝）、二寸→413×579、护照→390×567 白底、美国→600×600 白底且 JPG 54–240KB、申根/日本/澳/韩→413×531 白底、加拿大→591×827、英国→413×531 米色/浅灰（非白）。

2. 换底色（抠图 + 合成）

1. 用平台的抠图（matting）能力去除原背景，得到透明前景；
2. 按目标 rgb 合成纯色背景（白 255,255,255 / 蓝 67,142,219 / 红 255,0,0 / 英国米色 240,240,225）；
3. 边缘做轻微羽化，避免硬切白边。

3. 裁剪与缩放

• 按规格精确裁剪到 px_w × px_h，保持长宽比；
• 头部高度按目标规格的区间控制（护照 28–33mm、美国 25–35mm、申根/日本 32–36mm）；头部占画面高度 70%–80%，头顶留约 1/8 空间；无权威区间的规格（一寸、身份证、各类考试报名照等）按画面高度 65%–78% 推导参考值，head_check 返回带 _ref 后缀，交付说明里须注明这是参考比例而非官方标准；
• 用 python scripts/specs.py validate <宽> <高> <用途> 校验输出像素是否落入容差（默认 2px；身份证、法考、国考、教资、中国签证、注会等固定像素规格自动按 0 容差校验）。

4. 冲印排版（可选）

多张同版证件照可用 python scripts/specs.py layout <相纸> <用途> 计算网格坐标（如 layout 6寸 一寸 → 3×4=12 张），输出每张左上角坐标，据此排版到 6 寸（1200×1800）/ 5 寸 / A4 相纸上，并在张间加虚线裁剪线，间距 2–4mm，便于文印店或家用打印机冲印。

• 排版模板（推荐）：用 python scripts/specs.py sheet <相纸> <用途> [--count N] [--out 模板.svg] [--image 照片.jpg] 生成带虚线裁切线的 SVG 版式（如 sheet 6寸 法考 得 2×2=4 张法考照的版式）。加 --image 会把实拍图 base64 内嵌到每个格子，SVG 已声明物理尺寸（6 寸 = 101.6×152.4mm，A4 = 210×297mm），可直接打印或交文印店；不加 --image 时输出灰色占位框，仅作版式预览，不可直接冲印。

5. 导出与体积控制

• 默认导出 JPG；
• 美国 DS-160 等要求 54–240KB：脚本只提供 kb_min/kb_max 区间数据，不读取图像文件，体积需在导出时控制（如调整 JPEG 质量）并核对实际文件大小；
• 交付前逐条核对 references/specs.md 第五节「质量合规清单」（近期 6 个月内、免冠、露耳眉、双唇闭合平视、头部占比、着装与底色对比、无阴影、光照均匀）。

交付物

• 单张：按规格命名的 JPG（如 一寸白底.jpg、美国签证2x2.jpg）；
• 排版：一张 6 寸/A4 排版 JPG + 裁剪线；
• 简短说明：所用规格、底色、像素、文件大小、以及是否完全满足目标机关要求（不确定处提示以官方公告为准）。