# 1688 商品比价助手 — 使用指南  v9.2.1

获取免费试用   https://yirenceo.cn/1688

---

## v9.0 更新亮点（2026-06 ~ 2026-07）

**新增平台 — SHEIN 云端采集：**
- 搜索页新增「SHEIN」专属采集入口，粘贴 SHEIN 商品链接即可通过云端 API 采集（SHEIN 无本地内容脚本，强制走云端 API）
- 自动识别完整商品 slug（`-p-数字.html`），主图、价格、SKU、规格参数、店铺信息一应俱全，表格显示 #e8a000 橙色 SHEIN 徽章

**新增导出格式 — 淘宝上货数据包（第 10 种）：**
- 严格复刻第三方淘宝上货工具的「素材包」结构：每商品一个文件夹 `{标题}_{offerId}/`，内含 `{标题}.xlsx`（sku 表 13 列 + 商品属性表）+ 扁平主图/详情图 jpg
- 适配本地采集与 API 双通道字段，券后价/优惠前价/库存精确区分

**新增采集字段 — 淘宝券后价：**
- 新增「券后价」列：读淘宝详情页 DOM「平台加补后 ￥XX」/「店铺优惠后 ￥XX」，开关开启后自动遍历最小维度（颜色/规格中值数最少的）各 SKU 抓取精确券后价
- 缺货 SKU 自动清空券后价不兜底，主轴值精确匹配避免误填
- 券前/券后字段分离：原价阶梯保留，券后独立存储

**新增导出格式 — 万象数据包：**
- 淘宝商品导成万象上货软件可导入格式（每商品一个 `{productId}.txt` 单行 JSON，多 txt 打 zip），纯前端生成无需本地服务

**新增平台 — 1688 工厂档案：**
- 1688 实力商家筛选 + 工厂档案批量采集（13 字段：成立年份/员工数/厂房面积/产能/主营工艺等）
- 详情增量补充，已有数据不重复采集

**速卖通链接采集修复（防风控）：**
- `aliexpress.us` 域名稳定访问（.com 直接触发 x5sec 风控），自动改写 + 前台标签页打开
- 分阶段就绪检测（JSON-LD Product 信号优先，风控降级页降级兜底），避免死等
- 平台识别覆盖所有区域子域（.com/.us/.ru/小语种站）

**1688 找货源恢复 + 图搜改版适配：**
- 修复「1688找货源」勾选后进度卡在 0/N 不入库的问题（恢复事件驱动队列）
- 1688 图搜适配 air.1688.com 改版：selloffer 入口 + CDP 注入图片 + air 结果页自动采集

**导出体验优化：**
- 10 个导出格式下拉选项均加悬停说明（文件形态 + 内容 + 是否含图 + 目标工具），选中项联动显示
- 勾选「原图」导出时弹出风控提示（短时间内下载原图超过 100 张可能触发平台风控）

**其他：**
- 淘宝详情图修复（读 `data-src` 属性不依赖滚动，导出 CSV/XLSX 不再缺详情图）
- 淘宝上货 CSV 修复（清洗 ¥ 符号，价格不再为 0）
- 京东云端 API 采集接入（链接采集闭环）
- macOS 部署支持（`.command` 启动脚本 + 专用 zip）
- 下架「邀请返利」活动、简化云端 API 通道状态行显示

历史完整变更记录见仓库 **CHANGELOG.md**。

---

# 快速入门

## 安装

1. 打开 Chrome，地址栏输入 `chrome://extensions`
2. 开启右上角「开发者模式」
3. 点击「加载已解压的扩展程序」，选择插件文件夹
4. 安装完成，浏览器工具栏出现插件图标

> Excel 导出需要本地 Node.js 服务。**简便方式**：双击插件目录下的 `start-excel-server.bat`（Windows）或 `start-excel-server.command`（macOS），自动检测/安装 Node.js 和依赖并后台启动服务（无长驻 CMD 窗口）。**手动方式**：在插件目录下运行 `node excel-server/server.js`。停止服务可双击 `Stop-Service.bat`（Windows）或 `Stop-Service.command`（macOS）。
>
> **macOS 用户**：解压后若 `.command` 双击报错（路径开头 `/` 丢失、`command`→`Command`），是解压工具未保留可执行位所致，在终端运行 `chmod +x *.command` 修复即可。

