在 DeepSeek Harness（DSH）的使用場景中，除了命令行或 Web UI，直接通過即時通訊軟件與 Agent 交互能帶來更靈活的遠程運維體驗。dsh-messenger-gateway 正是爲解決這一問題而生的插件，它充當了 DSH 與 Telegram 等平臺之間的橋樑。
插件定位¶
由 GooDAnDReaREADY 維護的客戶端插件，提供企業級多傳輸協議消息網關。它將 DSH Agent 接入 Telegram，支持交互式按鈕、論壇主題和語音筆記等操作。
核心功能¶
- 傳輸協議支持：支持長輪詢或 webhook 模式的 Telegram 機器人，同時提供 Discord 和 Slack 適配器。
- 會話隔離與管理：支持按用戶或按聊天進行會話隔離，支持將論壇主題作爲獨立會話；提供會話導出、回溯和分支功能。
- 交互能力：提供快捷操作回覆鍵盤、多選交互式表單（Checkbox）、Artifact 與 Mermaid 圖表渲染。
- Agent 輔助：支持 Agent 角色與人設切換、工具與技能檢查，並提供 Agent 工具
messenger_ask用於獲取用戶反饋。 - 文件與通知：提供工作區文件管理器、管理員警報通道、定時提醒以及入站 webhook 事件調度器。
- 語音功能：支持語音轉文字和文本轉語音（TTS），支持發送語音筆記（需依賴 ffmpeg）。
安裝與啓用¶
通過命令行安裝插件：
dsh plugin --profile web add @goodandready/dsh-messenger-gateway
安裝後，在 DeepSeek Harness 的 Web 界面中進入“設置 → 插件 → Messenger gateway”進行配置：
- 啓用 Telegram 適配器。
- 輸入 BotFather 獲取的 Bot Token（該字段爲寫/只讀，用於保持當前 Token）。
- 設置允許列表或使用配對碼進行授權。
如需使用 Discord 或 Slack 功能，需安裝對應的輔助插件。
典型用法¶
在 Telegram 中通過以下指令進行操作：
/new- 新建會話/role coder- 切換 Agent 人設爲 coder/files- 進入工作區文件管理/remind 15m Call client- 設置 15 分鐘後的提醒- 配置 Discord/Slack 適配器 - 在設置面板中開啓對應服務並填入 Webhook 或 Bot Token
適用場景與注意¶
該插件適合需要在 Telegram、Discord 或 Slack 上遠程管理與 DeepSeek Harness Agent 交互的開發者或運維人員。
注意事項：
- 語音筆記依賴：語音筆記功能依賴
ffmpeg，否則系統會將其作爲普通音頻文件發送。 - 安全規範：Bot Token 屬於 DeepSeek Harness 的祕密字段，切勿提交到版本控制。
- 輔助插件：Discord 和 Slack 適配器需要安裝輔助插件才能正常工作。
- 運行環境：必須依賴 DeepSeek Harness 的 Web 配置環境。
該插件通過網關模式連接了主流即時通訊工具與 DeepSeek Harness，適合需要遠程控制或多端協作的開發場景。
