前言¶

DeepSeek Harness 的 Web 界面主要依赖视觉反馈。当智能体在后台运行或长时间输出时，开发者容易忽略状态变化。UI Beep 通过听觉反馈填补了这一空白，将智能体的运行状态转化为三个程序化生成的 Web-Audio 音调。

插件简介¶

这是一个为 DeepSeek Harness Web 界面提供的智能体心跳声化插件。它通过浏览器原生的 Web Audio API 生成三个无素材的音效：工作时的低频心跳、流式输出的短促滴答声，以及需要用户介入时的提示音。代码基于 MIT 许可证发布，是 deepseek-harness 仓库中 ui-beep 插件的独立 Fork。

环境要求¶

插件依赖 DeepSeek Harness (DSH) 的特定版本。

• DSH 版本：必须 >= 0.1.7。
• 兼容性警告：0.4.x 及更早版本无法激活此插件。DSH 0.1.7 引入了基于 Profile 的配置表单，这是此插件正常运行的基础。
• Semver 注意：^0.1.7-rc.2 匹配 0.1.7-rc.x 和 0.1.7，但不会匹配未来的 0.1.8-rc.x。

安装¶

使用 npm 安装：

npm install @xain_npm/dsh-client-ui-beep

启用与配置¶

在 harness 的 cordis.yml（或 cordis.patch.yml）中挂载插件：

- id: ui-beep
  name: '@xain_npm/dsh-client-ui-beep'
  config:
    enabled: true

配置项包括：
* enabled: 总开关。
* masterVolume: 主音量（0 到 2）。
* tickVolume: 滴答声音量（对应流式输出）。
* humVolume: 心跳声音量（对应后台工作）。
* chimeVolume: 提示音音量（对应等待用户输入或工作完成）。

注意：配置值默认为浏览器默认值。一旦用户在设置页修改，值将写入该浏览器的 localStorage，不同浏览器独立存储。

工作原理¶

插件不依赖外部音频文件，所有音效由代码实时合成。

• Hum（心跳）：当有会话正在运行（工作）且没有待处理的交互时播放。模拟低频的 “lub-dub” 心跳，每 4 秒一次，工作流输出或等待输入时会暂停。
• Tick（滴答）：当当前会话正在流式输出可见文本时播放。这是一个高频短促的 2kHz 声音。
• Chime（提示）：当有会话开始等待用户输入（审批、计划审查等），或者最后一个工作会话变为空闲时播放。未回答的交互会在 10 秒后和 30 秒后重复提示音。

注意事项¶

• 浏览器自动播放策略：大多数浏览器会阻止音频自动播放。插件会在页面上发生 pointerdown 或 keydown 用户手势后激活。在此之前，插件处于静默状态。
• 许可证：MIT。

结语¶

通过听觉反馈，开发者可以在不持续盯着屏幕的情况下感知智能体的状态。更多细节请参考项目主页：GitHub