FluidVoice全局快捷键设置教程：如何一键唤起全系统语音输入
【免费下载链接】FluidVoiceFastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows pre-build available! A local Wispr Flow alternative. DM us on X exclusive model access! 😉 - https://x.com/fluidvoiceapp项目地址: https://gitcode.com/GitHub_Trending/fl/FluidVoice
FluidVoice 是一款面向 macOS 的本地语音听写（STT）应用，它的核心体验之一就是全局快捷键：无论你在写文档、回邮件还是剪视频，按一下快捷键（默认是右 Option/Alt 键）就能唤起全系统语音输入，说完自动把文字"打"进当前光标处，全程无需切换窗口，数据也全部在本地完成处理。本教程带新手从零配好这组快捷键，1 分钟让 Mac 进入"动口不动手"状态。
为什么 FluidVoice 的全局快捷键值得设置
大多数听写工具需要你点进某个输入框、打开某个 App 才能录。FluidVoice 走的是"系统级监听"路线：
- 全应用生效：邮件、IM、代码编辑器、浏览器——任何有光标的地方都能直接录入文字。
- 毫秒级唤起：快捷键按下即开始录音，屏幕顶部（刘海区）会出现实时录音指示器。
- 本地 STT + 可选 AI 增强：语音识别模型跑在本地，可选的本地 AI 增强也不会让数据离开你的 Mac。
它的快捷键由GlobalHotkeyManager统一调度（GlobalHotkeyManager.swift），通过 macOS 的事件监听实现全局监听，这也是为什么需要"辅助功能"权限的原因。
三步开启 FluidVoice 全局快捷键
第 1 步：授予麦克风与辅助功能权限
FluidVoice 要"听见"你要麦克风权限，要把文字"打"进别的 App 则要辅助功能（Accessibility）权限：
- 首次启动时按提示允许麦克风访问；
- 系统会引导你到系统设置 → 隐私与安全性 → 辅助功能，勾选 FluidVoice。
这两步是快捷键能生效的前提，缺一不可（权限要求见 README.md）。
第 2 步：在设置里指定你的全局快捷键
打开 FluidVoice 主界面，进入Settings → Shortcuts区域，你会看到"Primary Dictation Shortcuts"（主听写快捷键）一行：
- 点击录制按钮后，直接按下你想要的组合键（如 ⌥、⌃⌥ 或任意键位），组合即刻生效；
- 默认快捷键是右 Option/Alt 键——单按一个修饰键即可唤起录音，几乎不占用常用组合；
- 支持添加多个主快捷键，互不冲突，适配不同使用场景。
界面逻辑见 SettingsView.swift，快捷键的键位解析（键盘、修饰键、鼠标按钮）统一封装在 HotkeyShortcut.swift。
第 3 步：选择激活模式（Toggle / Hold / Automatic）
同一组快捷键有三种触发方式，在 Settings 的Activation Mode下拉框中切换（定义见 HotkeyActivationMode.swift）：
| 模式 | 行为 | 适合场景 |
|---|---|---|
| Toggle（切换） | 按一次开始，再按一次结束 | 长段独白、写长文档 |
| Hold（按住说话） | 按住才录音，松开即停止 | 短消息、怕误触的用户 |
| Automatic（自动，默认推荐） | 轻点一次 = 切换模式；按住不放 = 按住说话 | 想两者兼得，一劳永逸 |
小技巧：Hold 模式下如果你按住修饰键期间又误按了其他键，FluidVoice 会识别为"打断"而不启动录音（相关判定逻辑见 GlobalHotkeyManager.swift），大幅减少误触发。
进阶：不止键盘，鼠标也能当"语音开关"
FluidVoice 的全局快捷键不限于键盘：
- 鼠标按钮触发：可以把中键、侧键等设为听写快捷键（HotkeyShortcut.swift 支持 mouse 类型快捷键），适合用轨迹板/侧键的老用户；
- Cancel Recording：单独给"取消本次录音"配一个快捷键，录废了一次不用手动删；
- Paste Last Transcription：配一个快捷键，随时把上一次转写结果再插一次，不占用剪贴板；
- Command Mode / Edit Mode：分别为"语音执行系统指令"和"选中文字后口述修改"分配快捷键，从语音输入进一步走向语音控制整台 Mac。
所有这些快捷键在设置界面都能可视化录制、随时增删，改动一般即时生效。
常见问题
Q：快捷键按了没反应？先检查辅助功能权限是否授予且 FluidVoice 在前台启动过一次；事件监听在应用启动约 1.5 秒后建立，刚打开应用时稍等几秒再试。
Q：会和系统或别的软件快捷键冲突吗？尽量避免使用系统已占用的组合（如 ⌘ 系列多与系统功能绑定）。FluidVoice 内部对可能互相"包含"的修饰键组合做了冲突检测（HotkeyShortcut.swift），但跨应用冲突仍需你按上面的原则自行规避。
Q：只想按住说话，不想轻点触发，可以吗？可以。把 Activation Mode 切到Hold即可，行为见 HotkeyActivationMode.swift。
写在最后
配好 FluidVoice 全局快捷键后，你的 Mac 就拥有了"任意 App 里一键语音输入"的能力：默认右 Option/Alt 轻点一下开始说话，文字自动落到光标处。配合本地 STT 与可选的本地 AI 增强（Fluid Intelligence 本地模型介绍），整套流程既快又私密。
从安装到按出第一句语音，整个过程通常不超过 3 分钟——把快捷键交给手指，把语言交给 FluidVoice。
【免费下载链接】FluidVoiceFastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows pre-build available! A local Wispr Flow alternative. DM us on X exclusive model access! 😉 - https://x.com/fluidvoiceapp项目地址: https://gitcode.com/GitHub_Trending/fl/FluidVoice
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
