前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在開發智能體或配置多任務工作流時，開發者經常需要處理並行任務、後臺任務或等待人工介入。如果一直盯着頁面，容易遺漏關鍵狀態變更。dsh-chime-alerts 插件旨在解決這一問題，通過聲音提醒讓 Agent 工作事件在特定時刻發出提示。
該插件由 nienieai 維護，遵循 MIT 許可證。它不依賴外部音頻文件，默認使用瀏覽器合成的零版權負擔聲音，並提供跨平臺的系統蜂鳴支持。
核心功能¶
插件支持對十類獨立事件進行聲音控制，每類事件均可單獨設置開關、聲音和音量。
- 事件類型：支持任務完成、子任務完成、後臺任務完成、需要授權、插件授權、Agent 提問、計劃評審、目標受阻、其他打斷、後臺任務失敗。
- 混合發聲：提供網頁響鈴（Web Audio 合成音）與宿主蜂鳴（系統音效）兩種方式，並獨立控制。
- 工作區靜音：側欄每個工作區旁設有靜音按鈕，可按工作區獨立靜音。
- 跨平臺系統音：宿主蜂鳴支持 Windows wav、Linux freedesktop 主題音、macOS afplay。
- 聲音自定義：支持內置音效或上傳自定義音頻（動態版 ≤5MB，靜態版 ≤3MB）。
- 測試覆蓋：包含 247 項自動化測試斷言。
安裝與啓用¶
使用官方 CLI 進行安裝。
dsh plugin --profile web add dsh-chime-alerts
安裝完成後，需重啓 DSH 並重新打開網頁標籤頁以生效。
典型用法¶
- 打開 DSH 設置頁面，進入「聲音提醒」。
- 啓用總開關。
- 爲不同的任務類型配置聲音或音量。
- 在工作區側欄點擊喇叭圖標，快速靜音該工作區的所有提醒。
- 若使用靜態安裝，可在設置頁底部查看版本號確認加載狀態。
適用場景與注意¶
該插件適合需要同時監控多個任務狀態或長時間運行後臺任務的開發者。
需注意以下幾點：
* 權限與依賴：插件僅覆蓋本 DSH 進程內宿主能觀察到的事件。它依賴 DSH 內部契約（事件名與參數簽名），並非公開 API，DSH 升級可能導致行爲變化。
* 瀏覽器依賴：瀏覽器音需要頁面處於打開狀態。頁面關閉時，若未開啓宿主蜂鳴，則不會發聲。
* 平臺實測：Linux / macOS 的分支代碼已實現並通過 Node 模擬測試，但尚未在真實機器上實測。
* UI 適配：設置頁導航圖標與工作區靜音按鈕依賴特定的外殼 DOM 結構（CSS hack / 固定定位注入），外殼改版需同步適配。工作區行內靜音按鈕在真實瀏覽器中尚未驗證，可能不顯示。
結語¶
dsh-chime-alerts 提供了一種輕量級的聽覺反饋機制，通過獨立的聲音配置幫助開發者專注於核心業務邏輯。更多細節可參考 GitHub 倉庫 或 社區目錄。
