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

DeepSeek Harness 接入 Telegram：dsh-im 教程

通过社区插件 dsh-im，从 Telegram 向本机 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 步 — 绑定 Telegram

先创建 Telegram Bot，再将凭据填入本机 DSH 的 Telegram 卡片。

  1. 打开 @BotFather，发送 /newbot，按提示设置名称和用户名。
  2. 复制 BotFather 返回的 Token，只粘贴到本机 DSH 设置，不要公开或写进截图。
  3. 先取得你的数字用户 ID，按下方说明操作。保存访问模式 private-allowlist，在该机器人卡片的私聊白名单用户 ID 中填入这个数字；用户名不能代替它。
  4. 保存设置并连接，再打开机器人私聊发送 /start，继续完成第 3 步只读验证。白名单未保存前不要接入公开群。
怎样取得 Telegram 数字用户 ID？
  1. 使用你新建的测试机器人。先在 DSH 中停止它，并关闭使用同一 Token 的其他轮询程序。
  2. 在 Telegram 私聊这个机器人，发送 dsh-id-check。
  3. 下载下方本机脚本。电脑需已有 Node.js 22 或以上；在下载目录运行命令，按提示输入 Bot Token，输入不会回显或写入文件。
  4. 复制输出的 Telegram user ID 到该卡片的白名单用户 ID，保存后重新连接，再测试 /status。脚本只查询官方 Bot API；遇到已有 webhook 会停止，不会删除它。

下载用户 ID 查询脚本 ↓

node get-telegram-user-id.mjs

Node.js 是这个辅助脚本的前置条件，Desktop 安装本身不要求另装 Node.js。若返回没有测试消息，先确认发给的是同一个机器人，并已停止其他轮询，再发送一次测试文字。 getUpdates

BotFather 官方说明

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

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

在Telegram 与 Bot 的私聊中逐条发送以下消息，收到回复后再发下一条。

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

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

Telegram 常见问题

插件页面没有出现

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

卡片一直离线

检查 Bot Token 是否有效、本机能否访问 Telegram Bot API，以及是否有重复运行的机器人进程。

收到消息但没有任务回复

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

getUpdates 没有消息

检查是否存在 webhook 或另一个轮询程序。Telegram 的 getUpdates 与 webhook 不能同时消费更新。先确认旧程序用途，不要随意删除正在使用的 webhook。

安全提醒

  • 机器人 Token都是敏感凭据，不要提交 Git、公开截图或发到群聊。泄露后应在对应平台撤销或更换。
  • 先用没有生产密钥的测试工作区，并保持最小访问范围。IM 消息可能触发本机文件、命令和工具。
  • dsh-im 是社区插件，不是各聊天平台的官方集成。升级前重新检查作者 README、兼容性与变更记录。
本页依据与适用范围

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

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