用途
Portrait Retouch 用于分析和修饰单人肖像（不限性别），采用“诊断优先、保持身份”的工作流。它把输入视为一张可改进的照片，而非“有缺陷的脸”，重点区分拍摄成因（透视、镜头畸变、头姿、表情、光线、白平衡、裁切、遮挡）与人物本身的稳定特征。
主要能力
- 加载后立即展示精简导航菜单，推荐以 AI 照片诊断作为第一步；用户未选路线时停在菜单等待，已明确选路线时简要展示并继续。
- AI 照片诊断是独立完整功能，返回结构化诊断报告，不改动图像；报告后提供后续路线：保守修图、Photoshop 制作、AI 重生成、混合执行，或诊断后停止。
- 诊断按顺序分析：拍摄干扰因素、整体形态（脸宽、上中下三庭、颊颌连续性、下颌端点、中线）、局部几何（眼裂与眼形、眼睑、眉眼关系、鼻口下巴对齐）、色调与质感（眼下过渡、临时凸起瑕疵、永久身份标记、高光、色差、毛孔、胡须、妆容、锐化）、以及不确定度（标注为实测、视觉支持或存疑）。
- 支持多种模式：仅诊断、分阶段对比（默认）、直接成片、快速预览、确定性实现（地标、局部变形遮罩、分离的色调/质感通道）、Photoshop 制作（可编辑 PSD 与渲染样张）。
- 提供调整映射表，逐项记录观察、可能成因、具体操作、强度、锁定锚点与置信度；默认将无依据的鼻、口、下巴、额头和整体脸宽改动设为零，局部不对称向中点校正而非完美镜像。
- 生成隔离预览分支：01_capture_only（仅修正高置信拍摄/透视呈现）、02_geometry_only（仅修正实测局部不对称或轮廓不连续）、03_tone_texture_only（仅修正光色、临时瑕疵与微质感）；用户明确要求非诊断性重塑时，额外生成 04_user_preference_only 并单独标注。
- 最终版本仅合并用户批准的操作，保存成片、并排对比和简要清单（诊断、已批准操作、偏好覆盖、工具路线、提示词或参数，不含密钥）。
使用方式
- 加载后先读 references/navigation.md 并展示导航菜单。
- 按需加载参考文档：诊断相关读 references/ai-photo-diagnosis.md 与 references/diagnosis.md；生成或编辑图像前读 references/prompt-stages.md；选择实现方式前读 references/tools-and-sources.md；操作 Photoshop 或交付 PSD 前读 references/photoshop-uxp-workflow.md；用户提供视觉参考时读 references/reference-style-routing.md。
- 诊断前确认原图可读且含一张主脸，按原始分辨率检查，记录尺寸、方向、裁切与缺失元数据，不臆造相机距离或焦距；建立身份锚点（脸宽、发际线、发型发量、眼角、虹膜大小、鼻底、嘴、下巴、痣疤、胡须、耳朵、表情、背景线条、衣物）。
- 若提供 iBUG/Dlib 风格 68 点 .pts 文件，可运行： python3 scripts/measure_ibug68.py landmarks.pts --image-width WIDTH --image-height HEIGHT --json 测量结果作为证据而非审美标准；无地标时给出视觉估计，不编造精度。
- 参考图请求先提取为结构化 JSON，仅迁移色彩、色调、光线、皮肤渲染、颗粒、镜头特性等不改几何的属性到 Photoshop 调色；姿态、肢体、视线、表情、视角或构图变化走独立 AI 重生成分支；混合请求先生成获批动作或构图，再在 Photoshop 完成色调质感。不因参考图出现某变化就推断用户想改身份敏感或几何相关属性。
- 输出默认保存在 output/portrait-retouch_<source-stem>/，原图保存为 00_original.<ext> 且不被覆盖。
- 生成式编辑每次以原图为身份锚点，不递归用某张预览作为另一张的唯一来源；若拍摄畸变严重影响几何判断，先生成 01_capture_only 返回选择，再重新诊断后创建几何分支。
- 每个预览单独写提示词：明确图像左右、陈述观察差异与修正方向、仅改一个模块、列出必须固定的身份与场景锚点、声明禁止的补偿性编辑、冲突时减小编辑而非改动其他特征；避免堆砌形容词，转为几何、光、色、质感操作。
- 检查每个输出（适应屏幕与原始分辨率），出现身份漂移、年龄变化、未请求部位的改动、复制眼睛、完美对称、虹膜大小变化、新眼睑褶、蜡感皮肤、抹除胡须、美白、妆容、合成锐化、背景线条弯曲、发际线融化、家具变化或裁切漂移时，应拒绝或重做。
- 返回原图与预览并附紧凑对比表（改动模块、预期效果、观察到的副作用、建议），不把“最好看”当作客观事实。
适用场景
- 需要先了解照片问题再决定是否修图的用户。
- 希望在保持身份、年龄线索、毛孔、胡须和有用不对称的前提下做保守修饰。
- 需要可编辑图层、可复现参数或批量处理的生产管线。
- 用户提供风格参考图，需要把色调质感与姿态构图分开处理。
限制
- 仅面向单人肖像；需确认原图可读且含一张主脸。
- 默认不改发型发量，不套用性别化审美模板（V 脸、方下颌、大眼、窄鼻、尖下巴、美白、完美对称），除非用户明确要求单独偏好预览。
- 不从外貌推断健康、族裔、人格、性别认同等敏感属性，不打吸引力评分。
- 不得在技能或输出文件中存储 API 密钥或机密；未经明确同意不将私人肖像上传至不可信换脸网站。
- 不连接 Photoshop 仅用于诊断图像，需遵循导航参考中的 Photoshop 同意关卡。
- 若用户仅要求解释或诊断，除明确要求的报告外不改动文件。
- 关于具体收费、价格、平台支持范围与效果保证，资料未提供。