---

## 基本使用流程

```
点击插件图标打开侧边栏 → 输入关键词或上传图片 → 开始采集 → 补充详情 → 导出 Excel
```

---

# 功能详解

## 一、关键词搜索

1. 在侧边栏「搜索」页的文本框中输入关键词，**每行一个**，支持批量
2. 选择平台：1688 / 淘宝/天猫 / 京东 / 速卖通 / Temu
3. 选择排序方式：默认 / 销量优先 / 价格从低到高 / 价格从高到低
4. 选择采集数量：10 / 20 / 不限 / 50 / 100
5. 点击「开始采集」

多个关键词时自动按队列执行，进度区显示「关键词 3/10：当前关键词」。

### 各平台采集覆盖范围

                                详情补充（补充后额外字段）
 平台      关键词搜索  图片搜索  基础字段  店铺指标  规格参数  SKU明细
 ------    ----------  --------  --------  --------  --------  ------
 1688       ✓          ✓         ✓         ✓         ✓         ✓
 淘宝       ✓          —         ✓         ✓         ✓         ✓
 京东       ✓          —         ✓         ✓         ✓         ✓
 速卖通     ✓          —         ✓         ✓         ✓         ✓
 Temu       ✓          —         ✓         —         —         —
 SHEIN      —（仅链接） —         ✓         ✓         ✓         ✓

> SHEIN 仅支持链接采集（走云端 API），无关键词搜索/图片搜索/详情批量补充。

## 二、图片搜索

1. 切换到「图片」选项卡
2. 上传图片（三种方式）：
   - 点击上传区选择文件
   - 直接拖拽图片到上传区
   - Ctrl+V 粘贴剪贴板中的截图
3. 可同时上传多张图片，自动逐一搜索
4. 选择排序方式和数量，点击「开始采集」

> 图片搜索目前仅支持 1688 平台。1688 图搜已适配 air.1688.com 新版页面。

## 三、Ozon 主图提取

用于跨境电商：从 Ozon 商品页提取主图，再用该图去 1688 找同款。

1. 在图片搜索面板找到「粘贴 Ozon 商品链接」文本框
2. 粘贴 Ozon 商品链接，每行一个
3. 点击「提取主图」，自动获取商品主图
4. 提取的图片进入图片搜索队列，可直接点击「开始采集」

> 支持 ozon.com 及中国跨境 CDN（ozonru.cn）图片链接。

## 四、链接采集

无需搜索，直接粘贴商品详情页 URL 批量采集。

1. 在搜索页切换到「链接」选项卡
2. 粘贴 1688 / 淘宝 / 天猫 / 京东 / 速卖通 / Temu / SHEIN 商品详情页链接，每行一个（自动去重，自动识别平台）
3. 点击「开始采集」，自动逐个打开详情页提取数据（每次间隔 1.5 秒）
4. 采集结果直接包含完整详情（运费、多规格等），无需再补充详情
5. 支持导出 CSV 和 Excel

> 支持 1688、淘宝/天猫、京东、速卖通、Temu、SHEIN 详情页链接。需要许可证激活后才能使用。
>
> **速卖通链接采集**：走本地浏览器通道（万邦云端 API 不支持速卖通），自动将 `aliexpress.com` 改写为稳定的 `aliexpress.us`，前台标签页打开。批量建议每批不超过 20 条，采集中请勿操作浏览器。
>
> **SHEIN 链接采集**：强制走云端 API，需先在「激活」页配置 wb_key。仅识别 `shein.com` 且含 `-p-数字.html` slug 的链接。

## 五、详情页浮动按钮

在 1688 / 淘宝 / 天猫 / 京东 / 速卖通 / Temu 任意商品详情页，右上角会出现「采集此商品」浮动按钮。

