listing-report/fmode-image-set/docs/customer-quickstart.md

客户快速开始

完成后只读评分

完整评分不需要 API Key，也不使用外部配额。应在 Claude Code 中调用 $fmode-image-set-score，让 Skill 逐一打开全部成品图和商品原图、核验显式角色，再运行确定性计分器。

直接运行下面命令只会得到自动技术基线；它不会查看图片内容，因此 qualityScore 和完整保障分都不可用：

node skills/fmode-image-set-score/scripts/score-image-set.mjs "D:\待验收\套图" --profile generic --format markdown

完整视觉评分必须用 score-contract/v3，并从 stdin 提交逐图 × rubric 的 assessments 而不落盘 manifest。qualityScore 是套图自身基础质量；没有商品参考时只有 fidelityScore 为 N/A，没有显式角色时只有 contractFitScore 为 N/A；两者缺失都会使 assuredOverallScore 为 N/A，但不再阻止基础质量评分。所有分数必须和矩阵覆盖、可信度、硬失败、最弱图片及整改一起阅读。真实投放指标单独报告，不得根据视觉印象预测。

1. 安装 Node.js 20.11+，在包目录运行 npm ci。
2. 为 Claude Code/MCP 进程配置 FMODE_LLM_BASE_URL 和 FMODE_LLM_API_KEY；远程 HTTP 网关还需显式设置 FMODE_ALLOW_INSECURE_HTTP=true。
3. 在目标工作区运行 node <包路径>/bin/fmode-image-set.js workspace --smoke。
4. 重启 VSCode Claude Code。
5. 把商品图放在当前项目内，在对话中粘贴一个或多个路径并说：“这些是 MORI 咖啡的商品图，先规划七张套图，不要生图。”
   • 国内平台示例：“这些是 MORI 咖啡的商品图，按淘宝主图方案规划，不要生图。”此时必须明确平台为淘宝/天猫、京东或拼多多，不能依靠模糊猜测。
6. 检查每张图的目标、模型、尺寸和提示词摘要；系统不会展示生成费用。
   • 国内平台还要检查 platformRule 的资产用途、证据状态和警告；safe_fallback 只表示保守设计建议，不代表平台官方审核保证。
7. 确认后说：“按这个计划生成，confirmed=true。”之后可以离开界面等待；单图临时异常会自动尝试，仍失败也会继续后续图片。
8. 检查每项 quality.status；unverified 或 quality_rejected 需要人工复核。
   • 国内平台生成结果还会读取真实 PNG/JPEG/WebP 元数据并返回 platformValidation；required 规格失败会拒绝交付，recommended 规格只警告并保留文件。
9. 完整成功后检查中文运行目录和 商品原图/：项目根图片应已移动，项目子目录图片应保留并复制；最终消息应逐项给出新路径。
10. 如果最终列出失败 ID，回复“继续原任务，只重试 D4、D6”。系统必须使用原 runId + retryOutputIds，不得重新规划或生成已完成图片。

模型选择

• 默认/high_quality/gemini：使用 gemini-3.1-flash-image-preview，优先商品身份一致性和整体质量。
• seedream：使用 doubao-seedream-4-0-250828 的 2K 图片接口。
• 无论使用哪个生图模型，质量检查都使用 Gemini。
• 失败后不会自动切换模型；换模型会改变计划，必须重新规划和确认。

凭据缺失

• needs_token：配置 New API Key 后重启 MCP。
• needs_valid_token：检查 Key 是否过期或 endpoint 是否匹配。
• needs_recharge：充值后先核对原 run_id，不要直接创建重复请求。
• blocked（HTTP）：优先改用 HTTPS；仅信任内网网关时才允许远程 HTTP。