前言¶
在 DSH「一切皆插件」的擴展方式下，很多體驗細節都可以拆成獨立插件處理。多輪任務、計劃模式、工具執行、審批請求、報錯，這些狀態變化如果只靠盯屏，後臺窗口裏很容易被漏掉。
dsh-perlica-ding 是一個 DeepSeek Harness 插件，用於在關鍵節點播放不同提示音：計劃出方案、任務完成、需要你回應、出錯時會響，普通問答保持安靜。內置佩麗卡風格提示音，安裝後無需任何配置，也可以替換自己的 WAV 音效。
插件定位¶
dsh-perlica-ding 解決的是 DSH 任務執行過程中的狀態提醒問題：哪些節點該發聲，哪些節點保持安靜。
給定資料中的倉庫地址爲：
https://github.com/117BS/dsh-perlica-ding
給定資料中許可證爲 MIT，README 與 package.json 均標明；package.json 中的版本號爲 0.1.0。
核心能力¶
dsh-perlica-ding 提供的能力集中在任務狀態提示上：
- 計劃出方案、任務完成、需要你回應、出錯時播放不同提示音，普通問答保持安靜。
- 內置佩麗卡風格提示音，
sounds/目錄隨包分發，安裝後無需任何配置。 - 窗口在後臺也能聽到提示音。
- 只響主對話：子代理/後臺任務完成時不單獨響，隨主回合統一收尾。
- 每檔音效有獨立 2.5 秒防抖間隔，避免連響。
- 跨平臺支持：Windows (SoundPlayer) / macOS (afplay) / Linux (paplay/aplay)。
- 可配置總開關、防抖間隔、音效目錄和執行類工具列表（
execTools）。
安裝與啓用¶
從 GitHub 安裝¶
從 GitHub 安裝：
dsh plugin --profile web add https://github.com/117BS/dsh-perlica-ding
安裝後需要重啓 dsh web profile 才生效：
dsh web restart
從 npm 安裝¶
資料給出的 npm 安裝方式如下：
dsh plugin --profile web add dsh-perlica-ding
資料稱 npm 發佈後可用；給定資料未確認當前 npm 包是否已發佈。
本地開發安裝¶
本地開發安裝示例如下：
dsh plugin --profile web add D:\deepseek\dsh-perlica-ding
配置¶
在 profile 的 cordis.yml 或用戶 patch 層中設置 plugins.dsh-perlica-ding：
plugins:
dsh-perlica-ding:
enabled: true
debounceMs: 2500
soundDir: ""
execTools: []
各配置項作用如下：
enabled：總開關。debounceMs：同檔音效最小間隔，單位毫秒。soundDir：自定義音效目錄；留空則用當前工作區。execTools：指定哪些工具算“執行任務”；空數組表示所有工具都算。
自定義音效¶
內置音效位於 sounds/ 目錄，隨包分發，安裝後可直接使用。
如果想換成自己的聲音，將真正的 WAV（PCM）同名文件放到工作區根目錄或配置的 soundDir，同名文件會覆蓋內置聲音，立即生效無需重啓。
給定資料中的查找順序爲：配置目錄 → 工作區 → 包內自帶 → 系統回退。
自定義音效要求爲真正的 WAV 格式（PCM）。如果 TTS 工具導出 MP3，需要先用 ffmpeg 轉碼爲 PCM WAV。
手動測試聲音鏈路可以使用給定資料中的命令：
$p = New-Object Media.SoundPlayer 'D:\deepseek\done.wav'; $p.PlaySync()
適用場景與注意¶
適合以下使用方式：
- 使用 DSH 跑多輪任務，希望計劃、完成、審批、報錯等節點有聲音提醒。
- 希望普通問答保持安靜，不被每次對話打擾。
- 希望子代理/後臺任務不單獨發聲，只隨主回合統一收尾。
- 希望在後臺窗口也能聽到關鍵狀態變化。
注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 安裝後需要重啓
dsh web profile才生效。 - 自定義音效必須是 WAV（PCM），MP3 需先轉碼。
package.json聲明可選peerDependencies：@deepseek-ai/cordis、@deepseek-ai/schemastery。
鏈接¶
插件線索給出的目錄頁 URL 爲：
https://www.skillhub.cn/plugins/117BS/dsh-perlica-ding
倉庫地址爲：
https://github.com/117BS/dsh-perlica-ding
