常见问题
先看这里，再问人
按使用频率排序。没找到答案的，拉到最底部联系我们。
页面上没有出现采集按钮
依次检查：
- 是不是淘宝搜索页（
s.taobao.com）或天猫列表页？首页推荐流不注入按钮。 - 装好或更新扩展后，有没有刷新页面？页面注入只在加载时执行一次。
- 扩展是否被禁用、被其他同类扩展抢占？在扩展页确认无报错。
- 刷新后等 1–2 秒，商品卡片是异步渲染的。
改完设置没反应 / 按钮状态不同步
管理页保存后会广播给所有标签页；如果仍然没变，刷新目标页面最稳。扩展页面（管理页、弹窗）改完代码后需要重新加载扩展。
提示「本地 OCR 服务未启动」
本地 OCR 是可选组件，用来读主图上的文字。运行插件目录里的
采集小助手.bat，选择启动服务；浏览器访问 http://127.0.0.1:8766/ping 返回 ok 即正常。不想开就在设置里关掉「本地 OCR 识图」，插件会退回标题 + 店铺名判断。AI 识图 / 类目匹配报 401、402、404
401 是 Key 无效或没带空格，回服务商后台重新复制；402 通常是余额不足；404 一般是接口地址或模型名不对。注意兼容 OpenAI 格式的服务，地址通常以
/v1 结尾，模型名要和控制台里开通的一致。云同步连不上服务器
- 先确认服务端在跑：浏览器打开
http://127.0.0.1:8899/api/health。 - 地址不要带结尾斜杠，端口要和启动日志一致。
- 401 说明令牌不对，去控制台「设置」复制最新令牌。
- HTTPS 页面不能调用 HTTP 接口；公网部署请配 HTTPS。
导出后京东类目是空的
说明这个关键词在映射表、离线库、AI 三路都没命中。补一条映射表最省事；或者检查 AI 配置是否可用。也可以先导出 CSV，人工补齐后再交。
切换账号后还是未登录
扩展在切换后会做免登录握手并真实请求确认，失败会自动回滚。仍然不行时：先在浏览器里手动登录一次目标账号，确认能进
i.taobao.com，再重新保存该账号快照。部分账号需要短信验证，自动化无法绕过。采集到的商品缺图片或价格
淘宝卡片是懒加载，滚动过快时图片还没就绪。把采集速度调慢，或开启「放慢节奏」。价格缺失通常是卡片被特殊布局覆盖，可在管理页手动改价。
数据存在哪？会不会丢？
存在浏览器的
chrome.storage.local。清理浏览器数据、卸载扩展会清掉，所以建议定期在管理页导出备份 JSON。Chrome 账号同步只同步关键词 / 店铺 / 设置，不同步商品。换电脑怎么迁移？
旧电脑导出备份 JSON → 新电脑安装扩展 → 打开管理页导入（支持合并或覆盖）。如果开了云同步，也可以在新电脑装好后从控制台导出备份 JSON 再导入。
密码忘了怎么办？
登录验证默认是关闭的。开启后忘记密码，只能清空扩展数据重设——先在扩展详情里导出数据（如果还能打开管理页），否则商品数据会一起丢失。
会不会被平台封号？
扩展做了拟人化点击、随机停顿、每小时上限、后台暂停等限制，但任何自动化都不能承诺零风险。控制采集频率、不要长时间无人值守跑、遵守平台规则，是更可靠的做法。
可以商用 / 分发给团队吗？
可以内部使用和分发给同事，把插件文件夹打包成 zip 即可。不要上传到 Chrome 应用商店，采集类扩展很容易触发平台规则被下架。