Joey
103 lines
3.0 KiB
Markdown
103 lines
3.0 KiB
Markdown
# Seller Helper - 1688/淘宝采集插件
|
||
|
||
采集 1688/淘宝商品信息和图片到本地文件夹。
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
cd extension
|
||
pnpm install
|
||
pnpm dev
|
||
```
|
||
|
||
然后：
|
||
1. 打开 Chrome 扩展管理页面：`chrome://extensions/`
|
||
2. 开启"开发者模式"
|
||
3. 点击"加载已解压的扩展程序"
|
||
4. 选择 `extension/.output/chrome-mv3`
|
||
|
||
## 使用
|
||
|
||
1. 打开任意 1688 或淘宝商品页
|
||
2. 点击扩展图标，打开侧边栏
|
||
3. 点击"开始采集"
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
extension/
|
||
├── entrypoints/
|
||
│ ├── background.ts # Service Worker（代理图片 fetch）
|
||
│ ├── sidepanel/ # 采集控制 UI
|
||
│ └── content/ # 注入到商品页
|
||
├── src/
|
||
│ ├── profiles/
|
||
│ │ ├── types.ts # SiteProfile 类型定义
|
||
│ │ └── 1688.ts # 1688 采集配置（生产验证）
|
||
│ ├── collector/
|
||
│ │ └── url.ts # URL 工具（CDN 后缀处理）
|
||
│ └── schema/
|
||
│ └── product.ts # product.json 类型
|
||
├── wxt.config.ts
|
||
└── package.json
|
||
```
|
||
|
||
## 当前状态
|
||
|
||
✅ **M1 完成** - 采集引擎核心
|
||
- ✅ 1688 profile（选择器来自 v1.1.8 生产 bundle）
|
||
- ✅ 淘宝 profile（复用阿里系 CDN 规则）
|
||
- ✅ URL 工具链（CDN 后缀处理、去重 key）
|
||
- ✅ 图片提取（主图/SKU/详情/视频）
|
||
- ✅ 文本提取（标题/价格/参数表/描述）
|
||
- ✅ DOM 等待 + Shadow DOM 穿透
|
||
- ✅ Side Panel UI（展示采集结果）
|
||
- ✅ Console 可测试：`window.__SellerHelper.scan()`
|
||
|
||
🔨 **待实现（M3）**：
|
||
- [ ] File System Access 写盘（选目录 + 生成 product.json）
|
||
- [ ] sources.json 去重（二次采集追加不重复）
|
||
- [ ] 图片批量勾选与预览
|
||
- [ ] 文件夹管理（新建/切换）
|
||
|
||
## 测试方法
|
||
|
||
### 方法 1: Side Panel（推荐）
|
||
|
||
1. 打开任意 1688/淘宝商品详情页
|
||
2. 点击扩展图标 → Side Panel 打开
|
||
3. 滚动页面到底部（加载详情图）
|
||
4. 点击"开始采集"
|
||
5. 查看采集结果（文本数量、图片分组统计、警告）
|
||
|
||
### 方法 2: Console 测试
|
||
|
||
```js
|
||
// 在 1688/淘宝商品详情页的 Console 中执行
|
||
const result = await window.__SellerHelper.scan();
|
||
console.table(result.texts);
|
||
console.table(result.images);
|
||
console.log('stats:', result.stats);
|
||
console.log('warnings:', result.warnings);
|
||
```
|
||
|
||
## 采集重点
|
||
|
||
**必采**（高价值 + 高成功率）：
|
||
- ✅ 标题（100%）
|
||
- ✅ 主图（100%）
|
||
- ✅ SKU 图 + 规格名（95%）
|
||
- ✅ 详情图（90%，需滚动）
|
||
- ✅ 视频（80%）
|
||
|
||
**可选**（保留在 `_raw` 供 studio 参考）：
|
||
- 🟢 价格（90%）
|
||
- 🟢 参数表（80%）—— 1688 的参数不对应 Ozon 属性 ID
|
||
- 🟢 详情文案（70%）—— 中文，需翻译
|
||
|
||
## 相关文档
|
||
|
||
- [总体架构](../../docs/architecture.md)
|
||
- [1688/淘宝实施计划](../../docs/extension/1688-taobao-implementation.md)
|
||
- [插件原方案](../../docs/extension/plan.md)（1688 插件逆向分析）
|