customer-quickstart.md 1.4 KB

客户快速开始

  1. 安装 Node.js 20.11+,在包目录运行 npm ci
  2. 为 Claude Code/MCP 进程配置 FMODE_LLM_BASE_URLFMODE_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=truebudgetLimitCny=5.3。”
  8. 检查每项 quality.statusunverifiedquality_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。