前言¶
在 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