前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在将各类专业能力注入智能体。dsh-waimao 是一个专注于外贸获客流程的插件，由开发者 shine-233 维护。它将传统外贸中从「搜到线索」到「成交回款」的碎片化环节，整合进 DSH 的对话与工作流中，通过规则引擎、AI 评分和自动化执行，实现全链路的客户开发与管理。
安装与依赖¶
插件基于 @deepseek-ai/dsh 0.1.0-rc.7 插件面开发，无额外 npm 依赖。运行环境需满足 Node.js ≥ 22.13。
执行以下命令安装：
npx -y @deepseek-ai/dsh plugin --profile web add github:shine-233/dsh-waimao
安装后需重启 dsh web 服务。
核心能力¶
该插件覆盖了外贸开发信、线索挖掘、CRM 管理及合规风控的全套功能。
1. ICP 画像与线索挖掘¶
通过 icp_set 命令定义产品与买家画像。系统利用三层搜索策略（基础搜索、LinkedIn 职位定向、采购信号），结合 18 个市场预设，从 Google Maps 商家数据源中提取信息。搜索结果支持逐层去重与 CSV 导出。
2. 线索加工与评分¶
抓取的网页数据会经过规则引擎过滤，排除同行、B2B 平台、黄页等无效信息。系统使用 AI 对线索进行 0-12 分的评分，区分极高、高、中、低四个等级，并给出对口判断与开发建议。符合条件的线索会自动合并入 CRM。
3. 邮箱发现与验证¶
内置 35+ 种邮箱猜测模式，结合 MX 记录、SMTP RCPT 探测与 catch-all 检测，验证邮箱有效性。
4. 开发信与合规¶
开发信支持 DeepSeek 个性化生成与多语种模板（英/西/葡）。系统默认开启 dry-run 总闸，冷启动邮件需人工审批。支持 Spintax 变体、回复线程头、退订提示行及三层日上限控制（全局/每邮箱/预热池）。发送前会进行 SPF/DKIM/DMARC/MX 送达率体检。
5. 回复检测与跟进¶
通过 IMAP 扫描买家回复，先用正则过滤，模糊回复才调用 AI。AI 将回复细分为 12 类（如询价、拒绝、转介等），自动更新 CRM 状态并停止跟进序列。系统自动将退订客户加入抑制列表，退信整域名拉黑。
6. CRM 管线与 SOP¶
CRM 管线包含状态机管理（新→评估→触达→报价→成交/流失）。SOP 阶段机采用八阶段强制顺序，包含人工审批门，确保流程合规。
7. WhatsApp 与报价¶
集成 WhatsApp 功能，支持媒体消息发送与受控群发（随机间隔、每日上限、3 连败熔断）。提供零依赖的英文报价单 PDF 生成功能，可自动关联 CRM 客户档案。
8. 追踪、监控与预热¶
- 追踪：需配置公网入口以启用打开/点击追踪（像素注入、链接包裹、防开放重定向）。
- 监控：定时监控官网变化与意图信号，触发自动触达。
- 预热池：支持多收件箱互为预热，独立爬坡限额，误入垃圾箱自动恢复。
9. 集成与统计¶
- Instantly 直连：支持 OpenAPI v2，可推送线索与查看活动列表。
- 效果统计：提供漏斗转化、分层回复率、市场分布及打开率/点击率数据。
典型用法¶
- 设置画像：
icp_set（定义卖什么、找什么买家）。 - 完整获客流程：
sop_create->lead_search->lead_enrich->lead_score->email_compose->[人工审批]->email_send。 - 报价与触达：
kb_search（检索报价政策） ->quote_pdf->wa_send_media/email_send。
注意事项¶
- 安全性：所有 API key、邮箱密码仅存储于本地，Webhook 必须携带 token。追踪功能需要公网入口（如 Cloudflare Tunnel 或反向代理）。
- 合规性：使用时需遵守搜索引擎服务条款、CAN-SPAM/GDPR 邮件营销法规及 WhatsApp 服务条款。
- 权限与依赖：插件基于 DSH 进程运行，需注意 Evolution API 等第三方网关的配置。
