Telegram 远程控制 datit309/dsh-telegram-bridge

dsh-telegram-bridge

为 DeepSeek Harness（DSH）提供完整的 Telegram 双向远程控制、实时进度跟踪，以及系统原生通知。

把手机变成本地 DSH 智能体的远程编程驾驶舱：发送文本提示词、语音消息、截图，查看实时 diff，切换模型/会话，执行 shell 命令，审批工具，下载生成的交付物。

核心功能

1. 通过 Telegram 双向远程控制

- 💬 远程提示：在 Telegram 里发送任意文本消息，Mac 上活跃的智能体立即接收并执行。
- 🎙 语音转文本：按住录制语音消息（.ogg）。机器人用 ffmpeg + Gemini 语音转文本，把音频转成干净的文本提示词交给智能体。
- 📷 视觉 / 截图：发送终端或 UI 的 bug 截图，可附说明文字；智能体解析图片并修复代码。
- 📁 文档上传：把 .pdf、.sql、.json、.py、.js、.txt 文件直接发到智能体工作区。
- ⚡ 实时进度卡片：在单条消息里动态更新工具执行步骤（read、edit、bash、serena 等），配合输入状态提示，避免通知刷屏。
- 🔘 回合结束操作栏：每轮完成后附带一键内联按钮：[ 📄 View Diff ]、[ 📁 Modified Files ]、[ 🚀 Git Status ]、[ 🔇 Mute/Unmute ]、[ 🔄 New Session ]。

2. 源码与系统管理

- 📄 实时 Git Diff（/diff）：在当前工作区内查看已暂存和未暂存的详细代码改动。
- 🚀 Git 提交与推送（/commit <message>）：直接在手机上运行 git add -A && git commit -m <msg> && git push。
- 💻 直接执行 Shell（/sh <command>）：在本地运行终端命令（如 git status、pnpm test、docker ps、pm2 status），不消耗任何 LLM token。
- 📥 一键下载文件（/get <file>）：在 /files 里一键下载宿主机文件，或用 /get <path> 指定路径。
- 🎁 交付物自动发送：智能体调用 present 工具时，生成的交付物自动上传到你的 Telegram 聊天。

3. 会话与工作区导航

- 📋 会话切换（/sessions、/switch <index>）：列出所有打开的 DSH 会话，用内联按钮或索引切换当前目标。
- 📂 工作区切换（/workspaces、/cd <path>）：浏览项目目录，随时切换工作目录。
- 🧠 模型切换（/model）：用交互式内联按钮在多个模型之间切换（Gemini 3.8 Flash、Claude 4.6 Sonnet、GPT-6 Astra 等）。
- 🔄 新建会话（/new）：在当前工作区里开一个新会话。

4. 交互式权限与安全

- 🛡 工具审批按钮：智能体申请更高权限（approval/asked）时，机器人弹出 [ ✅ Allow ] 和 [ ❌ Reject ] 提示。
- ❓ 用户提问（ask_user_question）：智能体提问时，提供交互式单选/多选按钮。
- 🔒 Chat ID 锁定：只有授权的 Telegram chat ID 才能交互；未授权访问会收到 403 响应。

5. 原生系统音频与桌面通知

- 🔊 系统音频：通过 afplay 播放 macOS 原生提示音（成功时 Hero.aiff，出错时 Basso.aiff，提示词/审批时 Ping.aiff）。
- 🔔 桌面横幅：macOS 通知中心横幅，显示项目名、执行时长和修改过的文件列表。
- 🔇 远程静音（/mute、/unmute）：需要安静时，用手机把 Mac 扬声器静音。

Telegram 命令参考

