Photocraft Restore Old Photo

---
name: photocraft-restore-old-photo
description: 当用户需要用 photocraft 完成老照片修复，涉及划痕、折痕、褪色与局部缺损时使用；适用于从素材诊断到可编辑交付的完整任务。
license: Apache-2.0
---

# 老照片修复

## 任务起点

先读取素材，确认交付用途、目标尺寸或时长、修改范围与必要格式。能从任务和素材确定的细节直接采用合理默认值；只询问会改变结果的缺失条件。

需要可见编辑器时交给 **photocraft-editor** 技能。独立安装：`npx skills add full-aigc-skills/photocraft-skills --skill photocraft-editor`。当前新增技能为本地候选，发布前使用本地配套插件，不把此安装命令当作已发布证明。

执行前按 [修复操作手册](references/restoration-workflow.md) 判断损伤、处理顺序和降级边界。

## 执行步骤

1. 按划痕、霉点、褪色、缺失区域分区标记；人脸、文字和照片边缘单独保护。
2. 先校正旋转并检查整体灰阶；局部修复检查通过后，用可编辑调整层恢复中间调，不先锐化噪声。
3. 复制修复层，在背景选一个小区域试用修复画笔或克隆；沿相同纹理取样，避开五官边界。
4. 分区短笔触修复，频繁切换原图比较；大面积缺失没有可靠参照时保留缺损并说明。
5. 最后轻度降噪和输出尺寸锐化；上色只有在明确需要且具备相应能力时进行。

## 具体操作计划

使用[分阶段方法与参数](references/native-restoration.md)及[独立操作计划](references/restoration-plan.json)。先完成局部修补并查看检查点，再进行可选降噪与整体色阶；具体CLI、MCP调用和保存重开方法均在本技能内。它完善已有流程，不新增场景计数。

## 按实际像素生成局部计划

先用当前文档的实际宽高、已确认的损伤笔触和同纹理取样点填写 [输入样例](assets/local-repair-input.json)，再执行 `python3 <本技能目录>/scripts/repair_plan.py --input actual-input.json --output local-plan.json`。坐标单位是像素，不能沿用样例位置。`protected` 是经素材检查后声明的脸部、文字等矩形保护区，不是自动识别结果。

脚本只生成复制工作层和局部修复命令，不调用CLI/MCP、不修改图片、不执行整体调色。它检查笔刷半径、相邻点之间的保守包围盒，以及修复画笔随笔触移动的采样范围；触及保护区或越过画布即拒绝。保守矩形可能误拒绝安全斜线，可在看过图后拆为更短笔触，不能删保护区绕过。未声明的区域不受此检查保护；算法实际影响范围和最终画质仍须看导出图。

读取输出steps后，先在已确认的活动像素层上复制工作层，回读当前层，再按当前工具schema逐条调用command_run；禁止把一组步骤发送后假定全部成功。CLI的run/--cmd格式沿用本技能的具体操作手册。局部阶段另存新工程和PNG，检查损伤与保护区后，才决定是否执行原有整体影调阶段。输出文件已存在时脚本拒绝覆盖。

## 工具落地

用 doc_open/doc_new 打开或新建，doc_inspect 查看图层；command_list 查询实际命令，command_run 执行；doc_save 保存 .pcraft，doc_export 导出。

先读取实际工具 schema，再填写参数；对象或文档 ID 使用返回值。查询到的命令必须在当前后端可用。保存前选择新输出路径，保留输入。需要的算法、格式或命令不存在时说明缺口，不能用相近名称冒充。

## 结果检查

- 100% 查看眼睛、嘴角、鼻翼是否变形；边缘有无重复纹理和糊斑。
- 整体缩放检查影调是否自然，未修区域应保留原始纹理。
- 交付分层工程、修复图和同尺寸前后对比；推测重建区域单独标注。

对照用户目标检查实际内容，而不只检查进程退出码。局部编辑查看局部细节，版式任务查看整页，时间媒体查看起止与关键段。异常结果先检查当前工程，避免重复执行不可逆操作。

## 交付

返回可编辑工程、实际派生文件和简短说明：做了哪些修改、哪些步骤因当前能力未执行、需要用户判断的内容。只列真实存在且已经检查的文件。若用户随后返工，读取本次源工程并局部修改，保留已接受的内容。