PhotoCraft 场景操作手册按具体图像问题组织流程，不做全目录加载，只读取相关场景。所有流程默认从新打开的栅格原图开始，无选区和活动路径；复用会话时需重新选择原像素层，只有存在选区时才取消选区，无选区时 select.deselect 会拒绝执行。使用前先确认输入图片、用途和修改边界。
【场景分类与条目】 restoration（12 条）：老照片保守修复全流程、扫描灰尘与细小白点、胶片细划痕局部修补、背景折痕分区修补、照片角部小块缺损修复、银镜反光区域保守校正、扫描印刷网点轻度抑制、旧 JPEG 方块伪影减轻、暗部彩色噪声抑制、小面积霉点取样修复、靠近人物边界的划痕定区修复、平坦背景块状污点修补。 tone（7 条）：褪色黑白照片灰阶恢复、泛黄纸基色偏校正、老彩照偏红衰变校正、旧彩照转黑白并保留层次、编辑插图双色映射、彩色人像黑白通道混合、保留指定物体彩色其余转黑白。 geometry（2 条）：扫描倾斜与边框整理、扫描件四边污边裁去。 delivery（4 条）：修复成片的最终锐化、老照片打印分辨率标记、网页展示图缩小、透明四边扩画布交付。 portrait（7 条）：自然人像局部痘印修饰、眼下阴影轻度减淡、整体轻微白平衡、逆光人像暗部回调、保留皮肤纹理减弱局部油光、纯色背景杂发整理、牙齿自然去黄。 product（8 条）：商品中性白底基础校正、表面灰尘清理、白底抠图白边整理、深色旧底抠图黑边整理、主体蒙版分离、小面积反光点缓和、标签定区锐化、配色局部试样。 layout（2 条）：社交图片补画布留白、版式镜像副本制作。 mask-local（8 条）：室内窗景局部压高光、人物面部局部提亮、保留商品颜色并弱化背景色、主体外背景柔化、服装定向改色并保持肤色、白色包装局部去黄、天空与地面渐变曝光平衡、柔和暗角突出中心。
【同会话 MCP 路径】 先读取宿主实际工具 schema。已打开内嵌编辑器时使用该会话，editor_status 确认可编辑后再执行，不要另启 headless CLI 改另一个工程并声称画面同步。用 doc_open 打开图片后，doc_inspect 取得尺寸、当前文档和图层，路径相对本次 workspace，使用返回的图层 ID。对场景命令先用 command_list 按 filter 确认参数与可用性，再调用 command_run 执行，坐标为示例，须根据输入定位与取样。每个局部操作后查看实际画面与结果；长任务返回 job 时等待状态完成再继续，并核对工具是否支持 wait 参数。最后 doc_save 保存分层工程，doc_export 另存成片，重新打开工程检查层与修改仍存在。
【独立 CLI 路径】 执行前查询 photocraft-cli --version 与 photocraft-cli commands --json --filter，示例使用官方 0.9.0 语法；旧技能安装器锁定的维护版与此不同，不能把目录存在当作运行时已安装。通过 argv 调用，不手拼跨平台 shell 引号，一个编辑批次保持单进程。示例命令使用 run 配合 --cmd、--params 与 --out，随后用 info 核对图层、用 convert 导出成片。调整层创建后不能直接把像素笔画画在调整层上，手册将局部修复安排在影调调整之前，局部返工时重新选择工作像素层。
【参数、证据与验收】 参数的固定版本观察见命令证据，结构化步骤见 recipes.json；证据说明方法确实存在，不证明任意照片已经修复成功。例子是低强度起点，采样点、损伤轮廓、裁切和尺寸必须由图像决定。输出新工程、成片和同尺寸前后对比，无法恢复的细节与推测区域需明确列出。透明边缘配方中的 $ref:originalLayer 是手册记号，须先 inspect 取得真实原图层 ID 并替换为整数；工作副本复制后保留但隐藏原图层，验证 PNG 的实际 Alpha。逆光恢复使用已验证的可编辑曲线适配，不能仅凭 shadowsHighlights 同名方法推断其行为。main 导出预设 get 只返回参数，实际导出需按当前 schema 显式映射，不要给 doc_export 传未支持的尺寸字段。输入素材须有本任务使用权。