蛐蛐 (QuQu)：你可以像和朋友聊天一样写作,说的内容被实时、精准地转换成文字。开源免费的 Wispr Flow 替代方案，为中文而生的智能语音工作流

本文最后更新于 2025年10月5日 by 阿喵

蛐蛐 (QuQu) 是 Wispr Flow 的开源免费替代方案，专为中文用户打造的注重隐私的桌面端语音输入与文本处理工具。与 Wispr Flow 不同，蛐蛐完全开源免费，数据本地处理，专为中文优化，支持国产AI模型。

🆚 vs Wispr Flow：开源免费的替代方案

想象一下，你可以像和朋友聊天一样写作。说的内容被实时、精准地转换成文字，口误和”嗯、啊”等废话被自动修正，甚至能根据你的要求，自动整理成邮件格式或代码片段。这就是「蛐蛐」为你带来的体验 —— 而且完全免费！

项目截图

核心优势

🎬 功能演示

(这里是应用的GIF演示图)

• 一键唤醒: 全局快捷键 F2，随时随地开始记录。
• 实时识别: 本地 FunASR 引擎提供高精度中文识别。
• 智能优化: 连接您的AI模型，自动润色、纠错、总结。
• 无缝粘贴: 转换完成的文本自动粘贴到您当前光标位置。

🚀 从 Wispr Flow 迁移？

如果你正在使用 Wispr Flow 但希望节省订阅费用、保护隐私数据、更好的中文支持，那么蛐蛐就是你的完美选择！

🚀 快速开始

1. 环境要求

• Node.js 18+ 和 pnpm
• Python 3.8+ (用于运行本地FunASR服务)
• macOS 10.15+, Windows 10+, 或 Linux

2. 项目初始化

方案一：使用 uv (推荐) 🌟

uv 是现代化的 Python 包管理器，能自动管理 Python 版本和依赖，避免环境冲突：

# 1. 克隆项目
git clone https://github.com/yan5xu/ququ.git
cd ququ

# 2. 安装 Node.js 依赖
pnpm install

# 3. 安装 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"

# 4. 初始化 Python 环境 (uv 会自动下载 Python 3.11 和所有依赖)
uv sync

# 5. 下载 FunASR 模型
uv run python download_models.py

# 6. 启动应用!
pnpm run dev

方案二：使用系统 Python

如果您更喜欢使用系统 Python 环境：

# 1. 克隆项目
git clone https://github.com/yan5xu/ququ.git
cd ququ

# 2. 安装 Node.js 依赖
pnpm install

# 3. 创建虚拟环境 (推荐)
python3 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows

# 4. 安装 Python 依赖
pip install funasr modelscope torch torchaudio librosa numpy

# 5. 下载 FunASR 模型
python download_models.py

# 6. 启动应用!
pnpm run dev

方案三：使用嵌入式 Python 环境

项目还支持完全隔离的嵌入式 Python 环境（主要用于生产构建）：

# 1-2. 同上克隆项目和安装 Node.js 依赖

# 3. 准备嵌入式 Python 环境
pnpm run prepare:python

# 4. 测试环境是否正常
pnpm run test:python

# 5. 启动应用
pnpm run dev

3. 配置AI模型

启动应用后，在 设置页面 中填入您的AI服务商提供的 API Key、Base URL 和 模型名称。支持通义千问、Kimi、智谱AI等国产模型，配置将自动保存在本地。

4. 故障排除

常见初始化问题

问题: ModuleNotFoundError: No module named 'funasr'

# 解决方案 1: 使用 uv (推荐)
uv sync
uv run python download_models.py

# 解决方案 2: 重新安装依赖
pip install funasr modelscope torch torchaudio librosa numpy

# 解决方案 3: 使用嵌入式环境
pnpm run prepare:python

问题: FunASR 模型下载失败或加载缓慢

# 检查网络连接，确保能访问 modelscope.cn
# 如果在 macOS 上遇到 SSL 警告：
pip install "urllib3<2.0"

# 手动下载模型：
python download_models.py
# 或使用 uv:
uv run python download_models.py

问题: Python 版本不兼容

# 使用 uv 自动管理 Python 版本 (推荐)
uv sync  # 会自动下载 Python 3.11

# 或手动安装 Python 3.8+
# 检查当前版本: python3 --version

环境选择建议

其他常见问题

模型路径: 模型默认下载到 ~/.cache/modelscope/ 目录

权限问题: 在某些系统上可能需要使用 --user 参数安装Python包

网络问题: 首次运行时需要下载FunASR模型，请确保网络连接正常

项目地址