openclaw-voc-skill/claude-code/fmode-image-set/docs/customer-quickstart.md

客户快速开始

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。