Su-1003/dsh-notify-sound

---

它做什么

声音只负责「叫你一声」，三种场景用同一个音型（同音双响）；区别只体现在通知条的文字和颜色上。想区分场景，改 lib/client.cjs 里的 CALL_SHAPE 即可。

特性

• 不需要任何音频文件 —— 提示音用 Web Audio 实时合成（振荡器 + 指数包络），整个插件零资源文件、零运行时依赖
• 6 种音色：清脆 / 柔和 / 铃音 / 醒目（三连音）/ 极简（单声）/ 木质（默认）
• 不会刷屏：同类通知 1.5 秒内只响一次；4 秒内的同类事件在通知条里合并成 ×N
• 通知条：最多同时 4 条，20 秒后自动消失，可单条关、也可一键全部关闭
• 只在 DSH 窗口里弹：通知条是页面内的 DOM 元素，不调用系统通知、不盖到别的软件上；容器 pointer-events:none，只有卡片本身可点，不挡其他操作
• 不会跑到左侧栏上：挂载点上若有 transform / filter 的祖先，position:fixed 会失效，插件每帧测量并补偿，浮层始终贴在视口右上角
• 首次观测只做基线：插件加载时不会给你补一堆历史通知

安装

需要 DSH 的 Web GUI（插件声明了 "platform": "web"，TUI 不适用）。

方式一：一行命令

dsh plugin --profile web add github:Su-1003/dsh-notify-sound

桌面端的 profile 名通常是 desktop，按你的实际配置替换 --profile 后的名字。

方式二：手动放进去

git clone https://github.com/Su-1003/dsh-notify-sound.git "$env:USERPROFILE\.dsh\plugins\dsh-notify-sound"

然后在 GUI 的 设置 → 插件 → 本地开发 里选中这个目录安装，成功后就是下面这张卡：

装完重启 DSH，或刷新 Web GUI。

初次使用注意：浏览器规定必须有一次用户手势才允许出声，所以请先在界面上点一下或敲一下键 —— 插件会在这时解锁 AudioContext，之后才会响。

换音色

现在没有设置界面，两种改法：

1. 改 lib/client.cjs 里的 DEFAULT_SOUND_SET（可选：clean / soft / bell / alarm / minimal / wood），刷新 GUI；
2. 或在浏览器控制台执行 localStorage.setItem("dsh-notify-sound.style", "bell") —— 键名固定，刷新后按这个恢复。

已知限制

• 只在 Web GUI 生效。宿主侧半边是空壳（lib/index.js），全部行为在浏览器半边 lib/client.cjs。
• 页面没被点击过就不会响（浏览器 AudioContext 手势策略），通知条不受影响。
• 标签页在后台时浏览器会限流定时器，提示音可能延后；能不能叫醒你还取决于系统通知和标签页策略。
• 三种场景共用同一个音型，这是有意为之，不是 bug。

结构

cordis.patch.yml   把插件行插入 profile 名册
lib/index.js       宿主半边：空壳，只提供一个可挂载的 apply
lib/client.cjs     浏览器半边：状态跟踪 + 提示音合成 + 通知浮层（预构建，无需构建步骤）

判定逻辑全部来自 DSH 客户端 uiSession.sessionStatus 的状态迁移：pendingInteraction 出现 → 需要确认；running 由真变假且无待办 → 完成或出错。插件在 ui-session 之后激活也来得及（会轮询 15 秒等待服务就绪）。

许可

MIT