kitlangton/Hex

Hex（旧版 Swift 应用） – 快速概览

是什么 – Hex 是一个小型 macOS 实用工具，让你可以在任何地方听写文本。按下全局快捷键，说话，应用会在设备上进行语音转文字，并将结果粘贴到当前聚焦的窗口中。

为什么重要 – 它内置了设备端语音转文字模型（通过 WhisperKit），无需互联网连接，并与 macOS（麦克风 + 辅助功能权限）紧密集成，可在任何应用中使用。

---

核心功能

• 两种录音模式
  1. 按住：说话时按住快捷键，松开开始转写。
  2. 双击：双击锁定录音，说话，再点一次转写。
• 设备端转写 – 使用 WhisperKit 库（Apple Silicon 优化的 Whisper 模型）和 FluidAudio 的 Parakeet TDT v3 后端。
• 自动粘贴 – 转写完成后，Hex 通过 macOS 辅助功能 API 将文本插入活动窗口。

技术细节

领域	技术
语言	Swift（macOS 应用）
架构	Swift Composable Architecture（TCA）
语音模型	WhisperKit（本地 Whisper 推理）
音频后端	FluidAudio / Parakeet TDT v3
打包	以 .dmg 并通过 Homebrew Cask（kitlangton-hex）分发
平台	仅 Apple Silicon Mac

开始使用（旧版）

1. 安装 – 从 README 中的链接下载 .dmg 或运行 brew install --cask kitlangton-hex。
2. 授予权限 – macOS 会请求麦克风访问（用于录音）和辅助功能访问（用于粘贴）。
3. 在应用偏好设置中设置全局快捷键。
4. 使用两种录音模式之一进行听写，并让文本出现在你输入的地方。

开发与贡献

• 该仓库现在仅保留原始 Swift 代码、其历史记录和发布资产。主要开发已移至 anomalyco/hex（基于 Rust 的重写）。
• 对于旧版 Swift 应用的错误或小改动，请在此处打开问题。较大的功能开发应转到新仓库。
• 该项目使用 changeset 工作流（通过 bun/npm）生成发布说明并自动化 Sparkle 更新。

许可证

• MIT 许可证 – 可自由使用、修改和分发。

---

底线 – Hex 是一款实用的设备端语音转文字 macOS 工具，使用 Swift、WhisperKit 和 FluidAudio 构建。原始 Swift 版本已存档于此，而积极开发中的跨平台工作位于 anomalyco/hex 仓库中。