Schumchanvi/dsh-voice-input-cn

dsh-voice-input-cn

DeepSeek Harness Web 语音输入插件（国内可用版）

在聊天输入框添加麦克风按钮，点击说话即可将语音转为文字填入草稿。基于 阿里云 DashScope ASR（国内直连可用），替代原版依赖的 Google Web Speech API（国内无法访问）。

本项目 fork 自 NewDaNew/dsh-voice-input，原版使用 Web Speech API（Google 云端），在国内直连不可用；本版重写了识别引擎为阿里云 DashScope ASR + 本地 bridge。

🛠 开发工具：本插件在 DeepSeek Harness (DSH) 中开发与调试（代码重构、排障、测试均由 DSH 辅助完成）。DSH 是一个开源 AI 助手框架：https://github.com/deepseek-ai/dsh

---

✨ 功能

• 🎤 输入框麦克风按钮，点击开始说话，静音 1.5 秒自动停止
• 📝 识别文字实时填入输入框（光标位置插入，不覆盖已有草稿）
• 🔀 中文 / English 语言切换
• 📨 可选"识别后自动发送"
• 🔌 本地 bridge（Python）中转，国内直连阿里云，低延迟

🧱 架构

浏览器插件 (lib/client.js)
  ├─ AudioWorklet 采集麦克风 16kHz PCM
  ├─ 流式发送 → ws://127.0.0.1:8765
  └─ 本地 bridge (bridge/voice-bridge.py)
       └─ 阿里云 DashScope paraformer-realtime-v2 识别

为什么需要本地 bridge？ DashScope 的 ASR WebSocket 握手依赖官方 SDK 的内部鉴权逻辑，浏览器裸 WebSocket 直连会 401。bridge 用官方 Python SDK 处理鉴权，浏览器只负责录音和显示。

📦 安装

1. 安装插件

dsh plugin --profile web add github:Schumchanvi/dsh-voice-input-cn

或用 dshmarket 安装（如果已上架）。

2. 安装 bridge 依赖（Python 3.10+）

pip install dashscope websockets

3. 启动 bridge

# 前台运行
python bridge/voice-bridge.py

# 或 Windows 开机自启（双击注册到启动文件夹）
wscript bridge/start-voice-bridge.vbs

bridge 默认监听 127.0.0.1:8765（仅本机，不暴露公网）。

4. 配置 API Key

1. 刷新 DSH 页面
2. 点击输入框旁的麦克风按钮 → 右侧小箭头（⌄）打开设置
3. 填入 DashScope API Key（阿里云百炼获取）
4. 选择语言，保存

🎤 使用

1. 点击麦克风按钮开始
2. 正常说话（文字会实时填入输入框）
3. 停顿 1.5 秒或再次点击 → 自动结束
4. 若开启"自动发送"则直接提交，否则可继续编辑后手动发送

🔧 配置项（设置菜单）

📝 与原版的区别

⚠️ 安全说明

• API Key 存于浏览器 localStorage，本插件不上传 key 到任何第三方；但同一浏览器内的其他脚本可读取，请勿在共享电脑使用
• bridge 仅监听 127.0.0.1，不对外网开放
• 音频仅发送至阿里云 DashScope 识别，不留存

🐛 常见问题

Q: 显示"连接本地语音服务失败" A: bridge 没启动。运行 python bridge/voice-bridge.py，确认端口 8765 已监听。

Q: 识别不出内容 / "呃呃啊啊" A: 检查麦克风权限（浏览器 + Windows）；确认 Key 有效（阿里云百炼控制台可测试）；确认音频不是静音。

Q: 显示"无可用麦克风" A: 这是浏览器 getUserMedia 的 NotFoundError。检查 Windows 麦克风隐私设置、默认输入设备、驱动状态（Intel 智音端点幽灵化时需重装驱动）。

Q: 延迟高 A: 识别为流式，理论上说完即出；若延迟明显，检查网络到阿里云的延迟，或换用更近的区域节点。

Q: 报 NO_VALID_AUDIO_ERROR A: bridge 只接受裸 PCM（16kHz 单声道 int16）。如果你用自建脚本/客户端直连，别拼 WAV 头；本插件内置的 AudioWorklet 已输出纯 PCM，正常情况下不会出现此错误。

Q: 有回音/自己说话被识别 A: 麦克风流不允许连回 AudioContext.destination（回放）。本插件已断开该连接；若你魔改过，检查 worklet 是否接了 destination。

Q: 文字被填了两次 / 重复插入 A: 这是"停止提交"与"空闲提交"双触发的经典 bug。本插件统一由 onState("idle") 提交一次，手动点停不会再提交；若你魔改过，检查 stop 路径是否也提交了。

Q: 浏览器直连 DashScope 报 401 A: 这是预期的。DashScope ASR 的 WebSocket 鉴权在官方 SDK 内部完成，裸 WebSocket 无法携带签名。必须走本地 bridge（本仓库 bridge/voice-bridge.py）。

Q: bridge 端口被占用（Windows 报"address already in use"） A: 说明已有 bridge 实例在跑（或别的程序占了 8765）。关掉旧的，或用 set VOICE_BRIDGE_PORT=xxxx 换端口（同时需在客户端改 BRIDGE_URL）。

📜 License

MIT（保留原版 fork 版权声明；阿里云 DashScope 服务需遵守其使用条款）