前言¶
DeepSeek Harness (DSH) 是一個插件化的智能體開發工具。在開發過程中，往往需要手動審批、回答模型提問，或者等待後臺任務跑完。如果窗口處於後臺，這些狀態很容易被忽略。dsh-notify 是一個 DSH Web GUI 通知插件，用於在需要介入或任務結束時提醒。它沒有第三方依賴，全部邏輯運行在瀏覽器端。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add github:printz1/dsh-notify
安裝完成後，需要重啓 DSH 後端並刷新瀏覽器頁面（客戶端 bundle 是頁面加載時才拉的）。
界面與入口¶
- 鈴鐺按鈕：在會話頭部右上角。點擊該按鈕可以請求系統通知權限或手動開啓總開關。
- 設置面板：詳細配置在
設置 → 通知中。設置面板使用settings.section註冊，顯示在設置列表的最後。
通知功能與配置¶
插件提供三種通知渠道：系統通知、頁面內氣泡、提示音。
觸發場景¶
支持以下場景的提醒，默認狀態見下表：
| 場景 | 說明 | 默認 |
|---|---|---|
| 需要你審批 | 模型提問或計劃審閱 | 開 |
| 模型在等你回答 | 模型提問或計劃審閱 | 開 |
| 一輪指令結束 | 任務從 running 變爲 idle | 開 |
| 後臺任務結束 | 任務完成、中斷或失敗 | 開 |
| 會話出錯 | 任務出錯 | 開 |
| 子會話結束 | 子任務跑完 | 關 |
過濾與勿擾¶
- 前臺靜音：默認頁面在前臺且聚焦時不提醒。
- 免打擾時段：設置時間段（如
23:00-08:00），時段內完全不提醒。 - 時長下限：只提醒運行超過指定秒數的任務。
- 提醒節流：作用於“一輪結束”和“後臺任務”，審批、提問、出錯永不節流。
- 靜音指定會話：將當前會話加入靜音名單，靜音後該會話完全不提醒（包括審批）。
配置存儲¶
配置存儲在 localStorage 的 dsh-notify:config 鍵下。舊配置鍵會在首次加載時自動遷移。
技術實現與自檢¶
- 架構：Host 半側是一個空的 cordis 插件，全部邏輯都在
lib/client.js。 - 開發調試：支持使用
dsh plugin --profile web add link:/path/to/dsh-notify進行軟鏈安裝，修改文件後即時生效（需重啓後端 + 刷新頁面）。 - 自檢腳本：
node tools/verify-install.mjs：驗證宿主是否正確識別該客戶端包。node tools/selftest.mjs：驗證通知行爲是否正常（包含 122 項斷言）。
卸載¶
dsh plugin --profile web remove dsh-notify
卸載後需要重啓後端。
