dsh-plugin-sound-alert

dsh-plugin-sound-alert

DSH Web 轻量提示音插件（纯客户端 · 零资源文件 · 小而美）：

• 回答完成时响铃（叮-咚 上行双音 / 可自定义 WAV）
• 需要授权 / 计划审阅 / 向你提问时响铃（三连提示音 / 可自定义 WAV）
• 设置入口：设置 → 提示音（Settings → Sound Alerts）
• 自定义铃声直接选本机 .wav 文件即可，Data URL 持久化在本机浏览器，不上传

提醒：本插件为第三方开发，安装前请审阅源码。

安装（本地 link，方式与 dsh-plugin-polish-my-expression 相同）

# 1) 在 web profile 中加入依赖（link 到本项目）
#    等价于在 C:\Users\wanch\.dsh\profiles\web 下执行：
#    pnpm add "link:D:/mycode/dsh/dsh-plugin-sound-alert"
#
#    并把 "dsh-plugin-sound-alert" 追加进 package.json 的
#    dsh.profile.bundles 列表（顺序放在最后一个 bundle 后即可）。
#    若用 dsh 命令：
#    dsh plugin --profile web add "link:D:/mycode/dsh/dsh-plugin-sound-alert"

# 2) 重新安装/组合 bundle
#    dsh plugin --profile web install

# 3) 重启 web profile 使新 bundle 层生效
#    （在运行 GUI 的终端里 Ctrl-C 后重新 dsh web，或按你的启动方式重启）

对 GitHub 发布版使用者：

dsh plugin --profile web add github:WanchunLian/dsh-plugin-sound-alert

使用

1. 打开 设置（齿轮）→ 提示音。
2. 勾选 启用声音提醒。
3. 完成音 / 授权音各自选择：
   • 内置铃声：无需任何文件，WebAudio 合成；
   • 自定义 WAV：点“选择 WAV…”挑一个本机 .wav（建议简短、≤3MB）， 出现后可 试听 / 移除。
4. 可选：提醒范围（仅当前会话 / 所有会话）、音量。

行为说明

场景	铃声
会话 busy 态结束（回答/处理完成）	完成音
后台会话出现“已完成”提醒（范围=所有会话）	完成音
授权请求 / 计划审阅 / 向你提问（pendingInteraction 出现）	授权音
完成帧与等待授权同时出现	只响授权音（不重复打扰）

• 默认 仅当前会话，避免子会话/后台任务频繁打扰；需要后台完成提醒时切“所有会话”。
• 内置防抖（完成 1.6s / 授权 0.5s），避免一帧多个事件重复响。
• 浏览器自动播放策略：页面有过任意一次点击/按键后即可发声；若从未交互，声音会被浏览器静默拦截（首次试听请先点一下页面）。

数据与隐私

• 配置与自定义 WAV 仅存于本机浏览器 localStorage（键 dsh-plugin-sound-alert:cfg）， 不上传、不写入会话；换浏览器/设备后需重新设置。
• 插件纯浏览器实现，不注册任何后端路由、不调用 LLM。

目录结构

lib/index.js   宿主半边（cordis 空壳，插件为纯客户端）
lib/client.js  浏览器半边：状态监听 + 声音引擎 + 设置页
cordis.yml     bundle patch（web profile loader 入口）
docs/design.md 设计取舍说明

License

MIT