前言¶
在 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
