DeepSeek Harness 接入 Telegram：dsh-im 教程

快速开始

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

1. 安装 dsh-im。
2. 重启 dsh web，打开「设置 → IM机器人」。
3. 选择 Telegram，完成扫码或凭据绑定。
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 步 — 绑定 Telegram

先在 Telegram 里创建 Bot，再把 BotFather 返回的 Token 填入 DSH 的 Telegram 卡片。

1. 打开 @BotFather，发送 /newbot，按提示设置名称和用户名。
2. 复制 BotFather 返回的 Token，只粘贴到本机 DSH 设置，不要发给任何人。
3. 在 DSH 的 Telegram 页面选择访问模式。第一次建议使用 private-allowlist。

平台文档：BotFather。

第 3 步 — 发第一条任务

在 Telegram 与 Bot 的私聊 依次发送下面三条消息。第一条检查连接，第二条清掉旧会话，第三条才做真正的只读任务。

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

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

Telegram 常见问题

安全提醒

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