前言¶
在使用 DeepSeek Harness（DSH）時，當一輪任務完成或模型阻塞等待輸入時，缺乏直接的視覺或聽覺反饋。dsh-task-ask-notify 是一個 DSH 宿主側插件，它通過原生 Windows 11 通知和 WAV 提示音，解決了這一問題。當模型交還控制權或調用 ask_user_question 時，插件會立即發出提醒，不走過抖延遲。
核心功能¶
該插件提供以下能力：
- Windows 11 通知：彈出真實的系統通知，進入操作中心，並遵循你的 Windows 專注助手設置。
- WAV 提示音：播放提示音，支持自定義音效目錄和等概率隨機播放。
- 配置方式：支持通過配置文件或 DSH 插件界面進行配置。
- 自檢工具：提供適配器自檢工具，用於驗證基礎功能是否正常。
安裝與啓用¶
安裝過程通過 DSH 的插件管理器完成。插件本身不需要 Node.js 運行，Node.js 僅用於隨包附帶的工具。
-
準備代碼
將代碼放置在 DSH 插件目錄下。示例路徑爲：
%USERPROFILE%\.dsh\dsh-plugins\dsh-task-ask-notify
放置位置不影響功能，DSH 會通過plugin_manager讀取信息。 -
安裝 Bundle
在 DSH 中運行以下命令將 Bundle 裝入當前 Profile：
plugin_manager install_bundle %USERPROFILE%\.dsh\dsh-plugins\dsh-task-ask-notify
執行後若返回 `application: "applied"` 則生效；若返回 `restart-required` 則需重啓 DSH。
- 驗證安裝
運行自檢工具確認基礎能力：
node tools/win-alert-selftest.mjs
退出碼爲 `0` 表示自檢通過。隨後起一個任務並讓其完成，或讓模型提問，觀察是否收到通知和提示音。
典型用法¶
插件附帶了一些 Node.js 工具用於管理音效和測試：
- 運行自檢：
node tools/win-alert-selftest.mjs - 導入音效：將外部音效包複製到插件數據目錄：
node tools/import-audio.mjs --source "<你的素材包路徑>"
導入工具會對文件進行 SHA-256 校驗，且默認寫入 `%DSH_HOME%\plugin-data\dsh-task-ask-notify\`，修改後無需重裝即可生效。
- 生成默認提示音：生成用於兜底的
audio/_default/chime.wav：
node tools/gen-default-chime.mjs --check
環境與注意事項¶
使用前需確認環境滿足以下要求：
- 操作系統：Windows 10 2004+ 或 Windows 11。
- DSH 版本：0.2.0-rc.2 或更新（需要宿主插件的
Config與session/event接口）。 - PowerShell：系統自帶的 Windows PowerShell 5.1。
- Node.js：20+，僅用於運行測試和隨包工具，插件本身運行不需要 Node.js。
已知注意事項：
- 靜默失敗：若完全沒反應，可能是 AUMID 未在開始菜單註冊。此時 Windows 會接受 Toast 但不顯示。
- 適配器啓動方式：適配器不能使用
detached: true啓動，否則 Windows 會丟棄通知。
結尾¶
該插件爲 DSH 增加了系統級的通知能力，使任務狀態反饋更加明確。更多配置選項、音效目錄結構說明及排錯方法，請參考 GitHub 倉庫。
