GooDAnDReaDY/dsh-voice

📦 @goodandready/dsh-voice

DeepSeek Harness 零延迟流式语音听写与多服务商对讲输入插件

🇬🇧 English •
🇷🇺 Русский •
🇨🇳 中文说明

⭐ 如果您喜欢这个插件，请在 GitHub 上为它点亮 Star — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。

🐛 如果您发现 Bug 或希望增加功能，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。

⚡ 插件概览

dsh-voice 为 DeepSeek Harness Web 界面带来极速语音交互体验。无论是按自然停顿切分的流式听写，还是带撤回保护的语音消息以及键盘/鼠标 Push-to-Talk 对讲，dsh-voice 凭借多服务商自动故障转移备用链确保您的录音万无一失。

graph LR
subgraph Client [前端 Web 浏览器]
Mic[🎙️ 听写麦克风] -->|VAD 停顿切分| Stream[音频数据切片]
Wave[🌊 语音消息] -->|长按 / 松开| PTT[Push-to-Talk]
end

subgraph Host [DSH 服务端 Host]
Stream --> FFMPEG[ffmpeg 16kHz 转码器]
PTT --> FFMPEG
FFMPEG --> Chain{备用链轮询}

Chain -->|首选优先级| P1[Deepgram / Nova-2]
Chain -.->|遭遇限流 / 429| P2[Groq / Whisper Turbo]
Chain -.->|异常故障时| P3[本地 whisper.cpp / 离线]
end

subgraph Output [输出目标]
P1 --> Composer[💬 聊天输入框]
P2 --> Composer
P3 --> Composer
end

style Client fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
style Host fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4
style Output fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4

✨ 核心亮点

* 🎙️ VAD 智能流式听写：说话停顿自动切句（vadSilenceMs，默认 700ms），文字实时追加至输入框。
* 🌊 带撤回窗口的语音消息：录制完整语音，转写后在倒计时（autoSendMs，默认 4000ms）结束后自动发送。
* 🎮 沉浸式 Push-to-Talk 对讲：
* 鼠标操作：按住声波按钮开始录音，松开发送，拖离按钮取消。
* 键盘操作：按住 Ctrl 无需鼠标即刻说话，按 Esc 放弃本次录音。
* ⚡ 浏览器本地零延迟同声字幕 (browser)：Chrome Web Speech API 本地离线解析，说话同时浮动显示实时字幕。
* 🛡️ 多服务商自动容灾切换：首选 API 额度耗尽或遭遇 429 限流时，毫秒级顺位切换备用引擎。
* 🧠 上下文术语注入 (Context Glossary)：自动从输入草稿中提取代码变量名与专业术语，引导 STT 模型精准转写专业词汇。
* 🎵 内嵌音频播放器：在输入框与录音浮层中随时试听和回放刚刚录制的原始音频片段。
* 🔇 硬件降噪切换开关：在插件设置中自由开关浏览器级降噪、回声消除与自动增益控制。
* 📊 服务商延迟与健康监控看板：在设置界面实时掌握每个语音引擎的延迟（毫秒）、成功率与调用状态。
* 🔒 API 密钥安全隔离：密钥由服务端 ctx.credentials 统一解析，绝不向浏览器前端泄漏。
* 🖥️ 本地 whisper.cpp 服务端直连：自动管理 whisper-server 进程，结合 ffmpeg 实现实时音频转码。
* ⚡ SenseVoice-ONNX / Sherpa-ONNX (0.8.11)：超快速（~50–100ms）非自回归本地语音识别引擎，自动清除情绪/事件标签。支持 Sherpa-ONNX HTTP 和 OpenAI 兼容端点。
* 🌐 实时音频流 (0.8.11)：低延迟 WebSocket 桥接（/dsh-voice/realtime），支持 OpenAI Realtime API 或本地 Sherpa-ONNX 流式传输。API 密钥安全保留在服务端。
* 🌊 Liquid Wave 与 Dynamic Orb 动态可视化 (0.8.12)：录音面板内的生动波形动态可视化，实时响应麦克风音量。可选平滑流动波浪、发光脉冲球体、经典频条或关闭。

📝 0.8.19 更新说明

v0.8.18 质量审查后的修复批次（Gitea #79–#87，PR #88）：

- 设置占位提示在渲染时通过 locale 解析，不再冻结为 i18n key（#79）
- whisperModel / sensevoiceModel 使用模型路径提示（#82）
- 可视化器改用 DSH 主题 token，不再硬编码颜色（#80）
- 样式标签使用 data-dsh-plugin="dsh-voice"，避免邻居插件 HMR 清理误删（#81）
- 源码语言统一为英文；界面不再内置完整 ru 词典（#85）
- 浏览器端源码拆分为 lib/client-src/.js，由 npm run build:client 构建（#87）

[!IMPORTANT]
v0.8.19 语言说明： 未安装 translation 插件时，Web UI 保持英文。

🎮 四种语音输入方式

| 交互模式 | 触发手势 | 行为效果 |
|---|---|---|
| 流式听写 | 单击 🎙️ 麦克风 | 按停顿切分语音 (vadSilenceMs)，文本实时录入输入框 |
| 语音消息 | 单击 🌊 声波 | 持续录音至手动停止，转写后进入撤回倒计时 (autoSendMs) |
| 鼠标对讲 | 长按 🌊 声波 | 按住录音；松开发送，光标拖出按钮区域取消 |
| 键盘对讲 | 按住 Ctrl | 免鼠标快捷 Push-to-Talk 录音；按 Esc 取消 |

🛠️ 服务商矩阵

| 服务商标识 | 对应引擎 | 默认模型 | 环境变量凭据 | 特性说明 |
|---|---|---|---|---|
| browser | Web Speech API | 浏览器原生引擎 | 无需密钥* | 零延迟同声字幕输出 |
| deepgram | Deepgram API | nova-2 | DEEPGRAM_API_KEY | 极速高精云端转写 |
| groq | Groq Whisper | whisper-large-v3-turbo | GROQ_API_KEY | 毫秒级极速推理 |
| hf | HuggingFace Inference | openai/whisper-large-v3 | HF_TOKEN | 经典高精度开源模型 |
| local-whisper | 本地 whisper.cpp | 启动参数指定 | 无需密钥 | 100% 离线私密运行 |
| sensevoice | SenseVoice-ONNX / Sherpa-ONNX | SenseVoiceSmall | 无需密钥 | 超快速（~50ms）本地非自回归 STT |

📦 安装指南

dsh plugin --profile web add @goodandready/dsh-voice

📄 开源协议

MIT © GooDAnDReaDY