本地素材全链路处理
介绍商品上架前的本地素材全链路处理，包括原图预处理、主图裁剪、详情图或白底图生成、详情模板排版和商品视频处理，适合一款或整批商品。
这个功能能解决什么问题
本地素材全链路处理 用于在商品上架前，一次完成一款或一批商品的图片、详情图和视频预处理。
它可以按你在页面上开启的项目依次完成：
- 可选缩小商品文件夹根目录里的超大原图，并决定先备份还是直接覆盖。
- 批量生成 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层。
按统一层级表达：单个处理时，所选商品文件夹是第1层，直接放入的图片或视频文件位于第2层；再放进“视频”等素材子文件夹时，具体文件位于第3层。批量处理时，所选批量根目录是第1层、商品文件夹是第2层，直接文件位于第3层，素材子文件夹中的文件位于第4层。
2. 图片放在哪里
原始图片预处理和普通主图裁剪，读取的是商品文件夹根目录里的图片。
因此，单个处理时这类图片文件应位于第2层；批量处理时应位于第3层。放在更深层素材子文件夹里的图片不会被“普通主图裁剪”当作根目录图片，但本地智能筛选等明确支持递归的功能仍可按自身规则读取。
因此，单个处理时这类图片文件应位于第2层；批量处理时应位于第3层。放在更深层素材子文件夹里的图片不会被“普通主图裁剪”当作根目录图片，但本地智能筛选等明确支持递归的功能仍可按自身规则读取。
支持的常见图片格式包括：
JPG、JPEG、PNG、WEBP、BMP、JFIF建议不要把尺码图、吊牌图、条形码图、白底图和营销卖点图当作普通主图混放。系统会尽量排除这些图片，但清楚的文件名和文件夹结构仍然更稳。
3. 视频放在哪里
视频可以放在商品文件夹根目录，也可以放在名称带“视频”的子文件夹里。
批量处理时，直接视频文件位于第3层；放在商品内部“视频”文件夹时位于第4层。单个处理时相应少一层。
批量处理时，直接视频文件位于第3层；放在商品内部“视频”文件夹时位于第4层。单个处理时相应少一层。
支持的常见格式包括：
MP4、MOV、AVI、MKV、M4V4. 商品文件夹怎么命名
本页面可以处理普通商品文件夹名称，但为了让后续上架、价格读取、库存读取、商品匹配等功能更稳定，建议尽量使用云店AI的六段式商品编码。
详细规则见：33_商品编码规范_全编码与半编码_用户说明。
页面设置怎么选
处理范围
单个处理：只处理当前选择的一个商品文件夹，适合第一次试跑或修复单款。批量处理：逐个处理根目录下的商品子文件夹，适合整批素材准备。
第一次使用时，建议先用单个处理确认输出效果，再切换到批量处理。
已有结果处理
保留已有结果：已有输出目录或同名文件时跳过，适合日常安全处理。替换同名结果：允许重新生成并替换同名文件，但不会先清空整个目录。
默认建议保留已有结果。只有确认旧结果可以替换时，再开启替换。
设置模板
设置模板保存的是当前页面的处理规则，例如输出尺寸、详情处理方式、白底图设置和视频比例。
模板不会保存本次选择的商品目录。这样同一套规则可以用于不同批次的商品。
保存模板：覆盖当前选中的模板。另存为模板：保存为一个新的模板，方便按店铺、类目或处理目的分别使用。
已经保存的模板可以到 设置中心 -> 设置模板管理 统一查看和删除；商品根目录和本次结果不会出现在模板管理中。
原始图片预处理
原始图片预处理
这是可选功能，默认关闭。关闭时不会缩小商品文件夹根目录里的原图，也不影响主图裁剪、详情图、白底图或视频处理。
开启后需要选择一种原图处理方式：
先备份原图再缩小（推荐）：首次把原图复制到原始图片备份；已有同名备份不会被覆盖。备份成功后才缩小根目录原图。直接覆盖原图片，不创建备份：不会建立原始图片备份，符合阈值的根目录图片会被缩小后的图片直接替换。本软件无法恢复被覆盖的大图。
选择直接覆盖时，正式开始任务前还会显示处理范围、像素阈值、目标尺寸和当前目录，请确认无误后再继续。
超过多少像素才缩小
系统读取图片的最长边。只有最长边超过这个数值时，才会缩小图片。
例如：
超过多少像素才缩小：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视觉优选素材：先从候选图片中挑选更适合作为主图的素材，再生成主图。当前更适合服装、鞋包类商品。
候选图不超过 5 张时，AI视觉优选会跳过在线判断，直接使用现有图片；达到 6 张及以上时才会调用在线视觉优选能力。
详情页处理
详情处理方式三选一：
AI生成详情图
系统会从商品资料里选择参考图，调用在线生成服务制作详情图，再按你选择的 750、790 或 1440 宽度保存结果。
需要注意：
- 开始前必须勾选“我确认开始后会使用在线生成额度”。
- 详情图只在线生成一次，多种宽度属于本地后处理，不会为了每个宽度重复生成。
- 原始生成图会保存在
详情页\原始生成图。 - 正式宽度版本会保存在
详情页。 - 在线服务额度不足或服务暂时不可用时，该款详情图可能失败；任务中心会保留具体失败原因。
- 一款详情图失败不会让其它商品停止排队，已经完成的主图、白底图或视频结果仍会保留。
如果你需要上传多张参考图、编辑策划、单张重做、查看草稿和预览结果，请使用独立的 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。
视频处理需要电脑里可以正常使用视频处理组件。如果环境缺失，任务中心会提示“当前电脑未找到视频处理组件”。
扫描、计划和正式处理有什么区别
扫描素材
扫描只读取目录，不生成输出。它会统计商品文件夹数、根目录图片数、视频数和已有输出目录。
生成处理计划
处理计划不会正式修改素材。它会根据扫描结果和当前页面设置，列出预计执行的动作、目标尺寸、详情参考图数量、输出宽度和视频比例。
处理计划用于提前核对，不是正式运行结果承诺。开始任务后还会重新检查文件和素材条件，最终结果以任务中心记录为准。
开始全链路处理
这是正式执行入口。开始后会按当前设置写入输出目录。运行过程中不要移动、重命名或断开正在处理的商品目录。
推荐的第一次使用流程
- 选择
单个处理。 - 选择一款素材比较完整的商品文件夹。
- 原始图片预处理默认可以关闭；确实需要缩小大图时，优先选择“先备份原图再缩小”。
- 已有结果处理选择
保留已有结果。 - 主图先选择一个方图和一个 3:4 竖图尺寸。
- 详情处理先按实际需要选择；选择在线生成时勾选额度确认。
- 白底图和视频首次可以先关闭，减少变量。
- 点击
扫描素材。 - 点击
生成处理计划，确认目录和动作正确。 - 点击
开始全链路处理。 - 在任务中心查看进度、失败原因和完成结果。
- 单款确认无误后，再切换为批量处理。
处理结果在哪里
实际出现哪些目录取决于你开启了哪些项目，常见结果包括：
商品文件夹
├─ 原始图片备份
├─ 800-800主图
├─ 1440-1440主图
├─ 750-1000主图
├─ 1440-1920主图
├─ 1440x2160主图
├─ 详情页
│ └─ 原始生成图
├─ 白底图_AI生成.jpg
├─ 原视频备份
├─ 1-1视频
├─ 3-4视频
└─ 9-16视频批量处理时，主图、详情页、原视频备份等输出目录通常位于第3层，目录中的具体结果文件位于第4层；直接保存在商品文件夹内的白底图文件位于第3层。单个处理时，相同结果位置相应少一层。
批量任务遇到失败会怎样
系统按商品文件夹逐款处理。一款图片损坏、缺少参考图或在线生成失败时，会记录该款失败原因，并继续处理后面的商品。
任务结束后请重点看：
- 成功商品数和失败商品数。
- 失败的是哪一个商品文件夹。
- 失败发生在主图、详情图、白底图还是视频。
- 已经生成的结果是否符合预期。
常见问题
为什么没有生成某个输出目录
先检查对应功能是否开启、是否选择了输出尺寸，以及已有结果处理是否选择了保留。
已有目录存在且选择保留时，系统会跳过该目录，不会重复生成。
为什么原图没有缩小
常见原因有三个：
- 原始图片预处理未开启。
- 图片最长边没有超过设置阈值。
- “缩小后最长边”没有小于触发像素，设置不符合缩小条件。
为什么详情图没有生成
请检查：
- 是否选择了
AI生成详情图。 - 是否选择了至少一个详情宽度。
- 是否勾选了在线生成额度确认。
- 商品文件夹里是否有可用参考图。
- 在线生成服务是否可用。
具体原因以任务中心记录为准。
为什么裁剪后主体偏了
当前图片和视频都采用中心裁剪。如果主体本来不在画面中心，输出也可能偏。建议先换一张构图更合适的原图，或使用 AI视觉优选素材后再裁剪。
会删除原始文件吗
不会删除原始图片或视频，但“直接覆盖原图片”会修改符合阈值的根目录原图。
选择“先备份原图再缩小”时，图片备份成功后才会缩小；选择“直接覆盖原图片”时不会创建图片备份。视频处理会先建立原视频备份。替换已有结果只替换同名输出，不会清空整个目录。
视频为什么处理很慢
视频时长、分辨率、输出比例数量和电脑性能都会影响处理时间。可以先减少输出比例，或先单款测试。
云店Agent可以怎么帮你
你可以这样问：
帮我解释本地素材全链路处理的扫描结果。这批素材适合先做主图裁剪，还是先做 AI视觉优选？为什么这一款详情图失败，但主图和视频已经生成了？帮我查看最近一次素材处理任务的失败原因。云店Agent会优先参考文档中心、当前任务记录和已开放的本地工具。涉及正式写入、替换输出或使用在线额度时，它会在执行前说明影响。