音效提醒 xjwwjx/dsh-sonic

dsh-sonic 🔔 音效提醒

音效提醒插件 —— 需要用户确认、任务完成或任务失败时，在浏览器端播放提示音效。
面向 DeepSeek Harness Web。

功能

- 需要用户确认时 播放「确认音」：审批请求（沙箱提权、插件运行授权、工具审批）、ask_user_question 等待作答
- 任务完成时 播放「完成音」：agent 由 running 转为 idle
- 任务失败时 播放「失败音」（默认 error，与完成音完全不同）：harness 发出 agent/error，即某个 step/turn 真实报错
- 失败音优先：同一个 agent 报错后紧接着的 idle 不再补一声完成音，一次失败只响一声
- 用户按「停止」/取消走的是 aborted 分支，不会触发 agent/error，因此不会误报失败音
- 9 种音效 全部由 Web Audio API 实时合成，无需任何音频文件：

| 音效 | key | 特点 |
| 叮 | ding | 单音清脆 |
| 叮咚 | dingdong | 门铃双音 |
| 泡泡 | pop | 轻快气泡 |
| 风铃 | chime | 柔和三连音 |
| 成功 | success | 上扬琶音（完成音默认） |
| 哔 | beep | 电子短哔 |
| 注意 | alarm | 提醒双音 |
| 木琴 | marimba | 木琴敲击 |
| 错误 | error | 下沉低音（失败音默认） |

- 设置面板（设置 → 通用）：一键静音、音量滑块、分别挑选「确认音 / 完成音 / 失败音」，点击即试听；选择自动保存并同步给模型
- 模型工具：
- sonic_play —— 立即播放指定音效（试听/演示）
- sonic_status —— 读取当前面板选择状态

工作原理

┌─ Host (宿主组合内静态插件) ───────────────────────┐ │ approval/request ─┐ │ │ ask_user_question ─┼─► 通知队列 ──┬─ GET /sonic/drain ──┐ │ agent/status idle ─┤ │ (webServer 路由) │ │ agent/error ───────┘ │ │ │ POST /sonic/state ◄── 面板选择 ─────────┤ │ sonic_play (工具) ─┘ │ └──────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────┐ │ 浏览器 (Client) │ │ 每 1s 轮询 /sonic/drain → 播放对应音效 │ │ Web Audio 合成 9 种音效 │ │ 设置 → 通用 内的选择面板（settings.general.item）│ └──────────────────────────────────────────────────┘

安装（永久挂载）

作为一个 bundle 插件随 Web profile 自动加载（机制与 @liustack/modlens 相同）：

1. 把本包链接进 profile：在 ~/.dsh/profiles/web/package.json 的 dependencies 加 "dsh-sonic": "file:<本包路径>"，并在 dsh.profile.bundles 列表加 "dsh-sonic"
2. 在 profile 目录执行 pnpm install（生成本包的链接）
3. 重启 DeepSeek Harness Web —— 插件随组合自动加载，进程重启后依然在

cordis.patch.yml 会自动插入插件行（- id: dsh-sonic, name: dsh-sonic）。

动态版（会话内 cordis_define 加载）的源码保留在 examples/dynamic-host.js 与 examples/dynamic-client.js，仅作参考；动态版在进程重启后会丢失，静态版不会。

文件结构

dsh-sonic/
├── dsh/
│ ├── index.js # Host 半体（事件监听、通知队列、webServer 路由、模型工具） │ └── client.js # 浏览器半体（Web Audio 音效、轮询、设置面板） ├── examples/ # 动态版源码（参考） ├── cordis.patch.yml # bundle 插件行补丁 ├── package.json ├── README.md └── LICENSE

自定义音效

音效是 Web Audio 合成的一组音符（PRESETS，见 dsh/client.js），每个音符支持：

- freq / endFreq —— 起始/结束频率（滑音）
- at / dur —— 开始时间与时长
- type —— 波形（sine / triangle / square 等）
- gain / attack —— 音量与起音

想加新音效，往 PRESETS 里加一个条目，并在 Host 端 sonic_play 的 enum 中补充即可。

License

MIT