在 DeepSeek Harness 的開發流程中，當智能體在後臺運行或處於等待確認狀態時，開發者往往需要手動檢查窗口狀態。dsh-notify 插件將 DeepSeek Harness 的狀態變化直接映射到操作系統的通知中心，解決“脫離視線”帶來的狀態遺漏問題。
這個插件由 Zhiyi-Zhao 維護，遵循 MIT 許可證。它是一個瀏覽器端插件，通過 Web Notification API 向桌面端或瀏覽器端發送系統級通知。
核心功能¶
插件會在以下時刻觸發通知：
* 輪次完成（turn finished）
* 輪次失敗（turn failed）
* 後臺作業結算（background job settled）
* 智能體等待確認（agent waiting for confirmation）
點擊通知可以直接聚焦窗口並打開對應的會話。爲了減少干擾，插件內置了噪聲控制機制：
* 當窗口處於聚焦狀態時，默認不發送通知。
* 默認忽略運行時間短於 10 秒的已完成任務。
* 同一會話內的重複通知會堆疊顯示，而不是互相覆蓋。
安裝與啓用¶
通過官方 CLI 進行安裝：
dsh plugin --profile desktop add github:Zhiyi-Zhao/dsh-notify
安裝完成後，首次加載會自動發送一條自檢通知，用於驗證通知通道是否正常工作。
配置方式¶
由於插件不讀取 cordis.yml 配置，所有運行時參數通過 localStorage 中的 dsh-notify.options 鍵進行控制。
通過瀏覽器控制台設置配置項示例：
localStorage.setItem('dsh-notify.options', JSON.stringify({
onlyWhenUnfocused: false, // 默認爲 true，聚焦時靜音
minRunMs: 0 // 默認爲 10000，忽略短於 10 秒的運行
}))
注意事項與適用場景¶
該插件以 DeepSeek Harness 進程的權限運行。在使用前，建議檢查源碼與許可證。
- 配置來源：插件不提供 Web 界面設置卡片，所有配置必須通過代碼或瀏覽器控制台修改
localStorage。 - 通知堆疊：同一會話內的多次通知會堆疊，不會相互替換。
- 多客戶端投遞：如果你同時掛載了桌面端和瀏覽器端兩個客戶端，兩個端都會收到通知。
- 無頭模式不支持：僅支持 Web GUI，在無頭模式或 ACP（Agent Control Panel）運行時不會收到通知。
- Windows 特性：在 Windows 上，永遠不要在
Notification構造函數中傳遞tag參數，否則 Toast 消息將無法送達系統中心。 - 權限管理：桌面端 shell 會自動授予通知權限；瀏覽器端需要用戶交互（點擊或按鍵）後才能請求權限。
總結¶
dsh-notify 提供了 DeepSeek Harness 與操作系統原生的集成能力，適合需要長時間運行任務或需要即時響應確認的開發場景。
