Meeting Transcriber：在 macOS 本地完成会议记录

整理会议纪要，不应该先把整场会议交给第三方的在线面板。Meeting Transcriber 选择了更直接的路径：在 Mac 上检测会议，分别采集应用音频和麦克风，使用本地模型完成转写与说话人分离，最后写出结构化的 Markdown 会议纪要。

这是 pasrom 用 Swift 6.2 编写的 macOS 菜单栏应用，目前版本为 v0.8.1。它不是让机器人加入通话的浏览器录音器，而是一套 local-first 流程：可以用 WhisperKit 或 Parakeet 识别语音，再使用 Claude、Ollama、LM Studio 或其它 OpenAI 兼容服务生成最终纪要。最新版本和变更说明应以项目仓库及项目网站为准。

它能做什么

Meeting Transcriber 可以通过窗口标题监测 Teams、Zoom 和 Webex。Google Meet 等浏览器会议需要用户主动开启检测；对于没有可靠会议信号的通话应用，也可以按应用开启麦克风输入检测。后两种方式默认关闭，因此不会把所有音频应用都当成录音触发器。

录音采用双轨设计：通过 Apple 的 CATap 音频采集路径录制应用声音，同时录制麦克风。这样自己的声音和远端对话保持分离，比一条混合音轨更适合后续标记说话人。WAV、MP3、M4A、MP4、FLAC、AMR、3GP、OPUS 和 OGG 文件也可以进入同一条处理流程；MKV 和 WebM 需要安装 ffmpeg。

转写完成后，FluidAudio 在设备上完成说话人分离，并可以通过语音嵌入匹配已知说话人。最后是会议纪要生成：可以选择 Claude Code CLI、Ollama 或 LM Studio 等 OpenAI 兼容端点，也可以完全不使用生成服务，只保存原始转写。最终 Markdown 包含摘要、参与者、讨论主题、决定、任务和未决问题。

如何安装

pasrom 的 Meeting Transcriber 目前没有官方 App Store 条目。请使用最新 GitHub Release下载 DMG，挂载后将 MeetingTranscriber.app 拖到 Applications。最低要求是 macOS 14.2，因为应用音频采集依赖 CATapDescription；要让本地模型运行得更顺畅，建议使用 Apple Silicon。

# Download the latest DMG:
open https://github.com/pasrom/meeting-transcriber/releases/latest

# Mount it and drag MeetingTranscriber.app to /Applications.

如果习惯 Homebrew，也可以执行 brew tap pasrom/meeting-transcriber，再运行 brew install --cask meeting-transcriber。v0.8.1 的 Release 页面还提供了 SHA256 值。第一次启动时应用会自动下载语音模型，不需要 Hugging Face token。想要完全本地运行时，可以配置 Ollama 或 LM Studio。Claude Code CLI 和 OpenAI 兼容端点也受支持，但要另外确认它们的处理方式和隐私条款。

如何使用

启动应用后，它会常驻菜单栏。检测到支持的会议后，应用会根据目标应用和检测设置开始录音。录制自己的声音需要麦克风权限；静音检测以及读取支持的会议应用中的参与者信息需要辅助功能权限。屏幕录制权限是可选的，用于更准确地获取会议标题，以及在音频采集失败时作为回退路径，但会议检测本身不依赖它。

你也可以不等待自动检测：从菜单手动开始录音，或使用 ⌘P 批量处理已有音频和视频。Record-only 模式只生成双轨录音和元数据 sidecar，跳过录音后的 VAD、转写、说话人分离和纪要生成，适合交给另一台机器继续处理。

Meeting detected
├─ app audio + microphone
├─ 16 kHz mono conversion
├─ WhisperKit / Parakeet
├─ speaker diarization
└─ Markdown protocol via Claude CLI / OpenAI-compatible / none

设置按照实际工作流划分。General 管理监测的应用和 Record-only；Audio 管理麦克风、VAD、分通道静音指示和可选的回声消除；Transcribe 选择 WhisperKit 或 Parakeet、模型、语言、自定义词汇和术语规范化；Speakers 管理说话人分离和已知声音；Output 则设置服务商、纪要语言、转写保留策略、输出文件夹和自定义提示词。

~/Library/Application Support/MeetingTranscriber/protocols/
├─ 20260225_1400_meeting.txt  # raw transcript, when enabled
└─ 20260225_1400_meeting.md   # structured protocol

