5分钟上手OpenWhispr：跨平台语音转文字工具的快速设置教程

5分钟上手OpenWhispr：跨平台语音转文字工具的快速设置教程

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

OpenWhispr是一款注重隐私保护的跨平台语音转文字听写应用，支持本地模型（如Nvidia Parakeet/Whisper）和云模型（需自备API密钥）。本教程将帮助你在5分钟内完成安装与基础配置，开启高效语音输入体验。

一、准备工作：环境要求与前置条件

在开始安装前，请确保你的设备满足以下基本要求：

• 操作系统：支持Windows、macOS和Linux（包括NixOS）
• 硬件配置：推荐8GB以上内存，若使用本地模型建议配备Nvidia显卡以获得更佳性能
• 网络环境：首次安装需联网下载必要依赖和模型文件

二、一键安装步骤：3种方式任选

2.1 Git克隆安装（推荐开发者）

打开终端执行以下命令：

git clone https://gitcode.com/gh_mirrors/op/openwhispr cd openwhispr npm install

2.2 脚本自动安装（Windows用户）

直接运行项目根目录下的安装脚本：

scripts/download-windows-fast-paste.js

2.3 Nix包管理安装（Linux用户）

通过Nix环境快速部署：

nix-env -iA nixpkgs.openwhispr

三、首次启动与基础配置

3.1 启动应用

安装完成后，通过以下方式启动OpenWhispr：

• 开发者模式：npm run electron:start
• 普通用户：直接运行生成的可执行文件（Windows为.exe，macOS为.dmg，Linux为.AppImage）

3.2 模型选择与下载

首次启动后，应用会引导你选择语音识别模型：

• 本地模型：推荐选择Whisper基础模型，通过scripts/download-whisper-cpp.js自动下载
• 云模型：需在src/components/settings/ApiKeysSection.tsx中配置API密钥

四、核心功能快速上手

4.1 语音听写（Dictation）

1. 点击主界面麦克风图标或使用默认快捷键Ctrl+Shift+D激活听写
2. 开始说话，应用会实时将语音转换为文字
3. 完成后按ESC键结束听写，文字会自动粘贴到当前光标位置

4.2 会议转录（Meeting Transcription）

通过src/components/notes/MeetingTranscriptChat.tsx功能实现：

1. 在侧边栏选择"会议转录"
2. 点击"开始录音"按钮
3. 应用会自动识别发言人并生成带时间戳的转录文本

4.3 隐私保护设置

OpenWhispr默认启用本地处理模式，所有语音数据不会上传云端：

• 可在src/components/settings/MeetingSettings.tsx中调整数据存储位置
• 通过src/helpers/secretCrypto.js管理敏感配置

五、常见问题与解决方法

5.1 模型下载缓慢

若遇到模型下载问题，可手动下载后放置到指定目录：

• Whisper模型：~/.openwhispr/models/whisper/
• 扬声器识别模型：src/constants/speakerDetection.json中定义的路径

5.2 快捷键冲突

在src/helpers/hotkeyManager.js中自定义快捷键：

1. 打开设置界面
2. 进入"快捷键"选项卡
3. 点击对应功能的输入框重新设置

六、进阶使用建议

• 性能优化：对于Nvidia显卡用户，建议通过src/helpers/whisperCudaManager.js启用CUDA加速
• 自定义提示：修改src/config/prompts/registry.ts来自定义转录格式
• 插件扩展：查看agent-skills/目录下的技能插件，扩展应用功能

通过以上步骤，你已成功搭建OpenWhispr语音转文字系统。如需了解更多高级功能，请参考项目官方文档或探索src/services/目录下的功能模块。

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