DeepSeek Harness Messenger: Telegram 通訊橋接插件

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。開發者若要在 DSH 的智能體流程中加入即時通訊能力，通常需要自行編寫適配器或維護獨立的 Bot 系統。DeepSeek Harness Messenger 是一個連接 DeepSeek Harness 與 Telegram 的橋接插件，由 syncended 維護。它將 Telegram 的消息流接入 DSH 的會話與工具體系，讓用戶可以直接通過 Telegram Bot 與 DSH 的智能體交互，實現會話管理、任務下發與狀態通知。

核心功能¶

插件通過 DSH Web Settings 中的 Messengers 頁面進行配置，使用 DSH 的憑據存儲來管理 Telegram bot-token，支持無需重啓 Host 即可實時重新配置。

會話管理與儀表板
插件提供 Telegram 原生命令菜單和內聯按鈕控制面板，用於管理當前會話。它支持列出並恢復持久化的頂層 DSH 會話，在創建新會話時允許選擇已註冊的 DSH workspace。會話綁定是持久的，支持跨 Host 重啓和實時重新配置。儀表板使用 DSH workspace 顯示名稱，避免使用晦澀的會話哈希。
交互與控制
插件支持模型選擇、推理控制、權限預設、上下文監控、轉向和取消等操作。ask_user_question 工具支持交互式選擇、多選和自由文本回答。界面提供 Claude 風格的動畫進度、打字活動、流式消息編輯和工具狀態顯示。
多媒體處理
支持將 Telegram 照片或文檔作爲 DSH 圖像提示，保留字面標題。支持本地 Whisper 按需轉錄 Telegram 語音消息。提供 messenger_send_image 工具，允許智能體通過顯式工具調用發送生成的圖像文件。
傳輸適配
插件實現了共享的 MessengerAdapter 接口，目前以 Telegram Bot API 爲初始傳輸，爲 Yandex Messenger、Discord 等未來傳輸預留了擴展能力。

安裝與依賴¶

插件依賴 DSH 的核心運行時環境。在安裝前，需確保本地環境包含以下 peerDependencies：

{
  "@deepseek-ai/cordis": "^4.0.2",
  "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
  "@deepseek-ai/dsh-attachment": "^0.1.2-rc.1",
  "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
  "@deepseek-ai/dsh-api-session-control": "^0.1.2-rc.1"
}

典型用法¶

命令操作¶

在 Telegram 中發送以下命令來控制會話和儀表板：

/start 或 /menu：打開儀表板。
/sessions：列出最近持久化的頂層 DSH 會話。
/resume [session-id]：恢復會話（可使用按鈕選擇，或直接指定 ID）。
/new：創建並綁定新會話（需選擇 workspace）。
/status：刷新儀表板。
/model：選擇模型。
/reasoning：選擇推理努力程度。
/permission：選擇權限預設。
/context：查看上下文壓力、構成和累計使用量。
/steer <text>：向當前回合發送引導。
/cancel：請求取消當前回合。
/unbind：移除當前綁定（保留通知）。
/notifications [on|off]：訂閱或取消 Host 級別的自動化通知。
/help：顯示命令幫助。

圖像處理¶

發送圖像：在 /resume 或 /new 後，直接發送 Telegram 照片或 PNG/JPEG/WebP/GIF 文檔（可帶標題）。系統會下載最大尺寸版本，作爲 DSH 附件存儲。圖像限制爲 20 MiB。
- JPEG/PNG 文件小於 10 MiB 使用 sendPhoto，更大文件或 GIF/WebP 使用 sendDocument。
接收圖像：圖像進入 DSH 會話歷史，可用於後續模型處理。
發送生成圖像：智能體在響應中使用 messenger_send_image 工具發送文件。例如：

{
  "file_path": "output/chart.png"
}

該工具會將文件發送到當前授權的聊天中。

適用場景與注意¶

適用場景：需要通過 Telegram 遠程管理 DSH 會話、接收 Host 級別的自動化通知、進行多輪對話交互，或利用 Telegram 的多媒體能力進行圖像提示的智能體開發。
注意：
- 下載僅在授權的聊天或操作員且已選擇會話時開始。
- 圖像傳輸有 20 MiB 限制和有界下載超時。
- 發送操作在出錯或取消後不會自動重試。
- /notifications 訂閱獨立於會話綁定，無需 /resume 或 /new 即可啓用。
- 通知交付不會切換當前選定的會話；僅用於訂閱。

該插件通過統一的適配器接口降低了多平臺集成的複雜度，爲 DSH 插件生態提供了標準的通訊能力。