在使用 DeepSeek Harness 進行智能體開發時，會話往往包含多個步驟和中間狀態。開發者需要在頁面內快速確認任務完成、處理審批或查看錯誤，而系統原生的交互可能不夠直觀，或者歷史記錄機制不支持實時回溯。@idoall/dsh-notify 旨在解決這一場景下的狀態追蹤與即時反饋問題。
插件簡介¶
這是一個 DeepSeek Harness 插件，用於在頁面內展示任務通知。它提供清晰的狀態提示、可摺疊的通知堆棧、聲音反饋以及後臺標籤頁的視覺關注。通知僅以實時方式傳遞，記錄不會存儲在歷史記錄中。
核心功能¶
1. 通知樣式
支持「增強」或「柔和」兩種模式。增強模式使用清晰的狀態顏色（如綠色表示完成、藍色表示問題、琥珀色表示審批）和四秒的注意力條；柔和模式則是更低調的展示。卡片會一直保留，直到手動關閉、打開對應會話或在卡片內完成回答。
2. 可摺疊堆棧
通知以卡片形式堆疊在頁面右上角。默認開啓摺疊，新卡片完全可見，舊卡片保留在下方。頁面內存中最多保留 50 張卡片，並優先處理待辦操作。
3. 直接導航與回答
點擊卡片可直接跳轉至對應會話的特定輪次。卡片內提供與 Composer 兼容的選項，可直接在 Toast 中完成回答。
4. 聲音與後臺關注
內置 WebAudio 提示音，支持自定義音頻。即使頁面在後臺標籤頁，也能通過 Favicon 或標題前綴獲得視覺/聽覺提醒。
5. 狀態判定
通知在 Agent 進入 idle 狀態時觸發，而非僅僅基於文本完成或計時。這意味着只有任務真正停止時纔會產生卡片。
6. 任務噪聲控制
默認關閉子任務、後臺作業和流程工作流的完成通知，避免信息過載。
7. 版本檢測
設置頁面會檢測本地版本與 npm 最新版本的差異，並提供升級命令。
安裝與啓用¶
插件需要 DeepSeek Harness Web 配置文件支持。安裝命令如下：
dsh plugin --profile web add @idoall/dsh-notify@latest
也可以從 GitHub 直接安裝：
dsh plugin --profile web add "github:idoall/dsh-notify"
典型用法¶
安裝完成後，在設置中選擇通知樣式（Enhanced 或 Soft）。若需使用自定義聲音，需上傳文件到配置目錄的 <dataDir>/sounds/ 文件夾。支持的格式包括 mp3、m4a、aac、wav、ogg 和 flac，文件大小限制爲 1MB。
適用場景與注意事項¶
適用場景：需要精細管理長會話狀態、習慣在頁面內快速響應審批或問題的開發者。
注意事項：
* 插件僅註冊設置部分和頁面覆蓋層，不修改 DSH 源代碼。
* 通知記錄僅保存在內存隊列中，刷新或重載後不保留。
* 不支持 Service Worker、Web Push 或操作系統級通知矩陣。
* 插件要求 DeepSeek Harness 版本 >=0.1.7-rc.1 且小於 0.3.0。
* 插件名稱爲 @idoall/dsh-notify，但內部 Cordis 名稱和路由爲 dsh-notify。
該插件通過頁面內的輕量級交互，解決了 DSH 原生交互中狀態反饋不明確的問題。更多細節請查閱插件目錄或 GitHub 倉庫。
