前言¶
在使用 DeepSeek Harness（DSH）開發智能體時，Agent 經常需要人工介入：工具越權需要授權確認、模型向你提問或提交計劃待確認、以及一輪任務跑完。如果這些時刻你不盯着界面，對話就會一直掛着。dsh-desktop-notify 插件通過系統級通知（Windows 下爲系統 toast）捕獲這三種狀態，讓你在處理其他任務時也能第一時間獲知並處理。
它是什麼¶
dsh-desktop-notify 是由 AFAP 維護的客戶端插件。它通過只讀觀測 DSH 官方的狀態源，將待處理的交互狀態轉化爲瀏覽器的 Notification API 通知。
核心功能¶
- 三類提醒：支持工具授權確認（
approval）、提問與計劃評審（question/plan-review）、以及任務完成（會話轉空閒）。 - 系統級通知：由瀏覽器發出（Windows 顯示爲系統 toast），無需常駐後臺程序。
- 點擊直達：點擊通知可將窗口拉到前臺，並自動滾動到對應的待處理卡片。
- 失焦補發：默認僅在 DSH 不在前臺時提醒，切走窗口後會補發壓下的通知。
- 子代理降噪：完成提醒僅針對宿主會話列表，子代理運行完畢不彈。
- 去重與自清理：同一請求只通知一次，回答後對應通知自動關閉。
- 零依賴與零佔用：無外部 npm 依賴、不註冊 HTTP 路由，側邊欄不新增入口，只在設置頁提供一節配置。
安裝與啓用¶
插件通過命令行安裝，刷新頁面後生效。
dsh plugin --profile web add github:AFAP/dsh-desktop-notify
安裝完成後：
- 打開「設置」→ 左側「桌面通知」。
- 點「開啓權限」，在瀏覽器彈窗裏允許通知。
- 點「發送測試通知」驗證通道。
使用說明¶
通知觸發場景¶
- 工具授權確認：工具請求越權執行（如寫入被沙箱拒絕）。
- 提問/計劃評審：模型向你提問或提交計劃待確認。
- 任務完成：宿主會話列表裏的會話由運行轉爲空閒。
行爲細節¶
- 自動關閉：在界面上回答完問題或點掉授權後，對應通知會自動關閉。
- 前臺抑制：默認開啓「僅在 DSH 不在前臺時提醒」，當你正看着界面時不會打擾。
注意事項¶
- 環境要求：需要 DeepSeek Harness 0.1.7-alpha.1 或更高版本。頁面必須是安全上下文（
https或localhost），瀏覽器才提供 Notification API。 - 權限管理：需要瀏覽器通知權限，且頁面必須是安全上下文（https 或 localhost）。設置只存瀏覽器
localStorage，不上傳任何數據。 - 安全設計：插件只讀觀測官方狀態源，不接管任何鏈路，不發送網絡請求，不讀取會話日誌，無憑證、無密鑰。
- 隱私：通知正文可能出現在鎖屏或通知中心，內容包含工具名、請求原因、會話標題。
結語¶
該插件通過系統級通知減少了 Agent 開發過程中對界面的依賴，適合需要多任務處理或長時間運行 Agent 的場景。
