Ecommerce Image Suite

电商套图生成助手

概览

本 Skill 实现从「商品原始图片 + 卖点信息」到「完整电商套图」的一键生成流程：

① 上传商品图片（必须）+ 输入卖点信息（可选）
        ↓
② AI 视觉分析：提取商品主体，智能生成卖点文案（可编辑）
        ↓
③ 选择平台规范 + 套图类型（7种标准图）
        ↓
④ AI 生成每张图的详细 Prompt（可编辑）
        ↓
⑤ 调用图像生成 API，输出完整套图（文案由生图模型直接渲染）
        ↓
⑥ 平台文案（可选）→ ⑦ 详情页 HTML（可选）
        ↓
⑧ 产品展示视频生成（可选，基于套图，需用户确认）

⛔ 前置检查：API Key 验证（必须最先执行）

在执行任何其他操作之前，Agent 必须先完成以下验证。若验证失败，立即停止，不得调用任何工具或执行任何后续步骤。

验证步骤

运行供应商检测脚本：

python3 scripts/check_providers.py

解析输出中的 configured 数组：

• 如果 configured 为空数组 []：

  ❌ 配置缺失，任务终止。

  向用户输出以下消息，然后立即停止，不再调用任何工具：

  ---

  未检测到任何图像生成 API Key，无法继续操作。

  请至少配置以下供应商之一（国内用户推荐前两个）：

  供应商	环境变量	说明
  阿里云通义	DASHSCOPE_API_KEY	国内直连，推荐
  字节跳动豆包	ARK_API_KEY	国内直连
  OpenAI	OPENAI_API_KEY	需代理
  Google Gemini	GEMINI_API_KEY	需代理
  Stability AI	STABILITY_API_KEY	需代理

  配置方法：

  export DASHSCOPE_API_KEY="sk-..."   # 推荐，国内直连
  # 或
  export ARK_API_KEY="..."

  加入 ~/.zshrc 后执行 source ~/.zshrc 使其永久生效，然后重新启动对话。

  ⚠️ Agent 规则：输出上述消息后，立即终止本次任务。不得继续分析图片、生成 Prompt 或调用任何其他工具。

• 如果 configured 非空：记录可用供应商列表，继续执行第一步。

check_providers.py 脚本报错处理

若脚本本身执行失败（非零退出码或输出异常），将完整错误信息输出到对话，格式如下，然后停止：

❌ 供应商检测脚本执行失败，任务终止。

错误详情：

[此处粘贴脚本的完整 stdout + stderr 输出]

请检查 Python 环境（需 Python 3.8+）及脚本路径是否正确。

触发入口：判断是否已上传图片

⚠️ Agent 必须在第一步开始前执行此判断，决定对话起点。

情况 A：用户触发时【未上传图片】

用户说了类似「帮我做电商套图」「我要给某商家出套图」但没有附带任何图片时，Agent 禁止直接进入第一步，必须先走以下引导流程：

1. 发送欢迎 + 图片输入引导（一条消息完成）：

好的，我来帮您生成完整的电商套图！

在上传图片前，先了解一下最佳输入方案，图片质量直接决定生成效果：

---

请选择您的图片输入方式：

编号	方式	效果	适用情况
① 正面 + 背面（平铺）	⭐⭐⭐⭐⭐ 最佳	AI 全面理解正背面结构，材质图自动用背面细节	服装/鞋类强烈推荐
② 单张正面（平铺）	⭐⭐⭐⭐ 优秀	标准正面展示，效果稳定	仅有一张时首选
③ 正面 + 背面（挂拍）	⭐⭐⭐⭐ 优秀	悬挂构图，适合有衣架的商家	有挂拍图时推荐
④ 单张挂拍	⭐⭐⭐ 良好	悬挂构图，效果较平铺略差	仅有挂拍图时
⑤ 模特实拍	⭐⭐⭐ 良好	AI 提取商品特征，去除模特	有模特图时可用

💡 小贴士：多张图必须是同一商品，不同颜色/款式请分批处理；平铺图请确保平整无褶皱。

📋 CLI 环境（如 Claude Code）：无法直接拖拽上传图片，请提供以下任一方式：

