淘宝主图批量替换用户说明
介绍如何按淘宝商品ID或商品编码整理主图ZIP，并通过妙手入口批量替换已发布商品主图，适合大量淘宝商品统一更新图片素材。
这个功能是做什么的
淘宝主图批量替换，用于把已经发布在淘宝店铺里的商品主图批量换成新的图片。
它通常分成两步：
- 先把主图素材按商品 ID 或商品编码整理成 ZIP 压缩包。
- 再通过妙手入口进行批量替换。
本地主图 ZIP 打包和妙手替换是两个独立功能区。已经有符合当前规则的主图 ZIP 时，可以直接使用替换区；需要重新整理本地图片时，再使用上方打包区。
主图会直接影响商品在搜索、推荐、店铺列表里的展示效果，所以这类任务要比普通文件整理更谨慎。建议先用少量商品确认替换效果，再扩大数量。
适合什么场景
这个功能适合以下情况：
- 淘宝商品已经发布，但主图需要统一换新。
- 一批商品主图做了新模板、新拍摄或新裁剪，需要统一替换。
- 商品数量多，人工逐个进入后台换图太慢。
- 主图素材已经按商品准备好，希望先生成压缩包再批量处理。
- 需要输出失败清单，方便后面补处理。
- 你希望先检查商品 ID 和主图素材是否能匹配，再正式替换。
如果商品还没有发布，通常应先使用淘宝本地素材上架；如果只是裁剪主图，应先使用电商素材处理。
为什么淘宝主图走妙手入口
当前淘宝主图批量替换走妙手入口。
你可以简单理解为：这个功能负责把素材和商品关系先整理好，再进入妙手提供的批量替换页面完成主图替换。
请注意：淘宝主图批量替换和淘宝详情图批量替换不是同一个入口。当前口径是：
淘宝主图批量替换：妙手
淘宝详情图批量替换：超级店长不要把两个入口写反。主图和详情图影响的位置不同，页面操作和结果也不同。
替换范围要先确认
当前任务会在平台里采用“仅使用本地图片”的替换策略。压缩包里没有包含的旧主图，可能会在替换后被移除。
开始前请确认每款需要保留的主图都已经进入压缩包。即使你只想换其中一张，也要先用 1 到 3 个商品检查平台实际效果，再决定是否放大批量。
使用前要准备什么
1. 主图素材目录
主图素材目录用于存放本批要替换的商品主图。
建议每个商品一个文件夹，文件夹名称尽量使用商品 ID 或能和表格对应的编码。例如：
主图素材目录
├─ 1234567890
│ ├─ 1.jpg
│ ├─ 2.jpg
│ └─ 3.jpg
├─ 1234567891
│ ├─ 1.jpg
│ ├─ 2.jpg
│ └─ 3.jpg不要把不同店铺、不同类目、不同批次的主图混在同一个目录里。
2. 商品 ID / 编码表
商品 ID / 编码表用于把商品和主图目录对应起来。如果主图子文件夹名称本身就是商品 ID，也可以开启“允许文件夹名作为商品 ID”后直接识别。
因此它是条件必填：开启“允许文件夹名作为商品 ID”且文件夹名都是完整商品 ID 时可以不填；关闭该选项时必须选择商品 ID / 编码表，否则页面不会提交扫描或打包任务。
表格里通常需要有：
- 商品 ID。
- 商家编码或其它辅助编码。
- 本批需要处理的商品清单。
使用前要确认页面里的“商品 ID 列号”和“编码列号”填对。
列号可以这样理解：
A 列 = 1
B 列 = 2
C 列 = 3列号填错时，压缩包可能会把主图对应到错误商品。
3. ZIP 输出目录
ZIP 输出目录用于保存生成好的主图压缩包。
建议单独创建一个目录，不要和原主图目录混在一起。目录名可以包含店铺、日期、类目和批次。
4. 淘宝店铺环境
店铺来自账号中心已经绑定并验证的店铺列表，登录环境由系统自动分配。开始替换任务前，确认选择的是正确淘宝店铺。
如果页面要求登录、扫码、安全验证或重新确认账号状态，需要先人工处理。不要在登录状态不稳定时启动批量替换。
5. 先人工抽查图片
主图影响非常明显，开始前建议抽查几款：
- 图片是不是对应正确商品。
- 图片比例是否符合你的要求。
- 是否有错图、空图、重复图。
- 是否混入了其它商品图片。
- 主图排序是否符合你的展示需求。
推荐操作流程
第一步：填写主图 ZIP 生成设置
先填写：
- 批次号。
- 入口软件。
- 主图素材目录。
- 商品 ID / 编码表。
- ZIP 输出目录。
- 每包商品数。
- 每款主图数。
- ZIP 体积上限。
- 商品 ID 列号。
- 编码列号。
这一步只是在本地整理图片包，还没有替换平台商品图片。
第二步：选择上传哪些主图
页面里会有这些选项：
- 上传 1:1 主图。
- 上传 3:4 主图。
- 允许文件夹名作为商品 ID。
- 覆盖已存在 ZIP。
如果你的素材目录里只有 1:1 主图，就不要误选 3:4 主图。 如果你同时准备了两种比例，要确认每个商品文件夹里两类图片都完整。
“覆盖已存在 ZIP”要谨慎使用。不确定时，建议换一个新的输出目录。
第三步：扫描并生成主图 ZIP 清单
先点击“扫描并生成主图 ZIP 清单”。
重点检查：
- 能匹配到多少商品。
- 有多少商品缺主图。
- 每款会取多少张主图。
- 会生成多少个 ZIP。
- ZIP 体积是否可能过大。
- 是否存在商品 ID 和文件夹名对不上的情况。
如果缺图商品很多，先不要生成压缩包。应该回到主图素材目录和商品表格里排查。
第四步：生成淘宝主图 ZIP 压缩包
清单确认无误后，再生成 ZIP 压缩包。
生成后建议打开输出目录检查：
- ZIP 文件数量是否符合预期。
- 文件名是否清楚。
- 压缩包体积是否合理。
- 每个包里是否都是本批商品。
- 有没有空包或异常包。
第五步：启动淘宝主图批量替换任务
确认 ZIP 没问题后，进入“淘宝主图批量替换任务”区域。
需要选择：
- 淘宝店铺环境。
- 入口软件：妙手。
- 已生成 ZIP 目录。
- 本批任务名称。
然后启动替换任务。
任务运行时，不要同时手动操作同一个妙手或淘宝页面，避免页面状态被打断。
第六步：查看失败清单和任务中心
任务完成后，先看结果摘要和失败清单。
如果失败，要重点看：
- 商品是否属于当前店铺。
- 主图 ZIP 里是否包含该商品图片。
- 图片比例或大小是否不符合要求。
- 妙手页面是否要求重新登录或验证。
- 上传是否超时。
- 是否有商品 ID 匹配失败。
看不懂时，可以让云店Agent帮你解释任务记录和失败清单。
页面字段怎么理解
批次号
用于标记本次任务。
建议包含店铺、日期和类目，例如：
淘宝A店_女装外套_第1批主图替换入口软件
淘宝主图批量替换当前走妙手入口。
这个字段主要用于提醒你本次会通过哪个平台入口处理，不要和淘宝详情图的超级店长入口混淆。
主图素材目录
存放本批新主图的目录。
建议按商品 ID 或编码分文件夹，方便和商品表格匹配。
商品 ID / 编码表
本批商品的对照表。
它用于把商品 ID、编码和主图目录对应起来。关闭“允许文件夹名作为商品 ID”时必填；开启且文件夹名就是完整商品 ID 时可以不填。
ZIP 输出目录
保存生成好的主图 ZIP。
建议单独建目录，方便检查和后续上传。
每包商品数
用于控制每个 ZIP 里包含多少个商品。
如果每款主图数量多，或者图片比较大，建议每包商品数不要太大。
每款主图数
用于控制每个商品文件夹最多取多少张主图。
如果你只想上传前 5 张，就把这个数量设置为 5。设置前要确认你的主图排序是否正确。
ZIP 体积上限
用于避免单个压缩包过大。
如果压缩包过大，可能导致上传慢、上传失败或页面长时间无响应。
商品 ID 列号 / 编码列号
用于从表格里读取商品 ID 和编码。
如果主图文件夹按商品 ID 命名，就重点确认商品 ID 列号。 如果主图文件夹按商家编码命名，就重点确认编码列号。
上传 1:1 主图 / 上传 3:4 主图
决定本次要上传哪种比例的主图。
如果只准备了其中一种，不要同时勾选两种。
允许文件夹名作为商品 ID
如果你的商品文件夹名称就是商品 ID，可以开启。
开启前要确认文件夹名没有多余空格、错误字符或不完整编号。
覆盖已存在 ZIP
如果输出目录里已经存在同名 ZIP，开启后会用新结果覆盖。
不确定时建议关闭，或者换一个新的输出目录。
常见问题
为什么有些商品显示缺主图
常见原因有：
- 商品 ID 列号填错。
- 编码列号填错。
- 主图文件夹名称和表格对不上。
- 商品文件夹里没有图片。
- 勾选了 3:4 主图，但目录里没有对应比例图片。
建议先从缺图商品里抽一两个，手动核对表格和目录。
为什么主图替换到了错误商品
通常是商品 ID、编码或文件夹名称匹配错了。
使用前要确认商品表格和图片目录属于同一批，不要混入其它店铺或旧批次素材。
为什么 ZIP 生成后上传失败
常见原因有：
- ZIP 体积过大。
- ZIP 结构不符合要求。
- 图片大小或比例不符合要求。
- 妙手页面登录失效。
- 平台要求验证。
- 网络不稳定或上传超时。
建议先看失败清单和任务中心，再检查系统用同店铺登录环境重新打开的相关页面。页面里尚未提交的临时内容不一定能够保留。
可以一次替换很多商品吗
可以分批处理，但第一次不建议直接跑很大批量。
主图变化会直接影响商品点击和转化。建议先少量确认效果，再扩大数量。
每款主图数应该填多少
这取决于你准备替换几张主图。
如果每个商品只准备 5 张主图，就不要填得比实际数量大。 如果目录里有多余图片，要先清理，避免不该上传的图片被放进压缩包。
淘宝主图和淘宝详情图是不是同一个入口
不是。
当前口径是：
淘宝主图批量替换：妙手
淘宝详情图批量替换：超级店长如果你要换详情图，请使用淘宝详情图批量替换，不要在主图页面处理。
使用建议
- 主图替换前先人工抽查几款。
- 商品表格、主图目录和店铺要属于同一批。
- 先扫描清单，再生成 ZIP。
- 生成 ZIP 后先打开输出目录检查。
- 第一次只替换少量商品。
- 不确定时不要覆盖旧 ZIP。
- 不要把淘宝主图和淘宝详情图入口混用。
- 任务失败时先看失败清单和任务中心。
- 平台要求验证时，先人工处理。
云店Agent能帮你什么
云店Agent可以帮你理解淘宝主图替换流程，也可以根据失败清单和任务记录帮你排查。
你可以这样问：
- “淘宝主图批量替换前要准备什么？”
- “为什么主图 ZIP 清单里有缺图商品？”
- “每款主图数应该填多少？”
- “淘宝主图为什么走妙手入口？”
- “这个失败清单是什么意思？”
- “我是不是把主图和详情图入口弄混了？”
涉及确认店铺、确认图片内容、确认是否覆盖主图等关键动作时，建议你自己看清楚后再继续。