企业官网建设流程全解析

OpenWhispr 语音转文字听写指南：如何用全局热键把说话直接变成文字

【免费下载链接】openwhisprVoice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.项目地址: https://gitcode.com/GitHub_Trending/op/openwhispr

OpenWhispr 是一款免费、开源、跨平台的语音转文字听写应用，支持本地 Whisper 模型与云端 AI 模型，覆盖 macOS、Windows 和 Linux。不想把录音交给云端、又希望一个热键在任何软件里说话出字的人，适合直接上手。

🎯 它能帮你做什么：4 个高频场景

• 边开会边自动记录：检测到 Zoom、Teams、FaceTime 通话后开始转录，实时区分说话人，并可对接 Google、Microsoft、Apple 日历。
• 边写邮件边口述成文：按下全局热键说话，文字自动出现在光标处，带自动标点，还能说中文、贴出英文。
• 边看屏幕边指挥 AI：专用语音助手热键把口述直接发给 GPT-5、Claude、Gemini 等模型，选中的文字可被就地改写，全程无需唤醒词。
• 边整理边归档笔记：拖入音频、视频文件或粘贴链接即可转录成笔记，支持文件夹管理、语义搜索和云端同步。

⏱ 五分钟上手：从安装到第一次听写

1. 下载与系统匹配的安装包：macOS 用.dmg，Windows 用.exe，Linux 可选.AppImage（免安装的通用包格式）、.deb、.rpm。
2. 首次启动时，按引导授予麦克风权限并配置热键。
3. 转录引擎二选一：图省事直接填云端 API key；要隐私就在「设置 → Speech to Text Processing」里启用本地模型，下文细讲。
4. 打开任意输入框，按下听写热键，说话，松开——文字出现在光标位置，第一次听写就跑通了。

想从源码运行：git clone https://gitcode.com/GitHub_Trending/op/openwhispr，进入目录后执行npm install && npm run dev，需要 Node.js 24+。

核心用法拆解：离线转录与 AI 语音助手

场景一：配置完全离线的本地转录

目标：音频不离开设备，断网也能听写。

操作步骤：

1. 右键托盘图标（或点击听写浮层）打开控制面板。
2. 进入「设置 → Speech to Text Processing」，启用Use Local Whisper，选一个模型，推荐base。
3. 点击保存，首次转录会自动把模型下载到~/.cache/openwhispr/whisper-models/。

预期效果：之后所有听写都走本机 whisper.cpp——它是 OpenAI Whisper 模型的高性能 C++ 实现，相当于把识别引擎装进你自己的电脑。Apple Silicon 自带 Metal 加速，NVIDIA 卡走 CUDA，AMD/Intel 卡走 Vulkan，运行时失败会自动回落到 CPU，听写不断。

场景二：用语音助手让 AI 代劳

目标：不动键盘，用嘴指挥 AI 写邮件、改文案。

操作步骤：

1. 在「设置 → AI」里配好一个模型（GPT-5、Claude、Gemini、Groq 或本地模型）。
2. 在任意应用里按语音助手热键，直接说指令，例如“帮我起草一封通知客户项目完成的邮件”。
3. 需要改写文字时先选中它，再发语音，AI 会就地编辑。

预期效果：没有唤醒词，也没有整理环节。开启自动粘贴后，回答直接出现在光标处；没有可写光标时，内容流入浮动面板并可一键复制。

📊 参数与模型怎么选：Whisper 本地模型对比表

拿不准就选base：142MB 下载量、约 1GB 内存，是速度与识别质量的平衡点。内存 8GB 以上、又想要更快更准，可以换turbo。

❓ 常见问题速查：3 个高频故障

Q1：麦克风没反应，提示“权限被拒绝”

• 症状：按热键后没有录音提示，或提示未检测到麦克风。
• 原因：系统级麦克风权限没有授予 OpenWhispr。
• 解决：macOS 打开「系统设置 → 隐私与安全性 → 麦克风」，Windows 打开「设置 → 隐私 → 麦克风」，确认 OpenWhispr 已启用；Linux 则用pavucontrol检查输入设备。

Q2：转出来是空的，历史记录只有空白条目

• 症状：听写流程走完了，结果却是空内容。
• 原因：输入设备选错、缓存损坏，或热键触发时没有声音。
• 解决：先确认系统声音设置里的输入设备；再删除本地 Whisper 缓存目录后重启应用；最后换一个热键重试，仍不行就重跑首次引导。

Q3：本地转录失败，提示“whisper.cpp 未找到”

• 症状：启用本地 Whisper 后转录直接报错。
• 原因：whisper.cpp 二进制是随安装包捆绑的，从源码运行时不会自带。
• 解决：源码运行就执行npm run download:whisper-cpp下载当前平台的二进制；安装包用户重启应用，macOS 也可用 Homebrew 安装 whisper-cpp 兜底。

📚 继续深入：文档、源码与社区

• 本地 Whisper 完整说明（含 GPU 加速细节）：LOCAL_WHISPER_SETUP.md
• 更多平台级故障排查：TROUBLESHOOTING.md
• 转录与模型相关核心源码：src/helpers/，如whisper.js、parakeet.js、llamaServer.js
• iOS 移动端工程：openwhispr-mobile/
• 使用中遇到问题，直接到项目仓库提交 issue 反馈即可。

OpenWhispr 把“说话”直接变成了文字、笔记和 AI 指令，而且录音可以完全留在本机。现在就可以先装好它，把本地base模型跑通第一次听写——剩下的功能，会在你每天用热键的过程中自然展开。

【免费下载链接】openwhisprVoice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.项目地址: https://gitcode.com/GitHub_Trending/op/openwhispr