前言¶
用 DSH 跑任务时，典型的工作方式是把活儿交给智能体，自己切去处理别的事。麻烦在于你不知道什么时候该回来：任务可能在等你审批，也可能早就跑完了。于是只能反复切回页面确认进度，注意力被切碎，切回来还未必有新进展。
dsh-notification-sounds 用两个声音解决这个问题：AI 需要你操作时播放「任务等待」，主会话及其全部子代理稳定完成后播放「任务完成」。听到声音再回来即可。下面介绍这个插件的定位、功能与完整的安装启用步骤。
这是什么¶
dsh-notification-sounds 是一个面向 DeepSeek Harness Web UI 的声音通知插件，由 qq33357486 维护，许可证为 MIT。官方一句话描述是「跨平台的等待用户与完成声音通知」。社区目录页将其归入「客户端」分类。
它只做提醒这一件事，触发时机有两个：
| 时机 | 声音 |
|---|---|
| AI 需要用户操作：需要审批、确认、计划审核或回答问题 | 「任务等待」 |
| 一个主会话及其全部子代理稳定完成 | 「任务完成」 |
有两点容易误解，README 中专门做了说明：
1、子代理单独完成不会响。只有所属主会话及其全部子代理都稳定完成，才播放「任务完成」。
2、多个主会话彼此独立，各自触发各自的「任务完成」。
核心功能¶
设置页面¶
插件在 DSH Web UI 中注册了 Settings → General → DSH Notification Sounds 设置页。进入后可以打开通知，并试听「任务等待」和「任务完成」两个声音。首次进入页面后需要点击或按键一次，以解锁浏览器音频，之后声音提醒才能正常播放。
面向 web 平台¶
插件通过 package.json 中的 dsh.client 配置声明自己面向 web 平台：
{
"dsh": {
"client": {
"platform": "web"
}
}
}
对应的安装与更新命令均使用 web Profile。
安装与启用¶
先确认环境：插件 package.json 中标注的版本为 0.1.2，engines 要求 node ^22.19.0 || >=24。
1、执行安装命令：
dsh plugin --profile web add dsh-notification-sounds
2、重启现有的 DSH Web 进程。注意不要启动第二个 Web 服务，插件需要重启现有进程才能生效。
3、重启后进入 Settings → General → DSH Notification Sounds，打开通知并试听两个声音。首次进入页面后点击或按键一次，解锁浏览器音频。
经过上面的步骤，插件即可工作。如果想确认 DSH 是否正确加载了插件，执行：
dsh --profile web --dump-config
在输出中检查存在 id: notification-sounds 和 name: dsh-notification-sounds 两项，存在即说明插件已被识别。
更新¶
已安装的插件用下面的命令更新：
dsh plugin --profile web up dsh-notification-sounds
典型用法：让 AI 帮你安装¶
README 提供了一段提示词，复制给 AI 即可让它代办安装与配置：
请安装并配置 dsh-notification-sounds：
1. 检查 dsh 是否可用，默认使用 web Profile。
2. 执行 dsh plugin --profile web add dsh-notification-sounds；如果已安装则执行 dsh plugin --profile web up dsh-notification-sounds。
3. 用 dsh --profile web --dump-config 验证存在 id: notification-sounds 和 name: dsh-notification-sounds。
4. 不要启动第二个 Web 服务；提醒我重启现有的 dsh web。
5. 告诉我进入 Settings → General → DSH Notification Sounds，打开通知、试听「任务等待」和「任务完成」，并点击或按键一次解锁音频。
6. 最后汇报安装版本和验证结果，不要修改 DSH 官方源码。
这段提示词把安装、重启、验证、设置页操作和注意事项都列全了，与自己手动操作是同一套流程。
适用场景与注意事项¶
适合在 DSH Web UI 里跑长任务、经常切走做别的事的人；如果同时开多个主会话，每个会话独立触发完成提醒，能省去来回查看的动作。
安装与使用前有几点需要留意：
1、插件会以当前 dsh 进程的权限运行。安装前建议先到仓库查看源码与许可证（MIT），确认可以接受再装。
2、DSH 的理念是「一切皆插件」，但社区维护的插件目录是独立站点，与 DeepSeek / 幻方没有官方从属关系，选择插件时自行把关。
3、不要启动第二个 Web 服务；需重启现有的 dsh web 进程，插件才会生效。
4、「任务完成」的触发条件是主会话及其全部子代理稳定完成，子代理单独完成不会响。
结尾¶
dsh-notification-sounds 解决的是一个很具体的问题：让 AI 安静工作，该回来时用声音叫你。一条命令安装，重启进程后到设置页打开通知、试听两个声音即可用上。
- GitHub 仓库：https://github.com/qq33357486/dsh-notification-sounds
- 社区插件目录页：https://www.skillhub.cn/plugins/qq33357486/dsh-notification-sounds
