Telegram 会话桥 Boobaw/dsh-telegram-bot

dsh-telegram-bot

Listed on dsh-plugin.org

DeepSeek Harness 的 Telegram 客户端。它把 DSH 配置档连接到 Telegram 机器人，让同一批 DSH 会话在两个界面里都能用。

演示

首次配置：https://youtu.be/QEeVucfBsWk

内容包括安装、机器人 token、允许列表、/start、/sessions，以及一条测试提示词。

开启 Threaded 模式

BotFather：Bot Settings → Threaded mode → Enable。

功能

- 每个 DSH 会话对应一个 Telegram 话题；Web 和 Telegram 共用同一个会话。
- Telegram 只同步从 Telegram 发起的轮次；在 Web UI 里发起的轮次留在 Web。
- /sessions 列出工作区和已有会话，还能在选中的工作区里新建会话。
- 助手回答以 Telegram Markdown 格式流式输出到话题里。
- 推理过程和工具调用以临时消息显示，回答完成后删除。每条工具调用记录最多两行。
- 内联控件可切换模型、推理强度、权限模式和上下文用量。
- 工具审批带 Deny / Allow 按钮。
- 支持 ask_user_question：选项、多选、自定义回答和计划审核。
- 在会话话题里发送的文档和照片会存为 DSH 附件，并传给智能体。
- /last、/rename、/stop、/restart、/status 和 /menu。
- 机器人消息支持英文和俄文。
- 机器人 token 保存在 DSH 凭据存储里。

要求

- DSH 0.2.1-rc.2 或更新版本，Node.js 22+。
- 从 @BotFather 获取的 Telegram 机器人 token。
- 在 BotFather 里开启 Threaded mode，并在机器人聊天里开启 Topics。

安装

从本仓库安装：

npx @deepseek-ai/dsh plugin --profile web add .

从 npm 安装：

npx @deepseek-ai/dsh plugin --profile web add dsh-telegram-bot@latest

安装或更新插件后重启 dsh web。然后打开 Settings → Telegram。

配置

| 字段 | 含义 |
| Bot token | 从 @BotFather 获取的 token；保存在凭据存储里 |
| tokenRef | token 对应的凭据/环境变量名；默认 TELEGRAM_BOT_TOKEN |
| cwd | Telegram 创建的会话使用的工作目录 |
| agentPreset | 为 Telegram 会话挂载的预设；默认 standard |
| Allowed users | Telegram 用户 id 或 @usernames |
| Allowed chats | Telegram 聊天 id 或 @channelnames |
| Show model thinking | 在临时消息里显示推理过程 |
| Show tool calls | 在临时消息里显示工具调用 |
| Bot language | en（默认）或 ru |
| Enable bot | 启动或暂停 Telegram 轮询 |
token 字段只报告是否已配置 token。通过环境变量提供的 token 无法从页面上覆盖。

首次运行

1. 用 @BotFather 创建机器人，把它的 token 保存到 Settings → Telegram。
2. 在 @BotFather 里打开 Bot Settings → Threaded mode 并启用。
3. 打开机器人聊天，点机器人名字，启用 Topics。
4. 在 All 里发送 /start。允许列表为空时，机器人会回复你的 user id 和 chat id。
5. 把你的 user id 加到 Allowed users，按 Save。
6. 在 All 里发送 /sessions，选一个工作区，打开或新建会话。
7. 在新话题里发一条测试消息。

插件页面

插件页面只提供信息。它指向 Settings → Telegram，并列出需要手动配置的文件。用页面上的 bundle 开关启用或停用插件；Enable bot 是软暂停，插件仍保持加载，但停止轮询。

无头配置档

机器人可以脱离 Web UI 运行：

mkdir -p ~/.dsh/profiles/tg
cd ~/.dsh/profiles/tg

package.json：

{
"name": "dsh-profile-tg",
"private": true,
"dependencies": { "dsh-telegram-bot": "latest" },
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "dsh-telegram-bot"]
}
}
}

cordis.patch.yml：

- id: telegram-bot
name: dsh-telegram-bot
config:
enabled: true
allowedUsers: ["<user-id>"]
allowedChats: ["<chat-id>"]

安装并运行：

npm install
printf 'TELEGRAM_BOT_TOKEN=%s\n' '<token>' >> ~/.dsh/.env
chmod 600 ~/.dsh/.env
npx @deepseek-ai/dsh --profile tg

不要把 token 写进 cordis.patch.yml。

安全

- 机器人 token 存放在凭据存储里，不在配置档补丁里。
- Allowed users 为空时，只在私聊里回复配置提示。
- 群聊和频道聊天需要在 Allowed chats 里有对应条目。
- 不要用同一个 token 跑两个轮询器；Telegram 会返回 409 Conflict。
- DSH 插件与 Host 在同一进程内运行。只安装你信任来源的插件。

开发

不需要构建步骤。

npm install
node --check index.js
node --check client.js

index.js 是 Host 那一半：Telegram 轮询、话题路由和会话桥接。client.js 注册 Settings 页面和 Plugins 页面上的说明。插件不添加任何面向模型的工具或系统提示词文本；它把 Telegram 接到现有的 DSH 智能体上。

许可证

MIT

致谢

Markdown 转 Telegram 格式使用 telegramify-markdown（MIT）。