淘宝店铺组图生成工具
将用户提供的店铺/品牌素材图智能处理为淘宝/天猫店铺装修所需的全部规格组图，保持原图画风和核心元素。
触发条件
用户提到以下需求时使用：
- "店铺装修""店招""店铺banner""淘宝首页"
- "导航图标""店铺logo""轮播海报""通栏背景"
- "把这张图生成淘宝店铺用的各种尺寸"
- 上传店铺素材并要求生成多尺寸版本
输出规格
PC 端
| 类型 | 尺寸 | 说明 |
|---|---|---|
| 店招（内容区） | 950 × 120 或 950 × 150 | 含导航，居中放 950 宽内 |
| 店招通栏背景 | 1920 × 150 | 全宽通栏 |
| 全屏轮播海报 | 1920 × 400 / 500 / 600 | 内容居中放 950 内 |
| 左侧栏 | 200 × 不限 | 高度按内容撑开 |
| 自定义区 | 950 × 不限 | 与店招同宽 |
手机端（无线店铺）
| 类型 | 尺寸 | 说明 |
|---|---|---|
| 首页 banner / 轮播 | 750 × 200 / 300 / 440 | 高度可按模块调整 |
| 导航图标 | 144 × 144 或 200 × 200 | 方形图标 |
| 关联促销条 | 750 × 300 / 400 | 促销区域 |
| 店铺 logo / 店标 | 80 × 80 或 120 × 120 | 小尺寸 logo |
工作流程
第一步：分析原图
读取原图信息：
- 原始尺寸（宽 × 高）
- 图片格式和文件大小
- 主色调（四角平均色，用于扩图补色）
- 主体区域（9 宫格方差法，用于智能裁切）
- 判断原图比例类型：方形 / 竖长 / 横宽
第二步：确定处理策略
| 原图比例 vs 目标比例 | 策略 | 说明 |
|---|---|---|
| 原图比例 ≥ 目标比例 | 裁切 | 按比例裁切，优先保留中心主体区域 |
| 原图比例 < 目标比例 | 扩图 | 上下/左右补主色调，保持主体完整 |
裁切优先级：
1. 先检测主体区域（9 宫格方差法），主体在中心则中心裁切
2. 主体偏左/偏右则智能偏移裁切，确保主体不被裁掉
3. 若无法检测主体，默认中心裁切
扩图规则：
1. 补图区域填充主色调（取图片四角的平均色）
2. 扩图后主体居中，不变形
第三步：批量生成
对每个目标尺寸执行：
1. 计算裁切/扩图区域
2. 调用图像处理（PowerShell + .NET System.Drawing）
3. 保存到对应子文件夹
第四步：组织输出
{输出目录}/
├── PC端/
│ ├── 店招_950x120.jpg
│ ├── 店招通栏背景_1920x150.jpg
│ ├── 轮播海报_1920x500.jpg
│ ├── 左侧栏_200x1200.jpg
│ └── 自定义区_950x1200.jpg
├── 手机端/
│ ├── 首页banner_750x300.jpg
│ ├── 导航图标_200x200.jpg
│ ├── 关联促销条_750x400.jpg
│ └── 店铺logo_120x120.jpg
└── 通用/
└── (跨端通用素材)
使用脚本
scripts/generate_shop_images.py 为编排脚本，实际图像处理通过 PowerShell + .NET System.Drawing 完成。
python scripts/generate_shop_images.py <原图路径> <输出目录> [--pc-only] [--mobile-only] [--skip-detail]
参数说明：
- <原图路径>：店铺素材原图路径
- <输出目录>：组图保存目录
- --pc-only：只生成 PC 端规格
- --mobile-only：只生成手机端规格
- --skip-detail：跳过高细节规格（加速）
注意事项
- 保持画风：只做几何变换（裁切/缩放/扩图），不做滤镜、调色、风格化处理
- 文件大小：输出 JPG 质量设为 90%，确保单张 ≤3MB
- 比例优先：裁切或扩图都不改变主体比例，不变形
- 左侧栏/自定义区：高度不限，默认生成 1200px 高，用户可自行裁剪
- 内容安全区：PC 端有效内容区为 950px 宽，手机端为 750px 宽，重要内容不要放边缘
