# 客户快速开始

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. 上传商品图并说：“分析这张图，先规划七张套图，不要生图。”
6. 检查每张图的目标、模型、尺寸、提示词摘要和人民币预算。
7. 确认后说：“按这个计划生成，`confirmed=true`，`budgetLimitCny=5.3`。”
8. 检查每项 `quality.status`；`unverified` 或 `quality_rejected` 需要人工复核。

## 模型选择

- 默认/`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。