HiWelink 外贸 AI 找客插件（HiwelinkFinder）功能与使用说明
版本：v1.0.0 品牌：HiWelink · 外贸 AI 找客 / 外贸客户开发 接口服务：https://www.hiwelink.com（云端登录、同步均强制走线上地址）
一、产品简介
HiwelinkFinder 是一款面向外贸 B2B 业务员的客户线索采集插件：从 Google / Bing 搜索、Google / Bing Maps、LinkedIn、Facebook、WhatsApp Web 及任意网站，一键提取名称、电话、邮箱、网址四大核心字段（辅助提取职位、地址、公司、社媒链接），本地暂存、云端同步并智能去重，客户线索统一沉淀到 Hiwelink 云端线索库。
二、功能特性
1. 多平台自动识别
打开页面后插件自动识别当前平台并在弹窗中标注：
| 平台 | 标识 |
|---|---|
| Google 搜索 | google_search |
| Bing 搜索 | bing |
| Google Maps | google_maps |
| Bing Maps | bing_maps |
| WhatsApp Web | |
| 其他任意网站 | generic_website |
2. 四大核心字段采集
- 名称：
og:title→ 页面标题 → H1 → 搜索结果显示卡 → Maps 商家名，逐级回退； - 电话：
tel:链接优先，页面文本正则扫描，Maps 商家电话；多个号码以;分隔保留； - 邮箱：
mailto:优先，页面正则扫描（自动过滤 example/test 等黑名单域名、no-reply 等无效邮箱），多邮箱仅取第一个为主，其余写入备注； - 网址/官网：显式"官网"链接 → 反查企业域名 → Maps 网站字段 → 页面根域名，统一去除协议前缀与尾部斜杠。
同时采集扩展字段：职位（job_title）、位置（location）、公司名（company）、社媒链接（linkedin/facebook/twitter/instagram/wa.me 等）。
3. 四种采集模式
| 模式 | 触发方式 | 行为 |
|---|---|---|
| 采集本页 | 弹窗「🚀 采集本页」/ 右键「采集本页线索」 | 秒级解析当前页面；搜索页则批量提取全部搜索结果线索 |
| 深度采集 | 弹窗「⛏️ 深度采集」/ 右键 | 自动发现页面中的 contact / about / team 链接，依次打开采集（最多 10 页，间隔 2 秒） |
| 深采搜索结果 | 弹窗「🔎 深采搜索结果」/ 右键（仅搜索页显示） | 打开搜索结果中每个网站（最多 10 站），逐一采集真实邮箱/电话 |
| 快速搜邮箱 | 弹窗「⚡ 快速搜邮箱」/ 右键（仅搜索页显示） | 对搜索结果域名执行 inbody:@域名 搜索引擎全文检索，不打开网站直接提取邮箱（并发 6，自动跳过搜索引擎/社交站自身域名） |
4. 本地暂存与去重
- 采集结果先进入本地待同步队列（chrome.storage 无限存储），断网也能继续采集；
- 队列内按「邮箱|电话|名称」自动去重，容量上限 5000 条（超出自动淘汰最早数据）；
- 待同步数量以红色徽标显示在插件图标上（超过 99 显示 99+）。
5. 云端同步与智能去重
- 点击「☁️ 同步」或右键「立即同步」上传（每 100 条分块，自动带
crawl_session_id批次号）； - 服务端按优先级合并：邮箱一致→合并更新（不覆盖商机金额/归属/星级等销售字段）、网址+名称相似→合并、仅电话一致→标记重复、无匹配→新增；
- 返回 新增/更新/跳过 统计；新线索自动发送系统通知；
- 每 30 分钟自动同步一次（需已登录且有待同步数据）；
- 每次同步写入采集历史（最近 200 条），可按批次追溯。
6. 同步队列管理页（manager.html）
点击弹窗「📋 管理队列」打开：
- 统计卡片：待同步线索 / 含邮箱 / 含电话 / 含网址 数量；
- 筛选与搜索：按名称/电话/邮箱/网址关键词搜索，按平台筛选；
- 批量操作：全选、删除选中、清空队列、单条删除；
- 立即同步与采集历史展示（时间、批次、新增/更新/跳过数）。
7. 右键菜单快捷操作
在任意网页右键即可使用：采集本页线索、深度采集本页、深采搜索结果各网站、快速搜邮箱（不打开网站）。
8. 账号体系
- 用户名/邮箱 + 密码登录；
- 未注册可跳转官网「注册并免费试用」；
- 登录状态云端校验，账号到期 / 停用 / 删除自动禁止采集与同步；
- 试用到期时弹窗提示联系管理员（邮箱 allen@hiwelink.com / 微信 18555112860）。
9. 清空本地数据
「🗑️ 清空本地数据」清除待同步队列与同步历史，保留登录状态，云端数据不受影响。
三、安装步骤
- 将下载的 ZIP 压缩包完整解压（不能直接在压缩包内安装）。
- 打开 Chrome 或 Edge 扩展程序页：
- Chrome：
chrome://extensions - Edge：
edge://extensions
- Chrome：
- 开启右上角开发者模式。
- 点击「加载已解压的扩展程序」，选择解压后直接包含 manifest.json 的 HiwelinkFinder 文件夹。
- 点击浏览器工具栏插件图标，登录 Hiwelink 账号即可开始使用。
更新旧版本：将新版文件覆盖到原插件文件夹，再到扩展程序页点击「重新加载」。不要先卸载旧插件，以免清除本地登录状态与待同步队列。
四、使用说明
1. 登录
- 点击插件图标 → 输入用户名/邮箱与密码 → 登录；
- 无账号点击「注册并免费试用」跳转 www.hiwelink.com/register 注册。
2. 采集当前页
- 打开目标网站（或 Google/Bing 搜索结果页、Maps 商家列表等）；
- 点击插件图标 → 「🚀 采集本页」；
- 查看统计（名称/电话/邮箱/网址数量），结果自动进入待同步队列。
3. 深度采集
在客户官网等页面点击「⛏️ 深度采集」，插件自动发现并打开 contact / about / team 等子页面逐页采集，聚合更完整的联系方式。
4. 深采搜索结果（搜索页专用）
在 Google/Bing 搜索结果页点击「🔎 深采搜索结果各网站」，后台依次打开结果网站采集真实邮箱/电话，适合把搜索结果批量转成线索。
5. 快速搜邮箱（搜索页专用）
点击「⚡ 快速搜邮箱」，对搜索结果域名执行搜索引擎全文检索，直接提取该域名下公开邮箱，不打开任何网站，秒级完成。
6. 同步到云端
- 点击「☁️ 同步」手动立即同步；
- 或等待每 30 分钟自动同步；
- 同步完成后查看新增/更新/跳过数量，新线索通知；
- 登录 www.hiwelink.com → 用户中心 → 联系人/线索 即可查看云端沉淀的客户数据。
7. 管理待同步队列
点击「📋 管理队列」：
- 查看待同步线索（含名称/联系方式/平台标签）；
- 按关键词或平台筛选，勾选删除不需要的数据；
- 点击「☁️ 立即同步」批量上传。
五、采集节奏与合规提示
- 安全延迟：深度采集、搜索深采默认每个网站间隔 2 秒，快速搜邮箱带并发节流，避免触发平台风控；
- 请在合理频率下使用，特别是 LinkedIn / Facebook 等平台，短时间大量请求可能导致账号受限；
- 采集数据仅用于您自身的客户管理工作，支持随时在云端导出或删除。
六、常见问题（FAQ）
Q1：为什么插件图标上一直有红色数字？ 红色数字 = 待同步队列条数。点击插件 → 「☁️ 同步」上传到云端后即消失；也可在「管理队列」中清理。
Q2：采集不到邮箱？ 网站本身未公开邮箱时无法提取；可尝试「深度采集」或「快速搜邮箱」补充；部分网站做了邮箱混淆/图片化，需要到页面内查看。
Q3：提示"账号已失效 / 请重新登录"？ 登录状态已过期或账号被停用/到期。重新登录；试用到期请联系管理员 allen@hiwelink.com。
Q4：同步时提示失败？ 确认网络正常且接口地址为 https://www.hiwelink.com；失败数据会保留在本地队列，恢复后可重新同步。
Q5：同步后云端没看到数据？ 登录 www.hiwelink.com → 用户中心 → 联系人/线索 查看；注意区分"本插件同步"与"社媒聊天采集"两个入口，线索归属当前登录账号。
Q6：换电脑/重装插件后数据会丢吗？ 请先同步到云端再重装。重装后登录同一账号，云端线索仍在；本地未同步队列无法自动恢复。
七、技术说明（可选）
- 云端地址强制为
https://www.hiwelink.com（存储中出现其他地址一律回退，防本地环境串线）； - 同步接口：
POST /api/v2/leads/sync（每批 100 条，Bearer Token 鉴权）； - 本地存储键：
hiwelink_finder_cloud（登录态）、hiwelink_finder_pending（待同步队列）、hiwelink_finder_history（同步历史）； - WhatsApp 采集通过注入
wa-bridge.js（WPP 库）读取会话联系人，仅在你打开 web.whatsapp.com 时生效。