前言¶
在 DSH 開發或使用智能體時，會話狀態的變化（如任務完成或等待用戶輸入）可能悄無聲息地發生。爲了解決遺漏重要通知的問題，我們介紹 roger-yang-cn/dsh-voice-alert。這是一個 DSH 瀏覽器插件，旨在通過聽覺和視覺反饋，幫助用戶及時感知會話狀態。
是什麼¶
dsh-voice-alert 是一個由 Roger-Yang-CN 維護的客戶端插件。它通過監聽會話狀態，在特定事件觸發時提供語音提示、頁面彈窗和系統通知。
核心功能¶
該插件提供以下能力：
- 語音播放：當任意會話完成任務（回合結束）或請示用戶時，播放指定的語音提示。
- 頂部提示條：在頁面頂部顯示提示條，6秒後自動消失，支持點擊關閉。
- 系統通知：當頁面失焦或最小化時，發送系統通知，點擊可跳回 DSH。
- 語音素材：內置「千織」語音。支持自定義替換，需保持文件名不變。
安裝與啓用¶
由於插件使用 file: 依賴，且 pnpm 對該類型的依賴不會自動刷新，需要手動同步插件副本。
- 克隆倉庫：將
roger-yang-cn/dsh-voice-alert克隆到本地任意目錄。 - 配置依賴：編輯 DSH profile 的
package.json（如~/.dsh/profiles/web/package.json），添加依賴與 bundle 配置：
"dependencies": { "dsh-voice-alert": "file:<克隆到的絕對路徑>" },
"dsh": { "profile": { "bundles": [ "...", "dsh-voice-alert" ] } }
- 安裝依賴：在 profile 目錄執行
pnpm install。 - 手動同步插件副本：將插件目錄的
lib/、assets/複製到node_modules/dsh-voice-alert/。 - 重啓：重啓 DSH，頁面出現提示條即生效。
典型用法¶
插件會自動監聽會話狀態，無需額外配置：
- 任務完成：當任意會話回合結束時，自動播放語音並彈出提示條。
- 請示用戶：當任意會話觸發
ask_user_question、審批或方案評審時，觸發語音與提示條。 - 自定義語音：替換
assets/下的任務已完成.wav或請求決策.wav，保持文件名不變即可生效。
適用場景與注意¶
- 權限要求：首次觸發時瀏覽器會請求通知權限，需允許後失焦提醒纔可用。
- 依賴機制：務必手動將插件的
lib/和assets/複製到node_modules，因爲pnpm的file:依賴不會自動刷新。 - 許可證：目前未在資料中明確說明許可證，安裝前建議檢查源碼。
總結¶
該插件通過語音和彈窗機制，幫助用戶及時感知 DSH 會話狀態變化。更多詳情與源碼請訪問 GitHub。
