淘宝商品组图生成工具
将一张商品原图智能处理为淘宝/天猫平台所需的全部规格组图，保持原图画风和核心元素。
触发条件
用户提到以下需求时使用：
- "淘宝主图""商品组图""白底图""SKU图"
- "详情页切片""电商图片""天猫主图"
- "把这张图生成淘宝用的各种尺寸"
- 上传商品图片并要求生成电商平台用的多尺寸版本
输出规格（按淘宝平台标准）
一、商品主图 / SKU / 白底图
| 类型 | 尺寸 | 说明 |
|---|---|---|
| 标准主图 | 800 × 800（1:1） | 单张 ≤3MB，建议 ≤500KB；≥800px 开放大镜 |
| 竖版/长主图 | 800 × 1200（3:4）或 750 × 1000 | 服饰类常用 |
| 白底图（第5张） | 800 × 800，纯白 RGB(255,255,255) | 无文字/水印/logo/阴影 |
| SKU 规格图 | 800 × 800（1:1） | 规格、型号、参数展示 |
| 主图视频封面 | 1:1（800×800）或 3:4（800×1200） | 对应视频比例 |
二、商品详情页
| 类型 | 宽度 | 高度建议 | 说明 |
|---|---|---|---|
| 手机端详情页切片 | 750px | 800–1500px/张 | 文字留 40px 安全区 |
| PC 端详情页切片 | 790px | 800–1500px/张 | 天猫 790px |
工作流程
第一步：分析原图
读取原图信息：
- 原始尺寸（宽 × 高）
- 图片格式和文件大小
- 主色调（用于白底图的背景分析）
- 主体位置（简单方差法检测主体区域，用于智能裁切）
- 判断原图比例属于哪类：方形 / 竖长 / 横宽
第二步：确定处理策略
对每个目标尺寸，判断用哪种策略：
| 原图比例 vs 目标比例 | 策略 | 说明 |
|---|---|---|
| 原图比例 ≥ 目标比例 | 裁切 | 按比例裁切，优先保留中心主体区域 |
| 原图比例 < 目标比例 | 扩图 | 上下/左右补白/补主色调，保持主体完整 |
| 白底图 | 去背景+纯白底 | 基于主色调分析，主体保留，背景替换为纯白 |
裁切优先级：
1. 先检测主体区域（边缘方差法），主体在中心则中心裁切
2. 主体偏左/偏右则智能偏移裁切，确保主体不被裁掉
3. 若无法检测主体，默认中心裁切
扩图规则：
1. 补图区域填充主色调（取图片四角的平均色）
2. 白底图则填充纯白 RGB(255,255,255)
3. 扩图后主体居中，不变形
第三步：批量生成
对每个目标尺寸执行：
1. 计算裁切/扩图区域
2. 调用图像处理（PowerShell + System.Drawing）
3. 保存到对应子文件夹
第四步：组织输出
{输出目录}/
├── 主图/
│ ├── 标准主图_800x800.jpg
│ ├── 竖版主图_800x1200.jpg
│ ├── 白底图_800x800.jpg
│ ├── SKU规格图_800x800.jpg
│ └── 视频封面_800x800.jpg
├── 详情页_手机端/
│ ├── 切片_01_750x1200.jpg
│ ├── 切片_02_750x1200.jpg
│ └── ...
└── 详情页_PC端/
├── 切片_01_790x1200.jpg
└── ...
使用脚本
scripts/generate_images.py 为编排脚本，实际图像处理通过 PowerShell + .NET System.Drawing 完成。
python scripts/generate_images.py <原图路径> <输出目录> [--skip-white-bg] [--skip-detail]
参数说明：
- <原图路径>：商品原图路径
- <输出目录>：组图保存目录
- --skip-white-bg：跳过白底图生成（耗时较长）
- --skip-detail：跳过详情页切片生成
注意事项
- 保持画风：只做几何变换（裁切/缩放/扩图），不做滤镜、调色、风格化处理
- 白底图质量：白底图需要背景分离，简单方法基于主色调判断，复杂背景建议用户先用专业工具抠图后重新生成
- 文件大小：输出 JPG 质量设为 90%，确保单张 ≤3MB
- 文字安全区：详情页切片若含文字，提醒用户在原始设计中确保文字距离边缘 ≥40px
- 比例优先：裁切或扩图都不改变主体比例，不变形
