Aionforge Auxiliary

---
name: aionforge-auxiliary
description: >
  阶段 5 商品辅助图生成：按「思考 → 事实锁定 → 生成 → 检查」四步闭环，
  严格对照拼多多等电商平台上架辅助图官方规范，基于已通过质检的 T 恤实拍合成图（bg_white）
  与模特主图（main），生成合规的 2:3 竖版商品长图（400×600px 起）与 1:1 纯白底商品白底图（480×480px 起，主体占比 80%–90%）。
  用户说生成辅助图、商品长图、白底图、拼多多长图与白底图、上架辅助图时使用。
  Use when the user runs /aionforge-auxiliary.
---

# 阶段 5：基于主图与商品实拍图生成商品辅助图（长图 + 白底图）

本流程严格对照拼多多等电商平台上架「商品辅助图」官方标准（搜索页、店铺页、分类页入口露出），基于阶段 2 产出的 **T 恤实拍合成图（`bg_white`）** 与阶段 3 产出的 **模特主图（`main`）**，生成可直接上架投放的辅助图套装。

未加载入口时先读 `../aionforge/SKILL.md`。工具只按名称引用，参数见工具卡；本文件不写命令。画幅与平台规范见 [platforms.md](../aionforge/references/platforms.md) 与 [vary.md](../aionforge/references/prompts/vary.md)。

## 上架辅助图官方规范基线

| 辅助图类型 | 目标比例与尺寸 | 格式与体积 | 官方基本要求 |
| --- | --- | --- | --- |
| **商品长图** | **`2:3` 竖版**（最低 `400 × 600px`，推荐 `800 × 1200px`） | `JPG/JPEG/PNG`，`< 3MB` | **带有背景**、**无牛皮癣**、**非合成图**（自然实拍感）、**主体完整**、**主体清晰不偏色**、**主体不变形**、**正面居中**、**不拼图**（单张完整画面）、**单人模特**、**无衣架** |
| **商品白底图** | **`1:1` 正方形**（最低 `480 × 480px`，推荐 `800 × 800px`） | `JPG/JPEG/PNG`，`< 3MB` | **纯白背景**（`#FFFFFF`）、**无牛皮癣**、**主体完整**、**主体占比 `80%–90%`**（大小适中）、**单主体**（套装除外）、**纯商品展示**（无人像与人体局部）、**主体不变形** |

## 输入与输出

| 方向 | 内容 | 说明 |
| --- | --- | --- |
| **输入** | 正面商品图 `bg_white`（`garment`）、已通过质检的正面模特主图 `main`（`source`）、`facts.json` | 长图强制以正面模特主图作为 `source` 保持锁脸与自然穿搭背景；白底图仅基于 `garment` 纯成衣平铺生成 |
| **输出文件（长图）** | `output/<logo>/auxiliary/<product>-<color>-long.png` | `2:3` 竖版正面居中单人模特长图 |
| **输出文件（白底图）** | `output/<logo>/auxiliary/<product>-<color>-white.png` | `1:1` 纯白底 `#FFFFFF` 平铺商品图（主体占 `80%–90%`） |

---

## 四步闭环执行流程

### 第一步：思考（Think —— 对照官方要求评估素材）

1. **评估商品长图（搜索页 / 店铺页露出）**：
   - 必须选取**正面居中**、**单人模特**、**带有自然实拍背景**（如街景/室内棚拍环境）的构图；严禁拼图、严禁牛皮癣贴纸、严禁生硬抠图合成感、严禁出现衣架。
   - 若现有 `main/<product>-<color>-hero.png` 为 `1:1` 方图，需延展为 `2:3` 竖版全身/大半身穿搭，保持模特正脸清晰、头顶留白适度、T 恤主体居中完整且不偏色变形。
2. **评估商品白底图（搜索 / 分类页入口露出）**：
   - 检查 `bg_white/<product>-<color>.png`：必须达到 **纯白背景 `#FFFFFF`**、**单主体纯平铺**（无人像、无手脚、无衣架）、**主体占画面 `80%–90%`**。若原图留白过多（主体占比低于 80%）、背景发灰或有投影，必须按标准重新裁剪/生成。

