DeepSeek Harness 插件：dsh-task-sounds —— 任務完成與提問提示音

在使用 DeepSeek Harness (DSH) 進行 Agent 開發或測試時，長時間運行的任務往往難以通過視覺狀態變化來實時追蹤進度。本插件通過在特定交互節點觸發提示音，提供了一種直觀的聽覺反饋機制。

是什麼¶

dsh-task-sounds 是一個爲 DSH Web UI 設計的輕量級插件，由用戶 henrytang2011win-coder 維護。它利用瀏覽器原生的 Web Audio API 實時合成提示音，不依賴任何外部音頻文件、網絡請求或宿主進程，支持完全離線工作。

核心功能¶

• 對話完成提示：當 Agent 完成一輪對話時播放提示音。
• 提問提示音：當 Agent 向用戶提問（包括問題、計劃審查或審批）並等待輸入時，播放 “ding-dong” 提示音。
• 零依賴合成：完全在瀏覽器端生成音頻，無需素材、無需網絡、無需宿主進程。
• 狀態持久化：支持靜音開關，靜音狀態保存在 localStorage 中，刷新頁面後保持。
• 歷史播放保護：加載歷史消息或分頁瀏覽時不會重複播放已處理節點的提示音。

安裝與啓用¶

執行以下命令安裝插件：

dsh plugin --profile web add dsh-task-sounds

安裝後重啓 dsh web 進程即可生效。

典型用法¶

1. 重啓 DSH Web 服務後，啓動一個任務或讓 Agent 自動運行。
2. 觀察並聆聽：
   • done：Agent 完成一輪對話時播放。
   • question：Agent 提出問題或需要審批時播放。
3. 點擊會話頭部工具欄中的 🔔 圖標可靜音，再次點擊恢復。

注意事項與適用場景¶

• 瀏覽器自動播放策略：音頻引擎需要在頁面發生第一次鼠標點擊或按鍵交互後纔會解鎖，因此初次操作後才能聽到提示音。
• 純客戶端實現：插件客戶端代碼爲純 JavaScript，無需打包工具。
• 適用人羣：適合需要在嘈雜環境中或通過聽覺輔助監控 Agent 運行進度的開發者。

結尾¶

該插件以極小的體積解決了狀態反饋缺失的問題，適合集成到 DSH 的日常開發流程中。更多技術細節與源碼可參考 GitHub 倉庫。