批量套用详情模板
说明如何给单款或多款商品图片批量套用详情模板，统一图片宽度、背景、留白和排版风格；该功能只整理现有素材，不重新生成商品和卖点内容。
这个功能能解决什么问题
批量套用详情模板 用来把已经准备好的商品图片统一排版，并输出为常用的详情页宽度。
它不会重新创作商品内容，也不会改变原图中的商品、文字或卖点。它做的是：
- 按统一宽度缩放图片，同时保持原图比例。
- 给图片添加整齐的背景、留白和标题区域。
- 为单个商品或一批商品生成统一风格的详情图片。
- 款式批量套框时，把处理结果保存到各商品文件夹的
详情页目录。
如果你需要根据商品参考图创作新的详情页内容，请使用 AI生成详情页 或 批量生成详情页。如果你已经有图片，只想统一尺寸和版式，使用本功能更合适。
单款套框和款式批量套框
单款套框
适合处理一个商品。你可以直接上传 1 到 12 张图片，选择宽度和样式后开始处理。每张图片不能超过 30MB。
系统按照上传文件名的顺序处理图片。第一次使用时，建议先用单款套框检查样式和宽度是否符合需要。
当前单款模式可以创建处理任务，但页面还没有提供“打开结果目录”或“下载结果”的入口。正式交付图片时，不要只依赖单款模式；该入口需要后续单独完善。
款式批量套框
适合一次处理多个商品。你需要选择一个商品根目录，根目录下面的每个子文件夹代表一个商品。
系统会依次读取每个商品子文件夹根目录中的图片，并把结果分别保存到各自的 详情页 目录。
批量处理前怎样整理文件夹
正确的目录结构示例：
本批商品
├─ 款式A
│ ├─ 01.jpg
│ ├─ 02.jpg
│ └─ 03.jpg
├─ 款式B
│ ├─ 01.png
│ └─ 02.png
└─ 款式C
├─ 01.webp
└─ 02.webp需要套用模板的图片应直接放在每个商品子文件夹的根目录中，不要只放在原有的 详情页 子目录里。
所选批量根目录是第1层，商品文件夹是第2层，需要套框的图片文件必须位于第3层。放在商品内部详情页、原图等第3层素材文件夹里的图片位于第4层，本功能不会把这些更深层图片作为批量套框输入。
系统支持以下图片格式：
- JPG、JPEG、JFIF
- PNG
- WEBP
- BMP
每个商品最多处理按文件名排序后的前 12 张图片。建议使用 01.jpg、02.jpg、03.jpg 这样的名称，以便明确控制图片顺序。
页面上的设置怎样选择
详情页宽度
当前可选：
750宽790宽1440宽
可以同时选择多个宽度。选择两个宽度时，每张原图会分别输出两个版本。
如果暂时不确定，先选择当前店铺最常用的一个宽度做小样测试。
模板样式
当前提供三种内置样式：
清爽标题：白色背景，带简洁的顶部标题区域。纯净留白：白色背景，只保留留白，不显示顶部标题。浅灰标题：浅灰背景，带顶部标题区域。
三种样式都会保持原图比例，不会强行裁掉商品内容。
顶部标题
选择 清爽标题 或 浅灰标题 时，可以填写最多 24 个字的短标题，例如 商品细节展示。
选择 纯净留白 时不显示标题，标题输入框会自动停用。
如果选择了带标题的样式但把标题留空，系统会使用默认标题 商品细节展示。
已有结果处理
保留已有结果 是默认选项。目标文件已经存在时，系统跳过该文件，不会覆盖。
替换同名结果 只替换本次将要生成的同名套框图片，不会清空 详情页 目录，也不会删除你放在目录里的其它图片或说明文件。
推荐操作步骤
- 先整理一款或一批需要套框的图片。
- 单款模式上传 1 到 12 张图片；批量模式选择包含款式子文件夹的商品根目录。
- 至少选择一个详情页宽度。
- 选择一种模板样式，并按需填写顶部标题。
- 保持
保留已有结果。 - 点击
检查图片，确认图片已经识别。 - 点击
生成处理计划，核对预计处理数量。 - 确认无误后开始套用外框。
- 批量模式完成后，到各商品文件夹的
详情页目录检查结果。
单款模式当前没有结果取回入口。如果只是为了正式产出可上传图片，建议先使用一个只含单款子文件夹的批量目录进行小样测试。
处理结果保存在哪里
款式批量套框的结果保存在每个商品文件夹的 详情页 目录中。
批量处理时，详情页目录位于第3层，套框后的具体文件位于第4层；原始输入图片仍保留在第3层，不会被移动或覆盖。
文件名示例：
详情页
├─ 750宽_01_套框详情.jpg
├─ 750宽_02_套框详情.jpg
├─ 790宽_01_套框详情.jpg
└─ 790宽_02_套框详情.jpg原始图片会保留在原来的位置。系统不会移动、改写或删除原图，也不会顺带生成主图、白底图或视频。
单款上传模式的图片会先保存到软件的本次任务工作目录，再从那里生成结果。当前页面还没有提供打开该目录或下载结果的入口；这是单独的功能缺口，不应把它误写成“可以直接下载”。
如何查看成功、跳过和失败
页面处理结果会显示本次处理的商品数、生成图片数、保留已有图片数和失败图片数。
如果某一张图片损坏或无法读取，系统会记录这张图片的失败原因，并继续处理同一商品中的其它正常图片，不会因为一张坏图丢掉全部结果。
需要查看完整过程时，可以进入任务中心查看任务进度和失败详情。
常见问题
为什么检查不到图片
批量处理时，请确认：
- 选择的是包含多个商品子文件夹的商品根目录。
- 图片直接放在商品子文件夹根目录中。
- 图片格式属于 JPG、JPEG、JFIF、PNG、WEBP 或 BMP。
- 商品子文件夹不是空文件夹。
为什么有些图片没有重新生成
如果选择了 保留已有结果，同名结果已经存在时会自动跳过。这是为了避免覆盖已确认的图片。
确实需要重做时，可以选择 替换同名结果。该选项仍然只替换同名套框图片，不会清空整个目录。
为什么图片顺序不符合预期
系统按文件名排序后处理前 12 张图片。建议统一使用两位数编号，例如 01、02、03，不要混用容易产生歧义的名称。
为什么图片高度不一样
本功能保持每张原图的比例，因此相同输出宽度下，横图、方图和竖图的最终高度会不同。这能避免强制裁剪导致商品内容缺失。
这个功能会自动生成商品卖点吗
不会。本功能只做本地图片排版。如果需要 AI 根据商品素材生成新的卖点版块和详情图片，请使用 AI 详情页生成功能。
云店Agent可以怎样帮助你
你可以这样询问云店Agent：
我有一批已有商品图片，应该用批量套用详情模板还是AI生成详情页？为什么这款商品只生成了两张套框详情图？750宽、790宽和1440宽应该怎么选？帮我根据任务记录解释哪些图片处理失败了。云店Agent会优先参考文档中心和任务记录回答，不会替你删除原始图片。