电商素材处理

本地素材全链路处理

介绍商品上架前的本地素材全链路处理，包括原图预处理、主图裁剪、详情图或白底图生成、详情模板排版和商品视频处理，适合一款或整批商品。

更新于 2026/10/5

这个功能能解决什么问题

本地素材全链路处理 用于在商品上架前，一次完成一款或一批商品的图片、详情图和视频预处理。

它可以按你在页面上开启的项目依次完成：

可选缩小商品文件夹根目录里的超大原图，并决定先备份还是直接覆盖。
批量生成 1:1 主图、3:4 主图和宝贝长图。
使用在线生成服务制作详情图，或给本地图片套用统一详情模板。
可选生成 800×800 白底主图。
备份原视频，并生成 1:1、3:4、9:16 比例的视频。

简单说，它像一条“上架前素材整理流水线”。你不需要在多个页面之间来回切换，就能把商品文件夹整理成后续上架工具更容易识别的结构。

如果你只想完成其中一个动作，也可以使用 批量图片裁剪、AI生成详情页、批量生成详情页、商品文件夹智能提取 或 批量套用详情模板 等独立页面。

适合哪些使用场景

这个功能适合：

厂家或档口给了一批原始图片，需要先整理成标准主图。
原图尺寸很大，担心后续上传慢或处理时间过长。
一批商品同时缺少方图、竖图或详情图。
商品文件夹里有视频，需要顺手生成常用比例版本。
准备使用淘宝或抖店上架功能，希望先把素材结构整理好。
想先扫描和预览处理计划，再决定是否正式执行。

使用前要准备什么

1. 单个处理与批量处理的目录结构

单个处理 时，直接选择某一个商品文件夹：

厂家-货号-商品文件夹
├─ 商品主图01.jpg
├─ 商品主图02.jpg
└─ 商品视频01.mp4

批量处理 时，选择包含多个商品子文件夹的根目录：

本批商品根目录
├─ 商品A
│  ├─ 商品主图01.jpg
│  └─ 商品视频01.mp4
├─ 商品B
│  ├─ 商品主图01.jpg
│  └─ 商品主图02.jpg
└─ 商品C
   └─ 商品主图01.jpg

批量模式会把所选第1层根目录下的每个第2层直接子文件夹当作一款商品。没有直接子文件夹时，系统会把你选择的目录本身当作一款商品处理。

按统一层级表达：单个处理时，所选商品文件夹是第1层，直接放入的图片或视频文件位于第2层；再放进“视频”等素材子文件夹时，具体文件位于第3层。批量处理时，所选批量根目录是第1层、商品文件夹是第2层，直接文件位于第3层，素材子文件夹中的文件位于第4层。

2. 图片放在哪里

原始图片预处理和普通主图裁剪，读取的是商品文件夹根目录里的图片。

因此，单个处理时这类图片文件应位于第2层；批量处理时应位于第3层。放在更深层素材子文件夹里的图片不会被“普通主图裁剪”当作根目录图片，但本地智能筛选等明确支持递归的功能仍可按自身规则读取。

支持的常见图片格式包括：

JPG、JPEG、PNG、WEBP、BMP、JFIF

建议不要把尺码图、吊牌图、条形码图、白底图和营销卖点图当作普通主图混放。系统会尽量排除这些图片，但清楚的文件名和文件夹结构仍然更稳。

3. 视频放在哪里

视频可以放在商品文件夹根目录，也可以放在名称带“视频”的子文件夹里。

批量处理时，直接视频文件位于第3层；放在商品内部“视频”文件夹时位于第4层。单个处理时相应少一层。

支持的常见格式包括：

MP4、MOV、AVI、MKV、M4V

4. 商品文件夹怎么命名

本页面可以处理普通商品文件夹名称，但为了让后续上架、价格读取、库存读取、商品匹配等功能更稳定，建议尽量使用云店AI的六段式商品编码。

详细规则见：商品编码规范。

页面设置怎么选

处理范围

单个处理：只处理当前选择的一个商品文件夹，适合第一次试跑或修复单款。
批量处理：逐个处理根目录下的商品子文件夹，适合整批素材准备。

第一次使用时，建议先用单个处理确认输出效果，再切换到批量处理。

已有结果处理

