# 抖店主图详情替换：ZIP 结构说明

这份说明用于核对“抖店主图详情图批量替换”任务实际读取的 ZIP。它不是平台上传包，也不需要把这份说明放进 ZIP。

## 先分清两件事

- 上方“生成 ZIP”区域才需要商品表、图片素材根目录、图片比例和每包商品数。
- 下方“抖店主图详情替换任务”只读取已经生成并检查过的 ZIP 目录。不要把原始图片根目录或商品表误选到这里。

## 可识别的两种图片结构

系统会在启动前检查 ZIP 是否含有可识别图片，并识别以下任一种结构：

```text
结构一：商品文件夹结构
DOU-26001/主图_001.jpg
DOU-26001/主图3:4_001.jpg
DOU-26001/详情图_001.jpg

结构二：图片文件名带商品 ID
DOU-26001_主图_001.jpg
DOU-26001_主图3:4_001.jpg
DOU-26001_详情图_001.jpg
```

`DOU-26001` 仅为示例，应替换为本批真实商品 ID。主图、3:4 主图、详情图只会按本次在打包区选择的类型进入 ZIP。

## 提交前检查

1. ZIP 是当前批次生成的，不是原始图片目录。
2. ZIP 内至少有一张图片；不要放密码、嵌套 ZIP 或不安全路径。
3. 不要把 `__MACOSX`、`._` 等系统隐藏文件一起打包。
4. 单包体积以页面填写的“ZIP 体积上限”为准；超限时先减小每包商品数。
5. 先用少量商品运行，确认主图/详情图对应正确后再扩大批量。

页面会在启动前再次校验 ZIP；校验失败时不会打开平台页面。