前言¶
在 DeepSeek Harness（dsh）里做联网或即时通讯类智能体时，常见做法是自建桥接服务或手动在多个界面之间切换。WhatsApp 没有面向个人开发者的通用 HTTP API，要在对话里「查未读、归纳群聊、代发一条消息」，往往需要额外中间层，并把账号绑定、鉴权与发送确认单独维护。
Wapliss 提供托管的 WhatsApp 网关，以 Model Context Protocol（MCP）对外暴露工具；仓库 proteuscrypto/wapliss-for-deepseek 是 Wapliss 面向 DeepSeek Harness 的官方配置包，只把 dsh 指向 https://wapliss.com/mcp/v1，不在本地存放消息或凭据。下面介绍其定位、能力、安装步骤与使用注意。
这是什么¶
Wapliss 由 NetDigitalTech LLC 运营，用户用手机号扫码绑定 WhatsApp 后，经 MCP 服务器让助手读取会话与群组、在确认后发送消息及附件。本插件（npm 包名 dsh-plugin-wapliss，版本 1.0.1，MIT 许可证）是「仅含配置的 dsh 捆绑包」：通过 cordis.patch.yml 注入一行 @deepseek-ai/dsh-mcp-client，连接托管 MCP；GitHub 维护组织为 proteuscrypto，与 SkillHub 目录「联网工具」分类一致。
DeepSeek 网页聊天与移动端应用不支持 MCP 连接器；本插件适用于 dsh web、TUI 与 headless 模式下的 DeepSeek V4 智能体。自建的 DeepSeek API 智能体也可按 Wapliss MCP 集成说明 使用同一服务。
核心功能¶
插件侧通过 MCP 暴露 16 个工具，在对话中以 mcp__wapliss__* 名称出现，按 README 划分如下：
- 会话与历史：
get_chats、get_chat_history、get_message— 列出与搜索会话，按序读取聊天或群组，获取单条消息。 - 最近动态：
get_last_incoming_messages、get_last_outgoing_messages— 跨会话查看近期收、发消息。 - 群组信息：
get_group— 名称、描述、管理员与成员。 - 发送：
send_text_message、send_image、send_document、send_audio、send_video、send_location、send_contact、send_poll、forward_messages— 文本、通过公开 URL 传文件、位置、名片、投票与转发。 - 账号：
get_account_status— 套餐、绑定号码、当日用量与配额。
发送类工具在 MCP 上标注为 destructive，智能体在收件人或正文不明确时会先确认；发送成功表示消息已入队（返回 queue_id），未必已送达。各工具还带有 readOnlyHint 等注解，便于客户端区分只读与写操作。
工作原理简述¶
DeepSeek Harness (dsh web / tui / headless, DeepSeek V4)
| @deepseek-ai/dsh-mcp-client, Streamable HTTP
| Authorization: Bearer $WAPLISS_API_KEY
v
https://wapliss.com/mcp/v1 (MCP 2026-07-28 和 2025-11-25)
|
Wapliss WhatsApp engine ---> WhatsApp
未设置环境变量 WAPLISS_API_KEY 时，补丁中的 Wapliss 行保持 disabled，dsh 照常启动且不会向 Wapliss 发起请求。
安装与启用¶
前置条件：DeepSeek Harness 版本满足 >=0.2.2-rc.1（README 标注在 dsh 0.2.2-rc.1 上测试通过）；在 Wapliss 注册免费账号并完成 WhatsApp 绑定。
- 在 wapliss.com 注册，并在 wapliss.com/app/connect 绑定手机。
- 在 Settings → API keys（wapliss.com/app/settings#api-keys）创建个人 API key；密钥仅显示一次，请妥善保存。
- 写入本地环境并安装插件、启动 Web UI：
echo 'WAPLISS_API_KEY=wp_live_your_key' >> ~/.dsh/.env && chmod 600 ~/.dsh/.env
npx -y @deepseek-ai/dsh plugin --profile web add "github:proteuscrypto/wapliss-for-deepseek#main"
npx -y @deepseek-ai/dsh web
也可在 dsh Web UI 的 Settings → Plugins → Add 中填写 github:proteuscrypto/wapliss-for-deepseek#main。
安装后可用自然语言请求 “Check my Wapliss account” 验证工具是否加载。README 还提供可选技能目录复制：
mkdir -p ~/.agents/skills && cp -r skills/wapliss-whatsapp ~/.agents/skills/
（skills/wapliss-whatsapp 为插件包内路径，执行前需先 cd 到该目录所在根路径。）
典型用法¶
README 中的示例提示可按目标直接复用（会话名与 WhatsApp 中一致，或使用带国家码的号码）：
| 目标 | 可向智能体这样说 |
|---|---|
| 查看近况 | Show me my latest WhatsApp messages |
| 归纳群聊 | Summarize what was said today in my family group |
| 读指定对话 | Read my last 20 messages with Ana and tell me what she needs |
| 群管理员 | Who are the admins of the work group? |
| 发消息 | Send ‘On my way, 10 minutes’ to +1 555 010 2030 |
| 发文件 | Send this PDF to Laura: https://example.com/quote.pdf |
| 发位置 | Send the office location to the project group |
| 投票 | Create a poll in the team group: Friday or Monday? |
| 查账号 | Check my Wapliss account and today’s usage |
中文指令在具备 MCP 工具的会话中同样可行，关键是明确群组名、联系人或号码。
适用场景与注意¶
适合谁：已在 dsh 中使用 DeepSeek V4、希望用同一套 Harness 读 WhatsApp、做摘要或在确认后代发消息与附件的开发者或个人用户。Wapliss 提供免费套餐起步，无需信用卡（以 Wapliss 当前政策为准）。
环境与权限：插件以当前 dsh 进程的用户权限运行；API key 存放在 ~/.dsh/.env，请勿在对话中粘贴密钥、二维码或会话数据。安装前应阅读 GitHub 仓库 源码、cordis.patch.yml 与 MIT 许可证，确认补丁内容符合你的安全策略。
产品边界：Wapliss 通过「关联设备」方式连接号码，类似 WhatsApp Web，并非 Meta WhatsApp Business Platform；智能体仅在用户请求时操作，拒绝批量或未请求的骚扰式发送。消息存放在你的 Wapliss 私有账号中，助手读取的内容会经其 AI 提供方处理，详见 隐私政策。可在 Wapliss 控制台随时撤销授权；服务侧还有每日套餐配额与每分钟每用户 60 次 MCP 调用等限制。
生态说明：DeepSeek Harness 奉行「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek 或幻方无官方从属关系。
结尾¶
proteuscrypto/wapliss-for-deepseek 把 WhatsApp 能力收敛为 dsh 里一组可确认的 MCP 工具，配置量小、凭据不进对话。若要查阅目录说明或提交 issue，可分别打开 SkillHub 目录页 与 GitHub 仓库；更完整的 DeepSeek 集成步骤见 wapliss.com/integrations#deepseek。
