DeepSeek Harness 的 Web 界面在處理長任務或需要人工介入的流程時，用戶往往需要保持標籤頁打開。當頁面處於後臺或用戶切換應用時，任務完成或權限請求的提示容易被忽略。該插件通過瀏覽器原生通知系統，彌補了這一體驗缺口。
插件簡介¶
這是一個由 pd90506 維護的插件，旨在爲 DeepSeek Harness Web GUI 添加系統級通知功能。它監聽會話狀態變更和權限請求事件，當這些事件發生時，通過瀏覽器通知中心向用戶發送提醒。
安裝與啓用¶
- 執行以下命令安裝插件：
dsh plugin --profile web add https://github.com/pd90506/dsh-web-notification/archive/refs/tags/v0.1.0.tar.gz
- 重啓 Web 服務器，使插件的宿主端和客戶端模塊生效。
核心功能¶
- 任務完成通知：當任意會話的代理狀態從
running變爲idle時觸發通知。 - 權限請求通知：當 Harness 發起批准或權限請求時觸發通知。
- 通知機制：插件通過內存隊列緩存事件，客戶端通過 GET /__dsh-web-notification/poll 接口輪詢獲取通知。支持多標籤頁同時監聽，同一會話的重複通知會互相覆蓋而不是堆疊。
- 圖標處理：通知圖標爲 DSH 頁面自身的
/favicon.svg，在頁面內轉換爲 PNG 顯示。
使用方法¶
- 確保已重啓 Web 服務器。
- 在瀏覽器中爲 DSH 頁面（例如
http://127.0.0.1:3080）授予通知權限。 - 在操作系統設置中允許瀏覽器顯示橫幅和聲音（例如 macOS 系統設置）。
技術與安全說明¶
- 資源消耗：插件僅爲 UI 功能，不消耗 Token，不註冊模型工具，不寫入會話日誌。
- 策略干擾：批准監聽器爲嚴格透傳，調用
next()繼續流程，不干擾 Harness 的策略執行或批准卡片。 - 安全邊界：輪詢接口僅返回通知項目本身，不包含消息內容或工具參數。
侷限性¶
- 運行依賴：需要 DSH 頁面在標籤頁中打開且通知權限已授予。頁面關閉後無法接收通知，且瀏覽器拒絕的權限無法在頁面內覆蓋。
- 延遲：通知延遲最高可達 2 秒（輪詢間隔）。
- 離線處理：如果在頁面未連接期間發生事件，最多排隊 60 秒。
總結¶
該插件通過輪詢機制實現了跨標籤頁的即時通知，適合需要頻繁切換工作流或長時間運行 Harness 任務的場景。安裝包遵循 MIT 許可證。
