opensquad-ai/dsh-voice-input

Install

python --version
   # 期望输出类似: Python 3.12.x（3.10 或更高即可）
   ```

### 手动安装 ffmpeg（可选）

> 浏览器端会把录音转成标准 WAV，正常使用**不需要** ffmpeg。它仅在服务端收到异常/无法识别的音频时作为兜底转码使用，建议安装以免个别浏览器录音无法转写。

- **Windows**：在 PowerShell 里执行
  ```bash
  winget install ffmpeg
  ```
  安装完成后**重启终端**，验证：
  ```bash
  ffmpeg -version
  ```
- **macOS**（需先装 [Homebrew](https://brew.sh/)）：
  ```bash
  brew install ffmpeg
  ```
- **Linux (Debian/Ubuntu)**：
  ```bash
  sudo apt update && sudo apt install -y ffmpeg
  ```
- **通用方式**：也可访问 [ffmpeg.org/download.html](https://ffmpeg.org/download.html) 下载，解压后把 `bin` 目录加入系统的 PATH 环境变量。

插件启动时自动完成：
1. 探测 Python → 自动安装 `flask / onnxruntime / librosa / soundfile / pyyaml` 等依赖（首次较慢）
2. 自动拉起下载网关（`gateway.py` :7102）
3. 首次使用 → 自动下载模型（约 230MB）并启动转写服务（`service.py` :7101）

## 安装插件

Add opensquad-ai/dsh-voice-input to your DSH config (web profile) to enable.