DSH 提示音插件（dsh-plugin-notification-sounds）
为 DSH（DeepSeek Harness） 提供可自定义的事件提示音：不同事件分别设置不同的声音，并且每个事件都可以上传本地音频文件作为提示音。
> GitHub Tag：dsh-plugin
功能
| 事件 | 触发时机 | 默认音效 |
|---|---|---|
开始运行 start | 代理开始处理一轮任务 | 短促单音（C5） |
成功完成 success | 一轮任务正常结束 | 上行双音（G5 → C6） |
异常中断 error | 任务出错（step/turn 错误） | 低沉警示音（方波下行） |
需要审批 approval | 弹出审批请求 | 叮咚双音（E5 → A5） |
子代理完成 subagent-end | 后台子代理结束 | 轻快双音（D5 → F#5） |
- 每个事件可独立：启用/停用、试听、上传本地音频（常见音频格式，单个最大 2MB）、恢复默认
- 总开关 + 音量（0–100%）
- 默认音效由代码合成（WAV，无外部资源依赖），文件版本见
assets/目录 - 自定义音效与全部配置持久化到工作区根目录
.dsh-notification-sounds.json，插件重启后依然保留 - 提示音在浏览器页面中播放（页面打开时生效）
事件检测原理
agent/status：running→ 开始运行；idle→ 结束（配合agent/error判断成功还是异常）agent/error：记录错误标记，回合结束时触发「异常中断」approval/request：审批瀑布事件触发「需要审批」（仅当审批真正需要用户决定时）subagent/end：子代理结束触发「子代理完成」
安装（常驻插件）
本插件是标准的 DSH web 插件包（Host 半边 lib/index.js + 浏览器半边 lib/client.js），安装到 profile 后重启 DSH 即常驻生效。
方式一：从 GitHub 安装（推荐）
dsh plugin --profile web add github:Heldea-xianmiao/dsh-plugin-notification-sounds#main方式二：本地源码链接安装
git clone https://github.com/Heldea-xianmiao/dsh-plugin-notification-sounds.git
dsh plugin --profile web add link:<仓库目录>后续更新本地源码版：git -C <仓库目录> pull --ff-only，然后重启 DSH。
安装后重启 dsh web，打开 设置 → 提示音 Sounds 即可配置。
目录结构
├── lib/
│ ├── index.js # Host 半边（事件监听、HTTP API、音效合成与持久化）
│ └── client.js # 浏览器半边（设置面板、音频播放、上传）
├── assets/ # 5 个默认音效的 WAV 文件（由脚本生成）
├── scripts/
│ └── gen-default-sounds.mjs # 重新生成默认音效：npm run gen:sounds
├── src/ # 动态插件版源码（cordis_define 用，旧格式）
├── cordis.patch.yml
├── package.json
└── README.mdLicense
[MIT](./LICENSE)