保留已有结果：已有输出目录或同名文件时跳过，适合日常安全处理。
替换同名结果：允许重新生成并替换同名文件，但不会先清空整个目录。

默认建议保留已有结果。只有确认旧结果可以替换时，再开启替换。

设置模板

设置模板保存的是当前页面的处理规则，例如输出尺寸、详情处理方式、白底图设置和视频比例。

模板不会保存本次选择的商品目录。这样同一套规则可以用于不同批次的商品。

保存模板：覆盖当前选中的模板。
另存为模板：保存为一个新的模板，方便按店铺、类目或处理目的分别使用。

已经保存的模板可以到 设置中心 -> 设置模板管理 统一查看和删除；商品根目录和本次结果不会出现在模板管理中。

原始图片预处理

是否需要开启

这是可选功能，默认关闭。关闭时不会缩小商品文件夹根目录里的原图，也不影响主图裁剪、详情图、白底图或视频处理。

开启后需要选择一种原图处理方式：

先备份原图再缩小（推荐）：首次把原图复制到 原始图片备份；已有同名备份不会被覆盖。备份成功后才缩小根目录原图。
直接覆盖原图片，不创建备份：不会建立 原始图片备份，符合阈值的根目录图片会被缩小后的图片直接替换。本软件无法恢复被覆盖的大图。

选择直接覆盖时，正式开始任务前还会显示处理范围、像素阈值、目标尺寸和当前目录，请确认无误后再继续。

超过多少像素才缩小

系统读取图片的最长边。只有最长边超过这个数值时，才会缩小图片。

例如：

超过多少像素才缩小：3000
缩小后最长边：2000

表示最长边超过 3000 像素的图片会按原比例缩小，让最长边接近 2000 像素。没有超过阈值的图片不会重复处理。

主图裁剪

可输出哪些尺寸

当前可以多选：

800×800，输出到 800-800主图。
1440×1440，输出到 1440-1440主图。
750×1000，输出到 750-1000主图。
1440×1920，输出到 1440-1920主图。
1440×2160，输出到 1440x2160主图。

主图会等比例放大或缩小后裁剪，不会把图片强行拉伸变形。默认使用普通居中裁剪；开启“智能裁剪人物居中”后，符合条件的人物图片可以进一步调整构图。无论使用哪种方式，都建议先用少量商品检查主体位置和留白是否符合预期。

主图来源怎么选

使用已整理图片：使用商品文件夹根目录里的可用图片，适合图片已经人工筛选好的情况。
本地智能筛选：按图片分辨率、比例、文件大小和所在目录等本地规则选出最多 5 张候选图，不使用在线额度。
AI视觉优选素材：先按“主图裁剪数量”生成裁剪成品，再由 AI 给最适合的前 5 张加排序前缀。其余裁剪成品仍保留，不再另建一个只有 5 张的主图子集目录。当前更适合服装、鞋包类商品。

选择 AI视觉优选素材 后，系统会调用在线视觉优选能力，每款最多确定 5 张成品的排序；没有被选中的裁剪成品不会被删除。

主图裁剪数量

全部：裁剪所有可用来源图。例如一款有 19 张图，会保留 19 张裁剪成品；选择 AI视觉优选时，只对其中最优 5 张加排序前缀。
自定义：先只裁剪填写的数量，再从这些成品中排序最多 5 张。

智能裁剪人物居中

这是主图裁剪的可选增强，默认关闭。开启后：

只有识别到人物，并且普通裁剪后的头顶留白超过“裁剪触发比例”时，才会调整人物构图。
“头顶留白”决定触发后希望保留的大致顶部空间。
“人物识别的智能裁剪数量”可直接选 全部 或 自定义；自定义时默认每个商品 10 张。同一张来源图输出多个尺寸只占一个数量。
默认值为触发比例 15%、头顶留白 10%、自定义 10 张。
没有识别到人物，或当前电脑的人物识别组件不可用时，会自动按普通居中裁剪继续，不会让整批任务失败。

这项能力只用于图片主图裁剪，不会改变视频预处理。选择 AI视觉优选时会使用在线能力；人物构图本身在当前电脑上完成。

AI生成主图与复用已有 AI 主图

