前言¶
DeepSeek Harness (DSH) 是一個基於插件的智能體開發框架。傳統的交互方式多依賴桌面端或 Web 界面。dsh-telegram-bridge 插件提供了一條通往 Telegram 的通路，允許你通過手機或通訊軟件直接與 DSH Agent 進行對話、調用技能或管理文件。
核心功能¶
該插件主要提供以下能力：
* Telegram ↔ dsh Agent 對話：支持私聊或羣組內 @ 機器人交互。
* 訪問控制：默認僅白名單可用，防止陌生人濫用。
* 工作目錄瀏覽器：在 Telegram 內通過 /cwd 命令瀏覽、切換目錄。
* 技能調用：查看可用技能並執行。
* 圖片與文件收發：支持多模態圖片交互及文件傳輸。
安裝與啓用¶
在 DSH 的 Web Profile（或其他 Profile）中安裝：
- 進入 Profile 目錄（例如
~/.dsh/profiles/web）。 - 執行安裝命令：
pnpm add dsh-telegram-bridge
- 修改
package.json文件，在dsh.profile.bundles數組中添加"dsh-telegram-bridge"。 - 重啓 dsh 服務。
配置步驟¶
完成安裝後，需要完成以下配置才能使用。
1. 獲取 Bot Token¶
在 Telegram 中找到 @BotFather，發送 /newbot 創建機器人，獲得 Token（格式爲 123456789:AA...）。
2. 配置 Token¶
有兩種配置方式：
* 可視化配置：在 dsh 設置頁的插件配置中，找到 Telegram Bot 橋接，在 Bot Token 輸入框粘貼 Token，點擊測試連接並保存。
* Credentials 配置：在 ~/.dsh/.credentials.yaml 中添加：
refs:
DSH_TELEGRAM_BOT_TOKEN: "你的token"
3. 配置訪問白名單¶
爲安全起見，必須配置訪問白名單。
* 允許的用戶名：填入你的 Telegram 用戶名（不帶 @），多用戶用逗號分隔。
* 允許的聊天 ID：可選，填入羣組 ID 或私聊 ID。
4. 代理設置（可選）¶
如果需要通過代理訪問 Telegram，在配置頁填入代理地址，格式如：
http://127.0.0.1:7897
留空則直連。
常用命令¶
Bot 支持以下命令進行控制：
/new- 重置當前會話/topic <名稱>- 切換命名子會話/cwd- 瀏覽/切換工作目錄/skills- 列出可用技能/skill <名稱> [參數]- 調用技能/model [provider model]- 查看/切換模型/status- 當前狀態/stop- 停止當前回合
安全注意事項¶
該插件以當前 dsh 進程的權限運行，涉及文件系統操作，請務必注意以下安全邊界：
- 工作目錄邊界：Bot 會話的 Agent 擁有工作目錄的讀寫能力。切勿將 Bot 白名單開放給不信任的人，以免造成文件系統風險。
- 羣組白名單：若在
allowed_chat_ids中填入羣組 ID，該羣內所有成員均可與 Bot 對話。 - 公網暴露：測試連接接口無鑑權。不要將 dsh Web 直接暴露到公網且不做訪問控制。
- 文件安全：Bot 收到的文件保存在
<工作目錄>/telegram-inbox/。
結語¶
dsh-telegram-bridge 通過 Telegram 實現了 DSH Agent 的遠程控制與移動端接入。它通過白名單機制保障了基本的訪問安全，適合需要在手機端快速調用 Agent 技能或查看工作目錄的開發者。
