OpenOats：会给你递话的会议笔记助手

项目简介

OpenOats 是一款运行在 macOS 上的会议笔记助手。它陪在你的通话旁边，实时转写对话双方的内容，并在需要的时候搜索你自己的笔记，把值得说出口的要点提示给你。

转写完全在你本机完成，音频不会离开设备；搭配 Ollama 使用时，整条链路都可以在本地跑通。

主要功能

• 对方看不到：应用窗口默认对屏幕共享隐藏，别人不会发现你在用它
• 完全离线的转写：语音识别全程在你的 Mac 上运行，音频不离开设备
• 可 100% 本地运行：与 Ollama 搭配，LLM 建议与向量化都在本地完成，完全不联网
• 任意 LLM 可选：用 OpenRouter 或 Requesty 接入 GPT-4o、Claude、Gemini 等云端模型，或用 Ollama 跑 Llama、Qwen、Mistral 等本地模型
• 实时字幕：边聊边看双方转写内容，一键复制全文
• 会话自动保存：每次对话自动存成纯文本转写与结构化会话记录，无需手动导出
• 知识库检索：指向一个笔记文件夹，它用 Voyage AI 向量、本地 Ollama 向量或任意 OpenAI 兼容接口，把相关内容找出来

安装与使用

通过 Homebrew 安装：

brew tap yazinsai/openoats https://github.com/yazinsai/OpenOats
brew install --cask yazinsai/openoats/openoats

后续升级：

brew upgrade --cask yazinsai/openoats/openoats

也可以从 Releases 页面 下载最新的 DMG，或从源码构建：

./scripts/build_swift_app.sh

快速上手：

1. 打开 DMG，把 OpenOats 拖进「应用程序」
2. 启动应用，授予麦克风与系统音频录制权限
3. 打开设置（Cmd+,）选择提供方：
   • 云端：填入 OpenRouter 与 Voyage AI 的 API Key
   • 本地：LLM 与向量化都选 Ollama（确保 Ollama 正在运行）
   • OpenAI 兼容：向量化选「OpenAI Compatible」，指向任意 /v1/embeddings 接口
4. 指向一个存放 .md 或 .txt 文件的文件夹，这就是你的知识库
5. 点 Idle 开始工作

首次运行会下载本地语音模型（约 600 MB）。

环境要求

• Apple Silicon Mac，macOS 14.2（Sonoma）或更高版本
• 仅源码构建需要：Xcode 26 / Swift 6.2；使用发布版 App 不需要 Xcode
• 云端模式：OpenRouter API Key + Voyage AI API Key
• 本地模式：Ollama 本地运行，并准备所需模型（例如建议用 qwen3:8b、向量用 nomic-embed-text）
• OpenAI 兼容向量化：任何实现了 /v1/embeddings 的服务（llama.cpp、llamaswap、LiteLLM、vLLM 等）

Parakeet 与 Whisper 转写在 macOS 14.2+ 可用；Qwen3 ASR 需要 macOS 15+，只在受支持的系统上提供。在 Sonoma 上选定 Qwen3 会回落到 Parakeet v2。加入会议后再开始录制，并选择真正承载通话音频的输出设备（使用耳机或外接显示器时尤其注意）。

从源码构建

# 完整构建 → 签名 → 安装到 /Applications
./scripts/build_swift_app.sh

# 仅开发构建
cd OpenOats && swift build -c debug

# 打包 DMG
./scripts/make_dmg.sh

代码签名与公证可选环境变量：CODESIGN_IDENTITY、APPLE_ID、APPLE_TEAM_ID、APPLE_APP_PASSWORD。

注意事项

录制同意与法律声明：OpenOats 会录制并转写你的麦克风与系统音频。许多司法辖区要求在录制对话前取得部分或全部参与者的同意（例如美国的双方/全员同意州、欧盟的 GDPR）。你需要自行确认录制在当地是否合法，并在开始会话前取得所有参与者所需的同意。开发者不提供法律建议，也不对使用本软件进行未经授权录制承担责任。首次录制前应用会要求你确认这些义务。

关于隐私：语音始终在本机通过 Apple Speech 转写，音频不会离开你的 Mac。在云端模式下，只有文本会外发——知识库分块会发给 Voyage AI（或你选择的 OpenAI 兼容接口）做向量化，对话上下文会发给 OpenRouter 生成建议；API Key 存放在 macOS 钥匙串中；转写内容保存在本地 ~/Documents/OpenOats/。使用 Ollama 的全本地模式则完全不联网。

---

本作品整理自 GitHub 开源项目 yazinsai/OpenOats，原作者 @yazinsai，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。