Hex常见问题解答解决你的语音转文字难题【免费下载链接】HexVOICE → WORDS项目地址: https://gitcode.com/gh_mirrors/hex15/HexHex 是一款专为 macOS 打造的语音转文字工具它的核心体验是按住说话、松开出字按下热键说出内容松开后语音转文字结果便自动粘贴到光标所在位置。本文汇总了新手使用 Hex 时最常遇到的 8 类问题与解决方案帮助你快速上手这款 macOS 语音转文字工具告别卡壳与报错。1. Hex 是什么语音转文字工具如何工作Hex项目描述VOICE → WORDS是一款常驻菜单栏的全局语音输入工具。它通过全局热键监听键盘事件按下热键即开始录音松开热键后调用本地 AI 模型完成语音转文字并把结果直接粘贴到任意应用中——无论是聊天窗口、文档编辑器还是邮件都能即说即得。它提供两种录音模式模式操作方式适用场景按住说话按住热键录音松开即转写短句、快速输入双击锁定快速双击热键锁定录音再按一次结束长段落、口述两种模式的判定逻辑由 HotKeyProcessor.swift 实现热键的具体按键组合配置见 HotKey.swift。2. 系统要求与安装方法我的电脑能用吗这是最常被问到的问题。Hex 目前仅支持 Apple SiliconM1 及更新芯片的 MacIntel 机型暂无法使用。系统版本建议 macOS 14Sonoma及以上。安装有两种最便捷的方式Homebrew 一键安装brew install --cask kitlangton-hex官网下载安装包从项目发布页获取最新的.dmg安装包如果你希望查看或参与源码也可以通过git clone https://gitcode.com/gh_mirrors/hex15/Hex获取完整工程。项目由 Swift SwiftUI 编写核心逻辑集中在HexCore/Sources/HexCore/目录下适合对 macOS 开发感兴趣的读者阅读。3. 首次启动麦克风与辅助功能权限怎么授予首次打开 Hex必须授予两项系统权限缺一不可麦克风权限用于录制你的声音。请在系统设置 → 隐私与安全性 → 麦克风中勾选 Hex。辅助功能Accessibility权限用于让 Hex 把转写文本自动粘贴到任意应用中。请在系统设置 → 隐私与安全性 → 辅助功能中启用 Hex。授予权限后建议完全退出 Hex 再重新打开确保权限生效。如果热键一直没反应优先检查辅助功能权限是否已勾选。4. 热键不生效怎么办如何正确设置热键热键是 Hex 的扳机设置不当会导致无法触发录音。常见原因与解决办法如下权限未生效重新检查辅助功能权限必要时移除后重新添加。热键冲突选择的组合键被其他软件如输入法、截图工具占用建议更换为Option、⌥K这类不常用组合。误触被拦截Hex 对修饰键单独作为热键如单独按 Option设置了 0.3 秒的保护阈值快速点按会被视为误触而静默忽略。这是为了防误触而刻意设计的行为按住超过 0.3 秒即可正常录音。唤醒后失效在睡眠唤醒后热键偶尔失灵可重启 Hex 或重新勾选权限。详细的判定时间线与阈值说明可参考项目文档 hotkey-semantics.md源码实现在 HotKeyProcessor.swift。5. 录音没有声音或转写失败如何排查按了热键却没反应或转写结果为空通常来自以下三方面麦克风选错设备在设置中检查是否选择了正确的输入设备尤其是外接耳机或声卡时。Hex 在音频设备变化时会自动重建采集引擎但偶尔需要手动切换一次麦克风。录音时间过短快速点按热键产生的超短音频小于 0.2~0.3 秒会被视为误触丢弃这是正常的防抖逻辑。请确保按住热键说出完整内容后再松开。模型未下载完成首次使用需要下载语音转文字模型若模型尚未就绪会直接跳转到模型设置页。请到设置中的模型库Model Library完成下载后再试。相关录音逻辑见 RecordingClient.swift转写调度见 TranscriptionFeature.swift。6. 转写结果不准确怎么提升识别率转写准确度与所选 AI 模型直接相关。Hex 内置两套本地模型Parakeet TDT v3默认推荐速度快、支持多语言云端优化过的推理模型日常使用首选。WhisperKitWhisper 系列完全离线运行支持 Tiny、Base 直到 Large v3 Turbo 多种规格追求更高准确率可选用 Large v3 Turbo体积约 632MB但速度比 Small 快数倍。建议按速度优先选 Parakeet准确率优先选 Whisper Large的原则选择。模型管理代码见 ModelDownloadFeature.swift。此外口音较重时可通过单词映射功能自定义纠错把常被识别错的词替换为正确写法规则定义在 WordRemapping.swift。7. 如何让输出文本更规范格式化技巧汇总Hex 内置了实用的文本后处理功能帮你出口成章自动小写适合输入代码注释、变量名等场景。去除标点一键去掉输出中的逗号句号适合短语速记。单词移除设置关键词自动从结果中删除例如去掉口头禅那个就是。单词映射支持转义符\n、\t可把识别结果自动插入换行或制表符。格式化逻辑见 TranscriptFormatting.swift单词移除规则见 WordRemoval.swift。8. 常见问题速查表FAQ 汇总问题快速解决方案热键没反应检查辅助功能权限更换冲突热键录音无声音切换麦克风设备确保按住热键说话转写为空确认模型已下载避免超短点按识别不准确切换 Whisper Large 模型配置单词映射输出格式不对在设置中开启小写/去标点/单词移除睡眠后失灵重启 Hex 或重新勾选权限结语Hex 把语音转文字做到了极致简单——按下、说话、松开文字即达。大多数问题都源于权限与热键配置按照本文的排查步骤操作几分钟内就能流畅使用。如果遇到文中未覆盖的问题欢迎在项目仓库提交 Issue 反馈或查看根目录的 README.md 与 CHANGELOG.md 了解最新版本动态。【免费下载链接】HexVOICE → WORDS项目地址: https://gitcode.com/gh_mirrors/hex15/Hex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考