前言¶

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