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 实例才能生效。