批量上传与替换总说明
总览淘宝、抖店商品视频批量上传与关联、主图详情图批量替换和淘宝视频ID采集流程，帮助商家区分本地素材整理、平台上传及商品关联步骤。
这个大模块是做什么的
批量上传与替换用于处理商品上架后的批量素材动作。
它解决的不是“从本地素材新建商品”，而是这些常见后续工作：
- 批量上传商品视频。
- 把已上传的视频批量对应到商品。
- 批量替换抖店主图和详情图。
- 批量替换淘宝主图。
- 批量替换淘宝详情图。
- 从淘宝视频空间采集视频 ID，并生成平台要求的主图视频导入文件。
平台上传、关联、替换和采集任务会进入淘宝、抖店、妙手、超级店长等页面，使用前要确认店铺登录环境。视频改名和三个图片 ZIP 生成工具只处理本地文件，不需要店铺登录环境。
适合什么场景
这个模块适合以下情况：
- 商品已经在平台上存在，但后面需要补视频、换主图、换详情图。
- 你有一批视频，需要先按商品 ID 改名，再上传到平台视频空间或素材库。
- 抖店视频已经上传，需要按台账批量关联到商品。
- 淘宝主图或详情图需要用压缩包批量替换。
- 淘宝视频空间里已有视频，需要采集视频 ID 再生成平台导入文件。
- 你希望把这些重复平台操作交给系统跑，自己只负责准备素材、表格和确认关键步骤。
如果你的商品还没有发布，通常应先使用“淘宝本地素材上架”或“抖店本地素材上架”；如果只是整理图片、裁剪或生成详情图，应先使用“电商素材处理”里的对应工具。
页面字段旁的问号用于查看当前设置说明。鼠标移入说明文字后，小窗会保持显示，里面的链接可以点击；详细说明会在独立文档窗口打开，当前设置页和已填写内容不会被替换。
入口怎么理解
左侧菜单里这一组有 6 个入口。
六个入口各自使用独立的设置模板。模板保存当前入口的上传、替换、匹配和执行规则，不保存本批素材目录、表格、压缩包目录或结果文件。即使模板名称相同，不同入口之间也不会互相覆盖。
保存模板：覆盖当前入口选中的模板。另存为模板：为当前入口新建一份模板。- 已保存模板统一到
设置中心 -> 设置模板管理 -> 批量上传与替换查看和删除。
设置中心为了便于筛选，把六个入口合并显示为“批量上传与替换”；这只是管理页分组，实际模板仍按六个入口分别保存。
1. 商品视频批量上传
用于把本地视频整理后上传到淘宝视频空间或抖店素材库。
页面里会区分：
- 淘宝视频上传。
- 抖店视频上传。
- 视频改名整理。
视频改名整理和平台上传是两个独立动作。常见流程是：
选择原视频目录
-> 按商品 ID 改名整理
-> 上传到平台视频空间或素材库
-> 写入上传台账
-> 后续进入视频 ID 采集或抖店商品视频批量关联如果你的视频文件名还不是商品 ID，建议先用页面里的“视频改名整理”，生成清单并复制到待上传目录，再启动上传任务。
如果视频已经按商品 ID 正确命名，可以跳过改名整理，直接选择待上传视频目录。
2. 抖店商品视频批量关联
用于读取抖店视频上传生成的台账，把已经上传的视频批量关联到商品。
这个页面只做关联，不再重复提供视频上传或视频改名。完整顺序是：
- 先在“商品视频批量上传”的“抖店视频上传”Tab 上传视频并写入台账。
- 再进入本页读取台账，把视频名称作为商品 ID 搜索并关联到抖店商品。
这个入口适合视频量比较多、需要批量关联商品的场景。
3. 抖店主图详情图批量替换
用于把商品表和图片素材整理成压缩包，再通过抖店相关批量替换入口替换主图和详情图。
常见流程是：
选择商品表
-> 选择图片素材目录
-> 生成压缩包
-> 启动批量替换任务
-> 查看失败清单建议先生成压缩包并检查结构，再启动平台替换任务。
4. 淘宝主图批量替换
用于批量替换淘宝商品主图。
当前淘宝主图批量替换走“妙手”入口。
常见流程是：
选择主图素材目录
-> 校验商品 ID 匹配
-> 生成主图压缩包
-> 进入妙手批量替换
-> 输出失败清单主图会直接影响商品展示，请先用少量商品测试。
5. 淘宝详情图批量替换
用于批量替换淘宝商品详情图。
当前淘宝详情图批量替换走“超级店长”入口。
常见流程是：
确认本批详情素材完整
-> 生成详情压缩包
-> 选择详情修改方式
-> 进入超级店长批量替换
-> 查看替换结果详情图替换前要特别注意页面里的“详情修改方式”。如果选择替换原描述，原详情内容会被覆盖；如果只是追加图片，当前只会添加到原描述上方。页面没有“尺码表已上传/补齐”勾选项，也不会替用户判断详情内容是否完整。
6. 淘宝视频 ID 采集
用于从淘宝视频空间采集视频名称、视频 ID 和发布状态。
采集结果可以继续生成平台要求的主图视频 CSV 导入文件，解决“视频名称和商品 ID 一一对应”的批量关联问题。
常见流程是：
进入淘宝视频空间
-> 选择视频空间分类
-> 采集视频 ID 和发布状态
-> 检查名称冲突
-> 生成主图视频平台导入文件如果视频名称和商品 ID 对不上，生成平台导入文件前需要先处理命名问题。CSV 是平台实际导入格式，不作为用户手工填写的参考模板；如需核对字段，应使用文档提供的 XLSX 或 TXT 示例。
使用前要准备什么
1. 店铺登录环境
涉及淘宝、抖店、妙手、超级店长等平台页面时，必须先确认对应店铺已经登录。
平台弹出普通验证码或滑块时，软件会先尝试本机自动处理，未解除再调用后台已配置且支持该题型的打码平台。只有两层均未解除时才保留现场并提示接管；扫码、短信、账号二次身份确认和重新登录仍需用户本人完成。不要在登录状态不稳定时启动长任务。
2. 商品 ID 或商品编码表
大部分批量任务都依赖商品 ID、商家编码或视频名称匹配。
建议准备一张清晰的表格，至少包含：
- 商品 ID。
- 商家编码。
- 视频名称或素材文件名；抖店批量对应时，视频名称应与商品 ID 一致。
- 上传状态或处理状态。
不同入口需要的列可能不同，以页面字段为准。
3. 素材目录
视频上传需要准备视频目录。
图片替换需要准备主图目录、详情图目录或压缩包输出目录。
目录命名尽量清楚，例如：
本批视频待上传
淘宝主图ZIP
淘宝详情ZIP
抖店主图详情ZIP4. 上传台账
抖店视频上传和批量对应会用到上传台账。
抖店上传台账的作用是记录：
- 哪个视频已经上传。
- 上传是否成功。
- 是否已经完成关联。
淘宝视频上传使用的是成功记录文件，不是抖店使用的 Excel 台账。成功视频写入记录文件后，下次运行会自动跳过。
不要随便删除或覆盖台账，否则后续对应和排查会变麻烦。
5. 小批量测试素材
首次使用每个入口时，建议先准备 1 到 3 个商品或少量视频测试。
确认流程跑通、入口选择正确、失败原因能看懂后，再逐步放大数量。
推荐使用顺序
视频类任务
如果你要批量处理视频，推荐顺序是：
商品视频批量上传（按需先用“视频改名整理”Tab）
-> 淘宝视频 ID 采集 或 抖店商品视频批量关联
-> 检查任务结果淘宝侧通常是先上传到视频空间，再采集视频 ID。抖店侧通常是先上传并写台账，再到独立关联页按台账批量关联商品。
图片替换类任务
如果你要批量替换主图或详情图，推荐顺序是：
整理图片素材
-> 检查商品 ID 匹配
-> 生成压缩包
-> 检查压缩包结构
-> 启动平台替换任务
-> 查看失败清单不要跳过压缩包检查。压缩包结构不对时，平台页面可能上传失败，或者替换结果不符合预期。
页面上的常见设置是什么意思
任务名称 / 批次号
用于任务中心、上传记录和结果文件中识别本批任务。
建议写成：
A店-夏款视频上传-本批或者：
女装大衣主图替换-第1批店铺环境
选择本次要操作的平台店铺。
店铺来自账号中心已经绑定并验证的店铺列表，登录环境由系统自动分配。你只需要确认店铺选对，不需要填写 Profile 目录或其它技术路径。
原视频目录 / 待上传视频目录
原视频目录是你最初收集到的视频。
待上传视频目录通常是改名整理后的目录。上传任务会读取这里的视频。
对账改名表格
用于把原始视频文件名转换成商品 ID 或商家编码。
如果你的视频已经按商品 ID 命名，可以减少改名步骤；如果视频名称混乱，建议先生成改名清单。
上传台账或成功记录
抖店使用 Excel 台账记录上传与关联状态；淘宝使用成功记录文件跳过已经上传的视频。
上传失败、已上传、已关联等状态都可以通过账本继续追踪。
每批上传数 / 本批上传上限
用于控制一次任务处理多少视频或商品。
建议新手先设小一点，确认平台页面表现稳定后再加大数量。
登录等待、步骤间隔、上传超时
这些都是为了让系统等待页面加载、上传完成或平台响应。
如果网络慢、电脑卡、平台页面反应慢，可以适当调大。不要一开始就把速度调得太快。
失败时保留浏览器现场
开启后，如果任务失败，系统会用相同店铺登录环境重新打开相关页面，方便你或云店Agent查看和继续排查。平台页面中尚未提交的临时内容不一定能够保留。
建议平台类任务默认开启。
运行结果在哪里看
你可以在以下位置查看结果：
- 当前功能页的轻量任务摘要和最近结果提示。
- 全局任务中心中的实时过程、失败原因、历史任务和详细日志。
- 上传台账。
- 失败清单。
- 生成的压缩包目录或模板文件。
如果任务失败，不要只看“失败”两个字。重点看：
- 是素材缺失。
- 是商品 ID 不匹配。
- 是店铺登录失效。
- 是平台页面弹出了验证。
- 是上传超时。
- 是压缩包结构不符合要求。
- 是视频名称冲突或状态不可关联。
常见问题
1. 商品视频批量上传和抖店商品视频批量关联有什么区别？
商品视频批量上传负责把视频传到平台。
抖店商品视频批量关联负责把已经上传的视频关联到对应商品。
上传和对应是两步，不要混在一起理解。
2. 淘宝主图和淘宝详情图为什么入口不一样？
淘宝主图批量替换当前走妙手入口。
淘宝详情图批量替换当前走超级店长入口。
两个入口不要写反。主图和详情图影响的位置不同，页面操作和结果也不同。
3. 为什么要先生成压缩包？
批量替换主图或详情图时，平台通常要求按固定结构上传图片包。
先生成压缩包，可以提前检查商品 ID、图片数量和文件结构，减少平台页面里反复失败。
4. 为什么视频要先改名？
后续采集视频 ID 或关联商品时，常常要靠“视频名称 = 商品 ID”来对应。
如果视频名称混乱，系统很难判断哪个视频对应哪个商品，所以建议先改名整理。
5. 任务失败后可以直接重跑吗？
不建议马上连续重跑。
先看任务中心和失败清单，确认失败原因。如果是登录失效、验证码、素材缺失或命名错误，先处理原因，再重跑。
6. 云店Agent能帮我什么？
你可以让云店Agent帮你：
- 解释上传失败原因。
- 看懂失败清单。
- 判断哪个入口适合当前任务。
- 根据任务中心记录判断卡在哪一步。
- 帮你整理下一次重跑前需要补的素材或表格。
示例：
帮我看看这次淘宝详情图替换为什么失败。我现在要给抖店商品批量对应视频，应该先准备哪些文件？安全提醒
批量上传与替换会进入真实平台页面，请务必注意：
- 第一次使用某个入口，先用少量商品测试。
- 普通验证码和滑块先由统一验证码守护自动处理；只有自动处理失败、扫码、短信、账号二次身份确认或重新登录时，才按页面提示接管。
- 不要在不确定店铺环境时启动任务。
- 替换主图和详情图前，先确认压缩包内容。
- 详情图选择“替换原描述”前，要确认原详情是否可以被覆盖。
- 遇到失败先查任务中心，不要连续重复点击开始。
- 跑长任务时，建议保持电脑和网络稳定。