DeepSeek HarnessHub
提交插件

nienieai/dsh-chime-alerts ↗★ 0

dsh-chime-alerts

DeepSeek Harness plugin: sound alerts for nine agent events — completion, subagent completion, background-job completion, approval, question, plan-review, goal-blocked, interruption, and background-job failure (browser Web Audio + Windows system beep, per-event toggles/sounds/volume, quick-mute button)

Agent 协作notifications
包名
dsh-chime-alerts
版本
0.4.3
许可证
MIT
最近更新
2026年8月21日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:nienieai/dsh-chime-alerts

说明文档

阅读完整 README ↗

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

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

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

特性

  • 九类事件独立开关 / 独立声音 / 独立音量：任务完成、子任务完成、后台任务完成、需要授权、Agent 提问、计划评审、目标受阻、其他打断、后台任务失败
  • 混合发声（双独立开关）：网页响铃（浏览器 Web Audio 合成音，存浏览器，跨平台）与宿主蜂鸣（系统音效，页面关闭也响，存本地磁盘）各自独立开关；另有网页通知独立开关（浏览器通知中心，v0.4.2 起改名，避免误解为宿主通知）
  • 工作区静音按钮：侧栏每个工作区条目（如 K230）旁的喇叭按钮，按工作区独立静音/恢复；已静音的工作区常驻显示橙色斜杠标志，状态即点即存
  • 并行/后台任务逐个响：3 个并行子代理分别完成 = 3 声（节流按种类+来源独立，互不吞）
  • 宿主常驻蜂鸣（跨平台，v0.4.0）：Windows 播系统 wav（wscript+WMP，可逐事件换 19 种）；Linux 播 freedesktop 主题音（canberra-gtk-play，无则回退 paplay）；macOS 用 afplay 播系统音——页面最小化甚至关闭时宿主照样响
  • 声音可替换：每事件可换其他内置音，或上传自定义音频（≤5MB）
  • 设置本地化：系统音模式与自定义音频存本地磁盘（v0.3.10 起以 sandboxPolicy.workspaceRoot 为存储基准，兼容 DSH 沙箱的 workspace-write 策略；v0.3.13 起若该基准落在系统目录——如 DSH 以管理员身份从 System32 启动——自动改用 DSH 数据目录 %USERPROFILE%\.dsh\plugins\dsh-chime-alerts\，Linux/macOS 对应 $HOME/.dsh/plugins/dsh-chime-alerts（v0.4.0），旧数据自动迁移）；其余设置（总开关/事件开关/音量/工作区静音）存浏览器 localStorage（键 dsh-chime-alerts-v1，旧键自动迁移）
  • 默认值即开箱即用：总开关开、固定监听所有会话（范围控制交给工作区静音按钮）、满音量；子任务音默认关
  • 中英双语界面：设置页与通知按浏览器语言自动切换（中文环境不变，英文环境显示英文）
  • Node 可跑的自动化测试：npm test（155 项断言，无需浏览器/DSH）

默认声音

默认声音全部是浏览器合成的（Web Audio 振荡器实时生成，九种事件各有独立的音型：任务完成=渐强上行琶音、需要授权=慢叮咚、目标受阻=卡住低音等），不附带任何音频文件，无版权、无许可证负担，开箱即用可商用。

  • 每个事件可换其他内置音，或上传自定义音频（≤5MB，存本地磁盘）
  • 宿主蜂鸣（可选，默认关）使用操作系统自带音效：Windows 系统 wav / Linux freedesktop 主题音 / macOS 系统音——这些音效属于操作系统本身，其使用受操作系统许可条款约束，与插件默认的合成音无关；不开启宿主蜂鸣就完全不涉及
  • 宿主音默认映射（v0.3.20 起可逐事件更换，按平台取默认）：Windows——完成→系统通知 / 子任务→ding / 后台完成→系统通知 / 授权→UAC / 提问→Windows Ding / 评审→Windows 默认 / 受阻→惊叹 / 打断→邮件通知 / 失败→错误；Linux——complete / message / dialog-warning / dialog-question / dialog-information / dialog-error 等 freedesktop 主题音；macOS——Glass / Pop / Ping / Tink / Sosumi / Basso / Blow 等系统音

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

  1. cordis_define：code.host 粘贴 lib/host.js 全文，code.client 粘贴 lib/client.js 全文（kind: "new"，idPrefix 自取，如 chime）
  2. cordis_run（mode run）激活
  3. 客户端包首次激活需在页面上批准（单勾授权本次；双勾以后更新免批）

动态插件不落盘：DSH 进程重启后按同样步骤重装即可（系统音模式与自定义音频存本地磁盘，其余设置存浏览器，重装后自动恢复）。

设置页

设置 → 「🔊 声音提醒」：

  • 总开关：启用声音提醒
  • 网页响铃（浏览器合成音，设置存浏览器）与宿主蜂鸣（系统音效，页面关闭也响，设置存本地磁盘）两个独立开关
  • 九个事件单行（分三组：主要通知 / 其他通知 / 需要人介入时）：名称 / 声音下拉（默认 + 九套内置 + 音频库「自定义声音 · 文件名」——导入的音频所有事件下拉共享；选中「自定义声音…」即弹上传窗 ≤5MB，音频存本地磁盘；换文件先选其他声音再选回）/ 静音图标键 / 音量条 + 数值 / 试听。宿主蜂鸣开启时每行追加第二行：宿主音下拉 + 宿主静音键（只静音该事件宿主音，v0.4.2 起）+ 宿主试听

