声音提示 sixtysevenlf/dsh-sound-alerts

@dsh-external/dsh-sound-alerts

DSH Web UI 声音提示插件（浏览器客户端 bundle，platform: web）。

当以下事件发生时播放提示音：

| 事件 | 默认声音 | 触发源 |
| 需要授权（沙箱/命令审批） | 双音 ×2（急切） | 会话 pendingInteraction === 'approval'（approval/requested 帧） |
| 需要回答问题（ask_user_question） | 单次双音（柔和） | 会话 pendingInteraction 为 question / plan-review |
| 任务/运行完成 | 三连胜利音 | 会话 running true→false（2.5s 复检）或后台会话 completed 标记 |
| 任务失败 | 关羽之歌（合成致敬版） | 当前会话 lastAgentError 从无到有（host/agent-error 帧） |
| goal 完成 | 四音胜利收尾 | 当前会话 goal 投影 phase → complete |

默认音全部由 Web Audio 合成（无音频资源）；声音在浏览器标签页中播放（含后台标签页），首次点击/按键后解锁 AudioContext。

自定义声音

设置 → 通用 → "声音提示 (Sound Alerts)"，每个事件一行：

需要授权 [上传] [试听] [清除] 自定义文件名.mp3

- 上传：本地音频文件（mp3/wav/ogg/m4a/flac，≤10MB），以 dataURL 存入 IndexedDB（不占 localStorage 配额，刷新/重启不丢）
- 试听：有自定义播自定义，无自定义播内置合成音
- 清除：删除自定义音频，恢复内置音
- 自动回退：自定义音频加载/播放失败时静默回退内置合成音

播放时音量跟随滑杆；全局 1.2s 防抖避免批量事件轰炸。

设置

总开关 + 音量滑杆 + 各事件开关/上传/试听/清除，持久化于 localStorage 键 dsh-sound-alerts:settings。

诊断

console.debug('[sound-alerts]', ...) + window.__soundAlertsLog（最近 100 条）。

结构

- src/index.ts — node half：空 apply（纯 UI 插件，让行出现在 host Loader）。
- src/client/index.ts — 浏览器 half：声音引擎 + sessions 监视 + 设置行 + 自定义音频。
- cordis.patch.yml — bundle patch：向 Web 装配树插入名录行 sound-alerts。
- dsh.bundle.patch — 使本包作为 profile bundle 层装配（dependencies + bundles）。

构建与安装

依赖（esbuild 构建 client；--legacy-peer-deps 跳过内部 rc 包的 peer 自动安装）
npm install --legacy-peer-deps

构建（node half: tsc via scripts/build.sh；client half: esbuild via scripts/build-client.mjs） bash scripts/build.sh # DSH_CHECKOUT 自动探测（$HOME/dsh-harness）
npm run build:client

注入器环境内热装配（改 profile package.json + junction + loader.create） dev_install_package D:/DSH/plugins/dsh-sound-alerts

安装后刷新浏览器页面：启动图 window.__DSH_BOOT__ 会包含本包 client.js，声音即生效（新名录行需一次刷新，之后 HMR 管内容热更）。