前言¶

在 DeepSeek Harness（DSH）日常开发中，Web 会话通常运行在本机 dsh web 里，离开电脑后不方便继续查看上下文或补一句指令。dsh-telegram-channel 是为 DSH 提供的 Telegram 手机遥控器：它附着本机正在跑的 Web 会话，让手机与电脑 Web 保持同轨迹、双向可见。

这是什么¶

dsh-telegram-channel 由 hi-wenw 维护，许可证为 MIT。它把 Telegram Bot 接到本机 dsh web 的当前会话上，用于手机查看会话、续接上下文、切换绑定会话的模型。

核心功能¶

下面介绍已核实的能力。

• Telegram 手机遥控器，附着本机正在跑的 Web 会话。
• 手机与电脑 Web 同轨迹、双向可见。
• 支持 /sessions，按工作区、会话列表并附着。
• 支持 /last，查看绑定会话的上次问答。
• 支持 /model，切换当前绑定会话模型，下一回合生效。
• 支持 /status、/unbind、/help 等 Bot 命令。
• 支持 token、allowedUserIds、allowAllUsers、maxMessageLength、pollingTimeoutSec、rendering 配置。
• 支持 Windows PowerShell、CMD、macOS/Linux 一键安装脚本。
• 支持通过 HTTP(S)_PROXY 访问 Telegram API。

安装前准备¶

需要准备：

• DeepSeek Harness（DSH），且本机已能跑通 dsh web
• Node.js，建议 >=22
• Telegram Bot Token
• 数字 User ID
• 可选：HTTP(S)_PROXY

不需要 Python。

安装与启用¶

可以直接使用插件安装命令：

dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel

这条命令会把 dsh-telegram-channel 添加到 web profile。

如果需要使用 Bot Token 和白名单，可以先设置环境变量：

export DSH_TELEGRAM_TOKEN='...'
export DSH_TELEGRAM_ALLOWED_USER_IDS='123456789'

然后执行：

dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel

DSH_TELEGRAM_ALLOWED_USER_IDS 是白名单；如果白名单都为空，谁都不能用。allowAllUsers 设为 true 仅用于调试。

一键安装脚本¶

Windows PowerShell：

irm https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.ps1 | iex

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.sh | bash

这些脚本用于在对应平台执行安装。也可以手工安装：设置 DSH_TELEGRAM_TOKEN 与 DSH_TELEGRAM_ALLOWED_USER_IDS 后，执行上面的插件安装命令。

典型用法¶

1、在电脑运行：

dsh web

2、手机对 Telegram Bot 执行 /sessions，选择工作区、会话后附着。

3、附着后，手机与 Web 走同一条会话轨迹；可用 /last 查看绑定会话的上次问答。

4、需要切换模型时，对 Bot 使用 /model，下一回合生效。

5、/unbind 只断开手机，不关闭电脑会话。

适用场景与注意¶

适合需要在电脑运行 dsh web 的同时，用 Telegram 手机查看会话、续接上下文、切换绑定会话模型的 DSH 使用者。

使用前需要注意：

• /model 需要 dsh web（apiProxy），并先通过 /sessions 绑定。
• Token 不要发到公开群；泄露后通过 BotFather /revoke 处理。
• allowedUserIds 白名单都为空时，谁都不能用。
• allowAllUsers 为 true 仅用于调试。
• 用户 patch 不要 insert 同名 id，应按 id 覆盖。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

结尾¶

dsh-telegram-channel 的价值是把手机 Telegram 变成本机 DSH Web 会话的遥控器，而不是另起一套会话。仓库地址：

https://github.com/hi-wenw/dsh-telegram-channel