快捷键与录音方式

听写通过全局快捷键开始，在任意应用中都可以使用，默认为 Ctrl Alt Space。如需更改，打开「设置 → 快捷键」，录制新的组合键。

能注册哪些组合键取决于操作系统。「设置 → 快捷键」会显示所选组合键是否注册成功；被其他应用占用时也会说明原因。

录音方式

「设置 → 快捷键」提供三种录音方式：

方式	效果
按住说话（默认）	说话时按住快捷键，松开即结束录音并开始识别。
按一下开始，再按一下结束	按一次开始，再按一次结束；松开按键不会停止录音。
按住或按一下	与按住说话相同；短按则锁定录音，无需一直按住，再按一次结束。

使用第三种方式时，「短按判定阈值」决定多短的按键算作短按，默认为 300 毫秒。任何方式下，「松开后继续录音」都可以在停止后让麦克风继续开启最多 5 秒，避免最后一个字被截断。

单个按键或鼠标键

除了组合键，还可以用单个按键开始听写：右 Ctrl、右 Alt、右 Shift、右侧的 Windows / Command / Super 键、Mac 上的 Fn 键，或鼠标的中键、后退键、前进键。它与组合键使用同一种录音方式。

• 按住它时再按其他键或点击鼠标，会取消这次按下所开始的录音，因此右 Ctrl + C 等快捷键照常可用。
• 在许多欧洲键盘布局中，右 Alt 是 AltGr，右 Shift 用于输入大写字母；选择这些键时，设置页会给出提示。
• 在 Mac 上使用 Fn 键之前，请在「系统设置 → 键盘」中把「按下 🌐 键时」设为「不执行任何操作」。
• 在 Mac 上，单键触发需要辅助功能权限；Voltip 粘贴文字时本来就需要这项权限。
• 纯 Wayland 会话不支持单键触发。

悬浮窗

听写时，屏幕底部的悬浮窗显示当前状态：

• 录音中：输入音量、已录时长；安装实时识别模型后，还会显示已识别的文字。录音被锁定时显示锁形图标。
• 处理中：当前步骤（识别、AI 润色或插入）及其已用时间。
• 完成：插入的字数，或文字留在剪贴板中的原因。

悬浮窗不会获取键盘焦点，因此文字仍然输入到你正在使用的应用中。

取消

录音或处理期间按 Esc 即可取消，可以取消时悬浮窗会用红色显示这个键。取消后不会插入文字，也不会写入历史记录；只有「边说边输入」方式下已经输入的句子会保留。Voltip 只在听写期间监听 Esc，其他时候不影响别的应用。

纯 Wayland 会话中，请为 voltip-desktop --cancel 绑定一个系统快捷键来取消。

录音时长

使用「整段输出」时，录音在 2 分钟后自动停止；使用另外两种边说边识别的输出方式时，上限为 10 分钟。最长 2 小时的长录音正在开发，见路线图。

Linux 与 Wayland

纯 Wayland 会话不允许应用注册全局快捷键或监听单个按键。请在桌面环境的键盘设置中，为下面的命令绑定快捷键：

命令	作用
voltip-desktop --toggle	开始听写，或结束听写并插入文字
voltip-desktop --edit-toggle	开始或结束一次语音编辑
voltip-desktop --cancel	取消当前的听写

以 AppImage 运行时，把 voltip-desktop 换成 AppImage 的路径；「设置 → 快捷键」会显示完整命令。在通过 XWayland 运行 X11 应用的会话中，组合键只在 X11 窗口获得焦点时有效，因此同样建议使用系统快捷键。