前言¶
DeepSeek Harness (DSH) 允許用戶通過配置文件定義智能體任務。當任務在後臺運行或窗口最小化時，直接在界面查看狀態會變得不便。dsh-web-push-notification 插件通過瀏覽器原生通知解決了這一問題，確保用戶不會錯過任務完成、停止、審批或需要回復的關鍵事件。
插件介紹¶
該插件屬於聯網工具類別，由 blauerberg 維護，開源協議爲 MIT。它主要解決的是在 DSH 任務運行期間，如何通過瀏覽器通知實時獲取任務狀態更新的問題。
安裝與配置¶
安裝插件需要指定 profile。以 web profile 爲例，執行以下命令：
dsh plugin --profile web add dsh-web-push-notification
安裝後，需在配置文件中添加插件配置。默認配置文件路徑爲 $DSH_HOME/profiles/web/cordis.patch.yml。添加如下內容：
- id: dsh-web-push-notification
config:
vapidSubject: 'mailto:admin@example.com'
其中 vapidSubject 是 VAPID 聯繫 URI，可以是 mailto: 或 https: 格式。訂閱和 VAPID 密鑰默認存儲在 $DSH_HOME/profiles/<profile>/web-push.json 中。
啓用與使用¶
啓動配置了插件的 profile：
dsh --profile web
由於瀏覽器安全策略，除非通過本地迴環地址訪問，否則必須通過 HTTPS 打開配置文件。在 iOS 和 iPadOS 上，啓用 Web Push 之前需將配置文件添加到主屏幕。
啓動後，打開 Settings → Notifications，啓用 Web Push，並使用 Send test 進行測試。
功能與說明¶
該插件具備以下功能：
- 事件通知：支持任務完成、任務停止或失敗、需要審批、需要回復四種事件類型，所有類型默認啓用。
- 通知內容：支持完整內容通知（默認）和僅摘要通知兩種模式。
- 獨立設置：每個瀏覽器或安裝的 PWA 單獨存儲其通知設置。
- 存儲路徑：訂閱和 VAPID 密鑰默認存儲在
$DSH_HOME/profiles/<profile>/web-push.json中。
注意事項¶
- 插件以當前 DSH 進程的權限運行。
- 使用前建議檢查源碼與許可證。
此插件將 DSH 的狀態集成到瀏覽器通知中，適合需要通過瀏覽器監控後臺任務流的開發者。代碼庫和文檔可在 GitHub 上找到。
