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 实时合成，无需任何音频文件：

• 设置面板（设置 → 通用）：一键静音、音量滑块、分别挑选「确认音 / 完成音 / 失败音」，点击即试听；选择自动保存并同步给模型
• 模型工具：
  • 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