前言¶

在 DeepSeek Harness（dsh）中運行 Agent 任務時，有些節點需要人介入或確認，也有本輪完成、回到空閒等狀態。如果頁面不在視野裏，僅靠視覺狀態容易漏掉關鍵變化。

dsh-bell-notify 是一個面向 dsh 的社區插件，用於把 Agent 生命週期事件轉換爲低打擾的聲音提示。

它不是桌面系統通知橋，也不是通用的瀏覽器通知庫；聲音只在 DSH Web 會話的 Agent 生命週期事件發生時播放。

這是什麼¶

dsh-bell-notify 由 Laplace-bit 維護，MIT 協議開源，屬於 DeepSeek Harness 社區插件，不是 DeepSeek 官方發行。

DSH 的社區插件可以從第三方倉庫安裝。這個插件解決的問題是：在 DSH Web 會話中，對關鍵 Agent 生命週期事件提供可配置提示音，方便開發者在不持續盯着頁面的情況下掌握進展。

核心功能¶

下面介紹它已提供的主要能力：

• 提供 10 個可配置 Agent 生命週期事件提示。
• 首次安裝默認只開啓開始執行、等待確認、本輪完成。
• 每個事件可試聽、上傳自定義音頻並還原默認。
• 使用 Web Audio 即時合成鈴聲，不攜帶音頻資源。
• 離線可用，不聯網、不加載外部資源。
• 自定義音頻保存在瀏覽器本地 localStorage 和 IndexedDB，不上傳。
• 提供啓用提示音總開關、總音量與事件開關配置。
• npm 包帶預構建產物。

安裝與啓用¶

如果 PATH 上已經有 dsh，可以執行：

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

如果從源碼倉庫使用 pnpm，可以執行：

pnpm dsh plugin --profile bell add dsh-bell-notify

啓動 Harness：

pnpm dsh --profile bell

打開頁面後，需要先點擊頁面任意位置一次，以解鎖瀏覽器音頻自動播放策略。

之後進入：

設置 → 插件 → 插件配置 → 鈴聲通知

在這裏可以調整啓用提示音總開關、總音量、事件開關，也可以對每個事件試聽、上傳自定義音頻或還原默認。

卸載時執行：

pnpm dsh plugin --profile bell remove dsh-bell-notify

配置¶

常規運行參數可以在 profile 的 cordis.patch.yml 中配置：

maxQueue: 8
maxConcurrent: 3
defaultCooldown: 1000

其中：

• maxQueue 是等待隊列容量。
• maxConcurrent 是同時播放的聲音數。
• defaultCooldown 是規則默認節流窗口，單位爲毫秒。

更新¶

npm 安裝更新：

pnpm update dsh-bell-notify

隨後重啓 Harness。

如果使用 link: 或 file: 本地開發安裝，插件會顯示爲開發版本，更新按鈕保持禁用。

版本兼容¶

已覈實事實中列出的 DSH 內核支持範圍是：

• 0.1.0-rc.5～0.1.0-rc.7
• 0.1.1-rc.2
• 0.1.2-alpha.1～0.1.2-alpha.3

使用 0.1.2 內核時，需要使用含兼容修復的構建。

0.1.2 內核移除了 settingsNamespace() 運行時助手；本插件通過本地內聯常量兼容，不靜態導入該運行時符號。

package.json 聲明 Node 版本要求爲：

^22.19.0 || >=24.0.0

適用場景與注意¶

它適合在 DSH 中運行較長任務、並行任務，或希望用少量提示音標記開始執行、等待確認、本輪完成等節點的開發者。

使用前注意：

• 它作爲隨 DSH 加載的插件運行，會在當前 dsh 進程環境中運行；安裝前應檢查源碼、依賴和 MIT 許可證。
• 資料提示不要對 @deepseek-ai/* 包的運行時符號做靜態導入。
• 自定義音頻保存在瀏覽器本地，不會上傳；文件字節存在 IndexedDB，事件到文件的映射存在 localStorage。
• 聲音只在 DSH Web 會話的 Agent 生命週期事件發生時播放，不是桌面通知橋，也不是通用瀏覽器通知庫。
• 首次加載後需要在頁面上點擊一次，以解鎖瀏覽器音頻自動播放策略。

鏈接¶

• GitHub：https://github.com/Laplace-bit/dsh-bell-notify
• 插件線索中的目錄頁：https://www.skillhub.cn/plugins/Laplace-bit/dsh-bell-notify