# 客户快速开始

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。