前言¶
DSH 的理念是「一切皆插件」。社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
如果使用 DSH web profile，需要确认 AI 是否已经完成回复时，可以用一个提示音作为反馈。dsh-notify-sound 在回合结束时播放内置提示音，并支持在 DSH 设置页中更换音效、调整音量与开关。下面介绍它的功能、安装与使用方式。
这是什么¶
dsh-notify-sound 是一个 DSH web 插件，由 xxxxxxxyu 维护。
它监听 turn/end（回合结束）事件，并通过 WebSocket 实时推送通知；前端收到通知后播放所选音效。插件代码采用 MIT License。
核心功能¶
回复完成提示¶
- AI 回复完毕后自动播放提示音
- 监听
turn/end（回合结束），并通过 WebSocket 实时推送，零轮询 - 默认音效为
staplebops-01.aac - 音效文件内置在插件中，无需联网
设置项¶
- 内置 44 个音效，可在设置页下拉选择
- 设置页支持开/关、音效选择、音量调节和试听
- 设置即时保存，重启后保留
- 设置存储在 DSH 设置服务，且全局生效
安装与启用¶
先确认运行要求：
- DSH web profile（
dsh web） - Node.js >= 20
从 GitHub 安装¶
下面命令中的 <you> 按原文保留为占位符：
dsh plugin --profile web add git+https://github.com/<you>/dsh-notify-sound.git
安装后确认包已加入配置项：
dsh.profile.bundles
然后重启 dsh 服务生效。
本地开发安装¶
先在 web profile 目录中安装本地包：
cd C:/Users/<you>/.dsh/profiles/web
pnpm add file:/path/to/dsh-notify-sound
如需开发构建，执行：
npm install
npm run build
构建产出：
lib/index.js
lib/client.js
典型用法¶
打开 DSH 设置页，左侧导航出现“提示音”。
可操作项如下：
| 设置项 | 说明 |
|---|---|
| 回复完成提示音 | 开关 |
| 提示音 | 下拉选择内置音效，共 44 个 |
| 试听 | 播放当前选中的音效 |
| 音量 | 0 ~ 100% 滑块 |
配置与接口¶
偏好存储在 DSH 设置服务中，namespace 为：
dsh-notify-sound
插件提供以下偏好 API：
/notify-sound/api/sounds.list
/notify-sound/api/prefs.get
/notify-sound/api/prefs.update
所有路由经过与 /api 网关相同的浏览器信任围栏（loopback / 同源校验）。
依赖与许可证¶
依赖方面，package.json 中声明的 peerDependencies 包括：
@deepseek-ai/cordis ^4.0.1
react
react-dom
其中 react 与 react-dom 为可选。
package.json 中声明的配置项为：
dsh.bundle.patch
值为：
./cordis.patch.yml
许可证方面，插件代码采用 MIT License。内置音效来自 Stephanvs/opencode-sfx，音效为 MIT 许可，版权归其作者。
适用场景与注意¶
适合使用 DSH web profile，并希望以声音确认 AI 回复完成的开发者或使用者。
插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
设置全局生效；音效内置且无需联网，适合不想依赖外部音频资源的场景。
结尾¶
dsh-notify-sound 提供了“回复完成提示音”的完整链路：安装、设置页配置、设置保存和重启保留。如果只需要一个轻量的完成提示，可以先按上面的步骤安装并试听。
插件目录页：https://www.skillhub.cn/plugins/xxxxxxxyu/dsh-notify-sound
GitHub：https://github.com/xxxxxxxyu/dsh-notify-sound
