前言¶

在 DeepSeek Harness（dsh）中运行 Agent 任务时，有些节点需要人介入或确认，也有本轮完成、回到空闲等状态。如果页面不在视野里，仅靠视觉状态容易漏掉关键变化。

dsh-bell-notify 是一个面向 dsh 的社区插件，用于把 Agent 生命周期事件转换为低打扰的声音提示。

它不是桌面系统通知桥，也不是通用的浏览器通知库；声音只在 DSH Web 会话的 Agent 生命周期事件发生时播放。

这是什么¶

dsh-bell-notify 由 Laplace-bit 维护，MIT 协议开源，属于 DeepSeek Harness 社区插件，不是 DeepSeek 官方发行。

DSH 的社区插件可以从第三方仓库安装。这个插件解决的问题是：在 DSH Web 会话中，对关键 Agent 生命周期事件提供可配置提示音，方便开发者在不持续盯着页面的情况下掌握进展。

核心功能¶

下面介绍它已提供的主要能力：

• 提供 10 个可配置 Agent 生命周期事件提示。
• 首次安装默认只开启开始执行、等待确认、本轮完成。
• 每个事件可试听、上传自定义音频并还原默认。
• 使用 Web Audio 实时合成铃声，不携带音频资源。
• 离线可用，不联网、不加载外部资源。
• 自定义音频保存在浏览器本地 localStorage 和 IndexedDB，不上传。
• 提供启用提示音总开关、总音量与事件开关配置。
• npm 包带预构建产物。

安装与启用¶

如果 PATH 上已经有 dsh，可以执行：

dsh plugin --profile bell add dsh-bell-notify

如果从源码仓库使用 pnpm，可以执行：

pnpm dsh plugin --profile bell add dsh-bell-notify

启动 Harness：

pnpm dsh --profile bell

打开页面后，需要先点击页面任意位置一次，以解锁浏览器音频自动播放策略。

之后进入：

设置 → 插件 → 插件配置 → 铃声通知

在这里可以调整启用提示音总开关、总音量、事件开关，也可以对每个事件试听、上传自定义音频或还原默认。

卸载时执行：

pnpm dsh plugin --profile bell remove dsh-bell-notify

配置¶

常规运行参数可以在 profile 的 cordis.patch.yml 中配置：

maxQueue: 8
maxConcurrent: 3
defaultCooldown: 1000

其中：

• maxQueue 是等待队列容量。
• maxConcurrent 是同时播放的声音数。
• defaultCooldown 是规则默认节流窗口，单位为毫秒。

更新¶

npm 安装更新：

pnpm update dsh-bell-notify

随后重启 Harness。

如果使用 link: 或 file: 本地开发安装，插件会显示为开发版本，更新按钮保持禁用。

版本兼容¶

已核实事实中列出的 DSH 内核支持范围是：

• 0.1.0-rc.5～0.1.0-rc.7
• 0.1.1-rc.2
• 0.1.2-alpha.1～0.1.2-alpha.3

使用 0.1.2 内核时，需要使用含兼容修复的构建。

0.1.2 内核移除了 settingsNamespace() 运行时助手；本插件通过本地内联常量兼容，不静态导入该运行时符号。

package.json 声明 Node 版本要求为：

^22.19.0 || >=24.0.0

适用场景与注意¶

它适合在 DSH 中运行较长任务、并行任务，或希望用少量提示音标记开始执行、等待确认、本轮完成等节点的开发者。

使用前注意：

• 它作为随 DSH 加载的插件运行，会在当前 dsh 进程环境中运行；安装前应检查源码、依赖和 MIT 许可证。
• 资料提示不要对 @deepseek-ai/* 包的运行时符号做静态导入。
• 自定义音频保存在浏览器本地，不会上传；文件字节存在 IndexedDB，事件到文件的映射存在 localStorage。
• 声音只在 DSH Web 会话的 Agent 生命周期事件发生时播放，不是桌面通知桥，也不是通用浏览器通知库。
• 首次加载后需要在页面上点击一次，以解锁浏览器音频自动播放策略。

链接¶

• GitHub：https://github.com/Laplace-bit/dsh-bell-notify
• 插件线索中的目录页：https://www.skillhub.cn/plugins/Laplace-bit/dsh-bell-notify