固定监听所有会话（v0.3.8 起不再提供「声音范围」选项），范围控制交给工作区静音按钮。设置页底部显示本地存储位置。

侧栏工作区条目旁（如「K230」行的 ⋮/+ 按钮旁）有喇叭按钮：点击单独静音该工作区的所有事件声音（含其子任务）。已静音的工作区会一直显示橙色斜杠标志（无需悬停），点击即可恢复；未静音的工作区悬停行时显示喇叭按钮。状态持久化，与设置页总开关独立。

仓库结构

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

工作原理

  • 宿主半监听 agent/status（完成/打断/子任务）、session/event（授权、目标受阻）、tools/execute（提问、计划评审）、jobs.onJobDone（后台任务完成/失败），节流 3s（种类+来源）后入事件缓冲
  • 客户端每 700ms host.call('pull', …) 拉取并播放；15 秒以上旧事件跳过；boot 令牌防插件版本串扰
  • 防误报：800ms 防抖（完成/打断类）、主代理 inbox.hasPending 跳过
  • 浏览器音用 Web Audio 振荡器合成，零音频资源文件；系统蜂鸣按平台：Windows 由宿主写临时 .vbs 经 wscript.exe + WMP 播放系统 wav（v0.3.9 起，避开 PowerShell；九类事件映射见 CHANGELOG）；Linux 探测 canberra-gtk-play → 回退 paplay 播 freedesktop 主题音（v0.4.0）；macOS 用 afplay 播系统音（v0.4.0）

静态化路线图（npm 安装）

dsh plugin --profile web add dsh-chime-alerts 已可安装（dsh.bundle.patch 补丁层），但当前静态安装只有宿主半（事件记录 + 系统蜂鸣）——完整功能请以动态安装为准。

完整静态双端还需三步（社区已验证可行的封套形态）：

  1. 客户端 bundle 封套：lib/client.js 需包成 window.__ModuleLoader__.load({ id, factory }) 经典脚本，package.json 补 exports["./client"] + dsh.client: { platform: "web" }
  2. styles.insert → 自建 `` + HMR 去重
  3. host.call 动态桥 → 该模板的答案是不要桥：静态客户端 inject sessions/workspaces 服务订阅快照（running/pendingInteraction/goal 投影/jobsBySession）自行检测；宿主半保留 reason 精确判定与常驻蜂鸣

官方契约（已从 @deepseek-ai/dsh-client-modules 源码核实）：dsh.client.platform 必须为 "web"，bundle 从 /plugins//client.js 以经典脚本加载。

已知限制

  • 仅覆盖本 DSH 进程内宿主能观察到的事件；跨进程/跨机器任务需常驻方案
  • 浏览器音需要页面开着；页面关闭时只有宿主常驻蜂鸣（需开启）
  • 系统蜂鸣按平台：Windows 走 wscript.exe + WMP 播放系统 wav（v0.3.9 起，避开安全软件对「node → 隐藏 PowerShell」链路的拦截弹窗）；Linux 需装有 canberra-gtk-play 或 paplay（多数桌面默认有）且存在 freedesktop 声音主题（/usr/share/sounds/freedesktop/，随 sound-theme-freedesktop 安装）；macOS 需 afplay（系统自带）——播放器/音效缺失时静默不响
  • Linux / macOS 分支（v0.4.0）已实现并通过 Node 模拟测试（135 项断言含 14 项跨平台链路），但尚未在真实 Linux/macOS 机器上实测；Windows 为本机实测平台。如有问题欢迎反馈（仓库 issue）
  • 轮询延迟 ≤~1.5s（700ms 轮询 + 完成/打断 800ms 防抖）
  • 自定义上传音频与系统音模式存本地磁盘（工作区根目录，DSH 从系统目录启动时自动改存 DSH 数据目录 %USERPROFILE%\.dsh\plugins\dsh-chime-alerts\ 并迁移旧数据），换浏览器/清缓存不影响；仅更换工作区或删文件才会丢
  • 设置导航的扬声器图标是 CSS hack：外壳 navIcon 按分区 id 写死且无图标注册 API，故隐藏第 5 个导航项默认 svg、在 label::before 用 SVG mask 画扬声器；若将来设置分区排序变化需同步改 nth-child(5)
  • 工作区行内静音按钮是 DOM 注入（外壳没有工作区行的插槽）：锚定 div[role="treeitem"][aria-expanded]（会话行无 aria-expanded），按钮挂在 document.body（React 树外，免疫重渲染抹除）、fixed 定位贴在工作区行右侧、悬停显示；悬停按钮时用 snd-keep-open 类 + 外壳哈希类名 YDXeBa_* 保持官方 ⋮/+ 按钮可见；外壳若改行结构/属性/类名需同步适配

开发

本插件由 AI Agent 工具辅助开发：功能设计、代码实现、多 Agent 代码审计、自动化测试与文档整理均由 Agent 工具协作完成（详见 CHANGELOG.md）。

npm test      # 宿主 56 + 客户端 89 项断言（Node 即可，无需浏览器/DSH）
npm run check # 语法检查（lib/index.js + 双半函数体）

发布与上架

见 docs/REGISTRIES.md（npm 发布检查清单 + WhaleHub / dsh-market / dshfind / awesome 列表提交入口）。

License

MIT © 2026 dsh-chime-alerts contributors