快速上手

快速开始

1. 启动守护进程并重启 Fcitx5

systemctl --user enable --now vinput-daemon.service
fcitx5 -r

2. 在 Fcitx5 中启用

打开 Fcitx5 配置 → 附加组件 → 找到 Vinput → 启用。

3. 安装模型

打开 Vinput GUI（从应用菜单启动，或在终端运行 vinput-gui）。

进入 资源 → 模型，在可用模型列表中选择需要的模型，点击 下载 安装，然后点击 使用 激活。

也可以用 CLI：

vinput model list -a            # 浏览可用模型
vinput model add <模型名>        # 下载并安装
vinput model use <模型名>        # 设置为当前模型

也可手动将模型目录放到 ~/.local/share/vinput/models/<模型名>/，目录内需包含：

• vinput-model.json
• model.int8.onnx 或 model.onnx
• tokens.txt

4. 开始使用

• 短按 Alt_R 开始录音，再按一次停止并识别
• 长按 Alt_R 录音，松开自动识别上屏（push-to-talk）

ASR 提供商

除了内置的本地模型，还可以安装云端 ASR 提供商，在速度、效果和成本之间灵活选择。

在 Vinput GUI 中进入 资源 → ASR 提供商，浏览可用提供商并点击 安装。或用 CLI：

vinput provider list -a        # 列出可用远程 ASR 提供商
vinput provider add <id>       # 从注册源安装
vinput provider use <id>       # 切换当前 ASR 提供商

随时按 F8 打开 ASR 提供商 / 模型切换菜单，在运行时自由切换。

当前可用的云端 ASR 提供商：

提供商	模式	说明
豆包（非流式）	非流式	豆包语音 / 火山引擎录音文件极速版
ElevenLabs	非流式 / 流式	ElevenLabs speech-to-text API
阿里百炼	非流式 / 流式	Qwen3-ASR，OpenAI 兼容 / Realtime API
豆包（流式）	流式	火山引擎 AI Gateway Doubao ASR Realtime
豆包输入法（流式）	流式	非官方豆包输入法实时语音识别协议
OpenAI 兼容	非流式 / 流式	OpenAI /v1/audio/transcriptions 或 Realtime WebSocket

按键说明

按键	默认	功能
触发键	Alt_R	短按切换录音；长按即说即停
命令键	Control_R	选中文本后按住，语音指令修改选中内容
ASR 菜单键	F8	打开 ASR 提供商 / 模型切换菜单
场景菜单键	Shift_R	打开场景切换菜单
翻页	Page Up / Page Down	候选列表翻页
移动	↑ / ↓	候选列表移动光标
确认	Enter	确认选中候选
取消	Esc	关闭菜单
快选	1–9	快速选择候选

所有按键均可在 Fcitx5 配置界面中自定义。

配置文件位置

文件	路径
Fcitx5 插件配置（按键等）	~/.config/fcitx5/conf/vinput.conf
核心配置（模型、LLM、场景）	~/.config/vinput/config.json
模型目录	~/.local/share/vinput/models/
ASR 提供商脚本	~/.local/share/vinput/providers/
LLM 适配器脚本	~/.local/share/vinput/adapters/

Flatpak 安装下路径不同：

文件	路径
Fcitx5 插件配置	~/.var/app/org.fcitx.Fcitx5/config/fcitx5/conf/vinput.conf
核心配置	~/.var/app/org.fcitx.Fcitx5/config/vinput/config.json
模型目录	~/.var/app/org.fcitx.Fcitx5/data/vinput/models/
ASR 提供商脚本	~/.var/app/org.fcitx.Fcitx5/data/vinput/providers/
LLM 适配器脚本	~/.var/app/org.fcitx.Fcitx5/data/vinput/adapters/