dsh-voice-alert
DSH browser plugin: voice alert, popup and system notification on task completion / ask-user
- Stars
- 0
- Language
- JavaScript
- Created
- Aug 17, 2026
- Updated
- Aug 17, 2026
Introduction
语音提醒插件
DSH 浏览器端提醒插件:当任意会话完成任务(回合结束)或请示用户(ask_user_question / 审批 / 方案评审)时:
- 播放语音提示(
任务已完成.wav/请求决策.wav) - 页面顶部弹出提示条(6 秒自动消失,可点击关闭)
- 页面失焦/最小化时额外发送系统通知(点击可跳回 DSH)
语音素材说明:内置语音为「千织」(原神角色)语音。可自行替换
assets/下的 wav 文件(保持文件名任务已完成.wav/请求决策.wav不变即可),换成任意你喜欢的提示音。
结构
lib/index.js— Host 半区:webServer注册/voice-sound/{done|ask}.wav静态路由,直接吐原始 wav 字节lib/client.js— Client 半区:shell.overlay插槽 +useSessions订阅会话状态,Audio 播放 + 弹窗 + 系统通知assets/— 语音素材(可替换)cordis.patch.yml— 组合补丁(插入voice-alert插件行)
本地安装(file: 依赖)
git clone https://github.com/Roger-Yang-CN/dsh-voice-alert到本机任意目录;- 在 DSH profile 的
package.json(如~/.dsh/profiles/web/package.json):
"dependencies": { "dsh-voice-alert": "file:<克隆到的绝对路径>" },
"dsh": { "profile": { "bundles": [ "...", "dsh-voice-alert" ] } }
- 在 profile 目录执行
pnpm install; - 手动同步插件副本:将插件目录的
lib/、assets/复制到node_modules/dsh-voice-alert/(pnpm 对file:依赖不会自动刷新); - 重启 DSH,页面出现提示条即生效(首次触发时浏览器会请求通知权限,允许后失焦提醒可用)。