1. 打开一个商品详情页
2. 点击右上角的「采集此商品」按钮
3. 当前页面的商品数据自动采集并添加到结果表格
4. 采集完成后按钮变为「已采集」（3 秒后恢复）

> 支持 1688、淘宝/天猫、京东、速卖通、Temu详情页。需要许可证激活后才能使用。

## 六、查看与操作采集结果

采集完成后自动跳转到「结果」页，展示数据表格。

### 1688找货源

在结果页勾选商品后，可使用"1688找货源"功能自动搜索同款：

1. 勾选需要找同款的商品
2. 点击工具栏「1688找货源」按钮
3. 在下拉面板中选择：
   - 用途：找同款（将1688搜索结果追加到表格）或 补充1688报价（将1688价格/运费等数据回填到原商品）
   - 匹配数量：每个商品搜索 1/2/3 条结果（补充1688报价时自动取第一个结果，无需选数量）
   - 搜索方式：关键词搜索（用标题搜索）或 主图搜索（用商品图片搜索）
4. 点击「开始搜索」

插件会自动逐个搜索 1688 并将结果追加到表格，搜索过程中显示进度条，可随时点击停止。

**补充1688报价**模式特别适用于从 Temu/淘宝/京东等平台选中商品后，自动在 1688 上搜索同款并将 1688 的价格、运费、评分、库存、好评率、复购率、店铺指标等数据回填到原始商品记录中，无需手动对比。回填字段包括：最低价、次低价、到手价、运费、起批量、发货地、库存、评分、收藏数、好评率、复购率、近30天成交、7日UV、代发价、下单价、价格阶梯、SKU信息等。

> 找同款仅支持 1688 平台。补充1688报价支持任意平台商品。找货源期间不可进行正常搜索或补充详情。

### 列显示控制

- 表格上方有「显示列」控制区，勾选需要的列即可显示/隐藏
- 点击「全选」或「取消」快速操作
- 默认显示：平台、销量、最低价、次低价、运费、操作、时间
- 可选显示：到手价、店铺、起批量、价表、款色、发货地、评分、收藏、库存、好评率、复购率、近30天、7日UV、商品属性、分销单价、分销销量、代发价、下单价、包装信息、详情状态、新鲜度、价格变化、承诺发货、附图、视频链接、回头率、店铺服务、发货速度、店铺好评、券后价

### 排序

点击列标题切换排序：升序 → 降序 → 默认。支持排序的列：商品、销量、最低价、次低价、运费、到手价、店铺、起批量、款色、发货地、评分、时间（部分列如代发价、下单价、库存、好评率等排序功能尚未实现，点击无效果）。

### 翻页

底部有分页控件：上一页 / 下一页 / 跳转到指定页码。

### 选择商品

- 勾选商品前的复选框进行单选
- 表头复选框全选当前页
- 工具栏的「全选」选中所有数据，「清除」取消所有勾选
- 左侧显示「已选 5 / 120」计数

### 查看规格明细

点击行首的箭头图标，展开该商品的全部 SKU 规格，显示每个规格的名称、价格、库存和图片。工具栏的「全部展开」/「全部折叠」可批量操作。

### SKU 勾选导出

展开多规格商品后，每个 SKU 前有勾选框：

- 默认全部勾选（即导出所有规格）
- 取消勾选不需要的规格，导出时只包含勾选的 SKU
- 工具栏「SKU手动选」按钮：一键取消所有 SKU 勾选，然后手动逐个选择需要的规格
- 折叠状态下，徽章显示已选数量（如「265 种规格 ▶(10/265)」）

> 仅多规格商品（SKU > 1）显示勾选框，单规格商品不受影响。

## 七、补充详情

首次搜索只采集基础数据。点击「补充详情」可自动打开每个商品的详情页，获取完整数据。

1. **必须先勾选**需要补充详情的商品
2. 点击工具栏「补充详情」按钮
3. 进度条显示补充进度（如「15/50」）
4. 补充过程中可点击「停止」中断

> 未勾选任何商品时点击按钮无效。如需补充全部，请先点击「全选」。

