抖店主图详情图批量替换用户说明
说明如何按商品表格和图片素材生成抖店批量换图ZIP，并为已发布商品批量替换主图和详情图，区分本地打包与平台替换两个独立步骤。
这个功能是做什么的
抖店主图详情图批量替换，用于把已经发布在抖店里的商品，批量替换主图和详情图。
它通常分成两步：
- 先根据商品表格和图片素材目录，生成符合批量上传要求的 ZIP 压缩包。
- 再选择店铺环境，启动主图详情图批量替换任务。
本地 ZIP 打包和平台替换是两个独立功能区。已经有符合当前规则的 ZIP 时，可以直接使用替换区；需要重新整理本地图片时，再使用上方打包区。
这类任务会影响已经上架的商品展示，所以不建议直接大批量开始。第一次使用时，最好先选少量商品验证图片结构、商品 ID 匹配和替换效果。
适合什么场景
这个功能适合以下情况：
- 抖店商品已经发布，但后面需要统一换主图。
- 抖店商品已经发布，但详情图需要统一升级。
- 商品数量多，人工逐个进入商品编辑页替换图片太慢。
- 图片素材已经按商品准备好，希望先打包再批量上传。
- 你需要输出失败清单，方便回头检查哪些商品没替换成功。
- 你希望先检查商品表和图片目录的匹配关系，再正式替换。
如果商品还没有发布，通常应先使用抖店本地素材上架相关功能；如果只是本地裁剪或整理图片，应先使用电商素材处理。
为什么要先生成 ZIP 压缩包
批量替换主图或详情图时，平台通常要求按固定结构上传图片包。
先生成 ZIP 压缩包有三个好处：
- 可以提前检查商品 ID 和图片文件夹是否能匹配。
- 可以把一批商品拆成多个包，避免单个文件太大。
- 如果平台上传失败，可以更容易定位是图片缺失、压缩包太大，还是商品匹配问题。
不要跳过压缩包检查。压缩包结构不对时，后面进入平台页面也可能失败。
替换范围要先确认
当前任务会在平台里采用“仅使用本地图片”的替换策略。压缩包里没有包含的旧商品图片，可能会在替换后被移除。
因此开始前必须确认：
- 压缩包已经包含这次需要保留的主图和详情图。
- 没有因为漏勾图片类型而少打包。
- 已经用少量商品检查过替换后的实际展示。
如果你只想改其中一部分图片，又希望保留平台上的其它旧图，不要直接放大批量；应先用 1 到 3 个商品确认平台实际效果。
使用前要准备什么
1. 商品表格
商品表格用于告诉系统本批要处理哪些商品。如果图片子文件夹名称本身就是商品 ID，也可以开启“允许文件夹名作为商品 ID”后直接按文件夹名识别。
因此它是条件必填：开启“允许文件夹名作为商品 ID”且文件夹名都是完整商品 ID 时可以不填；关闭该选项时必须选择商品表格，否则页面不会提交扫描或打包任务。
表格里至少要有能识别商品的列，例如商品 ID、商家编码或其它能和图片目录对应的字段。
使用前要确认页面里的：
- 商品 ID 列号。
- 编码列号。
列号可以这样理解：
A 列 = 1
B 列 = 2
C 列 = 3列号填错，会导致商品和图片匹配错误。
2. 图片素材根目录
图片素材根目录是存放主图、详情图等图片素材的文件夹。
建议按商品 ID 或商家编码整理图片文件夹。比如：
图片素材根目录
├─ 1234567890
│ ├─ 1-1主图
│ ├─ 3-4主图
│ └─ 详情图
├─ 1234567891
│ ├─ 1-1主图
│ ├─ 3-4主图
│ └─ 详情图具体文件夹名称可以按你的素材习惯来，但要保证页面能按商品 ID 或文件夹名找到对应图片。
3. ZIP 输出目录
ZIP 输出目录用于保存生成好的压缩包。
建议不要和原图片素材放在同一个目录里，避免看不清哪些是原图、哪些是打包结果。
推荐命名方式：
抖店A店_女装外套_第1批主图详情替换ZIP4. 店铺登录环境
店铺来自账号中心已经绑定并验证的店铺列表，登录环境由系统自动分配。替换任务开始前要确认：
- 店铺选择正确。
- 登录状态正常。
- 没有扫码、短信验证、滑块或登录失效。
- 当前店铺和商品表里的商品属于同一个店铺。
不要把 A 店的商品表和图片包拿到 B 店去替换。
5. 先确认图片内容
主图和详情图会直接影响商品展示。
开始前建议人工抽查几款：
- 主图是否是正确商品。
- 详情图是否完整。
- 图片比例是否符合要求。
- 有没有混入其它商品图片。
- 是否有水印、错图、空图或重复图。
推荐操作流程
第一步：填写 ZIP 生成设置
先填写：
- 批次号。
- 每个 ZIP 商品数。
- 商品表格。
- 图片素材根目录。
- ZIP 输出目录。
- ZIP 打包结构。
- 商品 ID 列号。
- 编码列号。
- ZIP 体积上限。
这一步的目标是先把本地图片整理成平台可以批量接收的压缩包。
第二步：选择要包含的图片类型
页面里会有几类勾选项：
- 包含 3:4 主图。
- 包含 1:1 主图。
- 包含详情图。
- 允许文件夹名作为商品 ID。
- 覆盖已存在 ZIP。
如果你只想替换主图，就不要勾选详情图。 如果你只想替换详情图，也要确认主图相关选项没有误选。
“覆盖已存在 ZIP”要谨慎使用。如果输出目录里已经有旧压缩包，覆盖后旧包会被新的结果替代。
第三步：扫描并生成 ZIP 清单
建议先点击“扫描并生成 ZIP 清单”。
重点看：
- 匹配到多少商品。
- 有多少缺图商品。
- 会生成多少个 ZIP。
- 哪些商品没有找到图片。
- ZIP 体积是否可能超过上限。
如果缺图商品很多，先不要生成压缩包。应该回到图片素材目录检查命名和图片完整性。
第四步：生成抖店图片 ZIP 压缩包
清单确认没问题后，再生成 ZIP 压缩包。
生成后建议打开输出目录检查：
- ZIP 数量是否符合预期。
- 文件名是否清楚。
- 体积是否过大。
- 是否每个包都对应本批商品。
- 是否有空包或异常包。
第五步：启动抖店主图详情替换任务
确认 ZIP 没问题后，再进入“抖店主图详情替换任务”区域。
需要选择：
- 抖店店铺环境。
- 已生成 ZIP 目录。
- 本批任务名称。
然后启动替换任务。
任务运行时不要同时手动操作同一个店铺页面，避免页面状态被打断。
第六步：查看失败清单和任务中心
任务完成后，先看结果摘要和失败清单。
如果失败，要重点看：
- 商品是否在当前店铺。
- ZIP 里是否包含该商品图片。
- 图片比例或大小是否不符合要求。
- 平台是否要求验证。
- 店铺登录是否失效。
- 是否上传超时。
看不懂时，可以让云店Agent帮你解释任务记录和失败清单。
页面字段怎么理解
批次号
用于标记本次任务，方便在任务中心和输出文件里识别。
建议写清楚店铺、日期和类目，例如：
抖店A店_女装外套_第1批主图详情替换每个 ZIP 商品数
用于控制每个压缩包里放多少个商品。
如果每个商品图片很多，不建议这个数字太大。拆成多个包更容易排查，也能降低单个包过大的风险。
商品表格
本批要替换的商品清单。
使用商品表格时，它必须和图片素材目录能对上，否则会出现缺图、错图或无法匹配。按文件夹名直接识别时，则要保证每个商品子文件夹名都是完整商品 ID。
图片素材根目录
存放主图和详情图的总目录。
建议目录结构清楚，不要把不同店铺、不同批次、不同类目的图片都混在一起。
ZIP 输出目录
保存生成好的压缩包。
建议单独建一个输出目录，方便后面检查和上传。
ZIP 打包结构
抖店主图详情替换固定使用妙手混合结构。压缩包里的图片名称会包含商品 ID、图片类型和顺序，例如主图、3:4 主图或详情图。
这个结构由当前功能自动确定，不需要手动切换，也不要拿淘宝详情图的压缩包结构混用。
商品 ID 列号 / 编码列号
用于从商品表格里读取商品 ID 和编码。
如果商品图片目录是按商品 ID 命名，就要确认商品 ID 列号填对。 如果图片目录是按商家编码或其它编码命名，也要确认编码列号填对。
ZIP 体积上限
用于避免生成过大的压缩包。
如果图片质量高、商品数量多，压缩包可能比较大。建议按平台限制和网络情况设置合理上限。
包含 3:4 主图 / 包含 1:1 主图 / 包含详情图
这些选项决定本次压缩包里包含哪些图片。
只替换需要替换的内容，不要多选不需要的部分。
允许文件夹名作为商品 ID
如果你的图片文件夹名称就是商品 ID，可以开启这个选项，让页面按文件夹名识别商品。
开启前要确认文件夹名准确，不要有多余空格、特殊符号或混入其它编号。
覆盖已存在 ZIP
如果输出目录里已经有同名压缩包，开启后会用新结果覆盖旧结果。
不确定时建议先关闭，或换一个新的输出目录。
常见问题
为什么有商品显示缺图
常见原因有：
- 图片文件夹名称和商品 ID 对不上。
- 商品表格列号填错。
- 图片放错目录。
- 只准备了主图，没有准备详情图。
- 勾选了某种图片类型，但对应图片不存在。
建议先从缺图商品里抽一两个，手动检查表格和图片目录是否一致。
为什么生成的 ZIP 太大
常见原因有：
- 每个 ZIP 商品数设置过大。
- 图片分辨率过高。
- 每个商品详情图数量很多。
- 同一商品目录里混入了多余图片。
可以减少每个 ZIP 商品数，或者先清理图片目录。
为什么替换任务失败
常见原因有：
- 店铺登录失效。
- 平台要求验证。
- ZIP 结构不符合要求。
- 图片大小或比例不符合平台要求。
- 商品不属于当前店铺。
- 上传等待时间不够。
建议先到任务中心查看失败原因，再检查系统用同店铺登录环境重新打开的相关页面。页面里尚未提交的临时内容不一定能够保留。
可以一次替换很多商品吗
可以分批处理，但不建议第一次就跑很大批量。
主图和详情图直接影响商品展示。建议先用少量商品确认图片位置、比例和替换效果，再逐步放大数量。
主图和详情图可以一起替换吗
可以，但要确认你确实准备好了两类素材。
如果只需要替换主图，就不要勾选详情图；如果只需要替换详情图，就不要误选主图相关内容。
输出目录里已有旧 ZIP 怎么办
如果你确定要重新生成，可以开启覆盖已存在 ZIP。
如果不确定，建议新建一个输出目录，避免旧结果被覆盖后不好回查。
使用建议
- 商品表格、图片目录和店铺要保持同一批次。
- 开始前先抽查图片内容，避免错图批量替换。
- 先生成 ZIP 清单，再生成压缩包。
- 生成 ZIP 后先打开输出目录检查。
- 第一次只替换少量商品。
- 不确定时不要开启覆盖已存在 ZIP。
- 平台要求验证时，先人工处理。
- 任务失败时先看失败清单和任务中心。
- 主图和详情图影响商品展示，操作前要比视频上传更谨慎。
云店Agent能帮你什么
云店Agent可以帮你理解替换流程，也可以根据失败清单和任务记录给出排查建议。
你可以这样问：
- “抖店主图详情图替换前要准备哪些文件？”
- “为什么我的 ZIP 清单里有缺图商品？”
- “每个 ZIP 商品数应该怎么设置？”
- “这个失败清单是什么意思？”
- “我只想替换详情图，应该勾选哪些选项？”
- “为什么生成的压缩包太大？”
涉及确认店铺、确认图片内容、确认是否覆盖原图片等关键动作时，建议你自己看清楚后再继续。