前言¶
DSH 生態裏，插件可以擴展 DSH 的入口和能力。對智能體開發者來說，常見需求之一是：DSH 會話已經在運行，但人不一定在電腦前，想用手機快速查看工作區、創建會話、看任務狀態，或者直接取消當前任務。
dsh-telegram-bot 是 yuko0331 維護的 DSH 插件，MIT 許可證。它通過 Telegram 私聊提供一組受限的遠程入口，用於和 DSH 對話、查看會話與任務狀態，並在配置允許的範圍內控制當前 DSH 會話。
這是什麼¶
dsh-telegram-bot 的定位是：通過 Telegram 私聊遠程使用和查看 DeepSeek Harness。
它不是羣聊機器人，也不是完整替代 DSH Web 界面的移動端。它更像是一個受白名單限制的遠程終端入口：只接受配置的 Telegram 數字 User ID，只支持私聊，只處理文字消息，並通過長輪詢與 DSH 交互。
核心功能¶
已覈實的能力包括：
- 與 DSH 對話並接收回復
- 查看工作區和即時會話
- 在指定工作區創建會話
- 查看正在運行的任務
- 取消當前任務
- 僅允許一個指定的 Telegram 用戶操作
其中幾個使用邊界比較關鍵：
- 只接受私聊，不支持羣聊控制
- 只支持文字消息和長輪詢
- 不支持羣聊、語音、文件和按鈕操作
- 插件只能切換和控制自己創建的會話
/tasks顯示正在運行的 DSH 會話，不讀取瀏覽器任務看板- Telegram 不能代替用戶批准敏感工具操作
- 插件重啓後需要重新選擇會話
安裝¶
把插件安裝到 DSH Web profile：
dsh plugin --profile web add git+ssh://git@github.com/yuko0331/DSH-telegram.git
安裝前建議先檢查 GitHub 倉庫中的源碼、行爲說明和 MIT 許可證。它會以當前 dsh 進程具備的權限工作，因此命令能力、會話控制和任務取消都應放在你信任的環境中使用。
配置¶
啓用前需要準備兩樣東西：Bot Token 和管理員數字 User ID。
- 在 Telegram 中聯繫
@BotFather，執行/newbot創建 Bot，並取得 Bot Token。 - 通過
@userinfobot等機器人查詢自己的 Telegram 數字 User ID，例如123456789。 - 打開 DSH 的設置頁面：
設置 → Telegram
- 填寫 Bot Token 和管理員數字 User ID。
- 打開“啓用 Telegram 機器人”。
- 保存並應用。
Bot Token 通過 DSH 憑據系統讀取，不寫入插件配置。Bot Token 只寫入 DSH 憑據系統，頁面和接口不會讀取或返回 Token 明文。
不要把 Token 發到聊天中，也不要提交到 Git。
典型用法¶
啓用後，向這個 Telegram Bot 的私聊發送命令：
| 命令 | 用途 |
|---|---|
/help |
查看幫助 |
/workspaces |
查看工作區 |
/new <工作區ID> |
創建並選擇會話 |
/sessions |
查看即時會話 |
/use <會話ID> |
切換機器人創建的會話 |
/status |
查看運行狀態 |
/tasks |
查看正在運行的任務 |
/stop |
取消當前任務 |
發送其他普通文本，會進入當前 DSH 會話。
首次使用時，可以按這個順序：
/workspaces
/new <工作區ID>
你好，請檢查當前項目狀態
先查看工作區，再創建並選擇一個會話，最後發送普通文本進入當前 DSH 會話。
適用場景與注意¶
這個插件適合需要移動端遠程查看和操作 DSH 單用戶會話的場景，例如：
- 查看當前有哪些工作區
- 創建一個新會話
- 查看正在運行的 DSH 會話
- 取消當前任務
- 在手機上繼續當前 DSH 對話
它不適合當作羣聊協作入口、文件傳輸通道、語音交互入口，也不適合把 Telegram 當作敏感工具操作的最終批准層。敏感操作仍應按照 DSH 自身的安全機制處理。
另外，插件重啓後需要重新選擇會話；如果之前已經通過 /new 創建並選擇了會話，重啓後不要假設當前會話還保留着上下文選擇狀態。
結尾¶
dsh-telegram-bot 的價值在於給 DSH 增加一個受控的 Telegram 私聊入口：只允許一個指定用戶、只支持文字消息、只處理私聊場景，並能覆蓋對話、工作區、會話、任務狀態和取消任務這幾個常用操作。
如果你需要在手機上遠程查看和操作 DSH 會話，可以從這個插件開始驗證；使用時請確認自己接受它的單用戶、私聊、文字消息和會話切換邊界。
GitHub：
https://github.com/yuko0331/DSH-telegram