这是与普通主图裁剪分开的可选处理。开启 AI生成主图 后，可选择全部重新生成、仅缺图时生成或指定五个图位生成；每个图位分别选择参考原图与生成方式。生成比例可选 1:1、3:4 或 9:16，每个图位只生成一张所选比例的母图，其他尺寸在本地转换。生成结果保存在商品文件夹的 AI生成主图 数字组中，原图不会被覆盖。在线生成会消耗相应额度，建议先用单款核对结果。

如果商品已经有 AI 主图，可以使用 复用已有 AI 主图 选择指定组或跨组取图，不再调用付费生图；缺少的图位由商品原图补齐。需要调整本次详情时，详情参考来源 与 已有详情成品来源 分开选择：前者控制生成详情所参考的图片，后者控制本次整理哪套已有详情。选择的详情套不存在时按页面提示回退，不会凭空生成或上传。

自定义选图要求

选图要求文档 默认只查每款商品文件夹根目录的 选图要求.txt，也可改填另一 TXT 文件名，留空则不查文档。找到文档就整份采用文档要求；即使文档为空，也不会改读页面的 选图要求。没有找到文档时才用页面要求，两处都没有则按默认规则选图。可分别写主图、SKU 图和内容参考图要求，未写到的用途按原规则处理。此设置不会自行开启 AI 功能。

详情页处理

详情处理方式三选一：

AI生成详情图

系统会从商品资料里选择参考图，调用在线生成服务制作详情图，再按你选择的 750、790 或 1440 宽度保存结果。

需要注意：

开始前必须勾选“我确认开始后会使用在线生成额度”。
详情图只在线生成一次，多种宽度属于本地后处理，不会为了每个宽度重复生成。
原始生成图会保存在 详情页-AI生成详情\原始生成图。
正式宽度版本会保存在 详情页-AI生成详情。
在线服务额度不足或服务暂时不可用时，该款详情图可能失败；任务中心会保留具体失败原因。
一款详情图失败不会让其它商品停止排队，已经完成的主图、白底图或视频结果仍会保留。

详情组合方式：

完整详情（推荐）：先保存 AI 生成图，再按顺序补齐未参与 AI 生成的其它商品图。例如同时选择 750、790、1440，AI 只生成一次，然后由本机把 AI 图和补充图都输出为三种宽度。
仅 AI 详情：只使用 AI 生成图，不追加普通商品图，也不删除磁盘里已有的文件。

如果你需要上传多张参考图、编辑策划、单张重做、查看草稿和预览结果，请使用独立的 AI生成详情页 页面。

批量套用详情模板

系统会读取商品文件夹根目录里的图片，按选择的宽度缩放，并加上当前模板的统一留白和标题区域，输出到 详情页。

这是本地模板处理，不等于在线 AI 重新设计详情图。需要更丰富的模板和单独批量操作时，可使用 批量套用详情模板 页面。

不处理详情

本次只处理图片、白底图或视频，不生成也不修改详情图。

AI生成白底图

这是可选能力，默认关闭。

开启后选择“白底图生成-通用类目（自研）”。同一个方案会结合图片和类目自动识别服装及其它商品，也可以补充商品名称和处理要求；页面保留下拉框，便于以后增加确有必要的类目专用方案。

参考图数量可选 1 至 5 张。系统会优先读取 AI视觉优选素材结果和标准主图，生成结果保存为：

白底图_AI生成.jpg

自动读取类目时，系统会优先查找商品文件夹里的 类目属性和标题.txt，并兼容旧版 类目属性.txt、类目.txt 等文件；也可以切换为手动填写类目。

首次使用请先跑一款商品，确认商品边缘、背景和输出文件符合需要后，再批量处理。

视频预处理

视频预处理默认关闭。开启后会先把原视频复制到 原视频备份，再按勾选比例输出：

1:1，输出到 1-1视频。
3:4，输出到 3-4视频。
9:16，输出到 9-16视频。

视频采用居中裁剪，不是人物位置识别裁剪。超过 5 分钟的视频默认处理前 5 分钟；视频大小上限用于压缩兜底，默认 300 MB。

开启视频预处理后，还会检查全画面黑屏：开头和结尾的黑屏从第 1 帧起精确删除，中间只删除连续不少于 0.3 秒的黑屏，普通转场不处理。原声会按保留画面的时间段同步裁切。

