DSH 運行時，任務完成、等待輸入或失敗時，插件會在桌面右下角彈出原生通知，並伴隨音效。這解決了 AI 在後臺等待確認時，用戶因切換窗口而錯過提示的問題。
功能說明¶
插件支持三類核心事件：任務完成、等待輸入和任務失敗。通知內容包含項目名、Git 分支、耗時、Token 和結果摘要，方便用戶快速判斷是否需要返回查看。
交互與防打擾¶
- 防轟炸：同類事件在 10 秒窗口內自動合併爲一條通知。
- 漸進強提醒：等待輸入類事件在 5 分鐘未處理時，會自動升級重發。
- 防打擾機制：檢測 DSH 窗口是否在前臺，全屏狀態下靜默事件，支持按時間表設置勿擾時段（等待輸入類事件默認豁免）。
擴展能力¶
- 音效：提供成功、等待、失敗三套內置音效。
- 手機推送：支持 Bark、ntfy 和自定義 Webhook，等待輸入和失敗事件可推送到手機。
- 其他：支持歷史記錄與統計浮卡、關鍵詞監聽、TTS 語音播報以及 Agent 主動通知。
安裝¶
通過官方命令安裝：
dsh plugin --profile web add dsh-plugin-desktop-notice
典型用法¶
安裝後，可以通過以下方式測試通知功能：
# 瀏覽器訪問
http://127.0.0.1:3080/desktop-notice/test?kind=waiting
# npm 腳本
npm run notify:test -- waiting
# PowerShell
irm "http://127.0.0.1:3080/desktop-notice/test?kind=error"
平臺支持與注意事項¶
- Windows：需在系統設置中開啓應用通知權限。橫幅顯示可能受 AUMID 匹配或專注助手設置影響。
- macOS：首次使用需要授權系統通知權限。
- Linux：依賴系統自帶的
notify-send命令。 - 無桌面環境：在服務器或 WSL 環境下，插件會自動禁用彈窗與音效，僅保留日誌。
