如何快速上手OpenSuperWhisper：从Homebrew安装到第一次按住⌘说出第一句话的完整入门教程
【免费下载链接】OpenSuperWhispermacOS dictation app项目地址: https://gitcode.com/gh_mirrors/op/OpenSuperWhisper
OpenSuperWhisper 是一款 macOS 语音听写应用，基于 Whisper 语音识别模型实现实时录音与文字转写，支持用键盘快捷键或鼠标按键"按住说话、松手出字"。本文是一份面向新手的完整入门教程：从用 Homebrew 安装 OpenSuperWhisper，到首次启动下载模型，再到第一次按住⌘说出你的第一句话。
一、OpenSuperWhisper 是什么？30 秒了解这款 macOS 语音听写神器
OpenSuperWhisper 是一个运行在 Apple Silicon Mac 上的后台听写工具，核心能力包括：
- 🎙️实时录音与转写：按住快捷键说话，松开后语音自动变成文字并进入剪贴板
- 🧠双引擎识别：内置 Whisper 与 Parakeet 两种引擎，模型可直接在应用内下载
- ⌨️全局快捷键：支持按键组合（如 ⌥ + `）或单修饰键（左 ⌘、右 ⌥、Fn）
- 🖱️鼠标触发：可绑定中键或侧键开始/停止录音
- 🌍多语言自动检测，并为中日韩语言提供自动纠错（Asian Autocorrect）
它的界面极简：一个菜单栏图标 + 一个录音窗口，适合边写文档边口述输入。
二、Homebrew 安装 OpenSuperWhisper 一键步骤
前置要求只有一条：macOS + Apple Silicon（ARM64）。
打开终端（Terminal），依次执行：
brew update # 可选，先更新 Homebrew brew install opensuperwhisper安装完成后，在启动台或应用程序文件夹中找到 OpenSuperWhisper 并打开它，首次运行会进入引导向导。
💡 提示：安装命令的完整说明见项目文档 Readme.md。
三、首次启动向导：3 步配置语言、快捷键与 Whisper 模型
第一次打开 OpenSuperWhisper，引导页（源码：OnboardingView.swift）会带你完成 3 件事：
1. 选择听写语言
顶部下拉框默认跟随系统语言。如果你使用中文、日文等亚洲语言，可以顺手打开Use Asian Autocorrect开关，转写结果会自动按书写习惯断句、加标点。
2. 选择录音触发方式
有两种触发方式可选：
| 触发方式 | 默认按键 | 是否需要额外权限 |
|---|---|---|
| 按键组合（Key Combination） | ⌥ + ` | 不需要 |
| 单修饰键（Single Modifier Key） | 右 ⌥ | 需要"输入监控"权限 |
单修饰键模式下你可以选左 ⌘，也就是"按住⌘说话"的手感；该模式需要系统"输入监控"权限，但 macOS 只会监听修饰键事件，不会捕获普通按键。
3. 下载 Whisper 模型
页面下方列出可用的模型（Whisper 系列或 Parakeet），点击Download即可在应用内直接下载，完成后点Select选中，最后点Continue完成引导。模型管理逻辑见 WhisperModelManager.swift。
四、第一次按住⌘说话：从按下到出字的完整流程
引导完成后，OpenSuperWhisper 会在菜单栏常驻。第一次听写的操作只有三步：
- 按住你的录音键（例如单修饰键模式下的左 ⌘，或组合键 ⌥ + `），屏幕会弹出悬浮录音窗口，并开始播放提示音
- 对着麦克风说话，说多少记多少
- 松开按键，录音自动停止，Whisper 模型转写完成，文字自动复制到剪贴板，直接 ⌘V 粘贴即可
如果想让"按住说话"成为默认行为，可在 设置 → Recording Trigger 中开启Hold to Record（按住录音，松手停止），相关配置位于 Settings.swift。快捷键与按住逻辑的实现见 ShortcutManager.swift。
五、上手后值得知道的 3 个实用技巧
- 🎤切换麦克风：点击菜单栏图标即可在内置麦克风、蓝牙耳机、外部麦克风甚至 iPhone 连续互通麦克风之间一键切换
- 📁拖入音频文件转写：把
.m4a、.wav等文件拖进主窗口底部区域，应用会排队批量转写（队列处理见 TranscriptionQueue.swift） - 🔍搜索历史：主窗口顶部的 Search 框可以全文检索所有历史听写记录，找旧内容一秒定位
六、新手常见问题快速解答
Q：按住快捷键没反应怎么办？A：检查是否授予了"输入监控"（单修饰键模式）或"辅助功能"（鼠标模式）权限；也可以回到设置里换回默认的 ⌥ + ` 组合键试试。
Q：转写速度慢/不准？A：换更大的 Whisper 模型（在设置 → Model 中重新下载），或尝试 Parakeet 引擎；同时调低"无语音阈值"可以减少漏字。
Q：支持 Intel 版 Mac 吗？A：目前仅支持 Apple Silicon（ARM64），Intel 兼容还在开发路线中。
按上面 4 个步骤走完，你已经在 5 分钟内完成了 OpenSuperWhisper 从 Homebrew 安装到第一次按住⌘口述转写的全流程。接下来不妨打开一篇文档，试着"动口不动手"地写一段话——你会发现语音听写效率远超想象。
【免费下载链接】OpenSuperWhispermacOS dictation app项目地址: https://gitcode.com/gh_mirrors/op/OpenSuperWhisper
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
