Voltip：按住热键说话的语音输入工具

项目简介

Voltip 是一款面向 Windows、Linux、macOS 和 Android 的听写应用。在电脑上按住全局热键录音，松开后由云端或本机识别语音，可选地用 LLM 清理文本，然后粘贴到当前获得焦点的应用中。Android 端既能独立使用，也能作为电脑的麦克风和键盘。

主要功能

• 按住说话：默认全局热键为 Ctrl+Alt+Space，也支持 Right Ctrl 或鼠标侧键等单键；可按住说话、按一下开始再按一下停止，或轻点锁定长录音。浮动胶囊会显示输入强度、实时转写和结果。
• 云端或本地识别：云端支持 OpenAI、Groq、SiliconFlow、阿里云百炼实时模型及任意 OpenAI 兼容端点；本地支持 Qwen3-ASR 0.6B / 1.7B、SenseVoice 和 Paraformer。有 GPU 时 Qwen3-ASR 可通过 Vulkan（Windows/Linux）或 Metal（macOS）加速，否则使用 CPU。
• AI 润色：可使用多家云端 LLM 或本地 Ollama；支持个人词典修正识别错误的词、字面与正则替换规则，以及简体/繁体中文规范化。
• 语音编辑：选中文字后按住 Ctrl+Alt+E，说出「改得更正式」「翻译成英文」等要求，改写结果会替换选区。
• 场景：开始录音时所在的前台应用可决定本次的润色风格、输出方式、语言和额外指令。
• 长录音：可录制麦克风、电脑播放的声音或两者混合，单次最长两小时；边说话边分段转写，停止后较快得到文本。历史记录中可用 AI 预设分段处理长文本，并导出 SRT 字幕或纯文本。
• 手机作为麦克风和键盘：Android 手机可通过二维码或 6 位码配对。手机上按住说话，音频经 Noise XX 端到端加密并用 Opus 压缩，文字出现在电脑光标处；也可在手机上打字或发送剪贴板内容。
• 手机独立使用：没有电脑在线时，手机可自行识别和润色并复制文字，拥有自己的语音与 AI 服务商、预设、词典、规则、场景和历史记录。

安装与使用

Windows 10/11 可在 PowerShell 中执行：

irm https://raw.githubusercontent.com/sunerpy/voltip/main/scripts/install.ps1 | iex

Linux（x86_64）和 macOS（Apple silicon 或 Intel）可在终端中执行：

curl -fsSL https://raw.githubusercontent.com/sunerpy/voltip/main/scripts/install.sh | sh

安装脚本会自动选择对应包，并用发布中的 SHA256SUMS 校验。也可以从 Releases 手动下载 Windows 安装包/便携包、Linux .deb/.AppImage、macOS .dmg 或 Android .apk。

快速开始：

1. 启动 Voltip，首页会提示缺少的麦克风或辅助功能权限。
2. 把光标放进任意文本框，按住 Ctrl+Alt+Space，说话后松开。
3. 纯 Wayland 会话没有全局热键，可给合成器绑定 voltip-desktop --toggle，语音编辑绑定 voltip-desktop --edit-toggle。

需要本地识别时，在侧边栏打开 Speech models，选择 This device 并下载模型，例如 Qwen3-ASR 0.6B（690 MB）或更轻量的 SenseVoice-small（240 MB）。之后音频不再离开本机。

命令行也可用于脚本和服务器：

voltip-desktop --list-models
voltip-desktop --transcribe-file sample.wav --json

其他程序可以通过 OpenAI 兼容的 /v1/audio/transcriptions 使用 Voltip 的识别、词典和预设：在设置中开启 Local service，或在无桌面的 Linux 服务器上运行 voltip-server。

注意事项

• 发布包自带默认识别与清理服务，未配置也能直接听写；之后可随时切换服务商或本地模型。
• 音频只会发送到所选的识别服务；使用本地模型时不会离开本机。服务商密钥保存在系统钥匙串中，保存后不会再次显示。
• Windows 安装包尚未代码签名，首次启动会触发 SmartScreen 警告；macOS 包使用项目自签名证书且未公证，首次启动需在系统设置中允许打开。
• Linux 版构建于 Ubuntu 22.04，需要 glibc 2.34 或更新版本；.deb 依赖 libwebkit2gtk-4.1-0、libvulkan1 和 BLAS，AppImage 需要 FUSE 2。
• 手机与电脑通过中继连接，流量端到端加密，中继看不到音频或文字。
• 项目采用 AGPL-3.0 许可证。

---

本作品整理自 GitHub 开源项目 sunerpy/voltip，原作者 @sunerpy，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。