前言¶
在 DeepSeek Harness（DSH）平臺進行 Agent 開發時，經常遇到會話等待審批、需要回答結構化提問或任務成功/失敗的場景。如果開發者沒有時刻關注 DSH 頁面，很容易錯過這些關鍵事件。該插件通過瀏覽器通知機制，解決了這一問題。
功能特性¶
插件支持全會話監聽，不限於當前打開的會話。它提供四類通知：會話待審批、等待回答、任務成功和任務失敗。功能包括子代理任務通知獨立開關、標籤頁鯨魚圖標變色（黃/紅/綠優先級）、前臺抑制（當前會話不重複提醒）、多標籤頁單發（BroadcastChannel 機制）、點擊直達會話、獨立配置模塊、隱私安全（通知不包含聊天正文或參數）以及中英文雙語言界面。
安裝與啓用¶
安裝前需確保已安裝 DSH CLI 與 pnpm，並保持 DSH 頁面打開。
1、執行安裝命令：
dsh plugin --profile <profile> add github:Ycet/dsh-notifications
2、重啓網頁應用：dsh web
3、打開 DSH 頁面，進入「設置 → 插件 → 插件配置」
4、展開「消息通知」模塊，點擊「授權通知」並在瀏覽器權限提示中選擇允許
5、點擊「發送測試通知」驗證瀏覽器設置
配置與用法¶
配置存儲在 DSH settings 服務的 dsh-notifications 命名空間下。
| 字段 | 默認值 | 說明 |
|---|---|---|
enabled |
true |
總開關 |
approvalPendingEnabled |
true |
待審批通知 |
questionPendingEnabled |
true |
結構化提問通知 |
taskSucceededEnabled |
true |
任務成功通知 |
taskFailedEnabled |
true |
任務失敗通知 |
subagentTaskEndedEnabled |
true |
子代理任務通知開關 |
faviconEnabled |
true |
標籤頁圖標變色總開關 |
前臺抑制：默認只有在 DSH 標籤頁處於後臺，或事件來自非當前會話時才發送通知。
點擊直達：點擊通知會聚焦 DSH 並打開對應會話；若目標會話已不存在，則只聚焦頁面。
圖標變色邏輯：鯨魚圖標顏色由非子代理會話狀態決定。黃色表示有會話待審批或等待回答；紅色表示有會話任務失敗；綠色表示有會話任務完成。優先級爲黃 > 紅 > 綠。點開會話可清除該會話的顏色貢獻。子代理會話狀態不影響圖標顏色。
注意事項¶
1、版本兼容：插件兼容 DSH 0.1.0-rc.6 / 0.1.0-rc.7。
2、運行狀態：DSH 頁面必須保持打開，瀏覽器關閉後無法接收通知。
3、瀏覽器權限：必須授予當前 DSH 地址通知權限，非安全遠程 HTTP 地址可能被拒絕。
4、圖標支持：鯨魚圖標變色依賴頁面 favicon，Firefox 和 Safari 未列入首版驗收範圍。
5、功能限制：不提供原生 Node 通知、瀏覽器關閉後的推送、自定義通知音或外部消息渠道。
6、 多標籤頁機制：採用 BroadcastChannel，極端瀏覽器崩潰後最多等待約 6 秒重新選舉。
結尾¶
該插件爲 DSH 用戶提供了直觀的消息通知和狀態反饋機制，適合需要長時間運行 Agent 任務並關注狀態變化的場景。相關文檔與源碼可訪問插件目錄或 GitHub 倉庫獲取。