补充后新增的字段：运费、到手价、次低价、代发价、下单价、起批量、多规格价格表、库存、评分、收藏数、好评率、复购率、近30天成交、7日UV、商品属性、包装信息、分销价、分销销量、承诺发货、附图、视频链接、回头率、店铺服务分、发货速度、店铺好评率、商品规格参数、SKU明细图片、配送时效等。

### 速卖通特别说明

速卖通（AliExpress）的详情补充经过专项优化：

- **需要前台标签页**：补充详情时会短暂显示速卖通页面（自动打开后随即关闭），这是因为速卖通页面在后台不完整加载。如遇到验证码请手动处理，完成后采集会自动恢复。
- **采集建议**：速卖通反爬较严格，建议每批不超过 20 条商品。
- **新增字段**：速卖通额外采集规格参数（电压/材质/重量等）、店铺好评率、粉丝数、附图集、商品视频、预估配送时效。
- **链接采集防风控**：链接采集自动用 `aliexpress.us` 域名（.com 会触发 x5sec 验证码），前台打开，平台识别覆盖所有区域子域。

### 防封禁模式

选中超过 20 个商品补充详情时，会弹出确认框：

- 点击「**确定**」= 启用防封禁模式（推荐）
- 点击「**取消**」= 使用普通模式（快速但可能被封）

防封禁模式特性：
- 单并发：同一时间只打开一个详情页
- 随机延迟：每次操作间隔 2-5 秒
- 批次冷却：每 20 个商品后冷却 30-60 秒
- 自动暂停：连续 3 次失败自动暂停，防止账号被限制

> 建议批量补充时点击「确定」启用防封禁模式，速度较慢但更安全。

### 断点续传

补充详情或批量采集过程中，如果关闭浏览器或中途中断，重新打开扩展后会自动提示恢复：

- 自动检测未完成的任务进度
- 点击「继续」从断点恢复，已完成的数据不会重复采集
- 浮动采集按钮在页面跳转后也会自动恢复

### 注意事项

- 搜索采集和补充详情**不能同时进行**。请在搜索完成后再补充详情。
- 补充详情时，插件会在后台打开新的标签页。请不要手动关闭这些标签页。
- 速卖通补充详情时标签页会短暂出现在前台（自动关闭），属正常现象。

## 八、导出

### 导出 CSV

点击「CSV」按钮，直接下载 CSV 文件（UTF-8 编码，Excel 可打开）。无需本地服务。

### 导出 Excel

点击「Excel」按钮，生成带格式的 .xlsx 文件。需要本地 Node.js 服务运行。

Excel 导出特性：
- 商品主图和 SKU 规格图片直接嵌入单元格
- 多规格商品自动展开为多行，非规格列自动合并
- 支持 SKU 粒度筛选：仅导出已勾选的规格行
- 店铺名称和商品标题包含可点击超链接
- 仅导出当前表格中可见的列
- 勾选「原图」可导出未压缩的高清图片（文件更大；超 100 张可能触发平台风控，会弹确认框）

### 导出流程

```
选中商品 → 点击 CSV 或 Excel 按钮 → 等待进度条完成 → 文件自动下载
```

> CSV 适合快速导出纯数据（无需本地服务）。Excel 适合需要图片、格式的正式报告。

### 导出为 ERP / 上货工具格式

工具栏导出按钮旁的下拉菜单支持多种格式一键导出（每个选项悬停可见格式说明）：

**妙手素材包**
- 导出为妙手 ERP 可导入的素材包 ZIP
- 22 列官方模板格式，支持多 SKU 展开
- 包含主图、详情图、SKU 规格图、货源链接等完整字段
- 需要本地 Node.js 服务运行

**飞书多维表格**
- 采集数据直推到飞书多维表格（无需本地服务）
- 11 字段自动映射：商品标题、主图、最低价、店铺、销量、到手价、运费、发货地、商品 ID、平台、采集时间
- 批量推送，每批最多 1000 条
- 需要先在「激活」页配置飞书 App ID、App Secret 和表格 ID
- 支持测试连接和保存配置

