从装好到交付的完整流程

1. 安装扩展

1. 打开 Chrome 或 Edge，地址栏输入 chrome://extensions（Edge 是 edge://extensions）。
2. 打开右上角的「开发者模式」。
3. 点「加载已解压的扩展程序」，选择插件文件夹（例如桌面上的 采集小助手）。
4. 在工具栏把「采集小助手」图标固定，方便打开弹窗。

2. 首次打开管理页

点扩展图标 → 「打开管理页」，或者在扩展详情里点「扩展程序选项」。管理页分三块：

• 左栏：关键词导入、关键词队列、店铺管理、高级设置。
• 右栏：已采集商品列表，按关键词 / 店铺筛选，可编辑标题与价格。
• 顶部：导出 CSV、导出 Excel、使用说明、云同步。

第一次使用建议先关掉「登录验证」（设置 → 安全），免得每次打开都要输密码；确认流程顺手后再打开。开启后密码只在本机校验，2 小时内免重复输入。

3. 关键词与配额

在左栏「关键词导入」里粘贴关键词，可以直接从 Excel 复制多行多列，也支持逗号、顿号、横线分隔。点「导入并去重」后会去掉重复项并保留顺序。

• 点击关键词名称会筛选右侧商品；点「打开」在新标签打开该词的淘宝搜索页。
• 当前词会高亮显示，采满配额后自动跳到下一个词（需开启「自动下一词」）。
• 设置里的「定额」控制每个关键词采多少条，默认 2，常见配置是 20–40。

4. 手动采集

打开淘宝搜索页（s.taobao.com）或天猫列表页，稍等 1–2 秒，每个商品卡片右下角会出现「采集」按钮。点击后：

1. 商品标题、价格、销量、图片、链接写入本地库，按当前店铺 + 当前关键词归档。
2. 同一商品（按商品 ID 判断）重复点击会提示「已采集」，不会重复入库。
3. 最近一次采集可以撤回；采错的也可以在管理页删除。
4. 后台会静默打开一次详情页，把 SKU 价格区间补回来，然后自动关掉标签。

商品详情页也支持采集，入口在页面右下角的状态条上。

5. 自动采集与智能选品

设置 → 自动采集里可以切换四种模式：

• 普通采集：按页面顺序逐个采集，速度稳定。
• 随机采集：在候选商品里随机挑，避免固定顺序。
• 销量最高：优先采销量高的商品。
• 智能选品：按销量、评价、主图质量加权打分，低于阈值的跳过。

智能选品怎么打分

三个维度的权重（默认销量 50 / 评价 30 / 主图 20）可以调整。主图维度会先调用本地 OCR 判断图上文字量，文字太多的营销海报会被压低分；也可以开启 AI 主图评分，让视觉模型判断背景是否干净、主体是否清晰。

节奏与限制

自动采集内置随机延迟、页面停留和每小时上限，遇到验证码会暂停。不要为了快把延迟调到最低——平台风控看的是行为频率。

5.1 运营视角（爆款潜力）

智能选品除了三维打分，还会按真实选品逻辑叠一层系数，默认开启。它挑的不是「数据最好的」，而是「还有机会的」：

另外还有三档权重预设（爆款 70/20/10、品质 30/40/30、均衡 50/30/20），以及图片像素分析（背景纯度 / 色彩复杂度 / 锐度）用于判断主图是否干净。

5.2 京东采集怎么用

1. 打开京东搜索页（search.jd.com），搜任意关键词。
2. 每个商品卡片右下角出现「＋采集」按钮，点一下即入库。
3. 到管理页「数据」视图查看，京东商品前面带红色「京东」标签。

京东与淘宝共用同一个商品库、同一套去重和导出。能读到 SKU、标题、京东价、评价数（折算成销量位）、店铺与主图。京东主图有防盗链，插件通过本地服务中转，加载失败会自动退回原图或显示「无图」。

与淘宝的差异：京东页只有手动「＋采集」，没有自动翻页循环，也不参与智能选品排序——京东不提供销量接口，只有评价数。

5.3 按类目抓取与热门关键词

管理页左栏有两个找词入口：

• 按类目抓取：内置 15 个一级 / 44 个二级 / 99 个三级类目、1149 个关键词。三级联动选中后自动带出该类目关键词，可单个入队、按「前 N 个」批量入队，或直接打开该类目的淘宝搜索页。用这些词采到的商品，导出时会自动匹配对应京东类目。
• 热门关键词：一键抓取当前淘宝页面的热搜、相关搜索、大家都在搜区块，按出现次数排序，点 ＋ 入队。没有淘宝页时会自动在后台打开一个再抓，不抢焦点。

5.4 关键词蓝海分析

管理页中间第 4 个视图「关键词」，回答「这么多词先做哪一个」。

• 自动统计（来自已采数据）：商品数、月销合计、均价、旗舰占比、头部集中度（前 3 名销量占比）。
• 手动填写（淘宝京东不公开）：在线商品数、搜索人气、转化率，从生意参谋 / 京东商智抄过来。
• 蓝海值 = 搜索人气 ÷ 在线商品数：≥1.5 蓝海、0.5–1.5 一般、<0.5 红海。
• 机会分 = 需求 40% + 竞争反向 30% + 转化率 20% + 非旗舰占比 10%，用对数压缩避免大词压死小词。

蓝海值必须两个真实数都填了才算，缺一项显示「需填」，不会用销量硬凑出假蓝海。可按蓝海值 / 机会分 / 月销 / 商品数排序，把蓝海词批量加入队列，或导出 CSV。

