# dianxiaomi

**Repository Path**: guo0817/dianxiaomi

## Basic Information

- **Project Name**: dianxiaomi
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-01
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 店小秘 Voghion 发布助手

这是一个 Chrome MV3 扩展，用来辅助处理店小秘 Voghion 草稿箱商品。

## 功能

- 拉取 Voghion 草稿箱 `/api/voghionProduct/pageList.json`。
- 按 Voghion 编辑页逻辑读取 `/api/voghionProduct/add.json?id=产品ID`，保存时上传 `voghionSave.txt` 到 `/api/voghionProduct/add.json`。
- “立即发布”会先保存并移入待发布，再调用 Voghion 列表页同款 `/api/voghionProduct/batchPublish.json` 发布，和发布失败页“再发布”的路径一致。
- 进入发布助手后读取 Voghion 店铺列表，默认选第一个店铺。
- 产品分类使用店小秘原有 Voghion 类目接口做多级联动选择，和店小秘编辑页保持一致，也会记住上次选择。
- 配置页里的输入框和选择框会自动保存，下次打开继续使用上次配置。
- 默认库存 50、价格加价 55%，都可以在配置页调整。
- 拉取列表时可以分别设置“每页拉取数量”和“本次最多拉取”。
- 供应商商品 ID 每次处理时生成 UUID。
- 过滤 GIF/动图图片；产品图取前 6 张，场景图取前 4 张，尺寸图取最后 1 张，剩余名额给卖点图，总数最多 15 张。
- 描述图片最多上传 20 张；实拍图片区域下方的细节图回填倒数第二张采集图，统一过滤 GIF/动图。
- 变种图缺失时，按采集图片顺序依次顺延兜底；SKU ID 按编辑页“一键生成”的实际拼接规则处理，优先复用已有供应商商品 ID 作为前缀，再按变种值用 `-` 连接。
- 物流属性在发布时按类目接口直接匹配：优先 `普货`，没有 `普货` 时取第一个可用选项；只有一个物流选项时直接使用唯一选项。
- 支持勾选发布，也支持一键发布当前已拉取的全部商品，日志会显示总数和剩余数。
- 拉取列表时页大小和本次拉取上限都会自动限制在 5000。

## 安装

1. 打开 Chrome：`chrome://extensions`
2. 开启“开发者模式”。
3. 点击“加载已解压的扩展程序”。
4. 选择本目录：`/Users/guoshuai/Documents/dianxiaomi`

## 使用

1. 先登录店小秘。
2. 打开扩展，进入“发布助手”。
3. 确认库存、加价、默认店铺、默认分类和执行随机间隔。
4. 点击“拉取发布商品”，勾选要处理的草稿商品，或直接点“一键发布所有”处理当前列表全部商品。
5. 确认发布弹窗后开始发布计划。

## 注意

- 商品数据只保存在当前扩展页面内存中，不会持久化商品详情。
- 登录 cookie 不会被读取或存储，只由浏览器在请求店小秘接口时自动携带。
- 默认分类通过多级类目选择框手动改选，发布前必须选到最终类目。

接口与规则分析见 [docs/analysis.md](docs/analysis.md)。