前言¶
DeepSeek Harness (DSH) 依賴視覺反饋來傳達狀態，例如狀態點或側邊欄標記。一旦切換窗口，你既看不見也聽不見任何動靜，而智能體可能正等待你的決策或任務已完成。該插件將“等待你”和“已完成”轉化爲聲音信號，通過系統通知和標題欄標記，讓你即使離開屏幕也能掌握進展，且在確認狀態後不再打擾。
這是什麼¶
這是一個 DeepSeek Harness (DSH) 原生風格的通知音效插件。它利用 Web Audio API 實時合成提示音（無需音頻文件或網絡請求），並集成系統級通知與標題欄標記。插件由開發者 BillCx330 維護，採用 MIT 許可證。安裝後，它不會改變 DSH 的視覺設計系統，僅在需要時提供聽覺反饋。
核心功能¶
- 播放提示音：在等待決策、問題、計劃審查或任務完成時播放提示音。支持審批與問題區分。
- 後臺通知：當你在其他窗口時，系統會在後臺發送通知（內容爲審批原因或問題本身），點擊即可返回 DSH 窗口。
- 標題欄標記：在任務欄標題顯示“Waiting for you”或“Finished”標記。
- 重複提醒：對於未處理的決策，可在 1/5/15/30 分鐘後再次提醒，確認後停止。
- 子代理靜默：子代理（後臺任務）默認靜音，僅通知當前會話。
- 靜音時段：可設置靜音時段（例如 22:00–08:00），跨午夜自動延續。
- 聲音自定義：內置九種提示音（Bell, Chime, Ding 等），支持上傳自定義鈴聲（MP3/WAV/OGG，≤512KB），並支持音量控制。
- 一鍵更新：在設置中檢查 npm 版本並自動更新到插件自身目錄，更新失敗時支持回滾。
安裝與啓用¶
在終端中執行以下命令以安裝插件：
dsh plugin --profile <your profile> add github:BillCx330/dsh-plugin-notify-sounds
安裝完成後，需要在 DSH 中重啓才能加載新插件。
典型用法¶
- 設置聲音：在 DSH 設置頁面的“Sounds”選項卡中，選擇內置音效或上傳自定義鈴聲，調整音量。
- 配置提醒：設置重複提醒的間隔時間（例如 5 分鐘）和靜音時段（例如 22:00 至次日 08:00）。
- 使用場景：離開電腦去處理其他事務，DSH 運行智能體。當需要你決策時，系統會彈出通知並播放提示音；當你回來看到通知並點擊後，提示音停止。
適用場景與注意¶
- 權限說明：插件隨 DSH 進程運行，擁有 DSH 的權限。它僅讀取會話狀態並在本地播放聲音，不向外部服務器發送數據，僅與 DSH 本身通信以觸發窗口跳轉。
- 手動配置：偏好設置存儲在配置文件的
cordis.patch.yml中。手動修改該文件時，數值必須符合架構定義（音量 0–100，預設 ID，HH:MM 格式的時間），否則插件可能拒絕加載。 - 更新機制：一鍵更新僅將新版本的文件寫入插件自身目錄，不會修改 DSH 的配置文件或刪除舊文件（後續版本移除的文件會殘留，需手動卸載）。
短結尾¶
該插件通過聽覺反饋解決了 DSH 在多任務場景下的狀態遺漏問題，同時保持了對本地資源和配置文件的安全性。更多信息可參考社區目錄或 GitHub 倉庫。
