如何快速配置 OpenSuperWhisper 全局热键:键盘快捷键、单修饰键长按、鼠标侧键 3 种触发方式一次配齐

📅 发布时间:2026/9/30 17:40:08
如何快速配置 OpenSuperWhisper 全局热键:键盘快捷键、单修饰键长按、鼠标侧键 3 种触发方式一次配齐
如何快速配置 OpenSuperWhisper 全局热键键盘快捷键、单修饰键长按、鼠标侧键 3 种触发方式一次配齐【免费下载链接】OpenSuperWhispermacOS dictation app项目地址: https://gitcode.com/gh_mirrors/op/OpenSuperWhisperOpenSuperWhisper 是一款 macOS 上的实时语音转文字语音输入应用支持 Whisper 与 Parakeet 双引擎可以把你说出的话实时转成文字插入到任意输入框。它的最大亮点是灵活的全局热键无论用键盘组合键、单枚修饰键如左 ⌘、右 ⌥、Fn还是鼠标中键/侧键都能一键或长按触发录音转写。本教程带你一次性配齐这 3 种触发方式。准备工作安装应用并授予权限brew update brew install opensuperwhisper不同触发方式依赖的系统权限不同请提前授权触发方式所需权限用途键盘组合键辅助功能 输入监控部分系统全局捕获快捷键单修饰键输入监控Input Monitoring全局检测单枚修饰键按下鼠标侧键辅助功能Accessibility拦截指定鼠标按钮作为录音触发授权入口系统设置 → 隐私与安全性 → 输入监控 / 辅助功能勾选 OpenSuperWhisper 即可。应用内也有对应的Grant Permission按钮见 Settings.swift。方式一键盘组合键默认最简单打开 OpenSuperWhisper 的设置面板切换到快捷键Shortcuts标签页在Recording Trigger分段控件中选择Key Combination点击 Shortcut 输入框直接按下你想要的组合键。默认热键为⌥ \Option 加反引号定义见 [ShortcutManager.swift](https://link.gitcode.com/i/25a87afb569ee68b8964ad175f3f33d4)。如果你习惯 macOS 系统语音输入可以选一个不冲突的组合例如⌃⌥R。 组合键方式的优点是无需额外权限、开箱即用缺点是按键较多高频使用时略显繁琐。方式二单修饰键长按效率党首选这是本应用最有特色的玩法只需单独按下左 ⌘、右 ⌥、Fn 等任意一枚修饰键无需再按其他键即可触发录音。在Recording Trigger中选择Single Modifier Key在Modifier Key下拉菜单中选择你要绑定的按键支持左右 ⌘ Command、左右 ⌥ Option、左右 ⇧ Shift、左右 ⌃ Control 以及 Fn共 10 种可选枚举定义见 ModifierKeyMonitor.swift系统弹出输入监控授权提示时点击打开系统设置完成授权。实现原理是通过 CGEvent 事件监听器event tap只捕获修饰键状态变化事件不会截获任何普通按键输入源码见 ModifierKeyMonitor.swift。切换回该模式时应用会自动恢复你上次选择的按键lastModifierOnlyHotkey偏好项无需重复选择。推荐搭配把右 ⌥右手边的小 Option 键作为触发键左手继续打字右手拇指一按就开始口述松手结束——这就是按住说话Hold to Record模式详见下一节。方式三鼠标侧键办公与游戏用户福音如果你常用三键以上鼠标如罗技、雷蛇、MX Master 系列可以把滚轮或侧键变成录音开关在Recording Trigger中选择Mouse Button在Mouse Button下拉菜单中选择按钮Button 3Middle中键/滚轮Button 4Back后退侧键Button 5Forward前进侧键Button 6自定义侧键注意左右主键被系统保留不可用请选中间或额外侧键按钮枚举见 MouseButtonMonitor.swift。应用会拦截该按钮的原始事件因此它只会触发录音不会再触发浏览器前进/后退等默认动作。该模式需要辅助功能权限。关键开关Hold to Record按住说话三种触发方式都兼容同一个录音行为开关Hold to Record默认开启。开启按住快捷键/修饰键/鼠标按钮 录音中松开即自动停止适合逐句输入关闭按一下 开始录音再按一下 停止并转写适合长段独白。实现上应用会判断按键是否持续 0.3 秒以上来区分单击切换与长按录音逻辑见 ShortcutManager.swift设置项定义在 AppPreferences.swift。同一时间只会生效一种触发方式优先级为鼠标按钮 单修饰键 组合键切换时旧的监听会自动注销源码逻辑见 ShortcutManager.swift。常见问题排查现象原因与解决按修饰键/鼠标键无反应未授予输入监控或辅助功能权限设置页会有橙色 ⚠️ 提示点击 Grant Permission 重新授权热键与其他软件冲突打开系统设置 → 键盘 → 快捷键检查全局冲突或换一个不常用的组合/侧键切换触发方式后不生效应用重启监听是自动的若仍无效重启 OpenSuperWhisper想取消正在进行的录音双击Esc超过 10 秒的录音可用Cancel without confirmation跳过二次确认小结OpenSuperWhisper 的 3 种全局热键触发方式覆盖了绝大多数使用场景键盘组合键——零配置、最稳妥适合入门单修饰键长按——一个拇指键搞定配合 Hold to Record 实现按住说话、松手即转是效率最高的选择鼠标侧键——把闲置的滚轮/侧键变成录音键右手不离鼠标也能随时口述。三种方式互斥切换、即改即生效全部集中在设置的 Recording Trigger 区域完成5 分钟内即可配齐你的专属语音输入工作流。【免费下载链接】OpenSuperWhispermacOS dictation app项目地址: https://gitcode.com/gh_mirrors/op/OpenSuperWhisper创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考