前言¶
DeepSeek Harness（DSH）在執行某些操作（如工具調用審批或計劃複覈）時，需要人工介入。如果用戶不盯着界面，很容易錯過這些請求。dsh-sound-alert 插件通過監聽本機 DSH 實例的請求事件，在需要審批或選擇時發出聲音提示並彈出系統通知，幫助用戶在處理其他事務時也能及時響應。
這是什麼¶
這是一個由 zhangDSK-Xu 維護的 DSH 插件，核心功能是響一聲提示音並彈出系統通知。
當 DSH 需要你授權（審批策略爲 ask）或讓你做選擇（ask_user_question、計劃複覈）時，插件會立即響應。它不改變任何授權結果，只是旁聽事件並提醒用戶，確保不會遺漏重要的交互請求。
核心功能¶
- 聲音與通知：響一聲提示音並彈出系統通知。通知統一設爲
silent，聲音由插件負責，避免重複。 - Web Audio 合成：使用 Web Audio API 合成 5 種音色，無需加載音頻文件。音色包括：叮、叮咚（默認）、三連升調、鈴鐺、急促警報。
- 鈴鐺 UI：界面右下角常駐一個半透明的鈴鐺圖標。點一下可開關聲音；點旁邊的 ▾ 或右鍵可打開設置面板；按住鈴鐺可拖動到任意角落，鬆手自動吸附。
- 重複提醒：未處理時按間隔重複提醒（默認 5 秒），最多重複 10 次。達到次數上限或頁面有任何操作時立即停止。
- 標題閃爍：未處理時，頁面標題前會自動加上
🔔。 - 多實例監聽：插件默認監聽本頁實例以及
http://127.0.0.1:3080、http://127.0.0.1:19387。來自其它實例的通知會在正文末尾標出來源（例如來自 127.0.0.1:3080）。 - 完全透明：插件只是旁聽，不改變任何授權結果；卸載後行爲與安裝前完全一致。
安裝與啓用¶
前提：已安裝 DSH（Harness）。
安裝方式¶
- 通過界面安裝：
在 DSH 設置 → 插件中，將下面的倉庫地址填入安裝輸入框：
github:zhangDSK-Xu/dsh-sound-alert
- 通過命令行安裝（
web爲默認 Web 界面 profile，請根據實際情況替換）：
dsh plugin --profile web add github:zhangDSK-Xu/dsh-sound-alert
注意：桌面端 profile 無法使用 dsh plugin 命令操作，只能通過界面安裝。
卸載¶
dsh plugin --profile web remove dsh-sound-alert
典型用法¶
安裝完成後，插件會自動運行。以下爲常見操作：
- 開關聲音：點擊右下角的鈴鐺圖標。
- 打開設置：點擊鈴鐺旁邊的 ▾ 或右鍵鈴鐺。
- 調整位置：按住鈴鐺圖標拖動，鬆手後會自動吸附到最近的角落（右下、左下、右上、左上）。
- 測試提醒：在設置面板中可以手動發送一條測試提醒，或通過命令行手動觸發：
Invoke-WebRequest http://127.0.0.1:3080/dsh-sound-alert/test.json -Method POST -UseBasicParsing
適用場景與注意¶
- 適用場景：適合需要長時間運行 DSH 進程，且希望在不盯着屏幕的情況下，也能及時響應授權或選擇請求的用戶。
- 瀏覽器自動播放限制：瀏覽器策略要求頁面必須先有一次用戶交互才允許出聲。插件會在你第一次點擊或按鍵後“補響”這一次提醒。即使沒出聲，系統通知與標題閃爍仍會出現。
- 專注模式干擾：Windows 的專注助手/勿擾模式會靜音系統通知（不彈橫幅，但會進通知中心）。
- 多標籤頁行爲：如果打開多個瀏覽器標籤頁，每個標籤頁都會各自響一次。
- 必須保持頁面打開：必須至少有一個加載過插件的頁面處於打開狀態，插件纔會工作。
結尾¶
dsh-sound-alert 提供了一種非侵入式的提醒方式，通過聲音和通知讓 DSH 的交互流程更加透明。它不改變核心邏輯，只是作爲聽覺的延伸，確保在多任務處理時不會遺漏關鍵的審批或選擇步驟。
插件目錄：dsh-sound-alert - SkillHub
源碼倉庫：zhangDSK-Xu/dsh-sound-alert
