前言¶
在 DeepSeek Harness（DSH）的開發或使用過程中，Agent 執行任務或遇到權限問題時，如果用戶當前不在 DSH 的標籤頁內，很容易錯過這些關鍵狀態。proactive-notify 是一個運行在 DSH Web GUI 上的客戶端插件，旨在通過瀏覽器原生的 Notification API 解決這一問題。它可以在後臺運行，通過系統級通知提醒用戶，並自帶音效。
核心功能¶
該插件主要解決 Agent 任務流中的狀態同步問題：
- 權限與任務提醒：當 Agent 遇到權限問題（如工具被拒絕、等待審批）或完成任務（轉爲 idle）時，自動彈出系統通知。
- 系統音效：使用 Windows 系統自帶的通知音效，無需額外配置。
- 審批通知就位：確保審批通知在瀏覽器彈窗出現後才觸發系統通知，避免用戶看到通知切回頁面時，審批面板尚未加載的情況。
- 零打擾：通知正常工作後，DSH 頁面內不顯示任何 UI 元素，僅通過系統級提醒進行交互。
- 開頁引導：首次打開網頁時，若未授權通知權限，右下角會出現引導卡片，引導用戶開啓。
- 永久加載：作爲組合插件（Bundle），一次安裝後隨 DSH 進程啓動自動生效。
安裝與啓用¶
安裝需要使用 dsh plugin 命令，並依賴 pnpm 環境。
- 執行安裝命令：
dsh plugin --profile web add "github:DemoJ/proactive-notify#main"
- 重啓 DSH 以加載插件（重新運行
dsh web）。
使用方法¶
- 授權通知：首次打開網頁時，頁面右下角會出現「開啓通知」卡片。點擊卡片會觸發瀏覽器權限請求，選擇「允許」。
- 查看通知：DSH 標籤頁必須保持打開（後臺運行即可）。當 Agent 遇到權限問題或完成任務時，瀏覽器會彈出系統級通知。
- 手動重置權限：如果誤點拒絕，瀏覽器將不再自動彈出授權窗。需要在瀏覽器地址欄左側點擊「站點設置」→「通知」→「允許」，然後刷新頁面。
注意事項¶
- 標籤頁狀態：DSH 標籤頁必須保持打開。關閉標籤頁後，插件無法發送系統通知（後臺進程仍可運行）。
- 瀏覽器兼容性：推薦使用 Chrome、Edge 或 Firefox。
- 安裝依賴：安裝命令依賴 pnpm 環境。
- 許可證：MIT 開源協議。
結語¶
proactive-notify 通過瀏覽器原生能力，將 DSH 的任務狀態無縫同步到用戶的桌面環境，適合需要長時間運行 Agent 任務並希望實時掌握進度的場景。