**店小秘**
- 导出为店小秘可导入的 Excel
- 字段自动匹配店小秘导入模板：商品名称、主图、价格、SKU、规格、供应商、发货地、重量、到手价、商品链接
- 需要本地 Node.js 服务运行

**千牛模板**
- 导出为千牛可导入的 Excel 数据包（xlsx 格式）
- 18 列千牛官方模板格式，含隐藏元数据工作表
- 自动映射：商品标题（过滤源平台关键词）、一口价、导购标题、SKU 规格属性
- 多 SKU 商品自动展开为多行，每行对应一个规格
- 需要本地 Node.js 服务运行

> 导入方式：在千牛工作台 → 宝贝管理 → 导入数据包，选择导出的 xlsx 文件即可。

**淘宝上货 CSV**
- 导出为淘宝上货工具可导入的 CSV
- SKU 级价格、规格、库存字段
- 适配 1688（去 location 省后缀、shop_id 留空）与淘宝本地/API 双通道
- 无需本地服务

**万象数据包**
- 淘宝商品导成「万象」上货软件可导入格式
- 每商品一个 `{productId}.txt`（单行 JSON），多 txt 打包为 ZIP
- 纯前端 store 模式 ZIP，无需 JSZip 依赖，**无需本地服务**
- 价格元转分（字符串对齐样本），券后价优先

**淘宝上货数据包（素材包）**
- 严格复刻第三方淘宝上货工具产出的「素材包」结构
- 每商品一个文件夹 `{标题}_{offerId}/`，内含 `{标题}.xlsx`（sku 表 13 列 + 商品属性表）+ 扁平 `主图_N.jpg`/`详情_N.jpg`
- xlsx 两工作表：`sku`（名称|图片|skuId|价格|优惠前|券后价|物流信息|库存数量|限购描述|优惠券信息|图片链接|产品链接|产品名称）+ `商品属性`（属性名称|属性值）
- 价格=券后价，优惠前=券前原价，库存=stockNum/quantity 双路径兼容
- 需要本地 Node.js 服务运行

**工厂档案**
- 1688 工厂档案导出（仅选中含 factoryProfileFetched 的 1688 商品）
- 纵向区段 xlsx，含成立年份/员工数/厂房面积/产能/主营工艺等 13 字段
- 需要本地 Node.js 服务运行

### 淘宝属性模板

导出千牛模板时，"宝贝属性"列需要填充各品类的必填属性。支持自定义模板：

1. 点击顶部导航「激活」标签页，滚动到底部「淘宝导出属性模板」区域
2. 默认模板包含 4 个属性：产地(见包装)、生产企业(中国)、适用人群(不限)、消字号(见包装)
3. 点击「+ 添加属性」可新增属性行（属性名支持输入建议下拉）
4. 点击「新建」创建新模板（如"保健品"、"服装"等不同品类模板）
5. 通过下拉框切换当前使用的模板，导出时自动应用激活模板
6. 点击「导出」将所有模板导出为 JSON 文件，可用于备份或分享给其他设备
7. 点击「导入」从 JSON 文件恢复模板（合并模式，不覆盖已有模板）

> 默认模板不可删除。自定义模板可随时删除，删除后自动切换回默认模板。

**自定义Excel**
- 自定义列 + SKU 展开的 Excel 导出（xlsx 格式）
- 18 列可选：关键词、商品网址、商品名称、主图、附图1-7、包装重量、运费、下单价、变体名称、变体值、变体图片、SKU重量
- 支持列勾选：仅导出需要的列
- SKU 智能展开：首行填完整产品信息 + SKU 级字段，后续行仅填 SKU 级字段
- 每个变体行包含：完整规格组合（如"颜色A + 型号B"）、对应下单价、对应规格图片
- SKU 上限控制：每个商品最多导出的 SKU 数（默认 5，可调 1-100）
- 支持多模板管理、JSON 导入导出
- 需要本地 Node.js 服务运行

### 自定义Excel模板配置

