Handy 是跨应用的本地语音输入工具,支持 Windows、macOS 和 Linux。设置快捷键后,说完的话会在本机转写,再粘贴到当前应用,适合写消息、邮件、笔记和自然语言初稿。程序代码采用 MIT 许可,名称、图标与其他品牌素材另有保留条件,非官方分支在二次分发时需避开原项目专有品牌字眼与图标,以免造成官方授权错觉。

核心录音与识别可以在模型准备好以后离线运行。它还提供可选文本后处理:如果把后处理接到远程模型,转写文字会交给该服务处理。需要全程本地使用时,先确认所选识别模型和后处理配置,而不是只看“离线”这个标签。
第一次使用,把录音、识别和输入连起来
- 从官网或 Releases 选择匹配系统与架构的安装包。首次模型下载需要网络与磁盘空间,完成后再测试离线识别。
- 在设置里选择麦克风与识别模型,按系统提示授予麦克风权限;macOS 还需要辅助功能权限来把文字输入其他应用。
- 设置不冲突的快捷键。可以按住录音、松开停止,也可以使用切换模式,按一次开始、再按一次结束。
- 把光标放在普通文本编辑器里,说一段自己的常用内容,检查文字是否准确、是否出现在正确位置。
- 再扩展到聊天窗口、浏览器和办公软件,比较数字、英文缩写和专有名词的识别结果;先修改模型或输入方式,不急着启用额外后处理。
按住方式适合临时插入短句,切换方式则不用一直压着按键。录音快捷键要和当前软件配合:同一个组合在聊天窗口能顺利录音,切回编辑器却可能与现有全局热键撞车。
模型先按语言选,再看响应速度
- 多语言 Whisper:可以作为中文听写的起点,不同尺寸在响应速度、内存和识别效果上各有取舍。
- SenseVoice:当前源码模型列表包含中文、英文、日文、韩文与粤语,可按使用语言与设备尝试。
- Parakeet V3:目前源码模型定义列表仅覆盖 25 种欧洲语言,不支持中文识别,中文听写请优先看 Whisper 与 SenseVoice。
挑选模型时建议结合自己的麦克风音质与日常口音试录对比:整段话可拆分断句听写,而且日常普通话识别准确时,处理代码变量名和复杂终端命令仍建议搭配键盘微调细节格式。模型选项随版本变化,应以自己安装版本的列表为准。
如果需要自动整理句子或按提示改写,可配置后处理提供商、模型与提示词。该功能会对口述文字做润色和语句重写,涉及到严谨引用或合同条文时,仍应保留原始转写稿逐字对照。
没有文字出现时,按发生问题的环节排查
没有录到声音
先检查输入设备、系统麦克风授权和录音触发状态。macOS 使用蓝牙耳机麦克风时,双向音频可能影响播放质量,可保留耳机作输出,改用内置或外接麦克风作输入。此时换识别模型通常解决不了输入端没有声音的问题。
历史里文字正确,却粘贴不对
先查看 History 的转写结果,再检查目标窗口是否有输入焦点,以及辅助功能或输入模拟权限。若应用收到的是之前剪贴板里的内容,当前 README 建议在 Debug 中尝试 macOS/Windows 的 Reliable Paste (Beta),或调整标准粘贴路径的 Paste Delay (After)。后一项控制恢复原剪贴板前的等待,和发出粘贴按键前的 Paste Delay (Before) 是不同设置。Beta 功能仍需在出问题的目标应用中试用。
Linux 能识别,但快捷键或输入不工作
Linux 的桌面会话会影响输入方式:X11 常用 xdotool,Wayland 的支持则取决于合成器与 wtype、dotool 等工具;若在 Ubuntu 26.04 GNOME Wayland 下遇到异常,须专程查阅仓库针对该组合的故障文档,常规 Wayland 通用设置往往不适用。
Wayland 下可由桌面环境配置系统快捷键,让它调用已经运行的 Handy:
handy --toggle-transcription
如果录音浮层抢走焦点,可在 Advanced 中把 Overlay Position 设为 None,再试目标应用。安装输入工具或授予额外权限前,应按自己的发行版与会话核对;企业设备受策略限制时,需要管理员处理。
二次开发可从 src-tauri/src/managers/model.rs 看模型与语言定义,从 src/components/settings/post-processing 看后处理设置。Rust 桌面端与前端设置是不同部分,完整构建条件见 BUILD.md。
- 官网与安装入口:
https://handy.computer - GitHub 仓库与排查说明:
https://github.com/cjpais/Handy - 系统安装包:
https://github.com/cjpais/Handy/releases - Ubuntu 26.04 GNOME Wayland 说明:
https://github.com/cjpais/Handy/tree/main/docs/troubleshooting/ubuntu-26-04-gnome-wayland












暂无评论内容