声音通知 AlonDan/dsh-notifications

DSH 通知

一个 DeepSeek Harness (DSH) 插件，当智能体需要你关注或完成工作时播放简短提示音：提问、审批请求、回合完成、后台任务、子智能体以及错误。

0.0.4 用户： 0.0.4 在 DSH 0.1.7-rc.2 上可能无法激活（启动时出现 failed to import 警告）：其辅助库 @deepseek-ai/schemastery 只是 peer/dev 依赖，因此没有随插件一起安装，而该库的旧本地副本可能会破坏导入。请更新到 0.0.5： dsh plugin --profile update dsh-sound-notifications

声音通知卡片

功能

- 六种通知事件，每种都有自己的开关和声音选择器
- 20 种内置声音，使用 WebAudio 在浏览器中合成（无需音频文件）
- 总启用开关和总音量滑块
- 每行都有测试按钮，可预览任意声音
- 自动保存：更改立即生效，并在页面重新加载后保留
- 设置界面关闭后声音仍会继续播放（引擎在插件级别运行）

位置

主框架中的插件页面：打开 Plugins，点击 sound-notifications 行，配置卡片会显示在页面上（始终展开）。

事件与默认值

| 事件 | 含义 | 默认声音 | 默认启用 |
| 提问 | 智能体提出会阻塞会话的问题（包括计划审查） | chime | 是 |
| 请求审批 | 工具调用正在等待你的审批 | pulse | 是 |
| 任务完成 | 当前回合成功完成 | complete | 是 |
| 后台任务完成 | 后台任务已完成或被停止 | sparkle | 是 |
| 子智能体完成 | 当前会话的子智能体停止运行 | soft-ping | 否 |
| 错误或失败 | 回合以错误结束，或任务失败 | alert | 是 |

要求

- 带有 Web 客户端的 DeepSeek Harness（包含 Plugins 设置区域的配置文件）
- 已针对 DSH 0.1.7 测试。放宽的 peer 依赖使其可跨 DSH 版本安装；运行时使用 configForms 设置服务。

安装

该包已预构建发布；安装无需构建步骤。

从打包的 tarball 安装（推荐最终用户使用）：
dsh plugin --profile web add ./dsh-sound-notifications-0.0.5.tgz

从本仓库的检出安装（在仓库文件夹内运行）：
dsh plugin --profile web add .

如果你使用其他配置文件，请将 web 替换为你的配置文件名称。添加或移除插件后，请重启 DSH，以使新的插件集生效。

更新

dsh plugin --profile update dsh-sound-notifications

移除

dsh plugin --profile remove dsh-sound-notifications

说明与限制（v1）

- 事件仅针对当前会话进行跟踪（其任务和子智能体）。
- 浏览器会阻止音频，直到页面上发生首次用户交互；在此之前，声音是静音的（这不是错误）。
- 所有声音都使用 WebAudio 在本地合成；不需要网络访问或文件。

开发

pnpm install
pnpm build # tsc + tsdown -> lib/
pnpm typecheck

该包分为两部分：Host 部分（src/index.ts）导出一个 Config schemastery schema（14 个字段，全部为 .volatile()）以及一个空的 apply，因此 DSH 会为 notifications 条目 id 自动提供设置表单（无需 settings.installSection）；浏览器部分（src/client/）通过 configForms 服务渲染卡片，并运行会话观察循环。客户端 bundle 以 DSH 的惰性 CJS 模块格式输出（参见 tsdown.config.ts）。

更新日志

0.0.5
- 修复了在 DSH 0.1.7-rc.2 上的启动激活失败问题。 该插件曾警告 failed to import，因为 @deepseek-ai/schemastery 仅被声明为 peer/dev 依赖，因此它从未随插件一起安装；当存在该库的较旧本地副本（没有 volatile() API）时，host 入口加载失败。现在 @deepseek-ai/schemastery ~3.18.4 是直接的生产依赖，因此它始终随插件一起发布。
- 移除了已提交且过时的 pnpm-lock.yaml，并添加了本地 .npmrc（auto-install-peers=false），以便在检出目录中全新执行 pnpm install 时保持最小化且可靠。

0.0.4
- 因 DSH 0.1.7-rc.2 上的激活失败问题，已被 0.0.5 取代（参见上方说明以及 0.0.5 更新日志条目）。
- 移植到 DSH 0.1.7 设置模型：host 导出一个 Config schemastery schema（所有字段均为 .volatile()）以及一个空的 apply，取代了已移除的 settings.installSection；客户端通过 configForms（由 settingsScope 重命名而来）使用 ConfigForm 类型读取表单。
- 设置命名空间已与 notifications cordis 条目 id 对齐。
- 防御性的 jobsBySession 读取使会话和作业观察在不同 host 构建中都能正常工作。
- 放宽了 peer 依赖，使该插件可跨 DSH 版本安装。
- 平滑了主音量滑块：拖动时它会跟随指针，并在释放时提交一次，因此不再感觉卡顿，也不会在你松手后继续漂移。
- 整个设置卡片现在会实时响应：每个控件都会立即更新（乐观的本地状态），而设置保存会在后台运行。

许可证

MIT