anomalyco/hex

Hex 是一款本地优先的听写工具：按住快捷键说话，松开后在麦克风旁完成本机语音识别，并把文本粘贴到当前获得焦点的应用。它主要面向希望快速语音输入、又不想让普通听写音频进入云端的 macOS 用户；Windows 与 Linux 版本已提供，但标注为 beta。

工作方式与实际变化

安装时需下载本地语音模型，使用前要授予麦克风权限（用于录音）和辅助功能权限（用于识别快捷键并粘贴到前台应用）。macOS 默认按住 Option 说话；双击可保持录音，Escape 取消，Option-Shift-V 重新粘贴上一条完成的听写。设置中可调整快捷键、麦克风、语言、模型、录音行为和开机启动。具体步骤见安装与权限说明。

Modes 可在粘贴前修正姓名和偏好拼写，也可选择性地做改写和文本转换。一个关键机制是：可从菜单栏切换模型，每个模型会记住上次使用的语言，Whisper 还会记住识别提示。另一个机制是可选的 OpenCode 后处理：在 Mode 中启用后，Hex 会把转写文本、前台应用和 Brave 网站主机名发送给配置的模型提供商。改写失败时，Hex 保留修正后的本地转写并继续运行选定的文本转换；若转换阶段失败，则保留该阶段之前的文本，而不是部分结果。

Annotate 在 macOS 和 Linux 上默认可用（Windows 暂不支持），录屏时可在屏幕上边画边说，结束后把标注放到剪贴板或发送给 OpenCode 会话。macOS 发布二进制附带只读 CLI，可在应用运行时查询历史与会议。高级用户可编写确定性的 TypeScript/JavaScript 本地配置做文本转换，Hex 在嵌入式引擎中运行，脚本没有文件系统、网络或进程访问权限。

平台范围

macOS 版针对 Apple 芯片和 macOS 15 及以上。Windows beta 支持 Windows 10/11 的 x64 和 ARM64，包含快捷键听写、Modes、历史记录和签名自动更新，但不含 Meetings 和本地转写 API；安装包尚未代码签名，SmartScreen 可能警告。Linux beta 面向 x86_64 上的 i3/X11 及兼容 wlroots Wayland 合成器；原生 Wayland 粘贴依赖 wtype 或桌面 RemoteDesktop 门户，快捷键来自 GlobalShortcuts 门户或合成器绑定的 CLI 命令。细节见 Windows 指南和 Linux 指南。当前发布的是自动更新的 dev 构建，尚未有首个稳定版。

隐私与数据条件

普通转写在本机完成，默认不保存听写音频。历史记录默认保留成功粘贴的文本七天，包括本地转写、最终文本以及有限的应用和时间元数据，不保存音频、完整浏览器 URL 或窗口标题；保留上限为 10,000 条和 16 MiB 文本，超限先删除最旧记录。关闭保留不会删除已有记录，也不会停止诊断日志；日志可能包含转写文本、应用名和 Brave URL，但 Hex 不上传这些日志。可选的 OpenCode 功能会把上述数据发送给所选提供商。在敏感环境中使用前，建议阅读隐私说明。

升级与许可注意

从原 Swift 应用迁移需手动安装；设置和历史不会转移，应先退出旧应用，避免快捷键冲突。组织可通过偏好域策略禁用应用内更新。Hex 采用 MIT 许可；不接受外部 pull request，但欢迎提交 issue。