前言¶

在使用 DeepSeek Harness (DSH) 進行開發或自動化任務時，代理（Agent）常需用戶介入，例如提問、請求工具調用批准或完成當前回合。如果離開了 DSH 界面，這些關鍵事件容易被遺漏。dsh-ping 插件通過 Telegram 發送通知，確保你在任何位置都能收到這些提醒，從而不中斷工作流。

插件簡介¶

dsh-ping 是一個專注於通知功能的 DSH 插件。它不攔截 DSH 的交互，不生成自定義的問題卡片，也不實現回答或批准邏輯。插件僅通過觀察 DSH 的事件流，將關鍵信息推送到 Telegram。該插件由 chintoleung 維護，採用 MIT 許可證，具備零運行時依賴。

核心功能¶

插件目前提供三類核心事件的通知：

1. 提問通知：當代理調用原生 DSH 的 ask_user_question 時觸發。
2. 審批通知：當需要批准工具調用時觸發。
3. 完成通知：當回合結束（turn end）時觸發，默認開啓。

插件完全使用 DSH 的原生 GUI 進行交互，不支持在 Telegram 中回答問題或批准操作。

安裝與啓用¶

安裝前請確保環境滿足以下要求：
* 已安裝 DSH（建議使用 next 頻道）。
* Node.js 版本 >= 22。

1. 獲取 Telegram 憑據¶

在 Telegram 中通過 @BotFather 創建機器人，並使用 /getUpdates 接口獲取你的 chat.id。請妥善保管 botToken。

2. 安裝插件¶

在當前使用的 profile（例如 web）下執行安裝命令：

dsh plugin --profile web add github:chintoleung/dsh-ping

3. 配置憑證¶

編輯 profile 目錄下的 cordis.patch.yml 文件，添加以下配置：

- id: dsh-ping
  config:
    telegram:
      botToken: !!js "process.env.DSH_PING_TG_TOKEN || ''"
      chatId: !!js "process.env.DSH_PING_TG_CHAT || ''"

4. 設置環境變量¶

設置環境變量並確保它們對啓動 DSH 的進程可見：

export DSH_PING_TG_TOKEN='your-bot-token'
export DSH_PING_TG_CHAT='your-chat-id'

5. 重啓 DSH¶

重啓 DSH 服務，檢查日誌確認插件已加載（例如 [dsh-ping] armed: question/approval/turnEnd）。

兼容性說明¶

插件維護者會監控 DSH 的 next 頻道版本，並在新版本發佈時運行兼容性檢查。截至 2026 年 10 月 17 日，插件已驗證與 DSH 0.2.1-rc.2 版本的兼容性。插件本身不進行 npm 依賴檢查或更新，僅發送通知。

注意事項¶

• 無入站連接：插件不進行入站輪詢，不使用 webhook，也沒有管理控制台或運行時狀態文件。
• 隱私風險：通知內容（問題摘要、審批詳情、會話標題）可能包含敏感信息，請確保發送通道的安全。
• 交互權限：DSH 擁有所有交互權限，插件僅負責通知，不會干擾批准流程。

結語¶

dsh-ping 提供了 DSH 與 Telegram 之間的輕量級連接。你可以通過社區目錄查看更多詳情，或在 GitHub 上查看源碼。