在 DeepSeek Harness(DSH)的開發流程中,長時間運行的 Agent 任務往往缺乏實時的聽覺反饋,容易導致開發者錯過任務完成或異常終止的時機。dsh-reminder 插件將 pi-peon-ping-win 的功能忠實移植到 DSH,通過聲音和桌面通知提供任務生命週期的反饋。
核心功能¶
該插件基於 OpenPeon 聲音包,在任務狀態變化時觸發聲音和通知:
- 播放主題音頻片段。
- 顯示桌面通知。
- 原生 Windows 支持,具備三級音頻回退機制:
ffplay→mpv→winmm.dll。 - 自定義 WinForms 彈出窗口。
- 支持 OpenPeon 聲音包。
安裝¶
作爲 Profile 插件安裝:
dsh plugin --profile web add dsh-reminder
安裝後需重啓 Harness 或重新加載 Profile,插件會自動插入 cordis.patch.yml 配置。
配置與使用¶
所有設置均通過 Web 界面完成,無需使用 /peon slash 命令。
- 打開 Web 設置頁面(側邊欄齒輪圖標),滾動至 “Agent Presets” 下方找到 “peon-ping sounds” 區域。
- 在該區域可以:
* 安裝默認聲音包:直接從 peon-ping registry 下載 10 個默認包。
* 選擇聲音包:從已安裝的包中切換激活狀態。
* 調整音量:設置播放音量。
* 切換開關:控制桌面通知、工具錯誤提示音以及各類別的發聲(如task.complete、task.error等)。
* 設置靜音窗口:配置忽略短於指定秒數的任務完成提示。 - 配置修改會實時寫入
~/.config/peon-ping/config.json,無需重啓即可生效。
平臺支持¶
插件支持多平臺,音頻播放器根據系統自動選擇:
- Windows:推薦安裝 FFmpeg(
winget install Gyan.FFmpeg),回退順序爲 ffplay → mpv → winmm.dll。 - macOS:使用系統內置的
afplay。 - Linux:優先嚐試
pw-play、paplay、ffplay、mpv、play或aplay。 - WSL:通過 PowerShell
MediaPlayer播放,路徑會自動轉換爲 Windows 視圖。
注意事項¶
- 默認行爲:默認僅任務完成或異常終止時發聲,其他事件(如會話開始、工具錯誤等)默認關閉。
- 權限依賴:插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼與許可證。
- 數據共享:配置文件與 pi-peon-ping 共享,位於
~/.config/peon-ping/目錄。