dsh-chime-alerts · DSH 声音提醒插件

给 DeepSeek Harness (DSH) 加一组轻量声音提醒：Agent 干完活、需要你批准、提交计划等你评审、有问题问你、目标受阻、后台任务完成/挂了，电脑响一声——不用一直盯着页面。

前身 dsh-chime / dsh-sound-alerts。v0.3.5 因市场名称冲突更名；存储键自动迁移，设置不丢。

特性

• 十类事件，每类独立开关 / 声音 / 音量：任务完成、子任务完成、后台任务完成、需要授权、插件授权、Agent 提问、计划评审、目标受阻、其他打断、后台任务失败
• 混合发声：网页响铃（Web Audio 合成音）与宿主蜂鸣（系统音效，页面关闭也响）两个独立开关，另有网页通知独立开关
• 工作区静音按钮：侧栏每个工作区旁的喇叭按钮，按工作区独立静音，已静音常驻橙色斜杠标志
• 并行/后台任务逐个响：3 个并行子代理分别完成 = 3 声（节流按种类+来源独立）
• 宿主蜂鸣跨平台：Windows 播系统 wav（wscript+WMP）；Linux 播 freedesktop 主题音（canberra-gtk-play → 回退 paplay）；macOS 用 afplay 播系统音
• 声音可替换：每事件可换内置音或上传自定义音频（≤5MB）
• 中英双语界面、Node 可跑的自动化测试（npm test，161 项断言）

默认声音

默认声音全部是浏览器合成的（Web Audio 振荡器实时生成，每类事件独立音型，如任务完成=渐强上行琶音、需要授权=慢叮咚、插件授权=短叮咚），不附带任何音频文件，无版权、无许可证负担，开箱即用可商用。

宿主蜂鸣（可选，默认关）使用操作系统自带音效（Windows wav / Linux freedesktop / macOS 系统音），受系统许可条款约束；不开启就完全不涉及。

安装（动态插件，功能完整）

1. cordis_define：code.host 粘贴 lib/host.js 全文，code.client 粘贴 lib/client.js 全文（kind: "new"，idPrefix 自取）
2. cordis_run（mode run）激活，客户端包首次激活需在页面上批准
3. DSH 重启后按同样步骤重装；宿主音/自定义音频存本地磁盘，其余设置存浏览器，重装后自动恢复

设置页

设置 → 「🔊 声音提醒」：

• 四个总开关：启用 / 网页响铃 / 宿主蜂鸣 / 网页通知
• 十个事件单行（分组：主要通知 / 其他通知 / 需要人介入时）：名称 / 声音下拉（默认 + 内置音 + 音频库）/ 静音键 / 音量条 / 试听；宿主蜂鸣开启时每行追加第二行：宿主音下拉 + 宿主静音键 + 宿主试听
• 固定监听所有会话，范围控制交给工作区静音按钮；底部显示本地存储位置

存储位置：优先 sandboxPolicy.workspaceRoot；落在系统目录时（如 DSH 从 System32 启动）自动改用 DSH 数据目录 %USERPROFILE%\.dsh\plugins\dsh-chime-alerts\（Linux/macOS 对应 $HOME/...），旧数据自动迁移。

工作原理

• 宿主半监听 agent/status（完成/打断/子任务）、session/event（授权、目标受阻）、tools/execute（提问、计划评审）、tools/result（插件授权，v0.4.4+）、jobs.onJobDone（后台任务完成/失败），节流 3s（种类+来源）后入事件缓冲
• 客户端每 700ms 拉取播放；15 秒以上旧事件跳过；boot 令牌防版本串扰；完成/打断类 800ms 防抖，主代理 inbox.hasPending 跳过
• 浏览器音零音频文件；系统蜂鸣 Windows 走临时 .vbs + wscript.exe + WMP（避开安全软件拦截 PowerShell），Linux/macOS 见上

已知限制

• 仅覆盖本 DSH 进程内宿主能观察到的事件
• 浏览器音需要页面开着；页面关闭时只有宿主蜂鸣（需开启）
• Linux / macOS 分支已实现并通过 Node 模拟测试，但尚未在真实机器上实测；Windows 为本机实测平台
• 轮询延迟 ≤~1.5s（700ms 轮询 + 800ms 防抖）
• 设置导航扬声器图标与工作区静音按钮依赖外壳 DOM 结构（CSS hack / 固定定位注入），外壳改版需同步适配

仓库结构

lib/host.js          宿主半（函数体，动态安装粘贴；静态入口也消费它）
lib/client.js        客户端半（函数体，动态安装粘贴）
lib/index.js         静态宿主入口（npm 包 main）
lib/types/index.d.ts 类型声明
cordis.patch.yml     bundle 补丁层
tools/               syntax-check + 宿主/客户端测试
docs/REGISTRIES.md   社区市场上架指南

开发

本插件由 AI Agent 工具辅助开发（功能设计、代码实现、代码审计、测试与文档），详见 CHANGELOG.md。

npm test      # 宿主 64 + 客户端 97 项断言（Node 即可，无需浏览器/DSH）
npm run check # 语法检查

发布与上架

见 docs/REGISTRIES.md（npm 发布清单 + 社区市场提交入口）。

License

MIT © 2026 dsh-chime-alerts contributors