dsh-notify: DeepSeek Harness HTTP 通知插件

前言¶

在使用 DeepSeek Harness (DSH) 進行智能體開發時，開發者通常需要在外部系統或終端中獲知根 agent 的運行狀態，例如任務完成、出現錯誤或等待人工交互。dsh-notify 插件通過 HTTP 請求將上述狀態推送到配置的接口，方便集成到現有的工作流或監控系統中。

插件簡介¶

dsh-notify 是一個由 Huauauaa 維護的通知類插件。它允許用戶配置一個 HTTP 接口，當根 agent 完成一輪交互或需要人工介入時，插件會向該接口發送 POST 請求。

核心功能¶

插件主要提供以下能力：

1. 觸發時機：支持任務完成、任務出錯、需要回答、等待審批四種觸發時機。
2. 請求配置：支持自定義 URL、請求方法、Headers、接收者 以及認證信息。
3. 開關控制：支持全局默認開啓，同時支持在每個會話中獨立開啓或關閉通知。
4. 去重機制：子 agent 與 5 秒內同會話的重複事件不會重複觸發通知。

安裝¶

安裝前請確保本地已安裝 DeepSeek Harness，並重啓 dsh web。

本地安裝：

dsh plugin --profile web add link:/ABS/PATH/dsh-notify

發佈到 GitHub 並加上 dsh-plugin topic 後：

dsh plugin --profile web add github:OWNER/dsh-notify

配置與使用¶

1. 打開 設置，在側欄 Agent presets 下方進入 通知 頁面。
2. 填寫接口參數（URL、Method、Headers、Receiver、Auth），並選擇是否開啓 全局默認開啓。
3. 點擊 測試，接口會收到一條 通知測試：連通性檢查 的請求，用於確認連通性。
4. 在側欄三點菜單（Rename / Fork / Archive 下方）開啓每個會話的通知開關。會話開關優先於全局默認設置。

配置文件默認位於 $DSH_HOME/dsh-notify.json（即 ~/.dsh/dsh-notify.json）。

技術細節與注意事項¶

• 請求失敗處理：請求失敗僅會在日誌中記錄，不會影響 agent 的正常運行。
• 完成檢測邏輯：完成檢測邏輯與當前 DSH 一致。如果沒有全局 turn/end，會使用 agents.list() 進行輪詢。
• 功能區分：本插件與 aokamoaki/dsh-notify（Windows toast）不是同一個插件，前者提供自定義的 HTTP webhook，後者僅用於 Windows 彈窗通知。

結語¶

該插件通過標準 HTTP 接口將 DSH 的運行狀態暴露給外部，適合需要將 DSH 集成到現有自動化流程或監控系統的場景。更多詳情可查閱 GitHub 倉庫。