抖店本地素材上架用户说明
介绍如何把本地商品文件夹中的类目属性、主图、详情图、视频、标题、颜色尺码、价格库存和SKU资料批量填写到抖店商品发布页。
抖店本地素材上架
这个功能能做什么
抖店本地素材上架用于把电脑里已经整理好的商品资料，自动填写到抖店商品发布页。
系统可以按商品文件夹依次处理：
- 商品类目和类目属性。
- 1:1 主图与 3:4 主图。
- 商品详情图。
- 商品视频。
- 颜色、尺码、价格、库存和商家编码。
- SKU 颜色图与尺码图。
- 商品标题和导购短标题。
- 运费模板、售后政策和发货时间。
- 保存草稿，或按选择发布为下架、上架商品。
它适合已经把商品图片、视频和规格资料放在本地文件夹中的商家。你不需要逐个商品反复上传素材、填写规格和设置履约信息。
本功能是完整上架流程，不是只做素材检查。新店铺、新类目或新设置模板第一次使用时，建议先选择只包含 1 款商品的目录，并优先保存草稿或发布为下架商品，检查无误后再扩大批量。
使用前必须准备什么
绑定抖店店铺
先在账号中心绑定要操作的抖店店铺。每个店铺使用独立的浏览器登录环境，避免多店铺登录状态互相覆盖。
第一次使用某个店铺时，点击“打开登录窗口”。验证码和滑块会先进入统一自动处理；扫码、短信和账号二次身份确认按页面提示由你本人完成。系统不会在验证层仍存在时继续业务动作。
准备商品根目录
商品根目录下面通常是多个商品子文件夹：
本批商品根目录
├─ 商品A文件夹
├─ 商品B文件夹
└─ 商品C文件夹商品根目录下面必须继续放商品子文件夹。只测试 1 款商品时，也使用相同结构，只在根目录下面放 1 个商品子文件夹，不需要切换额外模式。
所选商品根目录是第1层，商品文件夹是第2层。SKU 表、类目属性、尺码图或视频直接放在商品文件夹内时，具体文件位于第3层；主图、详情页等继续放进素材分类文件夹时，具体文件通常位于第4层。
尽量使用规范商品编码
推荐商品文件夹使用以半角短横线 - 分隔的六段式编码，例如：
24361-GX-MC-66001-P130-K258最重要的是：
- 各段之间使用半角短横线
-。 - 第 3 段尽量填写厂家或档口编码。
- 第 4 段尽量填写厂家货号或商品编码。
P130 表示成本或拿货价 130 元，K258 表示控价或参考售价 258 元。K 不是库存。没有 P 字段时，价格按页面设置的兜底价格处理；库存始终优先读取 SKU 表，表内缺少库存时使用页面默认库存。完整规则请看商品编码规范：全编码与半编码。
准备类目属性和标题
每个商品可以在自己的文件夹根目录放一份 类目属性和标题.txt。旧文件名 类目属性.txt 仍可读取，但新建商品建议统一使用新名称。
标准格式：
原标题：原始商品标题或者商品简称
类目：女装/女士精品 >> 毛呢外套
材质成分：75%羊毛，25%其它
品牌：无品牌原标题 有助于 AI 写出更好的标题，手填关键词会作为最高权重保留。文档中没有类目时，需要在页面设置类目；没有材质成分时，页面会以“其它 100%”作为兜底。品牌可以整行删除不填。
品牌：无品牌 表示商品没有品牌。系统会匹配当前平台提供的无品牌选项；页面没有品牌字段或没有可确认选项时会跳过品牌，不让该非必填项阻断商品。
这份文档只读取 原标题、类目、材质成分（兼容材质、成分、面料等常见写法）和 品牌。适用季节、版型等普通属性不从文档读取，由页面设置、类目模板和属性识别处理。
标题文档按以下顺序查找：原标题.txt / 标题.txt / 商品标题.txt → 其它独立标题文档 → 类目属性和标题.txt → 类目属性标题.txt → 旧版 类目属性.txt。系统只查商品文件夹根目录。同一优先级出现多份标题文档时，优先使用唯一一份明确写有“原标题”的文档；仍无法唯一确认时，当前商品会记录冲突并跳过，后续商品继续处理。
没有文档类目或无法识别时，系统使用页面填写的备用类目和已经采集好的类目属性模板。备用类目可以先留空；点击新建任务后发现确实有商品需要兜底时，页面才会要求填写。新类目第一次使用时，需要先点击“采集类目与属性”。
商品文件夹里可以放什么
主图
系统支持模糊识别常见主图文件夹名称。
1:1 主图常见名称：
800主图
800
800-800
1:1主图
1440x1440主图
1440-1440主图
方图3:4 主图常见名称：
750主图
750
750-1000
3:4主图
1440x1920主图
1440-1920主图
竖图你可以直接使用已经整理好的主图，也可以开启“上架前自动裁剪主图”。
详情图
常见详情文件夹名称包括：
详情页
详情
宝贝详情
商品详情
商品详情页已有详情图时直接使用。没有详情图时，可以选择暂停、跳过，或开启 AI 生成详情图。
商品视频
页面可以选择：
- 有视频就上传。
- 必须有视频，缺少时暂停。
- 本轮不上传视频。
开启视频智能裁剪后，只有文件过大或比例不符合要求的视频才会重新处理；已经合规的视频会直接使用，不会无故重复转码。
SKU 表
SKU 表用于提供颜色、尺码、价格、库存和商家编码等规格资料。默认文件名为 SKU信息.xlsx，页面可以修改。旧版 .xls 文件仍可兼容读取，但新建表格和下载模板统一使用 .xlsx。
系统优先读取 SKU 表。表格缺少某些内容时，再使用页面中的默认颜色、默认尺码、兜底价格和默认库存。
SKU 颜色图
SKU 颜色图建议放在“SKU图片”“颜色图”等文件夹中。图片文件名尽量与颜色名称一致。
你可以设置缺图时暂停、缺图时跳过或本轮不处理。
尺码图
系统会优先读取并解析商品文件夹里的尺码图。没有尺码图时，可以使用页面保存的尺码参数模板补齐。
页面设置说明
本次任务基本设置
这里决定本次处理哪一批商品、使用哪套规则和哪个店铺。
选择设置模板
“保存模板”会覆盖当前选中的模板；“另存为模板”会创建一个新模板。模板保存本页规则，不保存商品根目录。
你可以为不同店铺、类目或批次分别建立模板。例如：
A店-毛呢外套
A店-连衣裙
B店-毛呢外套批次号
用于标记本次任务，通常可填写预计上架日期或本批名称，例如“2026.7.18上新”。
提交方式
- 保存草稿：填写完成后保存到抖店草稿。
- 下架：发布商品，但保持下架状态，不直接出售。
- 上架：发布商品并直接进入售卖状态。页面默认选择“下架”，只有明确选择“上架”时才会直接出售。
页面不会针对这三种状态再弹一次安全说明；这里选中的状态就是本次任务的提交方式。
商品类目与属性
系统的读取顺序是：
商品自己的类目属性文件
-> 当前类目共享模板“无文档时使用的备用类目”是条件必填：如果本批每个商品都有可用的类目属性文件，可以留空；点击新建任务后，如果检查出有商品缺少文件、文件为空或无法识别，页面才会要求填写。填写前请先确认这些商品属于同一个类目。
备用类目可以填写完整路径，也可以只填写最终叶子类目。例如：
服装 > 女装 > 大衣或：
大衣如果当前类目还没有模板，点击“采集类目与属性”。采集完成后，系统会保存类目树、必填属性和可选项，以后同类目可以直接复用。
类目输入框为空、正在检查模板或当前类目已有可用模板时，“采集类目与属性”按钮会按当前状态禁用，避免空采集和重复采集。需要更新已有模板时，应由管理员开放重新采集，新结果会保存为新版本，不会直接覆盖旧模板。
主图智能处理
主图来源策略
- 使用已整理图片：直接使用商品文件夹里已经整理好的主图。
- 本地自动选图（不使用AI额度）：只在电脑本地按分辨率、比例、文件大小、目录位置和画面差异筛选候选主图，不调用在线 AI，也不消耗 AI 额度。
- AI视觉优选素材：适合服装、鞋包类；候选图达到 6 张时才会调用。
自动裁剪尺寸
可以选择 800x800、1440x1440、750x1000、1440x1920。1:1 与 3:4 建议至少各保留一种。
主图上传策略
可以同时上传 1:1 和 3:4，也可以只上传其中一种。抖店类目要求可能不同，不确定时建议同时准备两套。
销售属性和规格
SKU 表、颜色、尺码、价格和库存
系统优先读取商品文件夹中的 SKU 表。表格存在时使用表内颜色、尺码、商家编码、价格和库存；缺表或缺字段时，才使用页面填写的兜底规则。
“默认颜色”和“默认尺码”不是覆盖 SKU 表，而是缺失时补齐。不同类目使用不同规格时，建议分别保存设置模板。
价格来源
- 读取商品文件夹编码中的 P 字段，缺失或解析失败时使用兜底价格。
- 全部使用固定价格。
默认库存
库存优先读取 SKU 表中的“库存/现货库存”字段；表内没有库存时使用这里的默认库存。商品文件夹编码中的 K 是控价，不参与库存计算。
SKU 颜色名称
- AI 自动识别：正式上架任务在 SKU 表缺少颜色时识别商品图片，并生成对应颜色图。提交前的类目文档检查不会调用，也不会产生这部分消耗。
- 使用手动兜底：SKU 表缺少颜色时直接使用页面填写的默认颜色。
两种方式只能选择一种：开启 AI 自动识别后，页面不再使用手动兜底颜色；填写手动兜底颜色时，页面会关闭 AI 自动识别。
详情页和尺码表
已有详情图时不会重复生成。开启 AI 生成详情图后，只在商品缺少详情图时生成。
如果在线生成服务额度不足或暂时不可用，任务会报告详情生成失败。你可以稍后重试，或先关闭 AI 生成详情图并按“缺失时暂停/跳过”处理。
尺码图默认采用“有图解析 / 缺图兜底”：有尺码图时先上传给抖店识别，识别成功后直接使用抖店回填结果；没有尺码图、识别失败或等待超时时，才执行所选兜底。
兜底方式只能二选一：使用“服装类尺码参数模板”，或填写与抖店后台完全一致的模板名称并精确选择“抖店后台模板”。模板未精确找到时先继续提交；如果当前类目把尺码设为必填，最终发布会明确报错并跳过当前商品。不同服装类目不要盲目共用同一套本地参数模板，新建或修改后先用 1 个商品检查抖店发布页中的最终参数。
标题、视频、履约与操作节奏
标题
开启 AI 生成标题后，可以选择通用类目版、女装趋势词版或女装常规版。系统优先把文档中的“原标题”作为最高权重参考；没有文档标题时，只把当前类目的末级名称作为原标题参考，再结合商品图片生成商品标题与导购短标题。
关闭后，系统先直接使用文档标题；没有文档标题时，保留原有规则，使用“类目末级名称 + 商品文件夹名称”。已经发起 AI 生成但服务返回失败时，当前商品会明确报错，不会拿普通兜底标题冒充 AI 结果。
商品视频
本模块使用商品文件夹中排序最前的 1 个视频作为主图视频。选择“必须有视频”时，缺少视频会暂停当前商品；选择“不上传视频”时，本轮不会处理视频。
开启视频智能裁剪后，只处理文件过大或比例不符合要求的视频；合规视频直接上传，不重复转码。
每个商品只上传排序最前的 1 个视频作为主图视频，因此页面只选择一个目标输出比例。这个比例是“原视频需要处理时的输出规格”，不是同时生成三条视频。
运费模板和售后政策
填写的名称必须能在当前抖店店铺中找到。系统按文字匹配已有选项，不会替你新建模板或政策。
发货时间
当前按现货模式填写，可选择当日发、次日发或 48 小时。请根据店铺真实履约能力选择。
操作节奏
操作节奏只控制相邻操作之间的间隔：稳妥为 0.5 秒，标准为 0.35 秒，快速为 0.2 秒；选择自定义后，可以自行填写动作间隔。
节奏不会改变任务允许执行的动作，也不会减少、跳过或截断步骤。无论本次计划有 16 步还是更多步骤，系统都必须执行完整计划；少执行一步或最终保存草稿 / 发布商品没有成功，都不能记为任务完成。
“页面最长等待”是独立的加载等待上限，不属于节奏设置，也不代表每一步都会固定等待这么久。页面提前准备好时会提前继续。
“任务结束或失败时保留浏览器现场”适合排查问题。保留后不要随意改变页面，方便查看失败位置。
验证码处理
任务进入抖店发布页、执行关键填写动作以及最终保存或发布前后，都会自动检查验证码。检测到简单滑块时先由本机自动处理；未解除时继续使用后台已启用的打码服务。验证仍未解除时，任务会保留现场并安全等待，不会带着验证码继续填写或误提交。
推荐使用流程
- 选择商品根目录。
- 选择设置模板和抖店店铺。
- 打开登录窗口并确认店铺登录状态。
- 设置主图、详情、视频、SKU、尺码、标题和履约规则。
- 点击“新建抖店上架任务”。
- 查看提交前类目文档和属性模板检查结果；需要备用类目时，先确认这些商品属于同一类目并填写页面类目。
- 提示缺少属性模板时，先完成对应类目的模板采集，再重新新建任务。
- 确认检查结果后，到任务中心查看实时进度、失败原因和最终结果。
- 新店铺、新类目或新模板先用 1 个商品试跑，再扩大批量。
提交前类目检查和正式任务有什么区别
点击“新建抖店上架任务”后，页面先只读检查每个商品文件夹中的类目文档和本批最终类目对应的共享属性模板。它保留商品文件夹、有效文档、缺失文档和空白/无法识别文档四项统计；发现缺模板时会列出类目和影响商品数，并暂不提供“确认新建任务”。这一步不检查图片、SKU、视频或尺码表，不生成旧扫描报告，也不会现场采集模板。
确认弹窗结果后，正式任务才会打开真实抖店页面，填写并提交商品。正式任务仍会按当前设置处理缺失素材，例如主图裁剪、AI 颜色识别或 AI 详情生成。
类目文档和属性模板检查通过不等于真实发布一定成功。平台登录状态、页面临时变化、验证码和类目规则仍可能影响正式任务。
任务结果在哪里看
任务进度、当前处理商品、失败原因和历史任务统一在任务中心查看。功能页不再展示旧版运行记录或历史结果列表。
保存或发布后，系统直接读取当前抖店页面返回的成功提示。页面明确显示提交成功时，本次提交步骤记为成功；页面提示失败、校验未通过或没有出现成功提示时，任务会保留原因并停止当前商品。
本模块不会在提交后再搜索商品 ID，也不会返回商品列表做额外回查。这样可以避免已经提交成功后又因列表加载、搜索条件或状态延迟产生误判。
你也可以问云店Agent：
帮我看看抖店本地素材上架为什么失败。帮我检查这批商品缺哪些主图、详情图或 SKU 资料。常见问题
新建任务按钮为什么不可用
优先检查：
- 是否选择了商品根目录。
- 如果类目文档检查提示需要兜底，是否填写了“无文档时使用下方选择的类目”。
- 当前类目是否已经有可用模板。
- 是否绑定并选择了抖店店铺。
- 运费模板和售后政策是否填写。
类目一直提示需要采集
先确认类目名称准确，再点击“采集类目与属性”。采集时会打开店铺后台；验证码和滑块会按本机优先、后台打码平台其次自动处理，仍未解除时才保留现场。扫码、短信和账号二次身份确认由你本人完成。
如果类目已经有模板但不能重新采集，说明管理员没有开放重新采集权限。当前模板仍可正常使用。
找不到主图或详情图
检查文件夹名称是否接近本文列出的常见名称，并确认图片确实位于当前商品子文件夹中。
如果开启自动裁剪，检查商品根目录中是否有可作为源图的清晰图片。如果开启 AI视觉优选，候选图片少于 6 张时系统会跳过 AI，使用本地规则继续选择。
价格或库存不是预期值
价格问题先检查商品文件夹名中的 P 字段和页面兜底价格；库存问题检查 SKU 表中的库存字段和页面默认库存。K 字段是控价，不会被当作库存。
SKU 颜色不正确
先检查 SKU 表是否已有颜色。SKU 表中的内容优先级最高。
AI 识别颜色只在正式任务、SKU 表缺少颜色且开关启用时运行。图片不清楚或服务暂时不可用时会使用兜底颜色。
卡在登录或验证码
任务会先尝试本机和后台已配置的打码平台。若仍停在验证页，请在保留的同店铺现场处理；扫码、短信和账号二次身份确认由你本人完成。完成后让原任务继续，不要重复启动多个任务占用同一个店铺登录环境。
发布后任务仍显示失败
先查看当前发布页是否出现“商品提交成功”等明确提示，或是否出现必填项、类目、规格、价格、图片、登录验证等错误信息。
请保留浏览器现场，在任务中心查看当前页面返回的失败原因；不要立即重复发布同一商品，以免产生重复商品。
为什么同一个店铺不能同时跑多个任务
同一个浏览器登录环境同一时间只能由一个任务使用，避免页面和登录状态互相干扰。不同店铺使用不同登录环境时可以分别运行。
第一次为什么要先用 1 款商品
本功能会连续处理类目属性、主图、详情、视频、SKU、尺码、标题和提交状态。实际商品仍会受到店铺登录、平台验证、类目字段、素材完整度和当前页面变化影响。
第一次使用新店铺、新类目、新设置模板或新的素材结构时，建议先用 1 个商品测试，检查标题、图片、规格、价格、库存和最终状态，再扩大批量。