DeepSeekDSH
修复报错EnglishGitHub
菜单
独立社区指南与 DeepSeek 无隶属关系。
首页教程

DeepSeek Harness 接入 WhatsApp：dsh-im 教程

通过社区插件 dsh-im，从 WhatsApp 向本机 DSH 发送任务。先区分 Desktop、npx 与全局 CLI，再完成绑定、只读验证和访问限制检查。

维护：DeepSeekDSH（独立站点）资料整理参考版本：dsh-im 35f7e790
本页内容
前提：本机 DSH 已经能正常回复

先在本机测试文件夹完成一次只读任务，再按你的安装方式添加插件、绑定平台。 首次任务指南 →

第 1 步 — 按安装方式添加 dsh-im

只选下面与你当前安装相同的一条路线。检查插件与 Harness 版本兼容性，并使用同一个运行中的 Web Profile。不要为了安装插件开启局域网访问。

官方 Desktop 用户

如果当前构建的应用内插件管理中可找到 @xmanrui/dsh-im，核对兼容性后安装并重启。找不到该入口时，先按 Desktop README 核对本机版本的插件支持；本页没有该构建的安装验证记录。需要继续使用本教程时，可以按 Web UI 插件安装路线 建立独立 Web Profile，再使用下面的 npx 步骤。该路线会启动单独的 Web UI。

我用 npx 启动 DSH（没有全局 dsh 命令）

与安装教程保持相同的 npx 前缀。先检查版本，再安装并重新启动：

npx @deepseek-ai/dsh --version
npx @deepseek-ai/dsh plugin --profile web add -w @xmanrui/dsh-im
npx @deepseek-ai/dsh web

逐条执行。如果原先在包名后固定了 @版本号，这三条命令都使用同一个版本，不要在排错过程中混用版本。

我已安装全局 CLI，dsh 命令可用

仅在 dsh --version 正常显示版本时使用：

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

找不到 dsh 时，回到上面的 npx 路线，不要为了修复此教程而修改系统权限。

测试尚未发布的源码版本（高级）

普通安装不需要这条路线。作者提供以下源码安装命令；它会下载并构建 Git 依赖，执行前先阅读源码和构建脚本。

npx -y github:xmanrui/dsh-im install

安装并重启后打开「设置 → IM机器人」，确认当前 Profile 出现对应平台卡片。

第 2 步 — 绑定 WhatsApp

本教程使用 WhatsApp Web 关联设备流程，默认仅账号自聊触发 DSH。

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

这不是 Meta WhatsApp Business Cloud API。 已连接设备说明

第 3 步 — 验证只读任务与访问限制

先在机器人卡片中，把工作区设为不含密钥的测试文件夹，并选择已配置的模型。机器人的工作区独立保存，不一定与当前 Web 对话相同。

在WhatsApp 的“给自己发消息”对话中逐条发送以下消息，收到回复后再发下一条。

发给机器人
/status
/new
只读任务：列出当前工作区根目录的文件名，不要修改任何文件。
  1. /status 检查连接状态，不代表模型已成功执行任务。
  2. /new 解除当前聊天与旧会话的绑定，不删除旧会话；下一条普通消息创建新会话。
  3. 打开 DSH 中的新会话与工具记录，对照本机测试文件夹：路径正确、文件名一致，而且没有任何文件被修改。
  4. 配置了白名单时，用你管理的另一个未授权测试账号发送无副作用消息，确认不会触发任务。不要向不认识的人发送测试消息。
通过标准

连接有回应、工作区正确、文件列表与本机一致、文件未改动、访问限制有效。只收到 /status 不能算全部通过。

WhatsApp 常见问题

插件页面没有出现

确认插件装在当前运行的 Profile。重启 DSH Desktop，或使用安装时同一命令前缀重启 Web UI，再打开「设置 → IM机器人」。

卡片一直离线

检查本平台的二维码或关联会话是否失效，刷新绑定并查看本机日志。

收到消息但没有任务回复

先发 /status，再直接在本机 DSH 中检查模型、工作区、Agent Preset 与工具权限。分享日志前移除凭据。

关联设备掉线

确认手机上的关联设备状态。仅在确认旧会话不再使用后移除并重新扫码，首次保留 self-only。

安全提醒

  • WhatsApp 关联会话和认证目录都是敏感凭据，不要提交 Git、公开截图或发到群聊。泄露后应在对应平台撤销或更换。
  • 先用没有生产密钥的测试工作区，并保持最小访问范围。IM 消息可能触发本机文件、命令和工具。
  • dsh-im 是社区插件，不是各聊天平台的官方集成。升级前重新检查作者 README、兼容性与变更记录。
  • WhatsApp Web/Baileys 不是 Cloud API，业务使用前需另行评估账号与协议风险。
本页依据与适用范围

固定版本 dsh-im README、渠道源码、平台文档、Desktop README

参考快照：35f7e790。内容更新日期不代表重新安装验证；界面或版本不同时，以你安装版本的 README 为准。