Hex

项目简介

Hex 是一款用 Rust 构建的本地优先语音听写应用。用户可以按住快捷键说话，再把转写文本粘贴到前台应用中。macOS 版现已可用，Windows 与 Linux 提供测试版。普通听写使用设备端语音识别；当已有 OpenCode 服务在运行时，可选的 OpenCode 功能可以改写或处理转写文本。

核心功能

• 设备端语音转写：安装时可下载本地语音模型，普通听写不需要 OpenCode 或云端转写服务。可配置快捷键、麦克风、语言、本地模型、录音行为、反馈音量、登录时启动和 Dock 显示。Modes 可在粘贴前修正姓名和偏好拼写，并提供应用特定行为和可选文本处理或改写。Annotate 在 macOS 与 Linux 上录制屏幕绘画与语音，随后可粘贴或发送到 OpenCode，Windows 暂不支持。macOS 发布版的命令行可只读查询听写历史与会议转写；自定义 TypeScript 或 JavaScript

适用场景

• 在任意获得焦点的应用中通过按住说话快捷键口述文本。使用 Modes 修正在粘贴前的姓名和偏好拼写。在 macOS 与 Linux 上录制带语音讲解的屏幕标注，供回看或发送给代理。在支持的构建中从终端读取近期听写历史或会议转写。

快速开始

• macOS：可用 Homebrew 安装，命令为 brew install --cask anomalyco/tap/hex，或下载已签名 DMG，将 Hex.app 拖入 Applications，启动并完成麦克风、辅助功能和转写模型设置。Windows：下载 x64 或 ARM64 安装程序并运行，它会为当前用户安装且不需要管理员权限。Linux：可使用 Linux 安装脚本、Debian 或 Fedora 软件包，或二进制文件，并按 Linux 指南配置快捷键与合成器。可选 OpenCode 功能需要已在运行的 OpenCode

部署与要求

• macOS 需要 Apple 芯片和 macOS 15 或更高版本。Windows 测试版运行于 Windows 10 或 11 的 x64 与 ARM64；x64 需要 2013 年或更新、支持 AVX2 的处理器（Intel Haswell / AMD Excavator 或更新）。Linux 测试版面向 x86_64 Linux 上的 i3/X11 和兼容的 wlroots Wayland 合成器；x86_64 需要 2013 年或更新、支持 AVX2 的处理器。原生 Wayland 需要合成器支持剪贴板和 layer-shell 协议；粘贴使用

采用前须知

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