前言¶

DeepSeek Harness 是一个用于智能体开发的框架。在长时间运行的任务中，开发者可能无法时刻关注界面，从而错过关键事件，例如任务完成、工具审批请求、等待回答或发生错误。传统的单一蜂鸣声难以区分事件的紧急程度和类型。dsh-notify-bell 插件通过语义化声音和 Web UI 铃铛开关，帮助用户通过听觉反馈快速定位重要事件。

插件概述¶

dsh-notify-bell 是一个社区插件，由开发者 ZYar-er 维护。它旨在将 DeepSeek Harness 的内部事件转化为有意义的听觉信号。

核心功能¶

该插件提供以下能力：

• 语义化通知：针对完成、审批、提问、受阻和错误五种事件类型提供不同的声音。
• 多端播放：
  • 浏览器端：在 DSH Web 中播放。
  • 主机端：在 Windows、WSL 和 Linux 上播放。
  • Fallback：主机端若无法播放 WAV，可回退到终端 BEL。
• 播放控制：
  • Web UI 提供“静音/开启”开关。
  • 支持选择播放模式：Browser / Backend / None。
• 配置化：支持配置最小持续时间、自定义通知声音等。
• 无额外依赖：仅依赖官方的 @deepseek-ai/schemastery。

安装与启用¶

使用官方命令安装插件：

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

安装后，根据当前 DSH 的设置，可能需要重启 dsh web 服务。

典型用法¶

1. 启动 DSH Web 后，在界面中可以看到“Session log”旁边出现了一个铃铛图标。
2. 点击铃铛图标，会弹出通知设置面板。
3. 在面板中可以控制通知的开启与关闭，并选择声音的播放位置（浏览器或后端）。

配置说明¶

插件遵循官方 DSH Cordis 配置模型。配置位于 cordis.patch.yml。

示例配置：

- id: notify-bell
  config:
    minDuration: 10
    playback: backend

• playback：控制声音播放位置，可选值为 browser、backend 或 none。
• minDuration：设置完成通知的最小持续时间阈值，低于此时长的事件不播放声音。

适用场景与注意事项¶

• 该插件适合需要长时间运行任务并希望获得即时听觉反馈的开发者。
• 浏览器自动播放限制：若选择浏览器播放模式，浏览器通常要求用户先与页面进行一次交互（点击或按键）后，声音才能正常播放。
• 依赖项：插件仅依赖 @deepseek-ai/schemastery，不引入其他运行时库。

总结¶

dsh-notify-bell 为 DeepSeek Harness 增加了听觉层面的状态感知能力。通过简单的配置，可以在保持界面清爽的同时，确保不遗漏重要的智能体事件。更多细节可参考社区目录或GitHub 仓库。