前言¶
在使用 DeepSeek Harness (DSH) 時，審批請求可能會因爲窗口切換或注意力分散而被忽略。dsh-approval-chime 是一款用於處理聽覺反饋的插件：當審批請求出現時，它會在後臺合成聲音提示，並在窗口不在前臺時彈窗通知。
核心功能¶
- 審批提示音：只在審批請求出現時發聲，不改變審批行爲。
- 內置音色：提供風鈴、鈴鐺、蜂鳴三種音色，均爲 WebAudio 現場合成，不加載外部文件。
- 本地音頻導入：支持導入本地音頻作爲音色（上限 5MB，最多 50 個）。
- 按會話獨立設置：每個會話可單獨靜音或指定音色與音量。
- 無聲環境自證：顯示已觸發次數與上次觸發時間，確認插件在工作。
- Windows 系統通知：窗口不在前臺時彈真通知（默認關閉）。
- 測試通知功能：測試按鈕驗證通知鏈路，3 秒冷卻。
安裝與啓用¶
使用官方安裝命令將插件添加到 DSH。
dsh plugin add https://codeload.github.com/Cloudto1/dsh-approval-chime/tar.gz/refs/heads/main
安裝完成後重啓 DSH。進入「設置 → 通知提醒」頁面，確認該插件的分區頁已出現。觸發一次審批請求，應能聽到提示音。
使用方法¶
- 在「設置 → 通知提醒」中配置音色、音量及開關。
- 點擊「試聽」按鈕，解鎖瀏覽器的自動播放限制。
- 點擊「測試通知」按鈕，驗證通知鏈路是否正常（需先完成安裝）。
- 在審批列表中，點擊會話標題旁的鈴鐺圖標，可單獨靜音該會話。
配置與存儲¶
插件的設置項位於 $DSH_HOME/settings.yaml 的 approval-chime: 段。
| 字段 | 類型 | 默認值 | 含義 |
|---|---|---|---|
enabled |
boolean | true |
關閉後不產生任何聲音。 |
volume |
number 0..100 |
70 |
音量大小。 |
tone |
string | chime |
音色（chime/bell/beep 或 custom:<uuid>）。 |
nativeToast |
boolean | false |
開啓 Windows 系統通知。 |
按會話的獨立設置存儲在 <DSH_HOME>/approval-chime/sessions.json 文件中，不進全局設置文檔。Windows 通知功能需要先運行 deploy/native-toast/install.ps1 腳本進行註冊。
注意事項¶
- 不參與審批流程：插件不註冊
approval/request監聽，不改變審批決策路徑。 - 測試通知機制：測試通知的 key 格式爲
test:<ms>:<n>，永遠無法批准任何審批。 - 環境要求：Windows 通知功能需要先在本機安裝並註冊協議，且測試通知功能需要在真機上驗證。
