dsh-chime-alerts

DSH PLUGIN通知与集成

仓库 nienieai/dsh-chime-alerts · npm dsh-chime-alerts

通知与集成 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH plugin 声音提醒:Agent 完成、需授权、提问等十类事件独立开关与音量,浏览器合成音加跨平台系统蜂鸣,工作区快捷静音,默认零版权负担。

一句话选型结论

按资料字段整理

dsh-chime-alerts 是通知与集成类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类通知与集成 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 2 复刻 1 · 未关闭 issue 1
最近更新 2026-09-13 创建于 2026-08-20
README 10.3 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add dsh-chime-alerts
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.0-rc.2 等 11 个,Node.js 要求 >=18.0.0;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.0-rc.2 等 11 个版本版本不匹配时安装会报错
Node.js 要求>=18.0.0来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/cordis@^4.0.1需要同时安装的同级依赖
npm 包名dsh-chime-alerts可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-chime-alerts:DeepSeek Harness 的 Agent 事件声音提醒插件

  • 十类事件独立提醒
  • 混合发声与系统蜂鸣
  • 工作区快捷静音
  • 自定义声音与音量
  • 中英双语界面

适用场景

通知

上游标签

alertscordiscross-platformdeepseek-harnessdshdsh-pluginlinuxmacosnotificationpluginsoundweb-audiowindows

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-10-08): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.0-rc.2 等 11 个),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在通知与集成场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-chime-alerts当前 L5 · 运行验证通过 低风险 2 0.2.0-rc.2 等 11 个 有
treg L3 · 安装规范通过 低风险 4,976 未标注 无
dsh-purge 未做沙盒验证 未标注 3,412 未标注 有
dsh-im L5 · 运行验证通过 低风险 1,837 0.1.7-rc.2 等 10 个 有
dsh-aurabot-qq 未做沙盒验证 未标注 633 未标注 有
dsh-dafeiyu L5 · 运行验证通过 低风险 425 0.1.7-rc.2 等 10 个 有

仓库档案

通知与集成
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方nienieai仓库 dsh-chime-alerts · 默认分支 main
分类通知与集成notify
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue2 / 1 / 1收录时的数值,非实时
创建 / 更新2026-08-20 · 2026-09-13最后推送 2026-09-13
本站收录2026-08-22首次进入本站目录的时间

README 全文

10.3 KB
作者原文,中文版优先;只做安全转义,不改内容

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

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

特性

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

默认声音

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

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

安装

方式 A:静态安装(npm 包,推荐,功能与动态版一致、开箱即响)

一键安装(CLI 会写入 profile 依赖并注册 bundle 层):

dsh plugin --profile web add dsh-chime-alerts

> npm 包地址:https://www.npmjs.com/package/dsh-chime-alerts ;GitHub Release:https://github.com/nienieai/dsh-chime-alerts/releases

安装/升级后需重启 DSH + 重开网页标签生效。若插件装了但不加载(CLI 偶发只写依赖、漏注册 bundle 层),手动确认 profile 的 package.json 两处齐备:

  1. dependencies(或 devDependencies)里有 dsh-chime-alerts——npm 包名,或本地调试用 link:/file: 指向插件目录
  2. dsh.profile.bundles 数组里有 "dsh-chime-alerts"

然后在 profile 目录执行 pnpm install,再重启 DSH + 重开网页标签。

  • 宿主半(事件记录 + 系统蜂鸣)经 lib/index.js 自动加载;客户端半(浏览器合成音 + 设置页 + 工作区静音)经 exports["./client"] 以经典脚本加载(dsh.client.platform: "web")
  • 客户端直接订阅 DSH 会话/工作区快照检测「任务完成 / 子任务完成 / 后台任务 / 目标受阻」;「需要授权 / Agent 提问 / 计划评审 / 插件授权」快照里没有信号(pendingInteraction 不在会话列表快照内),改由宿主半检测后经 /dsh-chime-alerts/events 增量转发;设置存浏览器(键与动态版相同,切换安装方式设置自动继承)
  • 静态版差异:「其他打断」并入「任务完成」(快照无 turn 结束原因字段)、自定义音频存浏览器且上限 3MB;其余(十类事件、总开关 / 宿主蜂鸣开关 / 每事件宿主音下拉 / 宿主静音 / 宿主试听 / 工作区静音)与动态版一致
  • 设置页底部显示版本号(如「静态版 v0.5.8」),便于确认页面已加载最新代码

