前言¶
用 DSH Web UI 跑智能体时，回合往往在后台结束，或 Agent 通过 ask_user_question、审批流程等你输入。若一直盯着界面，容易错过；切到别的标签页时更明显。浏览器通知可以补一部分，但需要额外权限，且和「这一回合刚跑完」的语义并不一一对应。下面介绍客户端插件 dsh-finish-sound：在回合结束、以及 Agent 向你提问两类事件上播放短提示音，并在设置里统一开关、调音量与试听。
这是什么¶
dsh-finish-sound 是面向 DSH Web UI 的客户端插件，维护者为 mkpoli。它在两类事件上播放不同的短 cue：任意会话里某一回合结束、以及 Agent 发起提问或审批等待你操作时。插件自带由 MOSS-SoundEffect-v2.0（Apache-2.0）生成的 WAV，可离线播放；也可在本浏览器内替换为自定义音频。社区目录页：https://www.skillhub.cn/plugins/mkpoli/dsh-finish-sound；源码与说明：https://github.com/mkpoli/dsh-finish-sound。
核心功能¶
两种事件、两种音色¶
| 事件 | 说明 | 内置文件 |
|---|---|---|
| 回合结束 | 任意会话中回合结束都会触发，不限于当前前台标签；连续排队的多回合只在全部结束时响一次 | assets/finish.wav（两颗明亮马林巴音，相隔一步） |
| Agent 提问 | ask_user_question 或审批开始等待你时 |
assets/question.wav（两颗更快、更高、更柔的马林巴上行音） |
若同一快照既结束回合又进入提问等待，只播放提问 cue。各 clip 的 prompt 与 seed 见仓库 lib/sounds.js 中的 CLIP_PROVENANCE。
设置入口¶
Settings → General → Event sounds 在本浏览器内统一控制两种 cue 的开关、音量，并可分别试听。Composer 侧提供静音相关能力（与简介中的 composer mute 一致，具体 UI 以 Web 设置页为准）。
自定义音频¶
每种 cue 可换成浏览器能解码的音频文件（WAV、MP3、OGG 等），大小不超过 2 MB、时长不超过 10 秒；文件保存在本浏览器 IndexedDB。选择 Use built-in 可恢复插件内置 clip。
安装与启用¶
通过 DSH 插件管理器（Plugins → Add plugin）填写：
github:mkpoli/dsh-finish-sound
或在命令行为 web profile 添加并写入 bundle：
dsh plugin --profile web add github:mkpoli/dsh-finish-sound
随后在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 中加入 "dsh-finish-sound"，并重启 dsh web。包内带有 cordis.patch.yml 注入 loader；浏览器端通过包的 dsh.client 声明加载。
Release 附带的预构建包：
dsh plugin --profile web add https://github.com/mkpoli/dsh-finish-sound/releases/latest/download/dsh-finish-sound.tgz
本地目录可用 link:/path/to/dsh-finish-sound，用法与上述 spec 相同。
典型用法与行为注意¶
- 安装并重启
dsh web后，打开 Settings → General → Event sounds，打开事件音、调节音量并试听两种 cue。 - 在后台会话跑完一轮，应听到结束音；Agent 弹出提问或审批等待时，应听到提问音（与结束音不同）。
- 浏览器在未发生用户手势前会锁定音频：若 cue 触发过早，会在你下一次点击或按键时播放，除非新回合已开始。
- 需要个性化时，在设置里为对应事件上传短音频；不满意时用 Use built-in 还原。
适用场景与安装前注意¶
适合长时间用 DSH Web UI、多标签或多会话并行、又不想依赖系统通知的场景。插件属于 DSH 生态中的客户端类扩展；目录站点 skillhub.cn 为社区索引，与 DeepSeek / 幻方无官方从属关系。
安装前建议浏览 GitHub 源码与 MIT 许可证（内置 clip 为 Apache-2.0 模型输出）。插件随当前 DSH Web 进程与浏览器环境运行，自定义音频仅存本机 IndexedDB；敏感环境请自行评估后再启用。
结尾¶
dsh-finish-sound 用两种短 cue 区分「回合结束」与「Agent 在等你」，设置集中、可离线、可换音。需要安装 spec 与行为细节时，以 README 为准：
