live-manual-acceptance-checklist.md 4.5 KB
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_rejecteditem 的当前文件调用 edit，结果保存为原目录中的<outputId>-v2-1.<扩展名>，未创建顶层“单图处理”目录。 - 原始失败文件仍保留，原 item 的
revisions记录来源、结果和质量；用户输出不展示内部费用。 - 返修通过后原 item/run 状态更新；全部通过后才整理商品原图。
- 相同返修确认重复调用不再生图；
submission_unknown禁止新请求，已持久化远程 URL 可由原 run status refresh 恢复。 - 普通独立图片 edit 仍创建独立运行，且不移动源图。
质量
- 质检模型固定为 Gemini。
- 商品形状、包装、Logo 和主色跨图一致。
- 多角度人物身份、服装和配饰一致。
- 平台尺寸、安全区和文字规则正确。
- 没有伪造平台 UI、账号数据或工具水印。
- 淘宝/天猫、京东、拼多多计划逐项包含资产类型、证据状态和风险提醒；安全降级未被描述为官方合规。
- 国内平台结果报告真实文件格式、像素、比例和透明通道；违反官方必需比例时保留文件并拒绝作为身份锚点。