铃声通知Laplace-bit/dsh-bell-notify

dsh-bell-notify 🔔

· English

npm version Pages MIT license 在线试听

dsh-bell-notify 是 DeepSeek Harness（dsh）的社区插件。它把关键 Agent 生命周期事件变成可配置的声音提示，让你在不盯着页面时仍能掌握进度。

所有铃声均由 Web Audio 实时合成，不携带音频资源。配置集中在 设置 → 插件 → 插件配置 → 铃声通知：不再提供工作区悬浮面板或右下角状态点，避免占用会话界面。

它不是 DeepSeek 官方发行的一部分，是一个 MIT 协议开源的社区插件。

一句话定位

如果你在后台运行 DeepSeek Harness（dsh）任务，想在需要介入或任务完成时收到低打扰提示，安装这个插件即可。它适合长任务、并行工作和不希望一直盯着浏览器的开发者；不需要外部服务，也不会上传音频。

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

它能干什么

🎵 需要时才响

每个可配置事件都有独立铃声。首次安装默认只开启三个最需要注意的节点：开始执行、等待确认、本轮完成；其余事件预置为关闭，避免过程细节持续打断你。

| 环节 | 默认铃声 | 首次状态 |
|------|---------|---------|
| 会话启动 | startup | 关闭 |
| 开始执行 | click | 开启 |
| 开始思考 | notify | 关闭 |
| 工具调用 | tick | 关闭 |
| 工具完成 | drop | 关闭 |
| 命令执行 | beep | 关闭 |
| 命令完成 | rise | 关闭 |
| 等待确认 | alert | 开启 |
| 本轮完成 | success | 开启 |
| 回到空闲 | confirm | 关闭 |

🎛️ 每个声音都能自己换

打开 设置 → 插件 → 插件配置 → 铃声通知，可对每一个事件：

- 试听默认音，或者试听你上传的音
- 上传自己的音频文件替换默认音
- 还原回默认

换上的声音会记住（刷新后仍在），界面会显示上传的文件名。需要回到原始配方时，直接选择“还原默认”。

🎼 声音是「活」的

所有铃声都是实时合成的——不是一段段录好的音频文件。这意味着：

- 零音频资源，包体轻到可以忽略
- 内置配方在播放时实时生成；每个事件都可以替换成自己的音频
- 离线可用，不联网、不加载外部资源

为什么做这个

当 Agent 运行较久时，页面并不总在视野里。用少量高价值提示音标记开始、需要确认和完成，你可以把注意力留给别的工作，需要介入时再回到 Harness。

安装

从 DeepSeek Harness 源码仓库里：

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

如果 PATH 上已经有 dsh：

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

npm 包带预构建产物，无需 pnpm ≥10 的构建脚本授权，直接可装。

启动：

pnpm dsh --profile bell

打开页面后先点一下页面任意位置（浏览器的音频自动播放策略，点一次即可解锁声音），然后在 设置 → 插件 → 插件配置 → 铃声通知 中按需要调整事件。

卸载：

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

内核兼容性

| 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（含 2026-09-01 兼容修复的构建）；此前发布版在 0.1.2 上加载失败 |

- ✅ = 兼容。0.1.2-alpha.3 为当前宿主内核，已实测（产物导入 + 测试套件）；其余内核按双内核兼容设计支持（同一份构建、同一 API 面）。
- 0.1.2 起内核移除了 settingsNamespace() 运行时助手（≤ 0.1.1 上它只是个校验恒等函数，0.1.2 仅保留同名类型）。本插件不静态导入该符号，而是在注册设置命名空间时本地内联常量并断言为 SettingsNamespace 类型，新旧内核通用。
- 0.1.2 起不再静态导入 settingsNamespace()；此前发布版仅在 ≤ 0.1.1 内核上可用，请更新至含修复的版本。
- 不要对 @deepseek-ai/ 包的运行时符号做静态导入。宿主 CLI 经 node --import tsx/esm 启动，tsx 会应用宿主 tsconfig 的 paths 映射，外部插件对 @deepseek-ai/ 的裸导入可能被重定向进宿主源码，一旦宿主侧改名/删符号就会以模块实例化错误的形式炸掉启动。类型导入（import type）不受影响。

配置

常规运行参数仍可在 profile 的 cordis.patch.yml 中调整（Cordis 加载时会校验并补默认值）：

maxQueue: 8            # 等待队列容量
maxConcurrent: 3       # 同时播放的声音数（1 = 串行，值越大越能重叠）
defaultCooldown: 1000  # 规则默认节流窗口（毫秒）

在 设置 → 插件 → 插件配置 → 铃声通知 中：

- “启用提示音”是唯一的总开关；关闭即完全静音。
- 总音量与启用状态持久化在当前 profile。
- 每个事件的开关、自定义音源和文件名保存在浏览器本地（localStorage + IndexedDB），改完立即生效、刷新不丢。

旧版的右下角状态点和浮层设置已移除；现有配置都在插件配置卡中完成。

版本与更新

卡片会显示包元数据中的运行版本。只有当前 profile 能确认使用 npm registry 包时，才会启用“更新”；更新会在该 profile 内执行固定的 pnpm update dsh-bell-notify，随后按 Harness 规则同步 dsh.profile.bundles，完成后重启 Harness 生效。link: / file: 本地开发安装会显示为“开发版本”，更新按钮保持禁用，避免覆盖你的源码链接。

开发

pnpm install
pnpm build          # 产出 lib/index.js（Host）+ lib/client.js（浏览器）
pnpm test           # 单元测试
pnpm typecheck

想快速试听内置铃声？在仓库中打开 preview.html，或访问在线试听页。

常见问题

这是 DeepSeek 官方插件吗？
不是。它是 DeepSeek Harness（dsh）的社区插件，MIT 协议开源，不属于官方发行。

为什么点了没声音？
大概率是浏览器的自动播放策略——插件首次加载后需要你先在页面上点击一次，声音才会解锁。这之后事件声音就能正常响了。

在哪里配置提示音？
在 Web 设置的 插件 → 插件配置 → 铃声通知 中。这里可以设置启用状态、音量、事件开关与自定义铃声，也能查看并更新 npm 安装的版本。

为什么不再有右下角状态点或浮层？
它们已被移除，避免遮挡工作区。所有控制项现在统一放在插件配置中。

自定义的声音存在哪？
文件字节存在浏览器 IndexedDB，事件到文件的映射存在 localStorage。都在你本地，不会上传到任何地方。

许可证

MIT