前言¶
在 DSH 裏和智能體協作，多數時候仍依賴鍵盤：切窗口、打字、等回覆再讀屏。若希望「喊一聲就開始說、說完自動進輸入框、回答用嘴聽」，需要自己接喚醒、ASR、TTS 和客戶端注入，工程量不小。社區插件 dsh-voice-bridge（維護者 kinglhy2006，分類：客戶端）把這一套收成 DSH 插件：本地喚醒詞、中文識別、朗讀回答，並和 DSH 輸入框聯動。下面介紹它做什麼、怎麼裝、怎麼用，以及適用邊界。
這是什麼¶
dsh-voice-bridge 是面向 Windows 的 DSH 插件（當前 package.json 版本 1.0.1，MIT 許可）。定位是「賈維斯式」語音助手：默認喚醒詞 「你好賈維斯」，喚醒後說需求，識別結果寫入 DSH 輸入框併發送；模型回答時，若本輪是語音發起的，會用 TTS 朗讀（鍵盤輸入則不念）。
喚醒與語音識別在本地完成；朗讀默認走微軟在線神經語音，失敗時退回 Windows 系統語音。插件隨 DSH 啓動拉起「聽」「說」兩個後臺 Python 進程，關閉 DSH 時一併退出。
核心功能¶
本地喚醒與識別¶
- 喚醒詞：默認「你好賈維斯」，基於 sherpa-onnx 做本地關鍵詞檢測，不上傳音頻。
- 語音轉文字：本地 SenseVoice，面向中文；說完約 2.5 秒靜音後收尾（中途停頓不會被打斷）。
- 先填後發：識別文本先填入輸入框，底部浮條提示約 5 秒後自動發送；可點「等等」繼續補說，或點「現在發送」立刻發送。若不想發送，可在半秒內按退格刪掉。
朗讀與打斷¶
- 朗讀回答：在線音色可選曉曉、雲希等（見配置）；斷網或失敗時用系統語音。
- 打字不念：僅語音發起的對話會朗讀回覆。
- 可打斷：朗讀過程中再說「你好賈維斯」會停止；說「續 / 繼續 / 接着」可從斷點續播。
隱私與接口¶
- 喚醒與 ASR 均在本地，音頻不出本機。
- 朗讀會把文本發給微軟在線 TTS；本地服務只監聽本機並拒絕跨站請求。
安裝與啓用¶
前提：Windows，且已安裝 DSH（安裝腳本依賴 DSH 自帶的 Python）。官方 README 未提供 dsh plugin add github:... 一類命令，請按下列步驟操作。
- 將倉庫下載或解壓到可寫目錄（不要放在
C:\Program Files），例如D:\Jarvis。 - 右鍵
install.ps1，選擇「使用 PowerShell 運行」。腳本會安裝 Python 依賴、引導試麥並寫入jarvis\device.json。 - 打開 DSH → 插件面板 → 添加本地目錄，填寫含
package.json的插件根目錄。 - 重啓 DSH。之後每次啓動會自動拉起聽、說進程。
# 步驟 2：在插件根目錄右鍵運行 install.ps1（圖形界面操作，無單行 CLI）
# 步驟 3：DSH 插件面板 → 添加本地目錄 → 指向 dsh-voice-bridge 根目錄
插件以當前 DSH 進程權限運行；安裝前建議瀏覽倉庫源碼與 LICENSE、models/NOTICE.md，確認第三方模型許可可接受。
典型用法¶
- 說「你好賈維斯」→ 聽到提示音「叮」→ 說明要做的任務 → 停約 2.5 秒 → 聽到「咚」表示一句結束。
- 查看輸入框中的識別結果與底部確認條；需要時可「等等」補話或「現在發送」。
- 等待 DSH 回覆；若是語音發起的對話，插件會朗讀；打字提問則只顯示文字。
- 朗讀中可說「你好賈維斯」打斷，再說「續 / 繼續 / 接着」續播。
換音色或語速：編輯 jarvis\voice.json 後重啓 DSH，例如：
{"voice":"zh-CN-YunxiNeural","rate":"+10%"}
可選 voice：zh-CN-YunxiNeural（雲希）、zh-CN-YunjianNeural（雲健）、zh-CN-YunyangNeural（雲揚）、zh-CN-XiaoxiaoNeural（曉曉）。
換喚醒詞：改 jarvis\kw_raw.txt（一行一個，格式 你好賈維斯 @你好賈維斯），再用 DSH 自帶 Python 執行 README 中的 make_keywords.py 命令重新生成關鍵詞文件；靈敏度可在 jarvis\jarvis_listen.py 的 build_kws() 裏調 keywords_score、keywords_threshold。
適用場景與注意¶
適合：長期在 Windows 上使用 DSH、希望 hands-free 喚醒與中文口述指令、並能接受朗讀走在線 TTS 的開發者。
限制與運維（來自 README）：
- 僅支持 Windows（MCI、SAPI、DSH Python 路徑等依賴）。
- 勿重複添加同名本地插件，否則會各起一套進程。
jarvis/voice.log、speak.log會持續增長，可定期清理。- 誤喚醒或喊了沒反應：按 README 常見問題表調麥克風
device.json或 KWS 靈敏度；可運行python jarvis\mic_probe.py 8排查設備。
DSH 生態強調「一切皆插件」；社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-voice-bridge 把本地「你好賈維斯」喚醒、SenseVoice 中文識別與 DSH 輸入框發送、以及可選的語音朗讀串成一條鏈路，適合在 Windows 上把 DSH 當成可喊可聽的對話入口。細節與故障排查以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/kinglhy2006/dsh-voice-bridge
- GitHub：https://github.com/kinglhy2006/dsh-voice-bridge
