Handy

项目简介

Handy 是一款免费、开源且可扩展的桌面语音转文字应用，可完全离线运行。设置快捷键后，按住说话、松开即可；Handy 在本机处理语音，并把转写文本粘贴到当前使用的文本输入框中。

核心功能

• 通过可配置的键盘快捷键，按住说话、松开后即可把转写文本粘贴到任意文本输入框。
• 语音处理全部在本机完成，音频不需要发送到云端。
• 支持按住说话、切换录音、仅按住和仅切换等录音模式，并可配置按键绑定。
• 使用 Silero VAD 过滤静音；提供 Whisper 模型，在可用时使用 GPU 加速。
• 提供 Parakeet V3，这是针对 CPU 优化的模型，并支持自动语言检测。
• 作为跨平台桌面应用运行于 Windows、macOS 和 Linux，项目免费、开源且可扩展。

适用场景

• 使用键盘快捷键，把口述内容直接输入到任意应用或文本输入框。
• 当隐私要求音频保留在电脑上时，在本机完成语音转写。
• 撰写较长文本或回复消息时，不必切换到单独的转写服务。

快速开始

• 从 Handy 的 releases 页面或官网下载最新版本。
• macOS 也可通过 Homebrew cask 安装：brew install --cask handy；Windows 也可通过 winget 安装：winget install cjpais.Handy。
• 在 Debian 或 Ubuntu 上，用 APT 安装下载的 .deb 包，例如 sudo apt install ./Handy_*.deb。
• 安装应用、启动 Handy，并授予麦克风和辅助功能等必要系统权限。
• 在设置中配置偏好的键盘快捷键，然后开始转写。

部署与要求

• 作为桌面应用运行于 Windows、macOS 和 Linux。
• 启动后需要麦克风和辅助功能权限。
• 在 Linux 的 X11 环境中，为实现可靠文本输入应安装 xdotool；在 Wayland 环境中应安装 wtype 或 dotool。
• Linux 安装依赖 gtk-layer-shell 运行时库，不同发行版的包名不同。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。