商品文件夹结构与标准目录
说明云店AI批量自动化所需的商品根目录、商品子文件夹、图片视频位置、文件所在层和标准目录规则，减少商品素材错配、漏读与任务失败。
为什么这是使用软件前的核心规范
云店AI的大多数批量自动化，需要先解决两件事：
- 用稳定的商品编码确认“哪些图片、表格、视频和平台商品属于同一款”。
- 用明确的文件位置确认“程序应该到哪一层读取具体图片、视频、表格或文档”。
因此，商品编码规范和本篇文件夹结构规范，属于开始批量使用软件前最重要的两份文档。
先统一三个称呼
起算根目录
从本次任务选择的来源目录或保存目录开始计算。这个目录本身是第1层；D:\、E:\ 等盘符不单独计算。
文件夹层级
一个文件夹算一级。进入一个子文件夹，文件夹级数增加一级。图片、视频、表格、文档等具体文件不计算为文件夹级数。
文件所在层
具体文件位于完整路径的最后一层。文件前面有几级文件夹，文件就在下一层。
统一表达方式为：
目标文件位于第 N 层；文件前面共有 N-1 级文件夹，属于 N-1 级文件夹结构。
例如：
E:\7.30测试提取 第1层：起算根目录
└─ HZ-RF-1D075-C37-P175-K268 第2层：商品文件夹
└─ 视频 第3层：素材分类文件夹
└─ 1D075-C37-视频(01).mp4 第4层：具体视频文件这条路径应表述为：
视频文件位于第4层；文件前面共有3级文件夹，属于3级文件夹结构。
只说明“商品文件夹位于第几级”不能代替文件位置说明。商品文件夹位置相同，具体文件仍可能因为中间还有主图、视频、详情页等子文件夹而处在不同层。
标准输出目录是什么
商品文件夹智能提取可以把同一批素材整理成三种明确结构。这里的1级、2级、3级，是指具体文件前面有几级文件夹。
1级结构：文件直接位于保存根目录
D:\保存目录 第1层：保存根目录
├─ 商品编码-主图(01).jpg 第2层：具体图片文件
├─ 商品编码-视频(01).mp4 第2层：具体视频文件
└─ 商品编码-尺码图(01).jpg 第2层：具体图片文件2级结构：保存根目录下按商品分文件夹
D:\保存目录 第1层：保存根目录
└─ 商品文件夹 第2层：商品文件夹
├─ 商品编码-主图(01).jpg 第3层：具体图片文件
├─ 商品编码-视频(01).mp4 第3层：具体视频文件
└─ 商品编码-尺码图(01).jpg 第3层：具体图片文件3级结构：按商品和素材类型分文件夹
这是商品文件夹智能提取的默认输出结构：
D:\保存目录 第1层：保存根目录
├─ 商品文件夹A 第2层：商品文件夹
│ ├─ 主图 第3层：素材分类文件夹
│ │ └─ 01.jpg 第4层：具体图片文件
│ ├─ 详情页 第3层：素材分类文件夹
│ │ └─ 01.jpg 第4层：具体图片文件
│ ├─ 视频 第3层：素材分类文件夹
│ │ └─ 01.mp4 第4层：具体视频文件
│ ├─ 尺码图 第3层：素材分类文件夹
│ │ └─ 01.jpg 第4层：具体图片文件
│ └─ 卖点图 第3层：素材分类文件夹
│ └─ 01.jpg 第4层：具体图片文件
└─ 商品文件夹B
└─ ...三种结构的核心区别是：
- 1级：具体文件位于第2层。
- 2级：具体文件位于第3层。
- 3级：具体文件位于第4层，默认使用这一项。
这里只表示目录规范，不要求每款商品同时生成五类素材。系统只会为本次实际提取到的素材创建并写入对应文件或目录。
类目属性和标题文档放在哪里
需要提供原标题、类目、材质成分或品牌时，在每款商品文件夹根目录放置：
类目属性和标题.txt旧版 类目属性.txt 仍可读取。新文档只保存 原标题、类目、材质成分 和 品牌；其它普通商品属性由页面设置、类目模板和属性识别处理。标准内容如下：
原标题：原始商品标题或者商品简称
类目：女装/女士精品 >> 毛呢外套
材质成分：75%羊毛，25%其它
品牌：无品牌原标题 有助于 AI 写出更好的标题，手填关键词会作为最高权重保留。文档中没有类目时，需要在页面设置类目；没有材质成分时，页面会以“其它 100%”作为兜底。品牌可以整行删除不填。
品牌：无品牌 表示商品没有品牌。系统会匹配当前平台提供的无品牌选项；页面没有品牌字段或没有可确认选项时会跳过品牌，不让该非必填项阻断商品。
系统只在当前商品文件夹根目录查找标题文档，不会进入主图、详情页等素材子文件夹。查找顺序为：
原标题.txt / 标题.txt / 商品标题.txt
→ 其它文件名含“标题”的独立 TXT 文档
→ 类目属性和标题.txt
→ 类目属性标题.txt
→ 旧版类目属性.txt其它独立标题文档不应同时带有“类目、属性、材质、成分”等名称。同一优先级有多份文档时，系统优先使用唯一一份明确写有“原标题”的文档；仍不能确认唯一标题时，只跳过当前错误商品，批次中的后续商品继续处理。
来源目录的三种组织方式
来源资料内部可能直接放文件，也可能继续使用主图、视频、详情图等子文件夹。因此，来源组织方式负责告诉系统“从哪里开始算一款商品”，具体文件所在层仍要根据真实完整路径判断。
方式一：所选目录就是单个商品目录
文件直接放在所选目录时：
D:\商品文件夹 第1层：起算根目录
└─ 01.jpg 第2层：具体文件文件位于第2层；文件前面有1级文件夹，属于1级文件夹结构。
文件放在素材子文件夹时：
D:\商品文件夹 第1层：起算根目录
└─ 主图 第2层：素材文件夹
└─ 01.jpg 第3层：具体文件文件位于第3层；文件前面有2级文件夹，属于2级文件夹结构。
方式二：所选目录下直接包含多个商品目录
文件直接放在商品目录时：
D:\档口或厂家、系列或批次 第1层：起算根目录
└─ 商品文件夹 第2层：商品文件夹
└─ 01.jpg 第3层：具体文件文件位于第3层；文件前面有2级文件夹，属于2级文件夹结构。
文件放在商品内部素材子文件夹时：
D:\档口或厂家、系列或批次 第1层：起算根目录
└─ 商品文件夹 第2层：商品文件夹
└─ 视频 第3层：素材文件夹
└─ 01.mp4 第4层：具体文件文件位于第4层；文件前面有3级文件夹，属于3级文件夹结构。
方式三：所选目录下先分组，分组内再包含商品目录
文件直接放在商品目录时：
D:\批次或日期 第1层：起算根目录
└─ 档口或厂家、系列或类别 第2层：分组文件夹
└─ 商品文件夹 第3层：商品文件夹
└─ 01.jpg 第4层：具体文件文件位于第4层；文件前面有3级文件夹，属于3级文件夹结构。
文件放在商品内部素材子文件夹时：
D:\批次或日期 第1层：起算根目录
└─ 档口或厂家、系列或类别 第2层：分组文件夹
└─ 商品文件夹 第3层：商品文件夹
└─ 视频 第4层：素材文件夹
└─ 01.mp4 第5层：具体文件文件位于第5层；文件前面有4级文件夹，属于4级文件夹结构。
分组不一定是档口，也可以是厂家、系列、类别、品牌、来源、日期或批次。
为什么不自动猜来源组织方式
同一个目录可能同时出现以下情况：
- 直属商品目录。
- 分组目录，下面再放商品。
- 暂时为空或只有一款商品的分组。
- 名称像“主图、视频”的素材子目录。
自动猜测容易把分组当商品，或把商品内部素材目录当商品。因此页面需要用户明确选择来源目录怎样组织；检查确认是混合结构时会阻止启动，不能可靠判断时不会随意报警。
混合结构怎样处理
不要在同一个来源目录同时放直属商品和“分组→商品”。可以：
- 提前整理成同一种组织方式后再处理。
- 分别选择不同来源目录，建立多个任务。
- 网盘资料很多时，先用淘宝商品表格整理阶段二生成的 PanTools 转存模板，在 PanTools 中按商家编码转存、命名和整理后再下载。
同名商品文件夹怎样处理
不同分组下可能有不同商品使用同一个文件夹名称。商品文件夹智能提取不会阻止，也不会覆盖前一个结果，而是自动增加数字后缀：
商品编码
商品编码-重复2
商品编码-重复3任务结果会提示重名数量。系统不判断它们是否真是同款，用户需要自行核对。
保存目录为什么不能放在来源目录内部
如果输出放进来源目录，下一次扫描可能再次读到上一次结果，造成重复、递归或覆盖。商品文件夹智能提取只允许整理到来源目录以外的新位置。
使用前检查清单
- 本次路径从哪个起算根目录开始计算。
- 要处理的具体图片、视频、表格或文档实际位于第几层。
- 目标文件前面共有几级文件夹。
- 当前来源属于单个商品、根目录下直接包含商品，还是先分组再包含商品。
- 同一个来源目录是否混合了不同组织方式。
- 保存目录是否位于来源目录之外。
- 快速检查显示的商品数量是否符合预期。
- 第一次处理新结构时，是否先用少量商品抽查。