dsh-plugin-telegram-bridge

DeepSeek Harness 插件：Telegram 桥接 —— 在自己的 Telegram 里与 Harness 对话、控制电脑， 随时随地，无需同一局域网。桌面版侧边栏的「Telegram 接入」入口即来自本插件。

功能

• 侧边栏「Telegram 接入」：引导创建 Bot（@BotFather）、粘贴 Token、显示 t.me 二维码
• 消息桥接：Telegram 消息 → Harness agent（独立会话）→ 回复发回 Telegram
• 多会话管理（Telegram 指令）：

| 指令 | 功能 | |---|---| | /help /start | 查看全部指令 | | /new | 新建对话（独立上下文） | | /list | 查看对话列表（含标题） | | /use N | 切换到第 N 个对话 | | /info | 查看当前对话信息（标题/工作目录/最近消息） |

• 代理支持：自动检测系统代理（Windows 注册表 / macOS scutil / 环境变量），也可手动填写
• 回复合并发送（一轮输出一条消息）；黑白主题、中英文自动适配

安装（npx 一键）

npx dsh-plugin-telegram-bridge
# 自定义 DSH_HOME：
npx dsh-plugin-telegram-bridge --dsh-home D:/my-dsh

安装器会：

1. 把插件复制到 $DSH_HOME/profiles/web/node_modules/@dsh-desktop/telegram-bridge
2. 生成注入 patch：$DSH_HOME/telegram-bridge.patch.yml

然后启动：

dsh web --patch $HOME/.dsh/telegram-bridge.patch.yml --port 3080

配置：Harness 侧边栏「Telegram 接入」→ 粘贴 @BotFather 创建的 Token → 保存并连接。

网络需能访问 Telegram；国内环境建议配置本地代理（面板会自动检测系统代理，或手动填写）。

手动安装（不通过 npx）

npm install -g dsh-plugin-telegram-bridge
# 或从源码：
git clone https://github.com/yansenlei/dsh-plugin-telegram-bridge
cd dsh-plugin-telegram-bridge && npm install && npm run build
# 复制 lib/ 到 profile 的 node_modules 并注入 patch（同上）

工作原理

• 纯 HTTP 实现 Telegram Bot API（getUpdates 长轮询 + sendMessage + getMe）， 零第三方依赖、无需 webhook / 公网 IP。
• 消息经 createUserMessage + agent.followup() 注入独立会话；重启后从磁盘历史恢复。
• 回复通过 session/event 的 assistant/message 事件转发。
• 配置（Token/代理/会话列表）持久化在 $DSH_HOME/telegram.config.json。

开发

npm install
npm run build     # 产出 lib/client.js

许可

MIT