dsh-fish-sound-notify

三个时刻各响一声 Windows 系统提示音： AI 弹出选项卡 / 请求权限 / 一轮对话结束。 按 DSH 官方组合包（bundle）规范打包；响铃全程不弹任何控制台窗口。

# English quick start
dsh plugin --profile web add ./dsh-fish-sound-notify-0.2.0.tgz
dsh --profile web --dump-config     # look for the "# == dsh-fish-sound-notify" layer
dsh web

Windows only. Everything is configurable: questionSound / approvalSound / endSound / cooldownMs / rootAgentsOnly / notifyOnQuestion / notifyOnApproval / notifyOnTurnEnd / enabled.

---

它做什么

时刻	触发事件	默认音效
AI 弹出选项卡	user-questions/request	Windows Notify.wav（双音）
请求权限	approval/request	Windows Ding.wav（单声"叮"，较急）
一轮对话结束	agent/status 变为 idle	Windows Notify System Generic.wav（柔和单音）

三种声音各自独立冷却，所以"刚响过结束音，紧接着弹权限卡片"不会把权限音挤掉。

附带模型工具 fish_beep：让 AI 随时响一声（试听 / 主动提醒你看屏幕）， kind 取 question / approval / end（默认 end）。

---

环境要求

项	要求	说明
操作系统	Windows 10 / 11	依赖 PowerShell 与 C:\Windows\Media 系统音效；其它平台不会发声，但会如实返回原因、不报错崩溃
DSH	>=0.1.0-rc.1（engines.dsh）	已在 0.1.5-rc.2 上实测通过
Node.js	^22.19.0 || >=24.0.0	与官方包一致
第三方依赖	无	只用 Node 内置 node:child_process 与官方 @deepseek-ai/dsh-tools、@deepseek-ai/schemastery（后者以 peerDependencies 声明，标准安装自带）
子进程服务	不需要	0.2.0 起自己 spawn 播放进程（原因见下节）

---

安装

四种方式任选，装进你要用的 profile（示例用 web）：

方式	命令	适用场景
本地 tarball	dsh plugin --profile web add ./dsh-fish-sound-notify-0.2.0.tgz	离线安装
源码目录	dsh plugin --profile web add ./bundle	手上有解压后的源码目录
GitHub	dsh plugin --profile web add github:<owner>/<repo>	仓库已公开。本包是纯 JS、无构建步骤，不需要 allowBuilds 构建授权
npm	dsh plugin --profile web add dsh-fish-sound-notify	作者发布到 npm 之后可用

装完先校验、再启动：

dsh --profile web --dump-config   # 输出里应出现 "# == dsh-fish-sound-notify" 这一层
dsh web

改完必须重启 DSH 才生效：DSH 的配置在启动时一次性组合（除非 profile 开了 patchReload: live）。 插件市场（dshmarket）会显示「待重启」并给出一键重启按钮。

安装后怎么确认装好了

1. --dump-config 输出里出现 # == dsh-fish-sound-notify 层；

2. 启动日志里出现 [fish-sound-notify] 已装载：弹选项卡响「…」，请求权限响「…」，回合结束响「…」；

3. 让 AI 调用一次 fish_beep，返回形如：

   提示音已播放：铃声=end，powershell.exe，退出码=0，原因=… ｜ 见过问询 0 次、权限请求 0 次、回合结束 1 次 ｜ 累计响铃 1 次，上次 15:58:13
   

4. 让 AI 用选项卡问你问题 → 响问询音；让它做一次需要授权的操作 → 响权限音；它这一轮说完 → 响结束音。

---

配置

所有可调参数都是配置字段（官方约定：不把可能需要按部署变化的取值写死在代码里）。 默认值定义在 index.js 导出的 Config schema 中；在 profile 的 cordis.patch.yml 里按行 id 覆盖：

⚠️ patch 会整行替换 config（不是深度合并），要保留的字段请一并写上。

- id: fish-sound-notify
  config:
    approvalSound: 'Windows Notify Messaging.wav'
    cooldownMs: 1500
    notifyOnTurnEnd: false

字段	类型	默认值	说明
enabled	boolean	true	总开关；false 时不注册任何行为
notifyOnQuestion	boolean	true	弹出选项卡时是否响
notifyOnApproval	boolean	true	请求权限时是否响
notifyOnTurnEnd	boolean	true	一轮对话结束时是否响
questionSound	string	Windows Notify.wav	问询音
approvalSound	string	Windows Ding.wav	权限音
endSound	string	Windows Notify System Generic.wav	结束音
cooldownMs	number	800	同一种声音两次之间的最小间隔
rootAgentsOnly	boolean	true	只对"人面对的根会话"响；false 时子 agent 也响
spawnTimeoutMs	number	15000	播放进程的兜底存活上限，到点强杀，避免残留

音效字段只接受 C:\Windows\Media 下的纯文件名（xxx.wav；含路径分隔符或引号的值会被忽略， 以防配置值被当成脚本注入）。查找顺序是「本时刻的音效 → 另外两个时刻的音效 → 系统默认通知音 → notify.wav → chimes.wav」；全都找不到时退回系统"星号"提示音。

---

升级 / 卸载

# 升级：装新版本覆盖（层和依赖一起更新），然后重启 DSH
dsh plugin --profile web add ./dsh-fish-sound-notify-0.2.0.tgz

# 卸载：依赖和配置层一起移除，然后重启 DSH
dsh plugin --profile web remove dsh-fish-sound-notify

排查（Troubleshooting）

| 现象 | 原因 / 处理 | | 一声都不响 | 先让 AI 调 fish_beep 看 ok；若 ok: true 但没听到，检查系统音量与声音方案（Windows 设为「无声」时会静音）、是否远程桌面/无音频设备 | | fish_beep 返回 ok: false | 把返回里的 detail 原文贴给 AI —— 它写明了失败在哪一步（找不到 PowerShell / 启动失败 / 退出码非 0 / 当前平台不是 Windows） | | 弹选项卡或请求权限时不响 | 若是子 agent 发起，按设计不响（rootAgentsOnly: true）；或距上一次同种声音不到 cooldownMs | | --dump-config 里没有这一层 | 检查 package.json 是否声明了 dsh.bundle、dsh plugin 的输出有没有报错、profile 的 dsh.profile.bundles 里是否列出本包 | | 声音比画面慢约半秒 | 正常：每次响铃都要启动一个隐藏的 PowerShell 进程（0.3～0.6 秒） |

---

已知限制

1. 仅 Windows（PowerShell + C:\Windows\Media 系统音效）。其它平台不发声，但会返回明确原因。
2. 机器级通知：同一进程里任何"人面对的根会话"提问/请求权限/结束都会响，不区分你在看哪个会话。
3. 起播有约 0.3～0.6 秒延迟（要启动一个隐藏的 PowerShell 进程）。
4. 同一时刻的不同声音可能叠在一起（三种声音各自冷却，互不挤占）。
5. 音效只能用 C:\Windows\Media 下的文件名，暂不支持自定义路径。

---

许可与作者

MIT · 作者：玉咸鱼 (YUsaltyfish)＆蓝色大肥鱼deepseek