前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在开发智能体或配置多任务工作流时，开发者经常需要处理并行任务、后台任务或等待人工介入。如果一直盯着页面，容易遗漏关键状态变更。dsh-chime-alerts 插件旨在解决这一问题，通过声音提醒让 Agent 工作事件在特定时刻发出提示。
该插件由 nienieai 维护，遵循 MIT 许可证。它不依赖外部音频文件，默认使用浏览器合成的零版权负担声音，并提供跨平台的系统蜂鸣支持。
核心功能¶
插件支持对十类独立事件进行声音控制，每类事件均可单独设置开关、声音和音量。
- 事件类型：支持任务完成、子任务完成、后台任务完成、需要授权、插件授权、Agent 提问、计划评审、目标受阻、其他打断、后台任务失败。
- 混合发声：提供网页响铃（Web Audio 合成音）与宿主蜂鸣（系统音效）两种方式，并独立控制。
- 工作区静音：侧栏每个工作区旁设有静音按钮，可按工作区独立静音。
- 跨平台系统音：宿主蜂鸣支持 Windows wav、Linux freedesktop 主题音、macOS afplay。
- 声音自定义：支持内置音效或上传自定义音频（动态版 ≤5MB，静态版 ≤3MB）。
- 测试覆盖：包含 247 项自动化测试断言。
安装与启用¶
使用官方 CLI 进行安装。
dsh plugin --profile web add dsh-chime-alerts
安装完成后，需重启 DSH 并重新打开网页标签页以生效。
典型用法¶
- 打开 DSH 设置页面，进入「声音提醒」。
- 启用总开关。
- 为不同的任务类型配置声音或音量。
- 在工作区侧栏点击喇叭图标，快速静音该工作区的所有提醒。
- 若使用静态安装，可在设置页底部查看版本号确认加载状态。
适用场景与注意¶
该插件适合需要同时监控多个任务状态或长时间运行后台任务的开发者。
需注意以下几点：
* 权限与依赖：插件仅覆盖本 DSH 进程内宿主能观察到的事件。它依赖 DSH 内部契约（事件名与参数签名），并非公开 API，DSH 升级可能导致行为变化。
* 浏览器依赖：浏览器音需要页面处于打开状态。页面关闭时，若未开启宿主蜂鸣，则不会发声。
* 平台实测：Linux / macOS 的分支代码已实现并通过 Node 模拟测试，但尚未在真实机器上实测。
* UI 适配：设置页导航图标与工作区静音按钮依赖特定的外壳 DOM 结构（CSS hack / 固定定位注入），外壳改版需同步适配。工作区行内静音按钮在真实浏览器中尚未验证，可能不显示。
结语¶
dsh-chime-alerts 提供了一种轻量级的听觉反馈机制，通过独立的声音配置帮助开发者专注于核心业务逻辑。更多细节可参考 GitHub 仓库 或 社区目录。
