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