原生本地语音输入

VoCoType‑linux v5 是跨 Linux 与 Apple‑Silicon‑macOS 的开源系统级离线语音输入方案。基于 FunASR 实现本地 CPU 语音识别，断网可用；提供按住说话的 PTT 输入方式，内置术语热词保护、ITN 格式转换；支持可选 AI 润色和基于上下文的语音编辑；Linux 下可以和 Rime 共存，不需要切换输入法。自带图形设置与词典管理，兼顾普通用户与高级用户，适合重视隐私、追求本地离线语音输入的桌面用户。

适配平台 Linux / macOS

热度指数 6

项目地址

VoCoType‑linux 是开源的系统级离线语音输入工具， v5.0.0 版本正式同时支持 Linux （Fcitx5 / IBus） 和 Apple Silicon macOS。底层基于 FunASR Paraformer 模型，语音识别运算全部在本机 CPU 完成，断网环境依然可用；支持按住快捷键说话、松开输出文字，额外提供 AI 润色、上下文感知语音编辑、热词术语保护、逆文本标准化等高级能力。

项目名称中 “‑linux” 属于历史命名，不代表仅支持 Linux ，现已完整适配 macOS arm64 平台。在 Linux 环境下可以和 Rime （小狼毫 / 鼠须管之外， fcitx5‑rime 、 ibus‑rime ）无缝共存，不需要切换输入法即可触发语音听写。

核心功能

1. 本地离线语音识别

基于 FunASR‑Contextual‑Paraformer ONNX 引擎，纯 CPU 运行，无需独立显卡，普通笔记本即可运行；
支持中英混合识别，可选实时预览识别过程，松开按键以后才采用完整录音做最终识别输出；
热词、术语保护、标点预测、 ITN 逆文本标准化内置在 C++ 核心，不需要 Python 运行时；
ITN 自动把口语转为书面格式：口语 “二零二六年五月十一号” 输出2026/05/11、“一百二十八元” 输出¥128等格式。

2. 三套核心快捷键（全平台统一语义）

默认快捷键	功能说明
`F9`	按住录音，松开执行离线识别，直接输出文本；支持`Esc`取消操作
`Shift+F9`	识别完成后调用兼容 OpenAI 协议的模型做 AI 润色纠错
`Ctrl+F9`	上下文语音编辑：读取当前输入框文本、光标选区，语音下达改写、替换、插入、删除、翻译、 LaTeX 修改、撤销重做指令

Linux Fcitx5 模块模式下，不需要切换输入法引擎，在 Rime 等任意输入法下直接按快捷键触发语音输入；IBus 为独立输入法引擎； macOS 采用 Palette InputMethodKit ，与现有输入法源共存，无需来回切换。

3. 图形化用户词典管理

提供 GUI 界面维护热词、保护术语，不需要手动编辑 YAML 也可以管理词库：

新增标准词条、别名、设置术语保护，防止专有名词被识别错误；
支持导入 YAML 词典，外部修改文件后可热重载；
可以直接打开词典存储目录，高级用户仍然可以直接编辑 YAML 源文件。

4. AI 润色与受限语音编辑

AI 模块支持本机、局域网、云端任意兼容 OpenAI 接口的大模型。

语音识别本身完全本地；只有开启润色 / 编辑时才会把文本发送到配置的 API 端点；
语音编辑会读取输入框上下文，执行受限编辑操作，失败会保留原始识别文本，不会执行不可控的自由操作。

5. 设置中心与诊断工具

Linux 使用 GTK3 、 macOS 使用 AppKit 原生图形设置界面；
模型下载管理、麦克风测试、 AI 接口连接诊断、 Playground 测试环境、故障 Doctor 诊断工具；
配置、用户词典、模型独立保存，升级安装包不会覆盖用户数据。

安装部署

macOS （ Apple Silicon arm64 ， macOS13+）

在 Release 下载VoCoType‑linux‑5.0.0‑macOS‑arm64.dmg；
将 App 拖入Applications；首次打开 Gatekeeper 拦截，前往「系统设置‑隐私与安全性‑仍要打开」；
打开应用，完成输入法组件安装，授予麦克风权限；
在任意文本框按住F9说话，松开完成输入。

Linux 发行包安装

下载对应发行版软件包（提供 Universal / Fcitx5‑only / IBus‑only 三种包，仅选其一）

# Debian / Ubuntu
sudo apt install ./vocotype‑linux_*.deb

# Fedora
sudo dnf install ./vocotype‑linux‑*.rpm

# Arch Linux
sudo pacman -U ./vocotype‑linux‑*.pkg.tar.zst

安装后打开「 VoCoType 设置」，校验模型、麦克风，即可使用。

Linux 源码编译

git clone https://github.com/LeonardNJU/VocoType‑linux.git
cd VocoType‑linux
# fcitx5 版本
bash scripts/install/fcitx5/install.sh --install‑system‑deps --download‑models
# 或者 ibus 版本
bash scripts/install/ibus/install.sh --install‑system‑deps --download‑models

Nix / NixOS

nix run github:LeonardNJU/VocoType‑linux/v5.0.0#settings