义可采集插件 0.2.0
Windows / macOS 通用 · Chrome / Edge 浏览器扩展
云端采集箱：https://collect.houhil.com

一、首次安装

1. 把 ZIP 完整解压到固定工作目录。
   Windows 建议使用 D:\CodexWork\义可采集插件；macOS 选择自己的固定工作目录。
   本包只包含浏览器扩展，不需要安装 Python 或启动本机接口。
2. Chrome 地址栏打开 chrome://extensions，Edge 打开 edge://extensions。
3. 开启“开发者模式”，点击“加载已解压的扩展程序”。
4. 选择本包内的“extension”文件夹，也就是包含 manifest.json 的文件夹。
5. 把“义可采集插件”固定到浏览器工具栏。

二、已有插件原位升级

如果已经安装旧版，请保持原安装目录，不要删除扩展或另装第二份。
先将旧 extension 文件夹完整备份，再把本包 extension 内的 7 个文件
覆盖到原 extension 文件夹。进入浏览器扩展管理页，点击该扩展的“重新加载”。
确认界面版本为 0.2.0，再打开采集箱。
原位升级保留浏览器中的采集记录、备注和连接；本安装包不会修改这些数据。
不要卸载扩展，也不要清除扩展存储。

三、云端连接只需设置一次

1. 使用获准的账号登录 https://collect.houhil.com。
2. 由管理员在网页中创建当前采集人员的“采集连接”，取得连接配置 JSON。
   此文件含个人采集连接密钥，请私下保存；不要放入共享安装包或发到商品页面。
3. 右键扩展图标打开“选项”或“采集箱”，展开“连接设置”。
4. 点击“导入连接配置”，选择管理员提供的 JSON 文件。
5. 页面显示待连接地址 https://collect.houhil.com 后，点击“授权并连接”。
   浏览器询问该网站访问权限时批准。插件只向这个固定域名申请云端权限。
6. 插件实际验证密钥成功后才保存配置，并自动发送浏览器中待传的商品与快照。
   后续不需要每次导出文件或重复输入密钥；更换电脑/浏览器或连接被撤销时需要重新配置。

如果从本机连接切换至云端：
商品、来源快照、备注和售价继续保留。旧服务的目标 ID 不会用于云端。
请在采集箱点击“按原店铺、品牌和站点重新匹配”，并重新选择默认采集目标。
云端已有店铺、品牌、站点能够匹配时直接归类；未登记的目标需要管理员先在网页登记。
插件采集连接不能创建云端店铺或站点，也不能导出全库；这些操作需管理员网页登录。
插件中的“复制/另存本地 JSON”和“导出交接资料”仍可用于自己的浏览器记录。

四、日常采集

1. 正常打开 1688 商品详情页：
   https://detail.1688.com/offer/商品ID.html
2. 等商品标题、图片和规格加载出来，需要的详情或尺码表先按页面正常方式展开。
3. 单击工具栏“义可采集插件”，商品资料先保存在浏览器，再自动同步到云端。
4. 打开采集箱查看实际送达结果、缺失字段和目标分类。断网或服务暂时不可用时，
   待传资料保留在浏览器；恢复后自动续传，也可点击“立即发送 / 重试”。

如果云端已经保存了相同或更新采集时间的不同商品版本，插件会校验来源后保留云端版，
显示“云端已有版本 · 已保留”，不使用浏览器旧字段覆盖它，也不会无限重传。
浏览器原字段保留供核对，来源快照独立上传。
未加载的详情、价格或 SKU 可能缺失；“已同步”不代表资料已完整或商品已上架。

五、常见情况

• 看不到云端授权按钮：先确认插件已重新加载为 0.2.0，再重新导入连接配置。
• 密钥无效或连接被撤销：请管理员重新创建连接，再导入新配置；商品队列仍保留。
• 目标未登记/需要管理员权限：到云端网页登记目标，再点击“读取接口目标”或重新匹配。
• 页面采集不完整：确认打开的是具体商品详情页，并检查源页面是否已加载所需内容。
• 浏览器队列达到 8 MB：先导出并整理记录，插件不会为了新采集自动删除旧资料。

本包不含账号、密钥、连接配置、商品数据库或采集记录。
本机兼容地址仍为 http://127.0.0.1:8765；只有继续使用本机服务时才需要原本机启动器。
