常见问题

1. 从官网 下载扩展包（wukong-2.0.0.rar），使用解压软件（WinRAR / 7-Zip）解压到任意文件夹。
2. 打开 Chrome 浏览器，地址栏输入 chrome://extensions/ 并回车。
3. 在扩展管理页面右上角，打开「开发者模式」开关。
4. 点击左上角出现的「加载已解压的扩展程序」按钮。
5. 在弹出的文件选择窗口中，选择第1步解压出的文件夹，点击确定。
6. 扩展安装完成！工具栏会出现悟空搜款图标。

Edge 浏览器：地址栏输入 edge://extensions/，其余步骤相同。

支持的浏览器（Chromium 内核）：

• Google Chrome（推荐，体验最佳）
• Microsoft Edge
• 360极速浏览器
• QQ浏览器
• 搜狗浏览器
• Brave / Vivaldi / Opera

不支持的浏览器：Firefox（Gecko内核）、Safari（WebKit扩展标准不同）。未来计划适配 Firefox（Manifest V3 兼容层），上线时间待定。

当前版本需要手动更新：

1. 从官网下载最新版本扩展包，解压覆盖原文件夹。
2. 打开 chrome://extensions/，找到悟空搜款。
3. 点击右下角的刷新按钮（圆形箭头图标）即可完成更新。

后续计划上架 Chrome 应用商店，届时可实现自动更新。关注微信通知获取版本更新消息。

请按以下顺序排查：

1. 确认页面是支持的平台：抖音电商（jinritemai.com）、淘宝、天猫、1688、拼多多、京东、搜款网（vvic.com）。其他网站不会显示搜图按钮。
2. 确认扩展已启用：打开 chrome://extensions/，悟空搜款的卡片应处于开启状态（蓝色/彩色），而非灰色禁用状态。
3. 等待页面加载完成：扩展在页面加载后 1-2 秒才开始注入按钮，请稍候。
4. 刷新页面：按 F5 或 Ctrl+R 刷新后等待 2-3 秒。
5. 检查商品图片区域：鼠标悬停在商品主图或缩略图上，搜图按钮应出现（部分平台是悬浮工具条形式）。

1. 鼠标悬停在商品图片上，搜图工具栏出现。
2. 点击工具栏的裁剪图标（剪刀形状）。
3. 在图片上拖拽框选商品的主体区域（建议排除背景、模特、水印、文字）。
4. 调整选区大小和位置确认后，点击裁剪工具栏的确认按钮。
5. 选择目标货源平台图标，系统将使用裁剪后的图片进行搜索。

技巧：纯商品主体的裁剪图搜同款命中率比整张商品图高 50% 以上。

可以，悟空搜款支持两种方式上传本地图片：

• 粘贴搜图：复制任意图片（右键复制图片、截图后Ctrl+C），在扩展弹窗中 Ctrl+V 粘贴即可搜索。
• 本地上传：在扩展弹窗中点击上传按钮，选择本地图片文件。

这在以下场景特别有用：手机拍了商品照片传到电脑、从微信/QQ收到的商品图、其他网站上的商品截图。

工具栏支持折叠功能：

• 点击工具栏右侧的上下三角箭头，可以将工具栏折叠为仅显示一行。
• 再次点击三角箭头可展开完整工具栏。
• 折叠状态会被记住（存于浏览器 localStorage），下次打开同样生效。
• 在扩展设置面板中还可以关闭不需要的平台，只保留常用的几个图标。

完全免费，永久免费。

以下功能全部免费：

• 跨平台一键以图搜款
• 图片裁剪精确搜图
• 剪贴板粘贴 / 本地上传搜图
• 10+ 货源平台同时支持
• 工具栏折叠与平台自定义

没有月费、没有使用次数限制、没有强制付费墙。截图上传到自有服务器等高级功能需要登录，但同样是免费的。未来如有商业化计划，现有功能将永久保持免费。

基础搜图功能无需注册、无需登录，安装后直接使用。

以下高级功能需要登录自有后端账号（ultra.btitib.com:83）：

• 截图上传到自有 OSS 服务器
• 采集入库管理等高级后台功能

注册方式：访问后台管理页面 → 点击注册 → 填写信息完成注册。

安全。悟空搜款遵循最小权限原则：

• 仅在您主动点击搜图按钮时，将当前商品图片的 URL 发送到目标货源平台。
• 不收集您的浏览历史、搜索记录、Cookie、账号密码、表单数据。
• 不监听您的键盘输入、页面浏览行为。
• 不在后台静默传输数据——所有网络请求都有明确的用户交互触发。

扩展的 Manifest V3 权限声明仅包含必要项：访问特定电商网站的内容脚本注入权限、跨域请求权限（搜图需要向货源平台 API 发请求）。不会访问与搜图无关的网站数据。

安装时 Chrome 会提示以下权限，每项都有合理用途：

• 读取和更改您在特定网站上的所有数据：用于在商品图片上注入搜图按钮和工具栏。仅限支持的电商网站域名。
• 与 cooperating 网站交换信息：用于向货源平台 API 发送以图搜款请求并获取搜索结果。

这些是 Chrome 对扩展的通用权限描述措辞，实际行为如上所述——仅在您操作时、仅对必要数据、仅向必要目标发送请求。

搜图来源（8大平台）：亚马逊、抖音电商、淘宝、天猫、1688、拼多多、京东、搜款网/唯品会

搜款目标（11+货源平台）：亚马逊(Stylesnap)、阿里巴巴(1688)、搜款网(vvic)、拼多多、淘宝、货捕头、17货源、青创网、京东、生意网(3e3e.cn)、爱搜鞋(sooxie)

搜图准确度说明：

• 不同平台的图片库和算法不同，同一个商品在不同平台搜索命中率可能有差异。
• 1688 和搜款网作为专业批发平台，商品库最全，命中率通常最高。
• 建议同款商品在 2-3 个平台上同时搜索比价。
• 使用裁剪功能精确选取商品主体，可大幅提升命中率。

如果搜出来的同款不太对，试试这些方法：

1. 使用裁剪功能：只框选商品主体，排除背景、模特脸、水印、logo 等干扰元素。
2. 换一个平台搜：不同货源平台的图片库侧重不同，1688 擅长服装鞋包，搜款网擅长女装，拼多多擅长日用品。
3. 用纯色背景的商品图：模特上身图、场景图比白底商品图更难匹配。
4. 多角度尝试：如果正面图没结果，试试切换到商品的侧面/细节图再搜。