前言¶

在 DSH（DeepSeek Harness）宿主環境中，等待 Agent 完成一輪對話、等待 Agent 提問回答、等待工具調用批准時，通常需要切回對話頁確認狀態。dsh-ding 是一個 DSH 插件：對話完成時播放提示音，並彈出 Windows 原生通知；WebUI 中的鈴鐺按鈕可用於開關提示音、調整音量、選擇音效或上傳音頻。

該插件由 CAOGGL 維護，許可證爲 MIT。

這是什麼¶

dsh-ding 用於把 DSH 對話和任務狀態轉成提醒。它覆蓋對話完成、長任務運行中、Agent 提問、工具調用等待批准等場景。

核心功能¶

下面按已覈實能力列出：

• 對話完成時播放提示音。
• 彈出 Windows 原生通知。
• Web 鈴鐺按鈕：單擊開關提示音、懸停調整音量、右鍵選擇音效或上傳音頻。
• 點擊 Windows 通知後自動打開瀏覽器並直達對應會話。
• 當前會話免打擾。
• 長任務運行中提醒。
• Agent 通過 ask_user_question 提問並等待回答時提醒。
• 工具調用等待批准時提醒。
• 高級設置彈窗中運行時修改通知開關、標題、時機毫秒、音量、自定義通知模板。
• 導入/導出 JSON 配置。
• 內置 ding.mp3 提示音文件。
• 通知正文與標題、面板文案跟隨 WebUI 中/英文語言。
• 默認 200ms 防抖和 3s 全局節流。
• 自動跳過子代理完成事件。

提示音文件格式資料列明爲 mp3/wav/mid/wma/aac；Web 上傳音效還列明支持 m4a/ogg/flac。

安裝與啓用¶

命令行安裝¶

如果環境尚未安裝 pnpm，可先執行：

npm install -g pnpm

然後執行安裝命令：

dsh plugin --profile web add github:CAOGGL/dsh-ding

安裝後重啓 dsh web 生效。

WebUI 插件市場¶

1、進入“設置 -> 插件市場”。

2、搜索 dsh-ding。

3、點擊一鍵安裝。

手動放置¶

1、把插件目錄放到：

$DSH_HOME/profiles/node_modules/dsh-ding/

2、在 cordis.patch.yml 中追加 dsh-ding 的 insert 配置。

3、保存後，補丁文件熱監控即時生效；插件代碼本身改動需要重啓服務。

典型用法¶

鈴鐺按鈕¶

在對話頁頂欄的鈴鐺上：

1、單擊：開關提示音。

2、懸停：調整音量。

3、右鍵：選擇音效或上傳音頻。

高級設置¶

打開高級設置後，可運行時修改通知開關、標題、時機毫秒、音量、自定義通知模板。

高級設置頁提供測試按鈕，可分別發出完成、運行中、提問、審批通知。

測試通知腳本¶

單獨測試 Windows 通知腳本時，可運行資料給出的 PowerShell 命令：

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-ding\notify.ps1" -Title "測試" -Text "dsh-ding 工作正常"

適用場景與注意¶

適合等待 Agent 回覆、長任務運行中、Agent 提問、工具審批等場景。

注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查倉庫源碼與 MIT 許可證。
• Windows 通知首次使用時需自動註冊 AppUserModelID；未註冊的 AUMID 會被 Windows 靜默丟棄。
• 手動放置方式中，cordis.patch.yml 補丁變更即時生效，插件代碼變更需要重啓服務。

鏈接¶

• GitHub：https://github.com/CAOGGL/dsh-ding
• WebUI 插件市場入口：設置 -> 插件市場 -> 搜索 dsh-ding