在 DeepSeek Harness（DSH）環境中運行智能體或進行復雜調試時，模型可能長時間處於後臺思考或輸出狀態，或者卡在等待審批、提問等環節。如果此時操作者切換了瀏覽器標籤頁，很容易錯過關鍵的消息節點。dsh-notify 插件通過瀏覽器原生通知機制，在模型開始輸出、輸出完成或需要你介入時，直接在桌面發送提醒，幫助你及時將注意力拉回工作流。
核心功能¶
該插件主要提供以下能力：
- 節點提醒：在模型開始新的一輪輸出時通知；在整輪輸出完成時通知。
- 狀態介入：當會話需要你的處理時通知，具體內容包括：
- 權限審批：顯示待審批的命令（如
bash）及原因（如危險）。 - 提問：直接顯示問題原文（超長內容會截斷並提示數量）。
- 計劃評審：提示打開會話進行評審。
- 權限審批：顯示待審批的命令（如
- 交互：點擊通知可直接聚焦頁面並打開對應的會話。
- 精細控制：提供 5 個獨立開關，支持中英雙語界面。默認開啓“僅頁面不可見時提醒”，以免正盯着頁面時被打擾。
- 多標籤頁優化：利用 Web Locks API 實現多標籤頁去重，避免同類通知重複堆疊。
安裝與啓用¶
前置條件：本機已安裝 dsh（可通過 npx @deepseek-ai/dsh web 啓動），且網絡可訪問 GitHub。
執行以下命令安裝：
dsh plugin --profile web add github:fxomomi/dsh-notify
注意：如果使用 pnpm ≥ 10，默認會拒絕運行 git 依賴的構建腳本，第一次 add 可能報錯。根據 dsh 提示，將打印出的包鍵（如 dsh-notify）複製進 profile 的 pnpm-workspace.yaml 文件中 allowBuilds 配置項，並重新執行 add。
安裝完成後，重啓 dsh web 進程，並在瀏覽器中刷新頁面。
配置與使用¶
- 打開 DSH 瀏覽器界面，進入「設置 → 通知」。
- 根據需求打開對應的開關（啓用通知、開始輸出、完成、需要處理等）。
- 點擊「申請通知權限」並允許。
注意：通知權限是每個瀏覽器獨立的，更換瀏覽器或機器需要重新授權。
技術細節與兼容性¶
- 配置存儲：由於 dsh 0.1.0-rc.6 的配置命名空間限制，第三方插件的設置命名空間讀寫會得到
settings-not-exposed，因此插件配置存儲在瀏覽器的localStorage中，而非 dsh 的設置系統。 - 兼容性要求：瀏覽器需支持 Notification API 與 Web Locks。Chrome / Edge / Firefox 的現代版本均可。插件開發與驗證基於 dsh
0.1.0-rc.6。
總結¶
dsh-notify 通過瀏覽器桌面通知解決了 DSH 環境下消息遺漏的問題，適合需要長時間運行智能體或頻繁進行多任務切換的開發者。更多細節可查閱插件目錄或GitHub 倉庫。