1. 点击顶部导航「激活」标签页，滚动到底部「自定义 Excel 导出模板」区域
2. 通过下拉框切换当前使用的模板
3. 点击「新建」创建新模板，输入模板名称
4. 勾选需要导出的列（取消勾选则不导出）
5. 设置 SKU 上限（每个商品最多导出的 SKU 数量）
6. 点击「保存」保存模板配置
7. 点击「导出」将所有模板导出为 JSON 文件，可用于备份或分享
8. 点击「导入」从 JSON 文件恢复模板（合并模式，不覆盖已有模板）

> 默认模板不可删除。自定义模板可随时删除，删除后自动切换回默认模板。

## 九、云端 API 采集通道

通过万邦中转 API 直接采集商品详情数据，无需打开浏览器标签页（更稳定、风控更低）。

支持平台：1688 / 淘宝 / 京东 / SHEIN（速卖通不支持，走本地通道）。

### 配置

1. 在「激活」页找到「云端 API 采集通道」区域
2. 填入 wb_key（万邦 API 密钥，存储在 excel-server 本地，扩展不持有）
3. 点击「测试连接」验证余额与配置
4. 状态行显示「已配置 wb_****xxxx · 余额 ¥xxx」

### 三个开关

- **详情补充走云端 API**：补充详情时优先调 API（仅对 1688/淘宝 生效）
- **链接采集走云端 API**：链接采集时优先调 API
- **淘宝券后价 SKU 遍历（慢·有风控）**：开启后淘宝链接采集/详情补充会自动遍历最小维度各 SKU 抓取精确券后价（v9.0.6 起选最小维度把点击次数降到最低，主轴值数超 20 自动跳过用基线，检测到风控页自动中止；仍有风控风险）

> 淘宝券后价遍历仅在 URL 含 `mi_id` 或 `skuId`（完整详情页）时生效，精简页无券后 DOM。券前/券后字段分离：原价阶梯保留在「最低」「次低」列，券后独立存「券后价」列。缺货 SKU 自动清空券后价。批量链接采集超 10 个淘宝商品且开启遍历时会二次确认提醒。

## 十、多店横向比价

将不同店铺的同类商品放入同一张表横向对比。

### 打开比价面板

点击顶部导航的「比价」标签页。

### 添加商品到比价

三种方式：
1. **从采集结果导入：** 在结果页勾选商品，点击工具栏「比价」按钮
2. **粘贴链接采集：** 在比价面板的店铺栏中粘贴 1688 商品链接，点击「采集」自动提取数据
3. **导入已有数据：** 支持 .xlsx / .csv 文件导入已有比价数据

### 比价表格

每行显示一个商品的比价信息：货物名称、样品价、每个店铺（动态2-10列，含店铺名称/规格/价格）、销量。

### 比价操作

- 点击列标题排序（各店铺价格列、总销量）
- 点击行内编辑按钮修改数据
- 支持从 .xlsx / .csv 文件导入已有比价数据
- 点击「Excel」导出带图片的比价表格

## 十一、价格追踪

插件自动记录每次采集的价格，无需手动操作。

- 表格中「价格变化」列显示涨跌方向和幅度
- 「新鲜度」列显示数据时效（如「2小时前」「3天前」）
- 降价超过 5% 时自动弹出通知
- 操作列的「价格历史」按钮可查看折线图（最低价 + 次低价双线走势）

## 十二、定时监控与降价通知

1. 点击顶部导航「监控」标签页
2. 点击「从结果添加」将已采集的商品加入监控列表
3. 可设定目标价格
4. 插件每 30 分钟自动检查价格
5. 降价超过阈值或达到目标价时推送浏览器通知
6. 支持暂停/恢复单个监控、手动「立即检查」
7. 每个监控项显示当前价、目标价、库存和上次检查时间
8. 点击「价格曲线」可查看历史价格折线图（最低价 + 次低价双线走势，标注最高/最低点）
9. 已下架商品自动标红提示（红色边框+标题前缀+降低透明度），库存降幅超过 50% 时推送通知

> 最多支持 50 个监控项。Chrome 需保持运行才能执行定时检查。

## 十三、激活授权

