DeepSeek Harness 接入 WhatsApp：dsh-im 教程

快速开始

如果你已经安装好 DSH，直接从第 1 步开始。整个流程的结果应该是：平台消息进入本机 DSH，DSH 完成任务，再把回复发回原平台。

1. 安装 dsh-im。
2. 重启 dsh web，打开「设置 → IM机器人」。
3. 选择 WhatsApp，完成扫码或凭据绑定。
4. 发送 /status，再发送一条只读任务。

第 1 步 — 安装 dsh-im

在安装了 DSH 的同一台电脑上运行。作者推荐 npm 已发布稳定版。

dsh plugin --profile web add -w @xmanrui/dsh-im

安装完成后，重启 Web Profile：

dsh web

如果终端提示没有 dsh 命令，可以把命令前缀换成 npx @deepseek-ai/dsh。不要把下面的 GitHub 源安装当成默认方案；只有要试用最新未发布代码时才用它：

npx -y github:xmanrui/dsh-im install

然后刷新浏览器，进入「设置 → IM机器人」。完整原文：dsh-im README。

第 2 步 — 绑定 WhatsApp

WhatsApp 走 dsh-im 的 WhatsApp Web 关联设备流程。默认只有账号自聊会触发 DSH。

1. 打开 DSH「设置 → IM机器人 → WhatsApp」，让页面显示二维码。
2. 手机打开 WhatsApp「设置 → 已连接设备 → 连接设备」。
3. 用手机扫描 DSH 页面二维码，等待卡片显示在线。
4. 保留默认的 self-only，先在 WhatsApp 的“给自己发消息”对话里测试。

这是关联设备方案，不是 Meta WhatsApp Business Cloud API。平台说明：WhatsApp 已连接设备。

第 3 步 — 发第一条任务

在 WhatsApp 的“给自己发消息”对话 依次发送下面三条消息。第一条检查连接，第二条清掉旧会话，第三条才做真正的只读任务。

/status
/new
只读任务：列出当前工作区根目录的文件名，不要修改任何文件。

1. `/status` 应返回当前机器人与 DSH 的连接状态。
2. 第三条消息应收到最终回复，同时在 DSH Web 中出现新的 Session。
3. 再用未授权账号测试一次，确认它不会触发任务。

WhatsApp 常见问题

安全提醒

• Token、App Secret、二维码会话和 WhatsApp 认证目录都是凭据，不要提交 Git 或发到公开聊天。
• 先用没有生产密钥的测试工作区，并保持最小访问范围。IM 消息可能触发本机文件、命令和工具。
• dsh-im 是社区插件。升级前重新看作者 README 和变更记录，不要把社区方案当作平台官方集成。
• WhatsApp Web/Baileys 不是 Cloud API；业务级使用前先评估账号和协议风险。