视频声音处理 默认关闭，关闭时保留原声。开启后可选静音或替换背景音乐；替换会完全移除原视频声音。系统递归读取背景音乐文件夹的全部子文件夹，每个视频每次运行都重新随机选歌；文件夹只放一首音乐时即固定使用它。

全黑、去黑后不足 5 秒、处理失败或替换音乐不可用时，只跳过当前视频并记录原因，不会改用原始问题视频，也不会阻断同款的图片、详情图等其它处理。

视频处理需要电脑里可以正常使用视频处理组件。如果环境缺失，任务中心会提示“当前电脑未找到视频处理组件”。

开始全链路处理

这是正式执行入口。开始后会按当前设置写入输出目录。运行过程中不要移动、重命名或断开正在处理的商品目录。

处理结果在哪里

实际出现哪些目录取决于你开启了哪些项目，常见结果包括：

商品文件夹
├─ 原始图片备份
├─ 800-800主图
├─ 1440-1440主图
├─ 750-1000主图
├─ 1440-1920主图
├─ 1440x2160主图
├─ AI生成主图（开启 AI 主图生成或复用时）
│  └─ 001组_方案名
│     ├─ 生成母图
│     ├─ 1比1成品
│     ├─ 3比4成品
│     └─ 9比16成品
├─ AI生成详情（原主图）（选用原主图详情数字套时）
│  └─ 001套
├─ 详情页-AI生成详情
│  └─ 原始生成图
├─ 详情页（选择批量套用详情模板时）
├─ 白底图_AI生成.jpg
├─ 原视频备份
├─ 1-1视频
├─ 3-4视频
└─ 9-16视频

批量处理时，主图、详情页、原视频备份等输出目录通常位于第3层，目录中的具体结果文件位于第4层；直接保存在商品文件夹内的白底图文件位于第3层。单个处理时，相同结果位置相应少一层。

批量任务遇到失败会怎样

系统按商品文件夹逐款处理。一款图片损坏、缺少参考图或在线生成失败时，会记录该款失败原因，并继续处理后面的商品。

任务结束后请重点看：

成功商品数和失败商品数。
失败的是哪一个商品文件夹。
失败发生在主图、详情图、白底图还是视频。
已经生成的结果是否符合预期。

常见问题

为什么没有生成某个输出目录

先检查对应功能是否开启、是否选择了输出尺寸，以及已有结果处理是否选择了保留。

已有目录存在且选择保留时，系统会跳过该目录，不会重复生成。

为什么原图没有缩小

常见原因有三个：

原始图片预处理未开启。
图片最长边没有超过设置阈值。
“缩小后最长边”没有小于触发像素，设置不符合缩小条件。

为什么详情图没有生成

请检查：

是否选择了 AI生成详情图。
是否选择了至少一个详情宽度。
是否勾选了在线生成额度确认。
商品文件夹里是否有可用参考图。
在线生成服务是否可用。

具体原因以任务中心记录为准。

为什么裁剪后主体偏了

图片主图默认采用中心裁剪。如果人物主体本来不在画面中心，可以开启“智能裁剪人物居中”，先用少量商品检查触发比例和头顶留白；没有识别到人物时仍会按中心裁剪处理。视频始终采用中心裁剪，主体偏移时建议换用构图更合适的原视频。

会删除原始文件吗

不会删除原始图片或视频，但“直接覆盖原图片”会修改符合阈值的根目录原图。

选择“先备份原图再缩小”时，图片备份成功后才会缩小；选择“直接覆盖原图片”时不会创建图片备份。视频处理会先建立原视频备份。替换已有结果只替换同名输出，不会清空整个目录。

视频为什么处理很慢

视频时长、分辨率、输出比例数量和电脑性能都会影响处理时间。可以先减少输出比例，或先单款测试。

云店Agent可以怎么帮你

你可以这样问：

帮我解释本地素材全链路处理的扫描结果。

这批素材适合先做主图裁剪，还是先做 AI视觉优选？

为什么这一款详情图失败，但主图和视频已经生成了？

帮我查看最近一次素材处理任务的失败原因。

云店Agent会优先参考文档中心、当前任务记录和已开放的本地工具。涉及正式写入、替换输出或使用在线额度时，它会在执行前说明影响。