dsh-sound-notify

前言¶

DeepSeek Harness (DSH) Web 端在長時間運行智能體任務時，如果用戶切換到其他窗口或後臺運行，僅靠視覺提示可能不夠直觀。dsh-sound-notify 是一個 DSH Web 插件，用於在特定事件發生時播放提示音，解決掛機任務“聽聲辨位”的問題。

功能¶

• 兩種事件音效：回合完成時播放單聲，需要人工介入（如審批、提問、plan 審閱）時播放雙聲。
• 自定義音頻：支持在設置頁選擇本地 mp3 或 wav 文件，配置會以 data URL 形式寫入配置快照，隨 DSH 配置同步到其他機器。
• 合成音回退：未選擇音頻文件時，使用內置的 Web Audio 合成音作爲兜底。
• 視覺兜底：事件發生時，標籤頁標題會閃爍提醒（如「🔔 任務完成」），作爲聲音被瀏覽器攔截時的備選方案。
• 後臺監聽：不分前臺或後臺，事件觸發即播放。
• 零構建架構：採用雙半插件架構（宿主半 + 瀏覽器半），無構建步驟。

安裝與啓用¶

安裝命令：

dsh plugin --profile web add github:Vuitier/dsh-sound-notify

安裝後需要重啓一次正在運行的 DSH Web 實例，新打開的頁面纔會裝載該插件。

使用方法¶

可以通過 DSH Web 界面或配置文件啓用。

界面操作¶

打開 DSH Web → 設置 → 提示音，啓用開關、調整音量，並選擇對應的提示音文件。

配置文件¶

直接修改 $DSH_HOME/settings.yaml（通常位於 ~/.dsh/settings.yaml）：

dsh-sound-notify:
  enabled: true
  volume: 0.6
  useSynthFallback: true

注意事項¶

• 配置體積：自選音頻以 data URL 格式存儲在 settings.yaml 中，文件越大配置文本體積越大（約 1MB mp3 ≈ 1.4MB 文本），建議使用短音頻。
• 瀏覽器策略：瀏覽器的自動播放策略要求頁面在用戶有過一次交互後才能播放聲音。首次安裝後若未響，嘗試點擊頁面任意處。
• 重啓要求：安裝後必須重啓一次 Web 實例才能生效。