• 本地文件路径（如 /Users/me/photos/product.jpg）
• 远程图片 URL（如 https://example.com/product.jpg）
• Base64 字符串（data:image/jpeg;base64,/9j/4AAQ...）
• Base64 文件路径（文件内容为 base64 编码的图片数据）

请选择编号（或直接上传图片 / 提供路径或 URL，我会自动识别类型），然后提供图片即可开始。

2. 等待用户回复：

• 用户选择编号后，记录 input_image_type（见映射表），再提示提供对应数量的图片（图形界面：上传图片；CLI：提供本地路径 / URL / base64）
• 用户直接上传图片或提供路径/URL/base64（未选编号），自动检测 input_image_type，进入情况 B

编号 → input_image_type 映射：

情况 B：用户触发时【已上传图片】

用户在同一条消息中附带了图片时，Agent 直接进入第一步，无需重复引导。 自动检测 input_image_type（见第二步 Step A），跳过欢迎引导。

第一步：收集输入信息

必须项

• 商品图片：用户上传的原始商品图，支持 1-3 张同一商品的不同角度/拍摄方式
  • 平铺图（flat lay）、挂拍图（hanging）、模特实拍图（model）均可
  • 多图时，Agent 综合所有图片分析，提取更完整的商品信息
  • 多图仅用于分析参考，生成套图时以 --product JSON 驱动，不直接传入多图

可选项（若用户未提供，AI 将自动从图片中分析生成）

第二步：AI 分析与卖点生成

🤖 商品识别三级优先策略（Agent 必须按顺序判断，不得跳级）：

优先级	条件	执行方式
① 最高	Agent 自身具备视觉理解能力（如 Claude Vision、GPT-4o 等多模态模型）	直接使用 Agent 内置能力分析图片，输出卖点 JSON。禁止调用任何外部脚本。
② 次之	Agent 不具备原生视觉能力，但拥有图像识别相关工具（如 analyze_image、img_recognize、vision_tool 等）	调用 Agent 内置工具分析图片，输出卖点 JSON。
③ 兜底	Agent 既无原生视觉能力、也无视觉工具	调用 scripts/analyze.py 脚本（见下方说明）。禁止让用户手动描述商品，禁止凭空生成商品描述。

⚠️ 严禁行为：在未尝试上述三级方案的情况下，直接询问用户「请描述一下您的商品」。

⚠️ 确定输出目录（output_dir）

⚠️ Agent 必须先检查已有目录，按最大编号 +1 递增，禁止直接使用 001！

每个商品任务使用独立子目录，避免多批次生成图与 generate_result.json 互相覆盖。

自动递增规则：

1. 检查 ./output/ 下已有三位数编号子目录（001/、002/、003/、004/……）
2. 取最大编号 +1 作为本次目录（如已有 004/ 则本次使用 005/）
3. 若 ./output/ 不存在或为空，则从 001 开始

Agent 操作流程：

1. 先检查已有目录（必须执行）：

# Bash 方式
if [ -d "./output" ]; then
  n=$(ls -d ./output/[0-9][0-9][0-9] 2>/dev/null | sort | tail -1 | grep -oE '[0-9]+$')
  next=$(printf "%03d" $((${n:-0} + 1)))
  echo "检测到已有目录，将使用: ${next}"
else
  next=001
  echo "output 目录为空，将从 001 开始"
fi

2. 创建输出目录：

output_dir="$(pwd)/output/${next}"
mkdir -p "${output_dir}"
echo "本次套图将保存到: ${output_dir}"

3. **告知用户**：

