前言¶
在 DeepSeek Harness（DSH）裏運行多輪對話、等待智能體完成目標時，終端或網頁常常不是唯一需要關注的窗口。dsh-notify 針對 DSH web 版提供對話完成通知：當應用處於後臺時，用 Windows toast 和提示音提醒回合完成、出錯、目標完成；當需要用戶回答或審批時，始終提醒。下面介紹它的功能、安裝方式和注意點。
這是什麼¶
aokamoaki/dsh-notify 是 DSH 社區插件，由 aokamoaki 維護，採用 MIT 許可證。它適用於 DSH web 版，桌面殼可選。插件以當前 dsh 進程權限運行，因此安裝前應檢查源碼、許可證和依賴來源。它與 DeepSeek 官方無關。
核心功能¶
下面按使用順序列出主要能力：
- 會話頭部提供鈴鐺：通知總開關和音量滑塊，操作即時落盤。
- 完成類通知僅在後臺觸發：web 頁面可見或桌面殼任一窗口聚焦時靜默。
- 提問和審批通知始終提醒，不因前臺而靜默。
- 總開關關閉後，所有通知全部靜默，重啓仍生效。
- toast 文案跟隨 Windows 顯示語言，支持中文與 English。
- 零配置起步，配置文件熱更新，無需重啓。
- 同會話 5 秒內不重複打擾；回合完成僅在空閒時提醒，並有 800ms 去抖；subagent 內部會話不通知。
- 提供 HTTP API，可讀取和更新配置，查詢和上報前臺狀態，且僅接受同源請求。
- Windows toast 與提示音由本地執行，支持聲音開關、彈窗開關和音量控制。
- 桌面殼可選，用於上報 shell 前臺狀態。
安裝與啓用¶
安裝命令爲：
dsh plugin --profile web add github:aokamoaki/dsh-notify
安裝後重啓 dsh web，插件即可生效。
如果是本地開發，可在 profile 的 package.json 中以 link 引入倉庫，例如：
"dependencies": {
"dsh-notify": "link:C:/path/to/dsh-notify"
}
同時確保 dsh.profile.bundles 含 dsh-notify。
典型用法¶
安裝並重啓後無需額外配置。默認行爲如下：
- 對話回合完成：後臺時提醒。
- 對話回合出錯：後臺時提醒。
- 目標完成：後臺時提醒。
- 提問：始終提醒。
- 審批：始終提醒。
想臨時關閉通知時，點擊會話頭部鈴鐺即可靜音；懸停鈴鐺可以調整音量。
配置文件位於：
~/.dsh/dsh-notify.json
會話頭部鈴鐺的操作會即時寫回該文件。
如果 dsh web 已在本機運行，可用下面命令做運行時 API 自檢：
curl http://127.0.0.1:3080/dsh-notify/config
開發或修改插件時，可運行以下命令驗證：
npm run check
npm test
npm run pack:check
適用場景與注意¶
該插件適合在 Windows 上使用 DSH web 的場景，並依賴 Node >=22.13。它通過 PowerShell 與 Windows 通知執行 toast 和提示音。
使用前注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼、許可證和依賴來源。 - peerDependencies 要求
@deepseek-ai/cordis ^4.0.1。 - HTTP API 僅接受同源請求，非瀏覽器來源會被拒絕。
- 前臺狀態爲內存態，不落盤；初始態爲後臺，避免上報鏈路故障時吞掉通知。
- 若
dsh-startup-guard檢測到插件損壞，會自動禁用，並在cordis.patch.yml追加disabled: true。 lib/client.js必須是 DSH client-bundle 產物格式，禁止 import 與 JSX。
結尾¶
它把 DSH 的完成、出錯、目標、提問和審批信號接到 Windows 通知上，適合後臺等待 DSH 的任務流。目錄頁與倉庫如下：
- 目錄頁：https://www.skillhub.cn/plugins/aokamoaki/dsh-notify
- GitHub：https://github.com/aokamoaki/dsh-notify
