Question 1

如何使用 Voconly？

Accepted Answer

使用非常简单，只需三步： 基本流程： 单击快捷键 - 开始录音（默认右 Alt 键） 说话 - 对着麦克风说出你想输入的内容 再次单击快捷键 - 结束录音，如果配置了 AI 服务，会先经过 AI 处理再输出 双击快捷键结束（直接输出）： 结束录音时双击快捷键，会直接输出原始识别结果 不经过 AI 服务处理，即使配置了也会跳过 适合需要快速输入、不需要润色的场景 单击结束（AI 处理）： 结束录音时单击快捷键，如果配置了 AI 服务，会先经过 AI 处理 自动润色、添加标点、格式化后再输出 适合需要整理成文的场景 应用常驻系统托盘，在任何应用中都能使用。

Question 2

Voconly 是免费的吗？

Accepted Answer

是的。Voconly 完全免费且开源（MIT 协议）。所有核心功能永久免费： 离线语音识别（本地模型） 全局快捷键 多语言支持 AI 服务（需自己配置 API） 没有付费版本，没有功能限制，没有使用次数限制。

Question 3

Voconly 是开源的吗？

Accepted Answer

是的。源代码托管在 GitHub： 仓库地址： https://github.com/xinkyle/Voconly 开源协议： MIT License 欢迎提交 Issue、Pull Request 或帮助翻译。

Question 4

我的语音数据会上传到云端吗？

Accepted Answer

不会，目前支持的是本地语音模型转录，暂时不支持云端语音模型。 离线语音识别：完全在本地运行，不需要网络 本地模型：音频在本地处理，不上传任何数据 AI 服务（可选）：如果配置了在线 AI API，文字会发送到你配置的服务商 如果你只需要离线语音输入，可以使用 Ollama 本地部署 AI 服务，所有数据留在本地。

Question 5

Voconly 支持哪些平台？

Accepted Answer

平台 支持 备注 ------ ------ Windows ✅ 完全支持 Windows 10/11 macOS ✅ 完全支持 macOS 11+ (Apple Silicon)

Question 6

如何安装 Voconly？

Accepted Answer

Windows： 从 GitHub Releases 或 Gitee Releases 下载 .exe 安装包 运行安装程序 首次启动会提示下载语音识别模型 macOS： 从 GitHub Releases 或 Gitee Releases 下载 .dmg 文件 打开 DMG 文件，将 Voconly 拖入 Applications 文件夹 首次打开可能会提示"无法验证开发者"或"安装文件已损坏"——这是 macOS 的安全保护机制 解决方法请查看 macOS 安装说明 首次启动会提示下载语音识别模型。

Question 7

首次启动需要做什么？

Accepted Answer

下载模型 - 首次使用需要下载模型 授予权限 - macOS 需要授予麦克风和辅助功能权限 设置快捷键 - 可以自定义快捷键

Question 8

我应该使用哪个模型？

Accepted Answer

根据你的使用场景选择： 中文场景： 需求 推荐模型 说明 ---------- ------ 纯中文语音 SenseVoice Small 速度快，资源消耗低 中英混合语音 Qwen3-ASR 1.7B 中英混合效果最佳，准确率最高 中文方言 Qwen3-ASR 1.7B 支持22种中文方言 英文场景： 需求 推荐模型 说明 ---------- ------ 英语专项 Parakeet Unified EN 0.6B 英语专项优化，支持流式推理 综合英文 Cohere Transcribe HuggingFace Open ASR 排行榜1 其他场景： 需求 推荐模型 说明 ---------- ------ 低延迟/实时 Nemotron 3.5 ASR Streaming 流式处理，80ms超低延迟 多语言覆盖 Whisper Large v3 Turbo 支持99种语言，内置翻译 低配置电脑 SenseVoice Small / Nemotron 0.6B 资源消耗小，纯CPU可运行 硬件建议： 有 NVIDIA GPU：可用 Qwen3-ASR 或 Cohere，启用 GPU 加速更快 无 GPU：建议 SenseVoice Small 或 Nemotron，纯CPU运行流畅

Question 9

本地模型和云端模型有什么区别？

Accepted Answer

Voconly 目前只支持本地模型，所有语音识别完全在本地完成。 本地模型的优势： 无需联网，断网也能使用 数据完全不上传，隐私安全 无使用次数限制 无额外费用 可用模型： Qwen3-ASR、SenseVoice、Cohere、Parakeet、Nemotron、Whisper 等 模型文件下载后即可离线使用

