sixtysevenlf/dsh-sound-alerts

README 摘要

@dsh-external/dsh-sound-alerts DSH Web UI 声音提示插件（browser client 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/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）。 构建与…

分类