1. 点击顶部导航「激活」标签页
2. 页面显示当前电脑的机器码
3. **免费试用**：点击机器码下方的「获取免费试用」链接，跳转网站自动获取 1 小时试用激活码
4. **付费激活**：将机器码发送给开发者，收到激活码后填入输入框，点击「激活」

激活码格式：`XXXXX-XXXXX-XXXXX-XXXXX`

### 重新激活与设备绑定

- 卸载重装插件后需要重新输入激活码激活
- 如果检测到新设备，会弹出确认框显示上次使用时间，确认后重新绑定
- 同一激活码同时只能在一台设备上使用，检测到其他设备使用时会自动下线
- 被踢下线后有 10 分钟冷却期，期间不可重新绑定

---

# 常见问题

**Excel 导出报错？**
确认本地服务已启动：双击 `start-excel-server.bat`（Windows）/ `start-excel-server.command`（macOS），或在插件目录运行 `node excel-server/server.js`，看到服务启动提示即可。CSV 导出和万象数据包导出不需要此服务。

**图片搜索支持哪些平台？**
目前仅支持 1688。但可以通过 Ozon 提取主图后用于 1688 图片搜索。

**淘宝搜索结果包含天猫商品吗？**
是的，插件已完整适配天猫详情页的数据采集。

**京东和速卖通能用吗？**
可以。京东搜索页/详情页已完整支持，且支持云端 API 链接采集。速卖通已适配新版 SPA 页面，搜索+详情采集均正常；链接采集自动用 `aliexpress.us` 域名防风控。

**Temu 能用吗？**
可以。v7.0 已完整支持 Temu 搜索页/详情页的数据采集。搜索页顶部切换平台选择 Temu 即可。

**SHEIN 能用吗？**
SHEIN 仅支持链接采集（走云端 API）。在搜索页选「SHEIN」单选，粘贴 `shein.com` 商品链接（需含 `-p-数字.html` slug），需先在「激活」页配置 wb_key。无关键词搜索/图片搜索/详情批量补充。

**速卖通采集有什么特别注意事项？**
速卖通已适配新版页面。链接采集自动用 `aliexpress.us`（.com 会触发 x5sec 风控），前台标签页打开。详情补充时标签页会短暂出现在前台（自动关闭），属正常现象。建议每批不超过 20 条，采集中请勿操作浏览器。采集字段含规格参数/店铺好评率/粉丝数/附图/视频/配送时效等。

**速卖通主图为什么不显示？**
v8.2 已修复。如仍不显示，请确认扩展已更新到最新版。

**淘宝券后价是什么？怎么采集？**
淘宝详情页的「平台加补后 ￥XX」/「店铺优惠后 ￥XX」即为券后价。需在「激活」页开启「淘宝券后价 SKU 遍历」开关，且商品 URL 须含 `mi_id` 或 `skuId`（完整详情页）。开启后自动遍历最小维度（颜色/规格中值数最少的维度）各 SKU 抓取精确券后价，券前原价保留在「最低」「次低」列，券后独立显示在「券后价」列。v9.0.6 起选最小维度把点击次数降到最低（如 15 色×4 规格只点 4 次而非 15 次），主轴值数超 20 自动跳过遍历用基线，遍历中检测到风控页自动中止。该功能较慢且有风控风险，精简页（bare `?id=`）无券后 DOM。批量链接采集超 10 个淘宝商品且开启遍历时会二次确认提醒。

**多规格数据能导出到 Excel 吗？**
可以。每个 SKU 展开为单独的行，包含规格名称、图片、单价和库存。

**采集遇到验证码怎么办？**
插件在 1688 详情页会自动检测验证码并暂停采集。手动完成验证码后，采集会自动恢复。速卖通遇到验证码（x5sec 风控页）时会自动跳过该商品并提示，建议减少批量、稍后重试。

**支持哪些浏览器？**
仅支持 Chrome。基于 Chromium 的 Edge、Brave 理论上可用，但未做针对性适配。macOS 用户需注意 `.command` 启动脚本的可执行权限（双击报错时 `chmod +x *.command`）。