| 命令 | 说明 |
| 发送语音消息 | 把语音转成文字，作为提示词派发 |
| 发送图片 + 说明文字 | 附上截图，让智能体看图修 bug |
| 发送文档 | 把代码或文档上传到工作区做分析 |
| /diff | 显示当前工作区的 git diff |
| /commit <msg> | 提交改动并推送到 git 远程仓库 |
| /sh <command> | 直接在宿主机上运行 shell 命令（0 token） |
| /get <file> | 从宿主机下载文件到 Telegram |
| /files | 列出最近修改的文件，附一键下载按钮 |
| /workspaces | 列出可用工作区，附快速切换按钮 |
| /cd <path> | 切换智能体的工作目录 |
| /model | 打开交互式模型选择菜单 |
| /sessions | 列出已打开的会话，附快速切换按钮 |
| /switch <index> | 按索引或 ID 切换会话 |
| /mute | 静音 Mac 扬声器声音 |
| /unmute | 取消静音 Mac 扬声器声音 |
| /new | 新建会话 |
| /status | 显示智能体、会话、工作区和扬声器的状态 |
| /stop | 立即中止智能体当前回合 |
| /help | 显示帮助信息和命令列表 |

前置条件

1. Telegram Bot Token：通过 @BotFather 创建。
2. 音频 / 语音转文字（可选）：
- 宿主机上已安装 ffmpeg（例如 brew install ffmpeg）。
- 本地运行 BeeRouter，监听端口 20128（或使用兼容 OpenAI 的语音/对话端点），用来转写收到的语音消息。
3. 安全与 Chat ID 锁定：
- 如果没配置 chatId，第一个给机器人发消息的人会被自动认领并锁定为所有者。
- 公开或共享的机器人，启动前要显式配置 chatId，防止被他人抢先认领。

DSH 安装指南

方式 1：通过 DSH 命令行（推荐）

在终端运行标准的 dsh plugin add 命令：

Install directly from GitHub into your active profile (e.g. web)
dsh plugin --profile web add github:datit309/dsh-telegram-bridge

或者从本地检出安装：

Clone the repository
git clone https://github.com/datit309/dsh-telegram-bridge.git ~/dsh-telegram-bridge

Install into DSH profilebash
dsh plugin --profile web add ~/dsh-telegram-bridge

dsh plugin add 会自动把依赖写进 ~/.dsh/profiles/web/package.json，并在 dsh.profile.bundles 中启用对应的 bundle 层。

方式 2：通过 DSH Web GUI

1. 打开 DeepSeek Harness Web GUI（http://127.0.0.1:3080）。
2. 点击最左侧边栏的 插件图标（拼图）。
3. 点击右上角的 Add plugin。
4. 输入 GitHub 仓库标识： text github:datit309/dsh-telegram-bridge
5. 点击 Install。插件会自动下载、打包并启用。

方式 3：手动配置（本地开发）

1. 把包加进 ~/.dsh/profiles/web/package.json： json {
"dependencies": {
"dsh-telegram-bridge": "file:/path/to/dsh-telegram-bridge"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-telegram-bridge"
]
}
}
}

2. 软链到 node_modules（本地开发、没跑 pnpm install 时用）：bash ln -sf /path/to/dsh-telegram-bridge ~/.dsh/profiles/web/node_modules/dsh-telegram-bridge

3. 在 ~/.dsh/profiles/web/cordis.patch.yml 中启用：yaml
- id: dsh-telegram-bridge
name: "dsh-telegram-bridge"

配置

方式 1：~/.dsh/telegram.json（推荐）创建或编辑 ~/.dsh/telegram.json：json { "token": "YOUR_TELEGRAM_BOT_TOKEN", "chatId": "YOUR_TELEGRAM_CHAT_ID" }

自动配对：chatId 留空，然后用手机给机器人发 /start。机器人会自动锁定你的 chat ID。

方式 2：DSH Web GUI 进入 Settings（左下角齿轮图标）➔ Telegram & Notifier：配置 Token、Chat ID、声音与通知开关，然后点击 Save。

方式 3：环境变量bash
export TELEGRAM_BOT_TOKEN="YOUR_TELEGRAM_BOT_TOKEN"
export TELEGRAM_CHAT_ID="YOUR_TELEGRAM_CHAT_ID"

运行

重启 DSH web 服务： bash

If dsh web is currently running, stop it with Ctrl+C, then:

dsh web

在手机上打开 Telegram，找到你的机器人，发送 /start。

许可证

MIT