Handy 离线语音转写教程：免费开源，本地跑不连网

【免费下载链接】Handy A free, open source, and extensible speech-to-text application that works completely offline. 项目地址: https://gitcode.com/GitHub_Trending/handy11/Handy

你肯定遇到过：语音输入 5 分钟，云转写服务要登录、要付费；或者出差没网，想口述一段会议纪要，发现全都没法用。Handy 离线语音转写工具就是为解决这个问题做的，声音全程不出你的电脑。

🎯 这个工具是什么

Handy 是一款免费、开源、跨平台（Windows / macOS / Linux）的离线语音转写应用。按住快捷键说话，松手后文字直接粘贴进任意输入框，全程不联网。核心能力就三条：

• 一键口述进任意输入框
• 全程本地运行不联网
• 模型可选：Whisper、Parakeet

🚀 三步跑起来

1. 拿到应用：安装官方 release 包，或者克隆仓库自己编译：git clone https://gitcode.com/GitHub_Trending/handy11/Handy，再按 BUILD.md 构建。做完后你应该看到：应用窗口打开，首次启动会引导你完成设置。
2. 授权并设快捷键：在系统设置里给 Handy 麦克风、辅助功能权限，再到 Settings 里选一个录音键。做完后你应该看到：按下按键出现录音指示，松手后文字出现在你正在输入的应用里。
3. 选模型并下载：在 Models 页挑一个（Whisper small 487 MB、Parakeet V3 478 MB 等）。做完后你应该看到：模型状态变成 "Downloaded"，可以直接开说。

✍️ 实测效果长什么样

口述长消息这个场景。以前用云服务，要上传音频、排队等结果，再手动复制。用 Handy 是松手后等几秒，文字就出现在聊天框里。如果选流式模型（streaming model，边说边出的模型），你说话时字幕会实时打在悬浮窗上，转写进度看得见摸得着。

硬件方面，官方文档写明 Parakeet V3 是纯 CPU 模型，中端 i5 上实测约 5 倍实时速度——10 分钟的语音大约 2 分钟转完，不挑显卡，也不需要网络。

🔧 进阶设置技巧

1. Shortcut Behavior 设为 Auto：按住录音、松手结束，或者点一下开始、再点一下结束，同一个键两种用法，新装默认就是它。
2. Custom Words 加专业词：产品名、人名丢进自定义词库，这些词识别准头更高，相关代码在 src/components/settings/CustomWords.tsx。
3. 命令行触发：handy --toggle-transcription 可远程开关录音，再配合 --start-hidden --no-tray 无窗后台跑，适合绑到宏键盘或启动器里当全局口述开关。

👥 谁适合用

• 重度打字的人：开发、客服、销售，每天靠聊天和邮件干活
• 隐私敏感场景：财务、医疗、法务，录音不能出设备的场合
• 找免费替代的人：想找一个开源的 Whisper 替代、还愿意自己 fork 魔改

不适合的情况：要批量转 2 小时的会议录音，Handy 干不了，它的定位是"边说边贴"，不是文件批处理。另外 Mac 上戴蓝牙耳机录音会掉音质（系统切到双向音频），这种场合换回内置麦克风。

---

Handy 一句话：免费、开源、离线的一键语音转写工具，声音永远不出你的设备。最新版本信息看 README，想参与开发从 CONTRIBUTING.md 入手。

【免费下载链接】Handy A free, open source, and extensible speech-to-text application that works completely offline. 项目地址: https://gitcode.com/GitHub_Trending/handy11/Handy