> 检测到已有商品任务（最高编号：004），本次将使用 **output/005/**。
> 直接继续，或输入自定义目录名（如 `黑色连衣裙`）。

**同一任务使用多个模型时**：在任务子目录下再创建模型名子目录（如 `output/001/nano-banana/`、`output/001/gpt-image-1.5/`）。

**多模型子目录**（同一任务对比不同模型效果）：

```bash
# 首个模型
output_dir="$(pwd)/output/001/nano-banana"
mkdir -p "${output_dir}"
# 后续模型
output_dir_2="$(pwd)/output/001/gpt-image-1.5"
mkdir -p "${output_dir_2}"

非 Bash 客户端：用文件系统工具列出 ./output/ 子目录，找最大数字编号 +1；若无法判断则默认 ./output/001/。

用户也可自定义目录名（如按商品命名）。

记录 output_dir 后，后续所有步骤统一使用此路径。

⚠️ 常见错误：直接使用 output/001/ 会覆盖之前的任务！必须先检查最大编号。

⚠️ 图片预处理（最先执行，所有步骤的前提）

用户上传的图片保存在 session 临时目录，脚本运行时可能因路径失效或权限问题无法访问。必须在调用任何脚本前将图片复制到 {output_dir}/ 下。

# 将所有用户上传的商品图片复制到工作区（路径以实际上传路径为准）
cp "/absolute/path/to/用户上传图1.jpg" "{output_dir}/front.jpg"
cp "/absolute/path/to/用户上传图2.jpg" "{output_dir}/back.jpg"   # 若有背面图

复制完成后，后续所有脚本一律使用 {output_dir}/front.jpg、{output_dir}/back.jpg 等工作区绝对路径，不得直接使用用户上传的原始路径。

Agent 操作规则：

1. 用 Bash cp 命令将每张上传图复制到 {output_dir}/
2. output_dir 已在上一步创建，无需重复 mkdir
3. 复制成功后记录工作区路径，后续 --product-images、--model-image、analyze.py 参数全部使用工作区路径

视觉分析步骤

Step A：判断 input_image_type（必须，影响生图构图）

Step B：确定参考图列表（决定 --product-images 参数）

使用图片预处理步骤中复制到 {output_dir}/ 的绝对路径，不得使用用户上传的原始路径。

• 1 张图 → --product-images {output_dir}/front.jpg
• 正反 2 张 → --product-images {output_dir}/front.jpg,{output_dir}/back.jpg（顺序必须：正面在前）
• 3 张 → --product-images {output_dir}/front.jpg,{output_dir}/back.jpg,{output_dir}/detail.jpg

生图脚本自动按图类型选图：

Step C：分析商品信息

1. 识别商品类型、颜色、款式、设计元素，多图时综合所有图片信息
2. 提取精确视觉特征：主色、辅助色、印花图案、领型、廓形、下摆、面料质感、季节属性
3. 基于视觉特征推断材质、功能卖点，生成每个卖点的视觉关键词（用于放大镜气泡）
4. 生成结构化卖点 JSON（格式见下），供第四步生成 generate.py 参数使用

卖点 JSON 结构（丰富版）

{
  "product_name": "黑色碎花交叉细吊带荷叶边下摆连衣裙",
  "product_category": "连衣裙",
  "product_subtype": "吊带裙",
  "product_type": "服装",

  "visual_features": {
    "main_color": "黑色",
    "secondary_colors": ["淡粉色樱花", "白色"],
    "pattern": "碎花印花",
    "neckline": "V领交叉细吊带",
    "silhouette": "鱼尾A字",
    "hemline": "荷叶边双层",
    "length": "短裙/中裙",
    "fabric_texture": "轻盈飘逸",
    "season": "春夏"
  },

  "selling_points": [
    {
      "type": "design",
      "title": "个性交叉领口",
      "description": "V领结合多重细绑带设计，凸显优雅锁骨曲线",
      "visual_keywords": ["cross-strap neckline", "V-neck detail", "collarbone"],
      "icon": "design",
      "en": "Cross-strap V-neckline",
      "zh": "个性交叉领口"
    },
    {
      "type": "pattern",
      "title": "唯美碎花印花",
      "description": "黑色底面点缀淡雅樱花图案，营造复古浪漫氛围",
      "visual_keywords": ["floral print pattern", "cherry blossom motif"],
      "icon": "design",
      "en": "Floral Print",
      "zh": "唯美碎花印花"
    },
    {
      "type": "silhouette",
      "title": "灵动鱼尾设计",
      "description": "下摆采用层次感荷叶边，行走间灵动飘逸",
      "visual_keywords": ["ruffle hemline layers", "flowy silhouette"],
      "icon": "fit",
      "en": "Ruffle Hemline",
      "zh": "灵动鱼尾设计"
    }
  ],

  "target_audience": "追求个性时尚、喜爱甜美法式风格的年轻女性",
  "target_scenes": ["海边度假", "浪漫约会", "周末聚会", "盛夏日常"],
  "target_scene_envs": [
    "tropical beach with golden sand and turquoise ocean, bright midday sunlight",
    "romantic outdoor restaurant terrace at dusk, warm candlelight, string lights",
    "stylish rooftop party, urban skyline backdrop, golden hour glow",
    "sunny park path, lush green trees, soft natural bokeh"
  ],
  "product_style": "甜美法式浪漫",

  "input_image_type": "flat_lay",
  "number_of_input_images": 1,

  "color": "黑色",
  "material": "轻薄印花面料"
}

📄 详细分析 Prompt 见 references/analysis-prompts.md

分析结果确认

分析完成后，Agent 向用户展示识别出的卖点，让用户确认或补充：

我分析出这是一件 [商品名]，主要特点是：

• [卖点1 title]：[description] • [卖点2 title]：[description] • [卖点3 title]：[description]

请确认这些卖点是否准确，或补充其他卖点（直接告知即可，我会更新后继续）。

用户确认后继续；若用户说"不对"或表示不准确：

⚠️ Agent 必须执行以下操作之一：

• 方式A（推荐）：直接调用项目中内置的专业分析脚本 analyze.py 重新分析
• 方式B：询问用户"是否使用项目中更专业的视觉分析脚本重新分析？"

调用 analyze.py 的命令：

# 自动选择已配置的视觉供应商（Qwen → 豆包 → OpenAI）
python3 scripts/analyze.py ./product.jpg --output ./output/product.json

使用 analyze.py 输出的结果继续后续流程。

⚠️ 错误处理：

• 若脚本返回 exit code 2，表示未配置任何视觉识别 API Key → Agent 必须告知用户配置环境变量（DASHSCOPE_API_KEY / ARK_API_KEY / OPENAI_API_KEY）
• 若脚本返回 exit code 1，表示 API 调用失败或 JSON 解析失败 → Agent 必须将完整错误信息输出给用户
• 若脚本无输出但成功执行（exit code 0），检查是否使用了 --output 参数导致结果写入文件而非 stdout

analyze.py 脚本详细用法

完整用法示例：

# 自动选择已配置的视觉供应商（Qwen → 豆包 → OpenAI）
python3 scripts/analyze.py ./product.jpg

# 指定供应商
python3 scripts/analyze.py ./product.jpg --provider tongyi

# 保存到文件供后续步骤使用
python3 scripts/analyze.py ./product.jpg --output ./output/product.json

analyze.py 供应商优先级（视觉识别，与图像生成供应商独立）：

⚠️ Agent 调试检查清单（当 analyze.py "没有分析出来"时）：

1. 检查环境变量：运行 echo $DASHSCOPE_API_KEY 或 python3 scripts/check_providers.py 确认是否配置
2. 检查图片路径：确认传入的图片路径存在且可读（ls -la ./product.jpg）
3. 检查脚本输出：分析失败时脚本会将错误输出到 stderr，Agent 必须捕获并显示给用户
4. 尝试手动调用：让用户手动运行 python3 scripts/analyze.py ./product.jpg 查看详细错误

analyze.py 供应商优先级（视觉识别，与图像生成供应商独立）：

若三者均未配置，脚本退出码 2，并输出配置指引。此时 Agent 必须将完整错误输出到对话并停止。不得继续。

第三步：选择平台与套图配置

⚠️ Agent 必须在此步骤主动询问用户目标平台，不得跳过。 若用户在第一步已明确说明平台（如"做一套淘宝主图"），可直接采用；否则必须先询问再继续。未确认平台前，禁止进入第四步及后续任何生图操作。

向用户提问：

请选择目标电商平台（决定图片尺寸和文案语言）：

国内平台：淘宝/天猫 · 京东 · 拼多多 · 抖音/小红书 国际平台：Amazon · 独立站/Shopify

可多选（如同时投放多个平台），我会按各平台规范分别生成。

📄 各平台规范详见 references/platforms.md

平台选择

标准套图（8种+自动补充）

每种图的详细规格见 references/image-types.md

自动补充类型：三角度拼图（正面/侧面/背面）

触发条件：当仅提供一张商品图时（len(product_images) == 1），脚本自动生成 three_angle_view 类型图片，实现360度展示。

设计说明：

• 采用三栏等宽拼图布局，左中右分别展示：正面、侧面、背面
• 服装类：使用模特展示（正面/侧面/背面，同一模特）
• 非服装类：使用商品平铺或挂拍展示
• 统一背景色（白色/浅灰），保持专业商拍风格

Agent 操作：

• 无需手动添加 three_angle_view 到 --types
• 脚本检测到仅一张图时自动插入到 multi_scene 之前
• 若用户已提供多角度图片，则不自动生成此类型

电商详情图（ecommerce_detail）

2026.04 新增：完整的电商详情页设计，包含产品主图、参数表、卖点卡片、多颜色版本展示。

生成内容：

• 产品英雄图（80% 占比，右侧 45° 角）
• 功能卖点图标列表（4个图标）
• 三角度技术图（正面/侧面/背面）
• 产品参数表（规格、电源、电池、尺寸等）
• 6 格卖点卡片（2×3 网格）
• 使用场景图（多场景呈现）
• 多颜色版本展示（相同结构不同颜色）

用途：适合需要详细产品信息的电商详情页面

第四步：准备生图参数（动态填充商品信息）

📄 各图类型的视觉规格参考见 references/image-types.md

⚠️ 架构说明：图片 Prompt 由 scripts/generate.py 内置引擎自动生成，Agent 的任务是准备好正确的商品 JSON 参数传给脚本，而非手写 Prompt 文本。图片名称和类型均由脚本固定输出（中文文件名），Agent 禁止自行调用图像 API 或另存文件。

Agent 必须完成的工作

将第二步的卖点 JSON 补充为完整的 generate.py 输入 JSON，关键字段：

product_description_for_prompt 格式要求

必须包含商品名 + 核心视觉特征（颜色、印花、款式细节），供 generate.py 在所有 Prompt 中引用。

格式：[product_name], [main_color] [pattern] [neckline] [silhouette] [hemline]

示例：
黑色碎花交叉细吊带荷叶边下摆连衣裙, black floral print V-neck cross-strap spaghetti dress with ruffle hemline
白色卡通小狗印花宽松精梳棉短袖T恤, white loose combed cotton short-sleeve T-shirt with cute dog print

完整 generate.py 输入 JSON 示例

{
  "product_description_for_prompt": "黑色碎花交叉细吊带荷叶边下摆连衣裙, black floral print V-neck cross-strap dress with ruffle hemline",
  "product_name": "黑色碎花交叉细吊带荷叶边下摆连衣裙",
  "product_category": "连衣裙",
  "product_type": "服装",
  "garment_position": "full-body",
  "visual_features": {
    "main_color": "黑色",
    "secondary_colors": ["淡粉色樱花", "白色"],
    "pattern": "碎花印花",
    "neckline": "V领交叉细吊带",
    "silhouette": "鱼尾A字",
    "hemline": "荷叶边双层",
    "fabric_texture": "轻盈飘逸"
  },
  "selling_points": [
    {
      "type": "design", "title": "个性交叉领口",
      "description": "V领结合多重细绑带设计，凸显优雅锁骨曲线",
      "visual_keywords": ["cross-strap neckline", "V-neck detail"],
      "zh": "个性交叉领口", "en": "Cross-strap V-neckline",
      "zh_desc": "V领交叉绑带，凸显锁骨曲线", "en_desc": "Delicate cross straps frame the neckline elegantly"
    },
    {
      "type": "pattern", "title": "唯美碎花印花",
      "description": "黑色底面点缀淡雅樱花图案，营造复古浪漫氛围",
      "visual_keywords": ["floral print pattern", "cherry blossom motif"],
      "zh": "唯美碎花印花", "en": "Floral Print",
      "zh_desc": "黑底樱花印花，浪漫复古韵味", "en_desc": "Romantic floral print adds vintage charm"
    },
    {
      "type": "silhouette", "title": "灵动鱼尾设计",
      "description": "下摆采用层次感荷叶边，行走间灵动飘逸",
      "visual_keywords": ["ruffle hemline layers", "flowy silhouette"],
      "zh": "灵动鱼尾设计", "en": "Ruffle Hemline",
      "zh_desc": "荷叶边层次下摆，行走飘逸灵动", "en_desc": "Layered ruffle hem flows beautifully with movement"
    }
  ],
  "target_audience": "追求甜美法式风格的18-30岁年轻女性",
  "target_scenes": ["海边度假", "浪漫约会", "周末聚会"],
  "target_scene_envs": [
    "tropical beach, golden sand and turquoise ocean, bright midday sunlight, coastal vibe",
    "romantic outdoor restaurant terrace at dusk, warm candlelight, string lights bokeh",
    "chic rooftop social gathering, urban skyline backdrop, golden hour glow"
  ],
  "product_style": "甜美法式浪漫",
  "print_design_lock": "black spaghetti dress with delicate cherry blossom floral print, cross-strap V-neckline, ruffle hemline — exact same print pattern, color and proportions must not change",
  "input_image_type": "flat_lay"
}

核心卖点图（key_features）展示样式选择

⚠️ Agent 必须根据商品卖点特征智能分析并推荐，不得使用简单规则匹配。

Agent 智能分析流程：

1. 读取商品卖点：分析 selling_points 数组，判断卖点类型

   • 材质细节类（莫代尔面料、真丝、蕾丝）→ 需要局部特写 → 推荐 ① 放大镜气泡
   • 功能特点类（防晒、速干、防水、保温）→ 需要图标化说明 → 推荐 ② 信息图标列表
   • 设计亮点类（交叉细吊带、荷叶边下摆、法式浪漫）→ 需要标注指向 → 推荐 ③ 标注线指示
   • 高端定位类（奢侈品质感、极简设计）→ 需要分割排版 → 推荐 ④ 分割板块

2. 给出有理有据的推荐：

根据分析您的商品卖点「莫代尔柔软材质、交叉细吊带设计、荷叶边下摆」，我推荐：

① 放大镜气泡 — 原因：您的卖点集中在材质细节（莫代尔）和设计细节（吊带、荷叶边），放大镜气泡可以清晰展示这些局部特写，让用户直观感受材质质感和设计亮点。

请选择编号（或直接回车使用推荐），也可以选择其他样式：

向用户展示所有选项：

① 放大镜气泡 — 居中主图 + 3个圆形放大镜气泡，连细线到商品局部 ② 信息图标列表 — 左侧商品图 + 右侧 3 条图标+文字卖点列表 ③ 标注线指示 — 商品居中 + 手写风格标注线指向各部位（生活杂志风） ④ 分割板块 — 上下/左右分割，每块一个卖点 + 对应商品局部特写（极简洁风）

用户确认后：Agent 通过 --per-type-templates key_features:N 参数传递选择（①→默认，②→默认非服装，③→2，④→3）

💡 重要：Agent 推荐必须基于卖点分析，而非简单规则匹配。例如：

• 错误：if 服装 then 推荐①
• 正确：if 卖点包含材质细节 or 设计亮点 then 推荐①，理由是...

放大镜气泡内容自动取自 selling_points[0..2].visual_keywords（首两个关键词，必须为英文，直接嵌入英文 Prompt）。

第四步半：模特图判断与模特选择（条件步骤）

本步骤仅在套图类型包含 model 或 lifestyle 时执行。

4.1 是否需要模特图？

Agent 根据第二步分析结果中的 product_type 判断：

若商品不需要模特，Agent 自动从 --types 中移除 model，并告知用户：

检测到您的商品为 [品类]，不适合模特展示图，已自动跳过该类型。

4.2 选择模特来源与展示风格

⚠️ Agent 必须主动向用户确认模特来源，不得跳过或自行决定。

若需要模特，向用户提问（仅询问模特来源）：

模特展示图的模特来源请选择：

1. 使用内置模特库 — 从预置的 AI 模特中选择，Agent 展示图片后确认（推荐，形象稳定一致）
2. AI 自动生成 — 由 AI 生成随机模特，生成后展示给您确认，确认后锁定用于场景图和多场景图

② 模特种族偏好（根据目标市场询问）

Agent 根据目标销售平台/地区询问用户模特种族偏好：

请问您希望使用什么种族的模特？（根据目标市场选择）

1. 亚洲模特 — 适合国内市场（淘宝、京东、拼多多）或东亚市场
2. 欧美模特 — 适合跨境平台（Amazon、独立站）或欧美市场
3. 混合种族 — 多元化展示，适合国际化定位

Agent 将用户选择传递给 generate.py：在商品 JSON 中添加 "model_ethnicity": "asian/western/mixed" 字段。

③ 展示风格（Agent 根据商品分析 JSON 自动判断，无需询问用户）

Agent 获取商品 JSON 后，按以下规则自动选择 --model-style：

若关键词无法确定，默认「标准商拍」。自动选择后可在回复中顺带说明（如：「已根据商品类型自动选择贴身合体展示风格」），用户如不满意可随时告知调整。

4.3 内置模特选择（用户选择方案 1）

🔒 人物锁定：选定内置模特后，--model-image 参数会作为参考图传入生图脚本。generate.py 会在 Prompt 中嵌入强制指令，要求生图模型严格复刻参考图中的人物外貌，不得替换为其他人物或外国面孔。

CLI 环境说明：若当前运行环境（如 Claude Code CLI 或其他命令行界面）不支持内联展示图片，禁止说"让我为您展示生成的套图"，应直接列出图片的绝对路径。此规则适用于本技能所有需要展示图片的场景（模特选择、模特确认、生成结果汇总）。图片路径从 generate_result.json 或 assets/models/{id}.png 读取。

Agent 必须展示模特图片（图形界面）或列出图片路径（CLI 环境），禁止只用文字描述。

流程：

1. 读取 assets/models.json 加载模特列表，按商品风格/性别自动推荐 3 位
2. 逐一展示模特图片：读取 assets/models/{id}.png 并直接在对话中展示图片
3. 同时附上文字信息辅助判断：

根据您的商品 [商品名]，推荐以下模特，请查看图片后选择：

[展示 assets/models/01.png 图片]
① 柔妍（优雅风·女·165cm）— 适合正装、中淑风

[展示 assets/models/02.png 图片]
② 雅琪（甜妹系·女·167cm）— 适合甜妹、JK、日系

[展示 assets/models/03.png 图片]
③ 宇菲（街头风·女·168cm）— 适合休闲、运动、街拍

请选择编号，或输入偏好（肤色/风格/体型），我为您筛选更多。

4. 用户选定后，记录 model_image_path = assets/models/{id}.png，进入 4.5

肤色/风格筛选：根据用户偏好（如"偏白"、"欧美风"、"男模"）过滤 models.json 的 style 字段后重新展示图片。

4.4 AI 自动生成（用户选择方案 2）

不使用内置模特，由 AI 随机生成。与方案 1 的关键区别是需要一次额外的确认步骤（见 4.5）。

默认模特风格（Agent 根据商品属性自动选择，并明确告知用户）：

Agent 告知示例：「将使用国内女模 AI 随机生成，生成后展示给您确认，确认满意后再用于场景图和多场景图。」

4.5 模特图生成与确认（两阶段生成的核心步骤）

⚠️ 模特展示图、场景展示图、多场景拼图 必须使用同一个模特参考图。 这三类图必须在确认模特后分两阶段生成，不得一次性批量生成全部 7 种图。

方案 1（内置模特）：直接进入阶段二

• model_image_path = assets/models/{id}.png（用户选定的内置模特路径）
• 已有参考图，无需额外生成，直接跳到「阶段二生成」

方案 2（AI 自动生成）：先生成→确认→锁定

阶段一：单独生成模特展示图

python3 scripts/generate.py \
  --product '{...}' \
  --provider [provider] \
  --lang zh \
  --product-images ./front.jpg \
  --types model \
  --template-set [N] \
  --output-dir ./output/

生成完成后，Agent 从 generate_result.json 读取模特图的绝对路径，然后展示图片并提问：

# 读取 generate_result.json 获取绝对路径（避免相对路径歧义）
import json
result = json.loads(open("{output_dir}/generate_result.json").read())
model_image_path = result["model"]["path"]  # 已是绝对路径

这是为您生成的模特展示图： [展示 {model_image_path} 图片]（CLI 环境：直接输出路径 {model_image_path}）

请问这个模特满意吗？

1. 满意 — 保存并用于场景展示图、多场景拼图
2. 重新生成 — 再生成一次（最多重试 3 次）
3. 换内置模特 — 切换到内置模特库选择

• 用户选 满意 → model_image_path = generate_result.json 中的 model.path（绝对路径），进入阶段二
• 用户选 重新生成 → 重新执行阶段一（超过 3 次建议切换内置模特）
• 用户选 换内置模特 → 回到 4.3 内置模特选择

阶段二：用确认的模特图生成剩余 6 种图

python3 scripts/generate.py \
  --product '{...}' \
  --provider [provider] \
  --lang zh \
  --product-images ./front.jpg,./back.jpg \
  --model-image [model_image_path] \
  --types white_bg,key_features,selling_pt,material,lifestyle,multi_scene \
  --template-set [N] \
  --output-dir ./output/

💡 --model-image [model_image_path] 确保 lifestyle 和 multi_scene 使用同一张已确认的模特图，三图模特形象完全一致。

4.6 同批次模特自动锁定机制

generate.py 内置行为，Agent 无需额外操作。

当一次调用中 --types 同时包含 model 和 lifestyle/multi_scene 时，脚本自动将本次生成的模特图用于后续类型：

model 生成完成 → 自动用作 lifestyle 的 --model-image → 自动用作 multi_scene 的 --model-image
控制台提示：🔒 锁定本次生成的模特图: /absolute/path/模特展示图.jpg

4.7 重新生成单张图时的模特锁定

当用户对某张图不满意，要求单独重新生成 lifestyle 或 multi_scene 时：

• generate.py 会自动检测 {output_dir}/模特展示图.jpg 是否存在
• 若存在，自动作为模特参考图（无需手动传 --model-image）
• 控制台提示：🔒 自动使用已有模特图: /absolute/path/模特展示图.jpg

Agent 操作规则：

1. 单独重新生成时，无论是 lifestyle 还是 multi_scene，不得省略 --output-dir（必须与首次生成保持一致，否则找不到已有模特图）
2. 若用户此时也想换模特，才需要显式传 --model-image [new_model_path]
3. 若 FileNotFoundError 错误信息含"参考图文件不存在"，从错误中读取解析路径（括号内绝对路径）告知用户实际查找位置：

   ❌ 参考图文件不存在: ./product.jpg（解析路径: /Users/.../product.jpg）
   → 告知用户：脚本在 /Users/.../product.jpg 找不到文件，请确认路径是否正确

第四步半 B：视觉风格模板智能推荐

⚠️ 此步骤必须在第五步生图之前完成。 Agent 必须根据商品特征智能推荐模板，不得使用简单规则匹配。

Agent 智能分析流程

1. 分析商品多维信息：

   • product_style：甜美法式、运动休闲、商务正装、极简主义...
   • target_audience：18-30岁年轻女性、商务人士、学生...
   • selling_points：材质特点、设计亮点、功能卖点...
   • visual_features：主色调、图案风格、廓形特征...

2. 综合判断推荐模板：

3. 给出有理有据的推荐：

根据分析您的商品特征：

• 风格定位：甜美法式浪漫
• 目标人群：18-30岁年轻女性
• 主色调：柔和粉色系
• 平台定位：淘宝/小红书

我推荐 ② 生活杂志： 理由：自然光氛围感与甜美法式风格高度契合，黄金时刻的光效能增强浪漫氛围，非常适合小红书等种草平台的视觉调性。

请选择编号（或直接回车使用推荐），也可以选择其他模板：

6 套视觉风格模板参考

各套模板对不同图类型的效果（供用户参考）：

用户确认后：Agent 通过 --template-set N 参数传递选择