方式 B:动态插件(免安装,重启 DSH 后需重新部署)

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

> 两条必须注意的坑(都实测踩过)
>
> - 两半要放在同一个包里。 后续用 cordis_run 的 update 切换版本时是整包替换,不是「只换宿主半」——如果你先只定义客户端半、再用一个 host-only 的新包去 update,会把它从浏览器里卸载掉(表现为设置页消失、浏览器不响),而 cordis_inspect_self 只会告诉你 hasClientHalf: false。改代码时请一次性给出 host+client 的新包。
> - 别用 .chunks/host.txt 之外的旧文本:.chunks/*.txt 由 npm run chunks 从 lib/*.js 生成、并由 npm test 校验一致(见下);直接抄 README 之外的任何旧副本都可能装到过期宿主。

设置页

设置 → 「🔊 声音提醒」:

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

存储位置:动态安装优先 sandboxPolicy.workspaceRoot,落在系统目录时(如 DSH 从 System32 启动)自动改用 DSH 数据目录;静态安装固定存 DSH 数据目录 %USERPROFILE%\.dsh\plugins\dsh-chime-alerts\(Linux/macOS 对应 $HOME/...,经 node:fs 直写,旧数据自动迁移)。

工作原理

  • 宿主半监听 agent/status(完成/打断/子任务)、session/event(授权)、goal/changed(目标受阻)、tools/execute(提问、计划评审)、tools/result(插件授权,v0.4.4+)、jobs.onJobDone(后台任务完成/失败,静态安装延迟挂接,v0.5.4+),节流 3s(种类+来源)后入事件缓冲
  • 动态客户端每 700ms 拉取播放;15 秒以上旧事件跳过;boot 令牌防版本串扰;完成/打断类 800ms 防抖,主代理 inbox.hasPending 跳过。静态客户端订阅 sessions/workspaces 快照检测「完成 / 子任务 / 后台任务 / 目标受阻」(running 边沿 / goal 投影 / jobsBySession 终态),并每 1500ms 拉 /dsh-chime-alerts/events 补齐「授权 / 提问 / 计划评审 / 插件授权」(宿主只对这四类入队,与快照自检不重叠)
  • 浏览器音零音频文件;系统蜂鸣 Windows 走临时 .vbs + wscript.exe + WMP(避开安全软件拦截 PowerShell;静态安装经 node:fs 直写,v0.5.4+),Linux/macOS 见上

已知限制

  • 仅覆盖本 DSH 进程内宿主能观察到的事件
  • 浏览器音需要页面开着;页面关闭时只有宿主蜂鸣(需开启)
  • Linux / macOS 分支已实现并通过 Node 模拟测试,但尚未在真实机器上实测;Windows 为本机实测平台
  • 轮询延迟:动态版 ≤~1.5s(700ms 轮询 + 800ms 防抖);静态版「完成/子任务/后台/目标受阻」为准实时(快照订阅),「授权/提问/计划评审/插件授权」≤~1.5s(1500ms 轮询 + 宿主 3s 节流)
  • 设置导航扬声器图标与工作区静音按钮依赖外壳 DOM 结构(CSS hack / 固定定位注入),外壳改版需同步适配
  • 待修:工作区行内静音按钮在真实浏览器中未验证(记录于 2026-09,尚未定位)。静态/动态客户端都用
    document.querySelectorAll('div[role="treeitem"][aria-expanded]') 取工作区行,再把整行 textContent 与
    工作区标题做精确相等匹配(client.web.js 的 syncWorkspaceMuteButtons);匹配不上就 continue 静默跳过——
    按钮不出现且不报任何错。因此只要外壳把行文本改成「标题 + 计数 / 图标 / 空白」之类,或在行内渲染了额外文本,
    按钮就会整片消失而没有任何迹象。已知代码层面该 role/属性确实存在(dsh-client-ui-workspace),但尚未在真实
    DOM 上确认匹配成功
    ;现象待复现后再决定改法(候选:改用行元素上的稳定标识而非文本、或加一次匹配失败告警日志)
  • 依赖 DSH 内部契约:事件名与参数签名(goal/changed、Session.ownEvents()、SessionSummary 字段)不是公开 API,DSH 升级可能再次漂移;本仓库的测试用真实契约做回归(见 tools/test-host.mjs 的「契约回归」与 tools/test-client-web.mjs 的 /events 用例),升级 DSH 后请先跑 npm test
  • 实参与类型声明可能不一致:实测 session/event 的 listener 只收到 2 个实参(Session、SessionEvent),而 inspect 签名写的是 3 个位置参数;插件因此按对象形状而非实参位置识别(type 字段判事件、id+snapshotEvents() 判 Session),两种布局都能工作。同类坑:动态宿主半没有 process(故动态安装的平台检测恒为 null,走 win32 兼容分支),静态安装是真实 Node 模块、不受此限

仓库结构

lib/host.js          宿主半(函数体,动态安装粘贴;静态入口也消费它)
lib/client.js        客户端半(函数体,动态安装粘贴)
lib/client.web.js    静态客户端(经典脚本封套,npm 安装使用)
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      # 宿主 104 + 客户端 96 + 静态客户端 47 项断言(Node 即可,无需浏览器/DSH)
npm run check # 语法检查 + .chunks 与源码一致性检查
npm run chunks # 改完 lib/host.js 或 lib/client.js 后重建动态安装用的 .chunks/*.txt

发布与上架

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

License

MIT © 2026 dsh-chime-alerts contributors

常见问题

9 问
答案由本站依据条目字段整理,不引用上游原文
dsh-chime-alerts 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add dsh-chime-alerts` 即可。对应的 npm 包名是 `dsh-chime-alerts`。

dsh-chime-alerts 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-chime-alerts 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

dsh-chime-alerts 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-chime-alerts 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1、0.1.6-alpha.2、0.1.6-alpha.1、0.1.5-rc.2、0.1.3-alpha.2。版本较多,只列出前 8 个。

dsh-chime-alerts 需要什么运行环境?

Node.js >=18.0.0;需要同时安装 @deepseek-ai/cordis@^4.0.1。环境不满足时安装会失败,建议先确认本机版本。

dsh-chime-alerts 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-chime-alerts 有哪些功能?

十类事件独立提醒、混合发声与系统蜂鸣、工作区快捷静音、自定义声音与音量、中英双语界面。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

通知与集成
按星标排序,可作替代方案

treg

treg

Treg 是面向 Agent 工具的 OpenRouter,聚合 60 个提供商的 2896 个端点,按调用计费,统一令牌访问,无需注册各供

L3 · 安装规范通过 4,976 星

dsh-purge

dsh-purge

dsh-purge Community · DeepSeek Harness 社区维护版:宿主兼容、状态诊断、提示词管理、更新与本机备份回滚

未标注验证等级 3,412 星

dsh-im

dsh-im

将IM机器人接入DeepSeek Harness,支持飞书、微信、钉钉等九种渠道,通过扫码或凭据配置,统一管理多机器人连接。

L5 · 运行验证通过 1,837 星

dsh-aurabot-qq

dsh-aurabot-qq

让 DeepSeek Harness 里的 AI 以「大肥鱼」人格住进 QQ,通过 OneBot v11 网关聊天、发表情语音、写空间日记并

未标注验证等级 633 星

dsh-dafeiyu

dsh-dafeiyu

DSH 大肥鱼是一款由 DeepSeek Harness 真实工作状态驱动的桌面伴侣插件,以始终置顶的透明窗口实时展示 Agent 的思考、

L5 · 运行验证通过 425 星

dsh-trading

dsh-trading

L3 · 安装规范通过 235 星

nienieai 的其它插件

1 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-10-08。