前言¶
在 DeepSeek Harness (DSH) 的使用場景中，當智能體在後臺運行或頁面被最小化時，任務完成或需要人工介入（如審批、提問）的信號容易被忽略。dsh-ui-task-notify 解決了這個問題，它通過監聽主機計算出的智能體狀態，在特定條件下觸發瀏覽器通知和系統提示音。
是什麼¶
這是一個由 ivvan3016 維護的插件，屬於聯網工具類別。它不渲染額外 UI，也不發送 RPC，而是利用 DSH 客戶端運行時已接收到的 host/session-status 和交互請求幀，向操作系統發出通知。
核心功能¶
該插件提供以下能力：
- 瀏覽器通知與系統提示：當智能體在頁面隱藏狀態下完成任務時，觸發 Windows 瀏覽器通知和系統 Toast（包含系統提示音），即使瀏覽器窗口被最小化也能顯示。
- 待處理交互提醒：當智能體處於等待狀態（需要批准、回答問題或計劃審查）時觸發提醒。
- 狀態反應：反應於主機計算的智能體狀態（運行/空閒）。
- 可配置設置：通過插件配置卡片調整通知行爲。
安裝與啓用¶
使用官方 npm 包進行安裝。
dsh plugin --profile web add dsh-ui-task-notify
安裝後，通過以下步驟啓用並授權通知：
- 打開 設置 -> 插件 -> 插件配置。
- 找到 任務完成提醒 配置卡片。
- 在 系統通知 行點擊 授權 按鈕，向瀏覽器申請通知權限。
- 授權後，按鈕狀態變爲“已授權”。當智能體完成工作或等待交互時，若頁面處於隱藏狀態，將彈出系統通知。
配置說明¶
在插件配置卡片中，可以通過布爾字段控制行爲：
- enabled：總開關，設爲
false時插件停止工作。 - onlyWhenHidden：僅在頁面隱藏時提醒，默認
true。若設爲false，頁面可見時也會提醒。 - includeSubagents：是否包含子智能體完成時的通知，默認
false。 - interactionAlert：是否在等待交互（批准、問題、計劃審查）時提醒，默認
true。
限制與注意¶
- 依賴 Notification API：需要瀏覽器支持通知 API。
- 標籤頁狀態：已關閉或被丟棄的瀏覽器標籤頁無法觸發通知，頁面必須保持存活。
- 子智能體默認靜音：默認不提醒子智能體的完成情況，需手動開啓
includeSubagents。 - 無 KV Cache 影響：該插件不涉及 Prompt、消息或 KV Cache 的處理。
- Git 安裝限制：通過 Git 安裝時，
pnpm可能會阻止構建，需在pnpm-workspace.yaml中添加允許列表（具體見 GitHub 倉庫說明）。
結尾¶
該插件適合需要在後臺運行 DSH 任務並希望及時收到完成或待處理信號的開發者。通過系統通知，可以在不保持頁面可見的情況下掌握任務進度。
