前言¶

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 倉庫。