Recap：macOS 本地会议音频转录与摘要工具

Recap 是一个专为 macOS 设计的开源工具，旨在帮助用户快速录制、转录和总结会议音频。它在本地处理所有数据，无需上传云端，保护用户隐私。开发者 Rawand Ahmad 打造 Recap，解决会议中难以同时专注讨论和记录的问题。Recap 利用 Apple 的技术，如 WhisperKit，进行音频转录，并通过 Ollama 生成摘要。目前项目处于开发阶段，用户需自行编译代码。Recap 适合注重隐私且具备技术能力的 macOS 用户。

功能列表

• 支持录制 macOS 系统音频和麦克风输入。
• 使用 WhisperKit 在本地转录音频为文字。
• 通过 Ollama 或 OpenRouter（可选）生成会议摘要。
• 确保数据本地处理，保护隐私安全。
• 支持主流会议平台音频检测（功能开发中）。
• 开源代码，鼓励社区贡献。

使用帮助

安装流程

Recap 目前需通过源代码编译安装，适合熟悉 macOS 开发环境的用户。以下是详细步骤：

1. 确认系统要求
   确保使用 macOS 系统，并安装 Xcode 15.0 或以上版本。可从 Mac App Store 下载 Xcode。
2. 克隆代码库
   打开终端，运行以下命令获取 Recap 源码：

   git clone https://github.com/rawandahmad698/recap.git
   cd recap
   

3. 打开 Xcode 项目
   在终端输入以下命令，打开 Recap 项目：

   open Recap.xcodeproj
   

4. 设置环境变量
   在 Xcode 的 Scheme Editor 中配置以下环境变量：
   • HF_TOKEN：Hugging Face 的 token，用于下载 Whisper 模型。需在 Hugging Face 官网注册并生成 token。
   • OPENROUTER_API_KEY（可选）：用于 OpenRouter 的摘要生成。若不设置，默认使用本地 Ollama。

   获取 HF_TOKEN 方法：

   • 访问 Hugging Face 官网，注册或登录。
   • 在账户设置中创建 API token。
   • 将 token 复制到 Xcode 的 Scheme Editor。
5. 编译运行
   在 Xcode 中点击“Build and Run”（快捷键 ⌘+R）编译项目。完成后，Recap 将在 macOS 上运行。
6. 未来计划
   开发者计划推出预编译版本，支持 Mac App Store 安装，并使用 Keychain 存储 token，提升安全性。

操作主要功能

Recap 的核心是录制音频、转录文字和生成摘要。以下是操作指南：

1. 录制音频

• 启动 Recap ：运行编译后的 Recap 应用。
• 选择音频源 ：Recap 默认录制 macOS 系统音频（如会议软件声音）。可在设置中启用麦克风录制。
• 开始录制 ：点击界面“开始录制”按钮（快捷键待开发者更新）。Recap 会捕获会议音频。
• 停止录制 ：会议结束时点击“停止录制”，音频文件保存至本地。

2. 本地转录

• 使用 WhisperKit ：Recap 利用 WhisperKit 在 macOS 上将音频转为文字，无需联网。
• 查看转录 ：转录完成后，文字显示在界面。可手动编辑以确保准确。
• 注意事项 ：转录效果受音频质量和设备性能影响。建议使用清晰音频并确保设备有足够存储。

3. 生成摘要

• 本地摘要 ：Recap 默认使用 Ollama 在本地生成摘要，提取会议关键点，如决定或任务。
• OpenRouter 选项 ：若配置 OPENROUTER_API_KEY，可通过 OpenRouter 生成更高质量摘要，需联网。
• 查看摘要 ：摘要生成后显示在界面，可复制、保存或导出为文本。

4. 隐私保护

• 本地处理 ：所有音频和文字处理在 macOS 设备上完成，数据不上传云端。
• 开源透明 ：代码托管在 GitHub，用户可审查以确保安全。

其他功能操作

• 会议平台检测 ：Recap 计划通过 macOS ScreenCaptureKit 自动识别 Teams、Zoom 等平台音频，目前需手动选择。
• 社区贡献 ：开发者可通过 GitHub 提交代码，优化功能或修复问题。

注意事项

• Recap 仍在开发，可能不稳定，仅建议测试使用。
• 确保 macOS 设备有足够存储空间。
• 遇到问题可在 GitHub Issues 页面反馈，开发者会及时响应。

应用场景

1. 远程会议记录
   macOS 用户在 Zoom 或 Teams 会议中可用 Recap 录制音频并生成摘要，专注于讨论无需手动笔记。
2. 开发者会议
   程序员可使用 Recap 记录技术会议内容，生成摘要以快速回顾重点，保持编码效率。
3. 敏感商务会议
   Recap 的本地处理适合记录涉及商业机密的会议，确保数据不外泄。
4. 教育场景
   学生或教师可录制 macOS 上的讲座音频，生成文字记录和摘要，便于复习或分享。

QA

1. Recap 是否需要联网？
   默认本地运行无需联网。使用 OpenRouter 摘要功能需联网并配置 API 密钥。
2. 如何获取 Hugging Face token？
   在 Hugging Face 官网注册，进入设置生成 API token，复制到 Xcode 配置。
3. Recap 支持哪些会议平台？
   当前需手动选择音频源，未来将自动支持 Teams、Zoom、Google Meet。
4. 摘要质量如何？
   取决于音频清晰度和转录准确性。Ollama 适合简单摘要，OpenRouter 提供更高质量但需联网。
5. 如何贡献代码？
   访问 GitHub 仓库（https://github.com/rawandahmad698/Recap），提交 Pull Request。