在 DeepSeek Harness (DSH) 的生態中，插件是擴展能力的主要方式。對於需要通過 Telegram 進行交互的場景，手動集成較爲繁瑣。winada82/dsh-telegram-bridge 插件提供了一個配置包，通過一個工具調用即可完成 Telegram 與 DSH 之間的橋接。
插件簡介¶
這是一個由 winada82 維護的 DSH 配置包，包含了一個 Telegram ↔ DSH 的橋接工具。安裝後，DSH 模型將獲得 install_telegram_bridge 工具，用於註冊和啓動橋接。該插件遵循 MIT 許可證。
核心功能¶
插件提供以下核心能力：
- 消息路由：長輪詢 Telegram Bot API，將收到的聊天消息路由至 DSH 子代理，並將代理回覆發送回原始聊天。
- 交互反饋：在處理過程中提供實時狀態指示，包括輸入動作和可編輯的“⏳ Processing…”消息，並附帶已用時間。
- 命令支持：內置多個命令，包括交互式內聯鍵盤的
/model（切換模型）、/new（開啓新對話）、/reset（清除上下文）以及/status（檢查橋接健康狀態）。這些命令會自動註冊到 Telegram 客戶端的/建議菜單中。 - 診斷支持：在主機可寫工作目錄中持久化保存診斷文件（
.tg-bridge-diag.json），可用於檢查週期、錯誤和解析後的沙盒策略。
安裝與啓用¶
在希望使用該插件的 DSH profile 目錄下執行以下命令：
dsh plugin add github:winada/dsh-telegram-bridge
安裝完成後，需要重啓 DSH 進程或重新加載配置，install_telegram_bridge 工具纔會生效。
配置與使用¶
使用前需準備一個 Telegram Bot Token（可在 @BotFather 創建）以及至少一個允許的聊天 ID（可用 @userinfobot 查詢）。
在 DSH 會話中，向模型發送如下指令：
Install the Telegram bridge. My bot token is “
: ” and my chat id is “5805491987”.
模型將調用 install_telegram_bridge { bot_token, allowed_chat_ids: [...] } 工具。工具返回新的 Plugin ID 和 Package ID 後，橋接即刻開始輪詢。
若需更換 Token 或調整允許列表，再次請求模型運行 install_telegram_bridge 即可。
環境要求¶
該插件使用 pwsh Invoke-WebRequest 進行 HTTPS 通信。由於需要訪問 api.telegram.org，必須確保當前會話的解析會話策略允許子進程進行 TLS 連接。默認的 workspace-write 策略會阻塞該連接，因此需要將策略設置爲 danger-full-access（或等效值）。
如果未滿足此要求，安裝過程會成功，但輪詢將因 SSL 連接失敗而中斷。此時可檢查 /status 命令的回覆以及 profile 的 cordis.patch.yml 中的 sandbox-policy 配置。
已知限制¶
- 進程模型：動態插件駐留在進程內存中。DSH 重啓後插件會消失，需要重新調用
install_telegram_bridge。 - 上下文管理：每個聊天的模型覆蓋僅保存在內存中，重啓丟失。每個聊天的對話歷史被限制在 12 輪。
- 傳輸性能：每次 HTTP 調用啓動一個
pwsh進程。輪詢週期約 3-6 秒，網絡狀況差時可能出現長達 30 秒的阻塞。這適合個人使用，不適合高吞吐量的消息分發。
結語¶
winada82/dsh-telegram-bridge 爲 DSH 提供了便捷的 Telegram 交互入口。通過配置正確的沙盒策略，開發者可以在 Telegram 中直接使用 DeepSeek 模型。更多細節與源碼可訪問其 GitHub 倉庫。
