dsh-attention：DeepSeek Harness 桌面通知插件

在 DeepSeek Harness (DSH) Web 中進行智能體開發時，往往需要長時間運行任務。當任務完成或需要人工介入審批時，如果頁面處於後臺或未聚焦，很容易錯過關鍵狀態。dsh-attention 插件旨在解決這一痛點，通過桌面層面的聲音、系統橫幅和標籤頁閃爍，提醒用戶注意任務進度。

插件介紹¶

dsh-attention 是一個 GitHub 分發的 DSH Web 插件，不屬於 Shell 修改。它通過瀏覽器插件機制監聽 DSH 事件，並在滿足特定條件時觸發多渠道警報。其核心價值在於確保用戶不會因爲分心而遺漏回合完成或等待審批的信號。

該插件提供多種通知渠道，每個渠道均可獨立在 Settings → Alerts 中開關：

標籤頁標題與圖標
- 回合完成：標籤頁標題前綴閃爍約 4 秒，Favicon 顯示徽章。
- 阻塞等待：如果當前有阻塞等待，標籤頁標題保持閃爍狀態。
聲音
- 短促的提示音（Web Audio API，風格類似 OpenCode/Codex）。只要瀏覽器標籤頁處於打開狀態，該聲音即可觸發。
原生系統通知
- 系統橫幅：通過 osascript（macOS）、notify-send（Linux）或 Windows Toast 觸發。
- 單生產者規則：當瀏覽器標籤頁的心跳活躍（小於 8 秒）時，由標籤頁擁有橫幅和聲音；當所有標籤頁關閉或凍結時，由主機接管，避免重複通知。
- 僅限迴環：原生通知僅限迴環觸發，遠程 Web GUI 無法觸發此功能。
瀏覽器通知回退
- 當原生通知二進制缺失或不可用時，自動使用瀏覽器原生的 Notification API 作爲備選方案。
首選項管理
- 支持存儲和刷新首選項。如果在首選項加載期間觀察到完成事件，這些事件會被暫存並在加載完成後刷新。

推薦使用插件自帶的安裝命令進行安裝。該命令會修改目標配置文件並執行依賴安裝，安裝過程中不會中斷 DSH。

    npx --yes github:shaomingbo/dsh-attention#v0.1.4

    npx --yes github:shaomingbo/dsh-attention#v0.1.4 status

    npx --yes github:shaomingbo/dsh-attention#v0.1.4 uninstall

該命令是冪等的，可以安全重複運行。

安裝或卸載完成後，需要手動重啓 dsh web，並在瀏覽器中硬刷新頁面（Ctrl+Shift+R 或 Cmd+Shift+R）以使更改生效。

首選項配置文件位於 $DSH_HOME/attention.json（默認路徑爲 ~/.dsh/attention.json）。

觸發時機：
- 回合完成：無條件觸發警報，包括用戶正在閱讀的回合。
- 審批/問題：僅當頁面處於後臺或未聚焦時觸發。當用戶正在查看頁面時，這些事件會保持靜音。
權限請求：首次訪問時，頁面可能會彈出 Toast 請求瀏覽器通知權限。該權限僅在原生通知不可用時作爲回退方案使用。
主機邏輯：主機監聽 approval/request 事件，但總是調用 next()，不直接響應審批。
環境依賴：原生系統通知依賴於系統環境變量（如 Linux 的 notify-send）。如果依賴缺失，插件會自動降級到瀏覽器通知。