前言¶
DeepSeek Harness (DSH) 是一個基於插件的系統，旨在提供靈活的智能體控制能力。在本地開發或部署場景中，通常需要通過 Web UI 來管理會話和查看輸出。kevin66z0/dsh-telegram 插件爲 DSH 提供了一個 Telegram 遠程控制入口，允許用戶通過移動端直接與 Agent 交互，實現會話綁定、實時查看流式回覆以及快捷操作。
插件簡介¶
該插件由 Kevin66Z0 維護，開源協議爲 MIT。它將 Telegram 作爲一個統一的控制台，通過白名單機制管理訪問權限，確保會話安全。
核心功能¶
- 完整會話控制台：支持綁定會話、查看會話詳情、發送文本提示，並在單條消息中實時編輯顯示回覆。
- 實時流式回覆：助手輸出以流式方式在消息中編輯呈現，包含思考過程和工具調用步驟，最終以 HTML 格式定稿。
- 交互式問題按鈕：當智能體調用交互式問題時，界面會生成可點擊的 Inline Keyboards，用戶無需輸入文本即可回答。
- 一鍵鍵盤：提供快捷操作行，如
/create（創建）、/archive（歸檔）、/attach（綁定）和/stop（停止）。 - 安全默認：採用白名單機制，只有被授權的聊天 ID 可以與機器人通信，其他訪問會被拒絕並返回無權訪問提示。
- 密鑰永不落地磁盤：機器人令牌通過環境變量引用（
!!js process.env.TELEGRAM_BOT_TOKEN），不直接寫入配置文件。 - 冷會話恢復：通過 Host 的 apiProxy 通信，支持冷會話恢復和隊列消息語義。
安裝與啓用¶
環境要求¶
- Node.js >= 22.19
- 已安裝 DeepSeek Harness 源碼目錄（推薦）或已運行的 DSH 部署
- 從 @BotFather 獲取的 Bot Token
- 允許出站訪問 api.telegram.org
安裝步驟¶
- 克隆或下載插件代碼。
- 運行安裝腳本，將插件掛載到 DSH 目錄：
./install.sh /path/to/deepseek-harness
配置步驟¶
- 設置環境變量：在
DSH_HOME/.env中注入令牌，並設置 600 權限：
echo 'TELEGRAM_BOT_TOKEN=<token-from-@BotFather>' >> "$DSH_HOME/.env"
chmod 600 "$DSH_HOME/.env"
- 配置白名單：在
$DSH_HOME/settings.yaml中配置允許訪問的聊天 ID：
telegram:
allowChatIds: [123456789]
- 重啓服務：重啓 DSH 服務使配置生效。
典型用法¶
插件通過 Telegram 機器人命令進行操作。以下是主要命令列表：
/attach [scope|n|id|none|arc]：綁定當前聊天到指定會話。/create：打開創建子菜單。/operate：打開操作子菜單。/new [path|n|none]：創建一個新會話。/fork [n|id]：從上一個完成的回合分叉創建會話。/archive [n|id]：歸檔指定會話。/status [n|id]：查看會話詳情。/model [name]：設置全局默認模型。/rename [title]：重命名當前綁定的會話。/preset [name|n]：選擇預設的 Agent 配置。
安全與注意事項¶
- 白名單限制：插件默認拒絕所有訪問，必須在配置中指定
allowChatIds。 - 無入站監聽：插件不監聽任何入站端口，僅通過 Telegram 的出站長輪詢通信，適合在 NAT 後運行。
- 令牌管理：令牌存儲在環境變量中，若泄露可通過 @BotFather 快速撤銷並重新生成。
- 依賴要求：必須滿足 Node.js >= 22.19 的版本要求。
總結¶
dsh-telegram 爲 DeepSeek Harness 提供了一個安全、輕量的移動端控制方案。通過 Telegram，開發者可以在任何設備上管理 Agent 會話，無需依賴 Web UI。所有敏感操作（如令牌存儲、會話綁定）均遵循安全最佳實踐。
