# Claude Code 真实人工验收

## 独立终局评分（无外部写动作）

- [ ] 对一个已完成生成目录调用 `fmode-image-set-score`，确认实际打开每张成品图与商品原图，并执行一次跨图复核。
- [ ] 只运行目录 CLI 时 `automaticScore` 可用但 `overallScore/grade` 为 N/A，不再出现“总体 100/A 但证据不足”。
- [ ] 完整 v3 逐图矩阵返回基础质量、商品一致性、合同适配和完整保障分，并列出单元覆盖、单图分、最弱图片、硬失败和整改项。
- [ ] 缺少商品参考或显式角色时，基础质量仍可用；只将对应可选层和完整保障分标为 N/A。
- [ ] 对任意外部套图目录运行同一 Skill，无需 runId、MCP 或 API Key。
- [ ] 评分前后所有源图片 SHA-256 一致，目录中没有新增报告、状态或临时文件。
- [ ] 相同 manifest/evidence 重复运行的确定性报告除展示格式外完全一致。
- [ ] 无商品参考时商品保真与总体分为 N/A；无投放数据时只把商业表现另列 N/A，不声称平台合规或预测商业表现。
- [ ] Windows PowerShell 中文路径通过 stdin 时显式使用 UTF-8 `OutputEncoding`，参考图不会退化为 `?` 路径。

## 安装与发现

- [ ] 工作区 `.mcp.json` 保留原有 Server。
- [ ] 八个 Skill 均可被发现，其中 `fmode-image-set-score` 带自包含评分脚本。
- [ ] MCP Server 暴露 manifest 中七个 Tool。

## Gemini 识图

- [ ] 显式图片路径可分析。
- [ ] 用户声明多张路径均为同一商品图时可全部作为 identity 分析。
- [ ] 不通过 Glob 或历史文件猜测商品图。
- [ ] 混合多图未标角色时返回 `needs_input`。
- [ ] 分析结果区分可见事实、推断和未知项。
- [ ] 用户声明商品名优先；没有声明时可使用明确识图名称。

## 计划门禁

- [ ] “只规划”不调用生图接口。
- [ ] 默认模型是 `gemini-3.1-flash-image-preview`。
- [ ] 用户可见计划不包含预计、累计或实际费用字段/金额。
- [ ] 未确认生成返回 `needs_confirmation`。
- [ ] 不传 `budgetLimitCny` 也可在明确确认后执行；旧调用传入过低上限仍返回 `needs_confirmation` 且不显示金额。
- [ ] 同一 request key 不重复提交。

## 真实生成（外部写动作）

- [ ] 用户明确确认张数、模型和计划。
- [ ] Gemini Markdown Data URL 能写入项目输出目录。
- [ ] Seedream `b64_json` 能写入项目输出目录。
- [ ] 本地参考图无需公网 URL。
- [ ] 临时异常在同一 outputId 使用稳定幂等键最多尝试三次；耗尽后继续后续项目且不自动换模型。
- [ ] 最终只列出失败 outputId 并询问是否补图；确认后原 `runId + retryOutputIds` 只生成指定项，已完成 requestId/文件保持不变。
- [ ] 远程结果 URL 下载失败只重试下载，不再次调用生图接口。
- [ ] 新运行目录为 `输出/商品套图/<商品名称>-<短标识>/`。
- [ ] 完整成功后项目根参考图移动、项目子目录参考图复制到 `商品原图/`，并逐项报告路径。
- [ ] 部分完成、失败、质量拒绝和 `submission_unknown` 不移动项目根参考图。
- [ ] 旧 `outputs/fmode-image-set/run_*` 状态仍可查询且不会重复生成。

## 套图单图返修（外部写动作）

- [ ] 对 `quality_rejected` item 的当前文件调用 edit，结果保存为原目录中的 `<outputId>-v2-1.<扩展名>`，未创建顶层“单图处理”目录。
- [ ] 原始失败文件仍保留，原 item 的 `revisions` 记录来源、结果和质量；用户输出不展示内部费用。
- [ ] 返修通过后原 item/run 状态更新；全部通过后才整理商品原图。
- [ ] 相同返修确认重复调用不再生图；`submission_unknown` 禁止新请求，已持久化远程 URL 可由原 run status refresh 恢复。
- [ ] 普通独立图片 edit 仍创建独立运行，且不移动源图。

## 质量

- [ ] 质检模型固定为 Gemini。
- [ ] 商品形状、包装、Logo 和主色跨图一致。
- [ ] 多角度人物身份、服装和配饰一致。
- [ ] 平台尺寸、安全区和文字规则正确。
- [ ] 没有伪造平台 UI、账号数据或工具水印。
- [ ] 淘宝/天猫、京东、拼多多计划逐项包含资产类型、证据状态和风险提醒；安全降级未被描述为官方合规。
- [ ] 国内平台结果报告真实文件格式、像素、比例和透明通道；违反官方必需比例时保留文件并拒绝作为身份锚点。