**什么是防封禁模式？**
批量补充详情（超过 20 个商品）时，1688 可能会限制访问。弹出确认框时点击「确定」即可启用，会自动降低采集速度、增加随机延迟和冷却时间，大幅降低被限制的风险。点击「取消」则使用普通快速模式。

**SKU 勾选对导出有什么影响？**
展开多规格商品后，可以逐个勾选/取消勾选 SKU。导出 CSV 或 Excel 时，只包含已勾选的规格行。单规格商品不受影响，始终导出。

**定时监控是怎么工作的？**
添加监控后，插件通过 Chrome Alarms API 每 30 分钟自动在后台打开商品详情页检查价格。如果降价超过阈值或达到设定的目标价格，会推送浏览器桌面通知。

**链接采集支持哪些平台？**
支持 1688、淘宝/天猫、京东、速卖通、Temu、SHEIN 的商品详情页链接。速卖通走本地通道，SHEIN/京东/1688/淘宝可走云端 API 通道。

**哪些功能需要许可证？**
关键词搜索、图片搜索、详情补充、链接采集、浮动按钮采集均需要激活许可证。免费试用可在网站自助获取。

**妙手/店小秘/上货数据包导出报错？**
妙手、店小秘、千牛模板、淘宝上货数据包、自定义Excel、工厂档案导出均需要本地 Node.js 服务运行。请双击 `start-excel-server.bat`（Windows）/ `start-excel-server.command`（macOS），或手动运行 `node excel-server/server.js`。飞书多维表格和万象数据包导出不需要本地服务。

**飞书多维表格怎么配置？**
在「激活」页面底部找到飞书配置卡片，填写 App ID、App Secret 和表格 ID（格式：appToken/tableId），点击「测试连接」验证通过后保存即可。

**云端 API 采集通道怎么配置？**
在「激活」页面找到「云端 API 采集通道」区域，填入 wb_key（万邦 API 密钥），点击「测试连接」验证余额。支持 1688/淘宝/京东/SHEIN；速卖通不支持云端 API，走本地浏览器通道。

**自定义Excel导出怎么用？**
在导出按钮旁的下拉菜单选择「自定义Excel」。首次使用时在「激活」页面底部配置导出模板（勾选需要的列、设置 SKU 上限），然后勾选商品点击导出即可。每个 SKU 展开为独立行，包含完整规格名、对应价格和图片链接。

**重装插件后需要重新激活吗？**
是的，卸载重装后需要重新输入激活码。如果检测到新设备会弹出确认框，确认即可重新绑定。同一激活码同时只能在一台设备使用。

**淘宝数据包怎么导入千牛？**

插件导出千牛专用 xlsx 格式（含隐藏元数据工作表）：

1. 打开千牛工作台，登录淘宝卖家账号
2. 左侧菜单选择「宝贝管理」→「仓库中的宝贝」（或「出售中的宝贝」）
3. 点击页面上方的「导入数据包」按钮
4. 选择插件导出的 xlsx 文件
5. 点击「开始导入」，等待导入完成
6. 导入成功后，商品默认放在「仓库中的宝贝」，需手动上架

**导入后需检查的项：**

- **宝贝类目**：导出的 xlsx 默认类目为空，导入后需为每个商品选择正确的淘宝类目（最重要的步骤，类目错误会导致审核不通过）
- **宝贝价格**：确认价格是否需要调整（如加价倍率）
- **SKU 规格**：如果商品有多规格，检查各规格的价格和库存是否正确
- **主图和描述图**：xlsx 不含图片，需在千牛中手动上传或通过其他方式补充

> 导入后商品默认在「仓库」中，确认无误后再批量上架。

**1688 找货源为什么之前不工作？**
v9.0.4 已修复 v8.1.0 架构重构导致「1688找货源」勾选后进度卡在 0/N 不入库的问题（恢复事件驱动队列 + 修复 keyword 伪信号/图搜导航/runId 竞态/风控跳过）。请确认扩展已更新到 v9.0.4 或以上版本。