6. 旗舰店与违禁词

「跳过旗舰店」默认开启，判定顺序是：标题、店铺名、主图 OCR、AI 识图。前两路不需要任何服务；后两路需要在设置里开启对应开关，本地 OCR 还要先运行 采集小助手.bat。

• 本地 OCR：Windows 自带识别引擎，离线、免费，单张图通常几百毫秒。
• AI 识图：复用你在「AI 类目匹配」里配置的模型，按张消耗额度。
• 违禁词：在设置里一行一个，标题命中就跳过，和旗舰店共用同一条过滤链路。

每次跳过都会写入采集日志（管理页 → 看板 → 日志），能看到具体命中了哪个词。

7. 多账号轮换

采集量大的时候，单账号容易被限流。多账号轮换会保存多套淘宝登录态，需要时一键切换：

1. 在浏览器里正常登录淘宝账号 A，打开管理页 → 多账号 → 保存为「账号A」。
2. 退出登录，登录账号 B，同样保存为「账号B」。
3. 之后点「切换」，扩展只清账号级 Cookie（保留设备指纹），写入目标账号凭证，再做一次免登录握手。
4. 切换后会发一次真实请求确认登录成功；失败会自动回滚到切换前的账号。

8. AI 类目匹配

导出时需要「京东一级 / 二级 / 三级类目」。扩展按三级顺序匹配：

1. 你导入的类目映射表（关键词 → 类目），最准。
2. 内置离线类目库，覆盖 14 大类常见词。
3. 前两级都没命中时，才调用大模型，按张数 / 条数消耗额度。

设置里填接口地址、API Key、模型名即可，兼容 OpenAI 格式（DeepSeek、火山方舟、阿里百炼、智谱都行）。点「测试连接」会发一条最小请求验证配置。

9. 导出与备份

导出 Excel

按店铺分 sheet，每行包含商品链接、关键词、京东三级类目，可选嵌入商品缩略图。纯前端生成，不需要服务器。

导出 CSV

带店铺批次与三级类目，适合交给下游系统或做数据透视。

备份

设置 → 备份与云同步：导出完整备份 JSON（商品、关键词、店铺、设置，不含登录 Cookie），在新电脑上导入即可继续用。也可以在云端控制台导入这份 JSON。

10. 云同步与控制台

云同步是可选的：插件把采集结果发到你自己部署的服务端，控制台负责查看、整理和交付。不开启时，插件行为和以前完全一样。

10.1 启动服务端

需要 Node.js 18 或更高版本，无需安装任何第三方包：

cd caiji-site
npm start

终端会打印访问地址、管理密码和云同步令牌。第一次启动会自动生成管理密码，请保存好；也可以用环境变量自己指定：

# Windows PowerShell
$env:ADMIN_PASSWORD="your-strong-password"; $env:PORT="8899"; npm start

默认监听 http://127.0.0.1:8899，控制台地址是 http://127.0.0.1:8899/console/。

10.2 在扩展里开启云同步

1. 打开扩展管理页，点右上角「云同步」。
2. 服务器地址填 http://127.0.0.1:8899（部署到内网就填对应地址）。
3. 令牌填服务端打印的那串字符，点「测试连接」。
4. 点「上传全部」，把当前采集结果推到控制台。
5. 需要时打开「自动同步」，之后每次采集变化会延迟合并上传。

10.3 控制台能做什么

• 看板：总商品数、今日新增、店铺分布、关键词 Top 10、最近采集。
• 商品：按关键词 / 店铺搜索筛选，批量改店铺、批量删除，单条删除。
• 导入：把插件导出的备份 JSON 直接拖进控制台。
• 导出：CSV（Excel 可直接打开）或插件可导入的备份 JSON。
• 设置：查看 / 轮换云同步令牌，复制服务器地址。

11. 控制台部署

服务端是单个 server.mjs，不依赖框架。常见部署方式：

• 本机：双击 start.bat，或 npm start。
• 内网服务器：把项目放到服务器，用 PORT=8899 npm start 常驻，建议配合 systemd / pm2。
• 公网：务必放在 HTTPS 反向代理后面（Nginx / Caddy），并设置强密码；不要直接暴露到公网 HTTP。

# Nginx 反向代理示例
location / {
  proxy_pass http://127.0.0.1:8899;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
}

如果控制台和扩展不在同一台机器，把 CORS 白名单改成扩展来源（chrome-extension://<扩展ID>），或保持默认允许本机来源、通过内网访问。

12. 排障速查

页面上没有采集按钮

• 确认是淘宝搜索页 / 天猫列表页，不是首页推荐流。
• 改完设置后刷新页面；扩展页面也要重新加载。
• 检查扩展是否被浏览器禁用，或被其他采集扩展冲突。

提示「本地 OCR 服务未启动」

运行插件目录里的 采集小助手.bat，浏览器访问 http://127.0.0.1:8766/ping 应返回 ok。不需要 OCR 时关掉「本地 OCR 识图」即可。

云同步提示网络错误

• 确认服务端在运行，浏览器能打开 http://127.0.0.1:8899/api/health。
• 服务器地址不要带结尾斜杠；改了端口要同步改扩展里的地址。
• 令牌填错会返回 401，去控制台「设置」重新复制。
• HTTPS 页面调用 HTTP 接口会被浏览器拦截，公网部署请一并上 HTTPS。

导出后类目是空的

说明这个关键词三级匹配都没命中。补一条映射表，或确认 AI 配置可用；也可以导出 CSV 后人工补。