前言¶
在使用 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 通知功能需要先在本机安装并注册协议，且测试通知功能需要在真机上验证。
