在 DeepSeek Harness Web 進行開發或調試時，長時間運行的任務或需要人工介入的場景容易讓人忽略狀態變更。dsh-notifications 插件通過瀏覽器原生能力，提供桌面通知和提示音，確保重要事件不被遺漏。
它是什麼¶
這是一個由 dat-lequoc 維護的 DSH 客戶端插件。它直接在瀏覽器中運行，支持通過 SSH 轉發訪問（例如 http://127.0.0.1:3084/ 轉發到服務器端口 3080），不依賴任何外部通知服務、音頻下載或模型工具。
插件通過監聽主線程狀態變化（如正常完成、取消、失敗）以及待處理問題、審批和審查計劃等事件，觸發相應的通知。它同時爲瀏覽器標籤頁提供視覺指示，並在點擊通知時自動聚焦 DSH 窗口。
核心功能¶
- 桌面通知與提示音：支持瀏覽器桌面通知和雙音調提示音。
- 無外部依賴：純瀏覽器端實現，無需額外服務。
- 事件觸發：監聽主線程狀態（停止、待處理問題、審批、審查計劃），每個事件觸發一次通知；初始空閒歷史和重連快照不觸發。
- 標籤頁指示：事件發生時，瀏覽器標籤頁圖標顯示紅點；返回、聚焦或交互頁面可清除紅點。
- 自動聚焦與導航：點擊桌面通知可自動聚焦 DSH 窗口並打開對應線程。
- 多標籤頁邏輯：同一來源下的多個 DSH 標籤頁中，一個標籤頁擁有自動通知交付權；另一個標籤頁關閉時自動接管。
安裝與啓用¶
使用官方安裝命令將插件添加到 Web 配置文件中：
dsh plugin --profile web add github:dat-lequoc/dsh-notifications
dsh --profile web
首次加載 DSH Web 界面時，需點擊 Enable notifications，並在瀏覽器彈窗中點擊 Allow。這一步不僅會啓用通知，還會同步解鎖提示音併發送一次測試通知。
典型用法¶
- 測試功能：進入設置 -> 通用 -> 通知頁面，點擊測試按鈕，驗證提示音和桌面通知是否正常送達。
- 保持標籤頁：由於多標籤頁歸屬邏輯，建議保持一個 DSH 標籤頁打開並處於激活狀態，以確保通知能夠正常交付。
適用場景與注意¶
- 適用場景：需要長時間後臺運行 DSH 的會話；需要及時響應審批或待處理問題的場景。
- 注意：
- 提示音在頁面首次加載後需要用戶交互（如點擊頁面或使用測試按鈕）才能解鎖音頻。
- 提示音要求擁有通知交付權的標籤頁已解鎖音頻。
- 瀏覽器/操作系統的通知設置和勿擾模式可能影響送達。
- 偏好設置屬於當前瀏覽器和來源，更改 SSH 轉發端口後需重新授權。
- 瀏覽器對通知可見性的支持各不相同；關閉標籤頁的推送和移動端 Service Worker 通知不在該插件支持範圍內。
總結¶
該插件通過原生瀏覽器 API 實現了即時反饋機制，解決了 DSH Web 在後臺運行時狀態感知滯後的問題。更多細節可參考 GitHub。
