淘宝详情图批量替换用户说明
介绍如何按商品ID或编码整理详情图ZIP，并通过超级店长入口批量更新淘宝商品详情页图片，区分本地素材打包和平台详情替换任务。
这个功能是做什么的
淘宝详情图批量替换，用于把已经发布在淘宝店铺里的商品详情页图片批量更新。
它通常分成两步：
- 先把详情素材按商品 ID 或商品编码整理成 ZIP 压缩包。
- 再通过超级店长入口选择详情修改方式，批量更新商品详情页。
本地详情 ZIP 打包和超级店长替换是两个独立功能区。已经有符合当前规则的详情 ZIP 时，可以直接使用替换区；需要重新整理本地图片时，再使用上方打包区。
详情页影响买家对商品的理解，也可能包含尺码表、卖点图、搭配说明、售后说明等内容。替换详情图前，一定要先确认本次是“添加到原描述上方”还是“替换原描述”。
适合什么场景
这个功能适合以下情况：
- 淘宝商品已经发布，但详情图需要统一更新。
- 旧详情页里图片质量不统一，需要换成新的详情图。
- 新增了尺码表、材质说明、卖点图，需要批量补充到详情页。
- 商品数量多，人工逐个进入商品编辑页替换详情太慢。
- 你希望先生成详情 ZIP，再通过超级店长进行批量处理。
- 你需要失败清单，方便回头补处理。
如果你只是要替换主图，请使用 21_淘宝主图批量替换_用户说明。当前口径是：淘宝主图走妙手入口，淘宝详情图走超级店长入口。
为什么淘宝详情图走超级店长入口
淘宝详情图批量替换当前走超级店长入口。
你可以简单理解为：本页先帮你把详情图素材整理成压缩包，再通过超级店长的批量功能，把详情图追加或替换到商品详情页。
主图和详情图入口不要混用：
淘宝主图批量替换：妙手
淘宝详情图批量替换：超级店长详情修改方式一定要看清楚
详情图替换最关键的字段是“详情修改方式”。
当前支持两种方式：
添加图片至原描述上方
新详情图会添加在原详情内容上方。
适合用来补充新的卖点图、活动图、尺码表或重要提醒，但原详情内容仍会保留。
替换原描述
新详情图会替换原来的详情内容。
这个选项风险最高。选择前一定要确认：
- 原详情是否可以被覆盖。
- 新详情图是否完整。
- 尺码表、材质说明、售后说明是否已经包含在新详情里。
- 是否已经保留旧详情的必要内容。
如果不确定，不要直接选择“替换原描述”。可以先用少量商品确认效果。
使用前要准备什么
1. 详情素材目录
详情素材目录用于存放本批要上传的详情图。
建议每个商品一个文件夹，文件夹名称尽量使用商品 ID 或能和表格对应的编码。例如：
详情素材目录
├─ 1234567890
│ ├─ 01.jpg
│ ├─ 02.jpg
│ └─ 03.jpg
├─ 1234567891
│ ├─ 01.jpg
│ ├─ 02.jpg
│ └─ 03.jpg详情图顺序很重要，建议用 01、02、03 这种方式排序，避免上传后顺序混乱。
2. 商品 ID / 编码表（条件必填）
商品 ID / 编码表用于把商品和详情素材目录对应起来。如果每个商品文件夹的名称本身就是准确的商品 ID，可以开启“允许文件夹名作为商品 ID”，表格可以不填。
关闭“允许文件夹名作为商品 ID”时，这张表必须填写，否则页面不会提交扫描或打包任务。
表格里通常需要有：
- 商品 ID。
- 商家编码或其它辅助编码。
- 本批要处理的商品清单。
如果使用表格但表格和详情素材目录对不上，会出现缺图、错图或无法替换。
3. ZIP 输出目录
ZIP 输出目录用于保存生成好的详情 ZIP。
建议单独创建，不要和原详情素材目录混在一起。
4. 替换前检查详情内容
如果选择“替换原描述”，一定要人工确认新详情已经包含本批需要保留的全部内容，例如尺码、材质、售后或其它必要说明。
页面没有“尺码表已上传/补齐”勾选项，也不会自动识别或校验尺码表。ZIP 校验只检查压缩包和图片结构是否可用，不能代替人工检查详情内容。
5. 淘宝店铺环境
店铺来自账号中心已经绑定并验证的店铺列表，登录环境由系统自动分配。开始替换任务前，确认选择的是正确淘宝店铺。
如果平台要求登录、扫码、安全验证或重新确认账号状态，需要先人工处理。不要在登录状态不稳定时启动批量替换。
推荐操作流程
第一步：填写详情 ZIP 生成设置
先填写：
- 入口软件：超级店长。
- 详情素材目录。
- 商品 ID / 编码表。
- ZIP 输出目录。
- 每包商品数。
这一步只是在本地整理详情素材，还没有改变平台商品详情。
第二步：确认包含详情图
页面里会有这些选项：
- 包含详情图。
- 允许文件夹名作为商品 ID。
- 覆盖已存在 ZIP。
如果你的详情素材目录是按商品 ID 命名，可以开启“允许文件夹名作为商品 ID”。
“覆盖已存在 ZIP”要谨慎使用。如果不确定旧压缩包是否还要保留，建议换一个新的输出目录。
第三步：扫描并生成详情 ZIP 清单
先点击“扫描并生成详情 ZIP 清单”。
重点检查：
- 能匹配到多少商品。
- 有多少商品缺详情图。
- 会生成多少个 ZIP。
- 商品 ID 和文件夹名是否能对上。
- 本批需要保留的详情内容是否都已经放进对应商品文件夹。
如果缺图商品很多，先不要生成压缩包。应该先检查详情素材目录和商品表格。
第四步：生成淘宝详情 ZIP 压缩包
清单确认无误后，再生成 ZIP 压缩包。
生成后建议打开输出目录检查：
- ZIP 文件数量是否符合预期。
- 文件名是否清楚。
- 每个包是否都属于本批商品。
- 有没有空包或异常包。
- 详情图顺序是否符合预期。
第五步：启动淘宝详情图批量替换任务
确认 ZIP 没问题后，进入“淘宝详情图批量替换任务”区域。
需要选择：
- 淘宝店铺环境。
- 入口软件：超级店长。
- 已生成 ZIP 目录。
- 详情修改方式。
- 页面会在启动前自动校验 ZIP 结构，这不是用户开关。
页面不会替你判断尺码表或其它业务内容是否齐全；选择“替换原描述”前请自行检查，确认无误后再启动任务。
成功完成的 ZIP 会被改名为以 .zip.done 结尾，下一次运行不会再把它当成待处理压缩包。这个标记只是防止重复提交，不会删除原始详情图片。
第六步：查看替换结果、失败清单和任务中心
任务完成后，先看结果摘要和失败清单。
如果失败，要重点看：
- 商品是否属于当前店铺。
- 详情 ZIP 里是否包含该商品详情图。
- 详情修改方式是否选错。
- 超级店长页面是否要求重新登录或验证。
- 上传是否超时。
看不懂时，可以让云店Agent帮你解释任务记录和失败清单。
页面字段怎么理解
入口软件
淘宝详情图批量替换当前走超级店长入口。
这个字段用于提醒你本次会通过哪个平台入口处理，不要和淘宝主图的妙手入口混淆。
详情素材目录
存放本批详情图的目录。
建议每个商品一个文件夹，文件夹里按顺序放详情图。
商品 ID / 编码表
本批商品的对照表。
它用于把商品 ID、编码和详情素材目录对应起来。关闭“允许文件夹名作为商品 ID”时必填；开启且文件夹名就是完整商品 ID 时可以不填。
ZIP 输出目录
保存生成好的详情 ZIP。
建议单独建目录，方便检查和后续上传。详情打包会在该目录下生成“详情图”子目录，启动替换任务时系统会自动读取这个子目录。
每包商品数
用于控制每个 ZIP 里包含多少个商品。
详情图通常比主图数量更多，单个商品图片也可能更多，所以每包商品数不建议过大。
包含详情图
用于确认本次压缩包里包含详情素材。
如果这个选项没有选好，生成的压缩包可能没有你想要替换的详情内容。
允许文件夹名作为商品 ID
如果你的商品文件夹名称就是商品 ID，可以开启。
开启前要确认文件夹名准确，没有多余空格、错误字符或不完整编号。
覆盖已存在 ZIP
如果输出目录里已经有同名 ZIP，开启后会用新结果覆盖。
不确定时建议关闭，或者换一个新的输出目录。
已生成 ZIP 目录
替换任务读取压缩包的位置。
必须选择刚才生成并检查过的详情 ZIP 目录，不要选错批次。
详情修改方式
决定新详情图如何放到商品详情页里。当前只支持添加到原描述上方或替换原描述。
这是本功能最重要的设置之一。选择“替换原描述”前，一定要确认新详情完整。
页面不会校验尺码表
当前页面没有“尺码表已上传 / 补齐”设置，也不会因为缺少尺码表而拦截任务。选择“替换原描述”时，必须由你自己检查新详情是否包含需要保留的尺码、材质、售后等内容。
替换前再次校验 ZIP
建议保留。
这是系统固定执行的安全检查，不需要用户另开开关。替换前会再次检查压缩包是否有效、是否包含图片、结构是否符合超级店长要求；校验失败时不会打开平台页面。
常见问题
为什么详情图替换后原来的内容不见了
通常是因为选择了“替换原描述”。
如果你只是想补充新图片，应选择添加到原描述上方。选择替换前，一定要确认原详情可以被覆盖。
为什么有些商品显示缺详情图
常见原因有：
- 商品 ID 和文件夹名对不上。
- 商品 ID / 编码表列号不对。
- 详情素材放错目录。
- 商品文件夹里没有图片。
- 文件夹名使用了不完整编码。
建议从缺图商品里抽一两个，手动核对表格和目录。
为什么详情图顺序不对
常见原因是图片文件名排序不清楚。
建议详情图使用：
01.jpg
02.jpg
03.jpg不要使用容易乱序的名称，例如“详情1”“新图”“最终版2”混在一起。
选择替换原描述前要检查什么
要检查新详情是否包含本批需要保留的全部图片和说明。尺码表只是可能存在的一类内容，系统不会识别或替你确认；如果你的商品需要尺码信息，就要把它作为人工检查项。
为什么超级店长页面失败
常见原因有：
- 登录失效。
- 平台要求验证。
- ZIP 结构不符合要求。
- 商品不属于当前店铺。
- 详情修改方式选择不符合本批目的。
- 上传等待时间不够。
建议先看失败清单和任务中心，再检查系统用同店铺登录环境重新打开的相关页面。页面里尚未提交的临时内容不一定能够保留。
可以一次替换很多商品吗
可以分批处理，但第一次不建议直接跑很大批量。
详情页内容多、影响面大。建议先少量确认详情顺序、内容完整性、追加或替换效果，再扩大数量。
使用建议
- 淘宝详情图批量替换走超级店长入口，不要和主图入口混淆。
- 详情修改方式一定要看清楚。
- 不确定时优先选择追加，不要直接替换原描述。
- 选择替换原描述前，确认新详情图完整。
- 选择替换原描述前，人工确认本批需要保留的详情内容已经齐全。
- 先扫描清单，再生成 ZIP。
- 生成 ZIP 后先打开输出目录检查。
- 第一次只处理少量商品。
- 不确定时不要覆盖旧 ZIP。
- 任务失败时先看失败清单和任务中心。
云店Agent能帮你什么
云店Agent可以帮你理解淘宝详情图替换流程，也可以根据失败清单和任务记录帮你排查。
你可以这样问：
- “淘宝详情图批量替换前要准备什么？”
- “添加到原描述上方和替换原描述有什么区别？”
- “为什么详情 ZIP 清单里有缺图商品？”
- “选择替换原描述前需要人工检查哪些内容？”
- “超级店长详情替换失败，下一步怎么看？”
- “我是不是应该用淘宝主图批量替换，而不是详情图替换？”
涉及确认店铺、确认详情内容、确认是否覆盖原描述等关键动作时，建议你自己看清楚后再继续。