@xjwwjx/dsh-sonic
DeepSeek Harness Web 的声音通知插件：需要用户确认时播放提示音，任务完成时播放成功音，任务失败时播放独特的错误音；可在设置 → 常规中从 9 种合成音效中选择。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xjwwjx/dsh-sonic#aa1d72db40bbc3015080e8f39d68b33e8f7f28a7Sonic 以 @xjwwjx/dsh-sonic 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
音效提醒插件 —— 当需要用户确认、任务完成或任务失败时，在浏览器端播放提示音效。 面向 DeepSeek Harness Web。
ask_user_question 等待作答running 转为 idleerror，与完成音完全不同）：harness 发出 agent/error，即某个 step/turn 真实报错
idle 不再补一声完成音，一次失败只响一声aborted 分支，不会触发 agent/error，因此不会误报失败音| 音效 | 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 相同）：
~/.dsh/profiles/web/package.json 的 dependencies 加
"dsh-sonic": "file:<本包路径>"，并在 dsh.profile.bundles 列表加 "dsh-sonic"pnpm install（生成本包的链接）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 中补充即可。