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