Question 10

模型下载很慢或失败怎么办？

Accepted Answer

检查网络连接 检查磁盘空间（模型文件 0.5GB-2GB） 如果下载中断，可以重新点击下载 手动下载导入： 从 ModelScope 或 HuggingFace 下载模型 在模型列表中点击"导入外部模型" 选择模型所在文件夹即可导入

Question 11

快捷键是什么？可以修改吗？

Accepted Answer

默认快捷键： 平台 开始录音 结束录音 ---------- ---------- Windows 右 Alt 右 Ctrl macOS 右 Alt 右 Ctrl 可以在设置中自定义快捷键。

Question 12

按下快捷键后没有反应？

Accepted Answer

按顺序检查： 检查麦克风权限 Windows：设置 > 隐私 > 麦克风 检查模型是否已下载 打开设置，确认模型状态为"已下载" 重启应用 尝试重启应用 检查快捷键冲突 可能与其他软件快捷键冲突，尝试更换快捷键

Question 13

为什么识别结果出现"Thank you"但我没说？

Accepted Answer

这是 Whisper 模型的已知问题：当检测到静音时，有时会"幻觉"出 "Thank you"。 解决方法： 按下快捷键后立即开始说话，不要停顿太久

Question 14

为什么第一个字或最后一个字被切掉？

Accepted Answer

这是音频捕获的时序问题。 解决方法： 按下快捷键后，停顿半秒再开始说话 说完后，停顿半秒再松开快捷键 给音频捕获留出启动和停止的时间

Question 15

为什么快速说话时识别不准确？

Accepted Answer

说话太快会导致识别准确率下降。 解决方法： 稍微放慢语速 吐字清晰，减少连读 尝试使用准确率更高的模型（如 Qwen3-ASR）

Question 16

专业技术术语识别不准确怎么办？

Accepted Answer

解决方法： 吐字清晰，适当放慢语速 后续版本会支持自定义词典

Question 17

AI 服务是什么？

Accepted Answer

AI 服务对语音识别后的文本进行智能处理，包括： 轻度润色 - 修正错别字、添加标点、格式化 专业润色 - 使文字更通顺、更正式 翻译 - 将内容翻译成其他语言 你可以根据不同场景配置不同的处理方式，一键切换。

Question 18

支持哪些 AI 服务？

Accepted Answer

本地大模型： Ollama（目前支持的本地方案） 在线大模型： OpenAI (GPT) Anthropic (Claude) 其他兼容 OpenAI API 格式的服务商 推荐使用 Ollama 本地部署，隐私安全且无额外费用。

Question 19

如何跳过 AI 服务处理？

Accepted Answer

配置 AI 服务后，默认会对语音识别结果进行处理。 跳过方法： 结束录音时双击快捷键，会直接输出原始识别结果 单击快捷键结束则会经过 AI 处理 这样可以在需要时快速获取原始文本。

Question 20

转录记录存储在哪里？

Accepted Answer

完全存储在本地： 平台 存储路径 ---------- Windows %LOCALAPPDATA%\Local\Voconly\User Data\ macOS ~/Library/Application Support/Voconly/User Data/

Question 21

可以导出数据吗？

Accepted Answer

目前不支持导出数据功能。

Question 22

如何完全清除数据？

Accepted Answer

历史记录存储在 history.db 中。

Question 23

如何检查更新？

Accepted Answer

Windows：设置 > 关于 > 检查更新 应用启动的时候会自动检查更新

Question 24

遇到问题如何反馈？

Accepted Answer

GitHub Issues： https://github.com/xinkyle/Voconly/issues 描述问题和复现步骤 附上系统信息和错误日志（如有）

Question 25

Voconly 适合什么场景？

Accepted Answer

会议记录 - 快速记录会议要点 文档撰写 - 邮件、报告、文章等 即时通讯 - 微信、Slack 等快速回复 编程辅助 - 代码注释、Prompt 编写 无障碍辅助 - 帮助手部不便的用户 内容创作 - 视频/播客字幕、博客

Question 26

可以用于编程吗？

Accepted Answer

可以。

常见问题

通用问题

安装与配置

语音识别模型

使用问题

AI 服务

数据与隐私

更新与支持

使用场景

每天省下 30 分钟打字时间