前言¶
用 DeepSeek Harness（DSH）跑智能体时，界面里常有需要你点选的选项卡、工具权限批准，以及一轮对话结束这类「等你看一眼」的时刻。人若同时开别的窗口或暂时离开屏幕，很容易错过。单靠视觉提示不够时，可以在这些节点加一声短提示音。下面介绍社区插件 dsh-notification-sound（维护者 YUsaltyfish，分类：客户端），在三个固定时刻播放音效，并支持替换为自己的音频文件。
这是什么¶
dsh-notification-sound 是 DSH 的 Cordis 插件（npm 包名 dsh-notification-sound，当前资料中版本为 0.2.2，许可证 MIT）。它在以下三个时刻各响一声：
- AI 弹出选项卡向你提问
- 有工具请求你批准
- 一轮对话结束
音效可使用插件自带文件，也可放到自定义目录或在配置里指定路径。仅支持 Windows 10 / 11（README 明确说明）。
社区目录页：https://www.skillhub.cn/plugins/YUsaltyfish/dsh-notification-sound
源码与说明：https://github.com/YUsaltyfish/dsh-notification-sound
核心功能¶
- 三档触发：问询（选项卡提问）、权限（工具批准）、结束（一轮对话结束），可分别用
notifyOnQuestion/notifyOnApproval/notifyOnTurnEnd开关（默认均为true）。 - 自定义音频：默认从插件内
sounds\读取；也可配置soundDirectory，或为三个时刻单独设置questionSound/approvalSound/endSound。 - 格式：支持
.wav、.mp3、.m4a、.wma、.aac、.flac（文档建议优先.wav）。 - 行为控制：总开关
enabled（默认true）；同种声音最小间隔cooldownMs（默认800ms）；rootAgentsOnly（默认true）表示只对人直接面对的会话播放。 - 试听工具：可通过让 AI 调用
fish_beep试听；若异常，将其返回的detail提供给 AI 排查。
插件以当前 DSH 进程权限运行；安装前建议自行查看 GitHub 源码与 MIT 许可证。
安装与启用¶
桌面端（desktop profile）安装命令如下（须与 README 一致，勿自行拼接其它 owner/repo 形式）：
dsh plugin --profile desktop add github:YUsaltyfish/dsh-notification-sound
桌面端通常会自动加载插件。若使用命令行 Web 版（dsh web），将命令中的 desktop 换成 web，并重启一次 DSH。
运行环境（来自 package.json）：Node ^22.19.0 || >=24.0.0，DSH >=0.1.0-rc.1。
典型用法：替换自带音效¶
方式一：覆盖插件目录下的默认文件名¶
把音频分别改名为 question.wav（问询）、approval.wav（权限）、end.wav（结束），放入：
%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-notification-sound\sounds\
注意：升级或重装插件会覆盖该文件夹；若需长期保留自定义文件，宜用方式二。
方式二：独立文件夹 + cordis.patch.yml¶
将音效放在任意目录，在 %USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml 末尾追加（保存后约一两秒生效，无需重启）：
- id: notification-sound
config:
soundDirectory: 'D:\我的音效' # 再按需加 questionSound / approvalSound / endSound
文档说明：修改配置时是整段替换该插件的 config，改设置时需把希望保留的项一并写上。
配置项一览¶
| 设置 | 默认 | 作用 |
|---|---|---|
soundDirectory |
空 | 自定义音效文件夹；留空用自带 sounds\，再找不到用系统音效 |
questionSound / approvalSound / endSound |
系统音效 | 三个时刻各自的音频（文件名或完整路径） |
notifyOnQuestion / notifyOnApproval / notifyOnTurnEnd |
true |
分别开关三个时刻 |
enabled / cooldownMs / rootAgentsOnly |
true / 800 / true |
总开关 / 同种声音最小间隔(ms) / 只对人面对的会话响 |
适用场景与注意¶
适合：在 Windows 10/11 上使用 DSH 桌面端或 Web 版，希望「选项卡提问、权限批准、一轮结束」时有听觉提醒的开发者或日常使用者。
注意：
- 平台限制为 Windows 10/11，其它系统不在 README 支持范围内。
- 插件与 DSH 同属「一切皆插件」的社区生态；SkillHub 目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。
- 安装前请核对源码与许可证；插件权限等同于运行 DSH 的用户环境。
试听与卸载¶
试听：让 AI 调用 fish_beep；出问题则将其返回的 detail 贴给 AI 协助排查。
卸载：
dsh plugin --profile desktop remove dsh-notification-sound
（Web 版同样将 desktop 换为 web。）
dsh-notification-sound 把 DSH 里三类常见「需要你介入」的时刻用短音标出来，并允许自定义音效与细粒度开关。更多信息见 SkillHub 目录页 与 GitHub 仓库。
