蛐蛐（ququ）部署全攻略：开源语音输入工具从零安装到实战

81 0 0

在AI技术日益普及的今天，语音输入工具正成为提升效率的利器。然而，像Wispr Flow这样的优秀工具往往需要付费订阅，且数据隐私存在隐患。今天，我要向大家推荐一个让人眼前一亮的开源替代方案—蛐蛐（QuQu）。这个由社区驱动的项目完全免费、数据本地处理，并专为中文优化，支持国产AI模型。无论你是开发者、写作爱好者还是效率追求者，都能通过本教程轻松部署蛐蛐，享受智能语音输入的便利。

蛐蛐展示页面

GitHub项目地址

https://github.com/yan5xu/ququ

一、部署前准备：环境与工具

在开始部署前，请确保你的系统满足以下要求：

- Node.js 18+ 和 pnpm：用于前端和Electron桌面端开发。
- Python 3.8+：用于运行本地FunASR语音识别服务。
- 支持的操作系统：macOS 10.15+、Windows 10+ 或 Linux。

如果你尚未安装这些工具，可以参考官方文档进行配置。推荐使用uv作为Python包管理器，它能自动处理版本冲突，简化依赖安装。

二、一步步部署蛐蛐：三种初始化方案

蛐蛐提供了灵活的部署方式，以下是基于README的详细步骤。我强烈推荐方案一（使用uv），因为它能最大程度避免环境问题。

方案一：使用uv（推荐，适合新用户）

uv是一个现代化的Python包管理器，能自动下载Python版本并管理依赖，让你专注于应用本身。

克隆项目代码：

git clone https://github.com/yan5xu/ququ.git
cd ququ

安装Node.js依赖：
```
bash pnpm install
```

安装uv（如果尚未安装）：

macOS/Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

初始化Python环境：

uv sync  # 自动下载Python 3.11并安装所有依赖

下载FunASR模型：
```
uv run python download_models.py
```
启动应用：
```
pnpm run dev
```

完成以上步骤后，蛐蛐的桌面应用界面就会启动。你可以按F2键测试语音输入功能了！

方案二：使用系统Python（适合开发者）

如果你习惯自定义Python环境，可以按照以下步骤操作：

克隆项目并安装Node.js依赖（同方案一）。

创建Python虚拟环境：

python3 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# 或Windows: .venv\Scripts\activate

安装Python依赖：

pip install funasr modelscope torch torchaudio librosa numpy

下载模型并启动应用：
```
python download_models.py
pnpm run dev
```

方案三：嵌入式Python环境（适合生产部署）

这种方式完全隔离外部依赖，确保稳定性：

克隆项目和安装Node.js依赖（同方案一）。
准备嵌入式环境：
```
pnpm run prepare:python
```
测试环境：
```
pnpm run test:python
```
启动应用：
```
pnpm run dev
```

三、配置AI模型：解锁智能优化功能

部署完成后，打开蛐蛐应用，进入设置页面，配置你的AI模型：

API Key：从AI服务商（如通义千问、Kimi等）获取。
Base URL：输入服务商的API地址。
模型名称：例如”qwen-turbo”。

配置后，蛐蛐的”两段式引擎”（ASR识别 + LLM优化）就能自动过滤口头禅、修正错误表述，甚至格式化代码术语。所有数据都本地处理，隐私无忧。

四、常见问题与解决方案

在部署过程中，你可能会遇到以下问题，这里提供快速解决方法：

问题1：ModuleNotFoundError: No module named ‘funasr’
- 原因：Python依赖未正确安装。
- 解决：使用uv sync重新同步环境，或运行pip install funasr modelscope torch torchaudio librosa numpy。
问题2：FunASR模型下载失败
- 原因：网络连接问题。
- 解决：检查网络，或手动运行python download_models.py。在macOS上，如果遇到SSL警告，可以安装pip install "urllib3<2.0"。
问题3：Python版本不兼容
- 原因：系统Python版本过低。
- 解决：使用uv自动管理版本（推荐），或升级到Python 3.8+。