界面与状态

仓库里的 Hero 动画把整个过程串了起来：会议被采集，音频经过本地转写，结果变成 Markdown 纪要。菜单栏图标本身也是状态指示器，动画波形会在 Idle、Recording、Transcribing、Diarizing 和 Protocol 之间变化；如果缺少权限或开启 Record-only，图标上还会显示对应的提示标记。

它在底层如何工作

最重要的架构选择是把两路输入分开。CATap 负责应用音频，麦克风单独录制；两条路径会先统一转换成 16 kHz 单声道，再交给语音引擎。这样实时录音和导入文件可以复用同一条流水线，同时保留足够的分离信息来判断谁说了什么。

WhisperKit 是覆盖语言更广的选项，支持 99 种以上语言，模型约 1 GB。Parakeet TDT v3 约 50 MB，面向 25 种欧洲语言，README 将它描述为大约快 10 倍。之后由 FluidAudio 通过 CoreML/ANE 完成说话人分离，既有标准模式，也有适合多人同时讲话的 Sortformer 模式。

仓库与 Releases

GitHub 仓库包含 Swift 应用、模型和音频处理代码，也提供自动化 API、Stream Deck 控制的文档以及发布工作流。Homebrew 构建还带有本地 Automation API：脚本可以把音频文件提交到本机并得到已分离说话人的转写，不需要把菜单栏应用变成云端服务。

这次核对的版本是 v0.8.1。发布说明包含 About 设置页、异常退出和输出目录不可用时的提示、辅助功能诊断、说话人名称字段修复，以及签名和 TCC 相关修复。仓库还记录了 CI 中的单元测试、lint 和分析任务，并提供在 Apple Silicon 上使用真实模型运行的 E2E 以及驱动真实应用的会议模拟测试。

安装前可以核对什么

稳妥的安装流程很简单：从v0.8.1 Release 页面开始，用页面公布的 SHA256 校验 DMG，确认系统为 macOS 14.2 或更新版本，并为所选模型预留空间。还要先决定纪要服务商使用本地还是远程端点，只授予录音模式真正需要的权限。安装后可以在 Advanced 设置中查看权限状态和诊断信息。

它的限制

本地处理也有首次运行成本。WhisperKit 模型大约 1 GB，Parakeet 更小；转写和说话人分离运行时会使用 Mac 的 CPU、GPU 或 Neural Engine。项目目标是 macOS 14.2 及以上，旧系统或旧 Mac 并不存在一个隐藏的、受支持的应用音频采集路径。

自动检测有意保持谨慎，也会受到权限影响：会议应用的窗口标题可能无法识别，辅助功能授权可能在 macOS 中失去同步，导入文件也可能缺少有效音轨。应用可以检测并报告扬声器回声，提供可选的回声消除和转写去重，但嘈杂房间里不可能保证完美的说话人归属。

“本地优先”也有明确边界。录音、转写和说话人分离可以留在 Mac 上，服务商也可以关闭；但如果使用 Claude Code CLI 或远程 OpenAI 兼容端点生成纪要，转写内容或提示词可能根据服务商的行为离开设备。对严格禁止上传的会议，应使用 Ollama 或 LM Studio，并在录音前检查输出设置。

许可证：可以怎么用

Meeting Transcriber 采用 MIT 许可证。你可以检查、修改并复用应用代码，也可以把它用于商业或闭源软件，只要再分发实质代码时保留版权和许可证声明。不要求你公开自己的修改。

这项许可只针对仓库代码，不会自动覆盖所有模型、依赖、服务或录音。WhisperKit、FluidAudio、下载的模型文件、Claude Code、OpenAI 兼容服务和 ffmpeg 都有各自的条件。录制会议还需要遵守参与者以及录音地点适用的告知和同意规则。

值得安装吗

如果你想整理会议纪要，又不想把每段音频都交给 SaaS 录音服务，Meeting Transcriber 是一个定位清晰的 macOS 选择。先从签名的GitHub Release DMG开始：需要更广语言覆盖时用 WhisperKit，需要小而快的模型时用 Parakeet；如果隐私是首要条件，就把纪要生成也保持在本地。这样从录音到 Markdown 的完整路径都能在自己的 Mac 上配置和检查。

# Download the latest DMG:
open https://github.com/pasrom/meeting-transcriber/releases/latest

# Mount it and drag MeetingTranscriber.app to /Applications.