### 第二步：事实锁定（Lock —— 锁定参考图角色与画幅参数）

1. 在 `facts.json` 中记录辅助图任务清单：
   - **长图任务**：绑定 `source=main/<product>-<color>-hero.png`（正面模特主图）、`garment=bg_white/<product>-<color>.png`，目标比例 `2:3`（输出尺寸 `≥ 400×600px`，推荐 `800×1200px`），单人正面居中、带自然背景、纯画面无文字水印。
   - **白底图任务**：绑定 `garment=bg_white/<product>-<color>.png`（纯成衣参考），目标比例 `1:1`（输出尺寸 `≥ 480×480px`，推荐 `800×800px`），纯白底 `#FFFFFF`、单件平铺占画面 `80%–90%`。

### 第三步：生成（Generate —— 编写 Prompt、静态检查并出图）

1. 分别编写 `<product_dir>/prompts/auxiliary/` 下的 Prompt 文件：
   - **长图 Prompt**：保持 `source` 模特五官、发型与 `garment` T 恤款式、颜色、正面印花位置及尺寸 100% 一致；采用 `2:3` 竖版单张单人正面居中穿搭构图，搭配真实自然的室外或室内环境背景，光线与肤色写实自然、具备实拍质感，T 恤主体清晰不偏色、不变形、完整无裁切，画面干净无任何文字、角标、贴纸或衣架。
   - **白底图 Prompt**：仅基于 `garment` 还原正面平铺 T 恤全貌，单件主体居中摆正并占满画面 **`80%–90%`**（四周仅留少量均匀白边）；背景为绝对纯白 `#FFFFFF`，无投影、无灰调、无人体局部、无衣架、无文字水印。
2. 调用 [prompt check](../aionforge/references/tools/prompt-check.md) 检查 Prompt 规范，确认无「图1/图2」指代且印花描述与事实一致。
3. 逐张调用 [generate](../aionforge/references/tools/generate.md) 生成至 `output/<logo>/auxiliary/`（长图指定 `2:3` 比例，白底图指定 `1:1` 比例）。

### 第四步：检查（Verify —— 客观校验与官方红线逐项复核）

1. **客观检查**：调用 [verify](../aionforge/references/tools/verify.md) 检查：
   - 长图比例为 `2:3`、尺寸 `≥ 400×600px`、体积 `< 3MB`；
   - 白底图比例为 `1:1`、尺寸 `≥ 480×480px`、体积 `< 3MB`。
2. **官方要求逐项看图质检**：
   - **长图 10 项核对**：带有背景、无牛皮癣、自然非合成感、主体完整、主体清晰不偏色、主体不变形、正面居中、单张不拼图、单人模特、无衣架；模特面部与 `main` 主图同一人。
   - **白底图 7 项核对**：纯白背景 `#FFFFFF`、无牛皮癣、主体完整、主体占比 **`80%–90%`**（不过大或过小）、单主体、纯商品无人像、主体不变形；衣服细节与 `bg_white` 100% 一致。
3. **交付汇总**：列出 `output/<logo>/auxiliary/` 下的长图与白底图路径及像素尺寸，提示可直接配合 `/pdd-help`（`pdd_prepare.py`）上传上架。

---

## 失败路由

| 现象 | 处置 |
| --- | --- |
| 长图出现拼图、拼接感或抠图贴图感 | 强化「单张自然实拍街景/室内半身人像、统一环境光影与景深」描述后重跑 |
| 长图模特背身、侧偏或画面裁切 | 强调「正面居中构图、单人模特正面向镜头、头顶与衣摆保留完整呼吸空间」后重跑 |
| 白底图主体占比偏小（<80%）或贴边裁切 | 调整构图描述为「T 恤平铺居中并放大至占画幅 85% 左右，四边保留少量均匀纯白边距」后重跑 |
| 白底图背景发灰、有投影或出现人体/衣架 | 确认仅传 `garment` 平面成衣参考，强调「绝对纯白 `#FFFFFF` 无影平面平铺单件成衣」后重跑 |
| 成衣颜色偏色或印花与 `bg_white` 不一致 | 核对 `garment` 真相源绑定并在 Prompt 中锁定精确底色与印花描述后重跑 |