macOS 纯本地语音转文字 yap：文件转录、系统音频与会议记录

yap 是一款专为 macOS 26 设计的命令行语音转文字工具，基于 Apple 自带的 Speech.framework 实现完全本地化的设备端处理。无需联网即可将音视频文件转录为文本，同时支持实时捕获系统音频与麦克风输入，适用于会议记录、字幕生成等场景，还内置了 MCP 服务器供 AI 代理调用。

核心亮点

• 纯本地运行：依赖 macOS 26 的 Speech.framework，所有转录均在设备上完成，无隐私泄露风险。
• 四大子命令：
  • transcribe：转录本地音频或视频文件；
  • listen：实时捕获系统正在播放的音频；
  • dictate：实时录制麦克风输入；
  • listen-and-dictate：系统音频与麦克风双路同时转录，专为会议场景设计。
• 自定义发言者标签：在 listen-and-dictate 会议模式下，可用 --mic-label 和 --system-label 分别标记麦克风与系统音频的发言者（默认为 Mic 和 System）。
• 丰富的输出格式：支持 --txt（纯文本）、--srt（字幕）、--vtt（WebVTT 字幕）、--json（结构化数据）四种格式，并通过 --word-timestamps 在 JSON 中获取词级时间戳。还可使用 --max-length（或 -m）限制时间轴格式中的单句最大字符数（默认 40 字符）。
• 灵活的输出管道：默认输出到 stdout，配合 -o 可写入文件，也能直接通过管道对接其他 CLI 工具（例如 llm）。
• 语言控制与审查：--locale 指定转录语言，--censor 可自动过滤敏感词。
• MCP 集成：内置 MCP 服务器（yap mcp），可作为工具被 Claude Code、Codex 等 MCP 兼容的 AI 代理调用。
• 实用组合场景：支持与 yt-dlp 联动转录 YouTube 视频、与本地 LLM 协同生成摘要、输出视频字幕文件等。

安装与使用

安装方式：

# Homebrew
brew install yap

# Mint
mint install finnvoor/yap

基本使用示例：

# 转录视频/音频文件
yap transcribe video.mp4

# 生成 SRT 字幕
yap transcribe video.mp4 --srt -o captions.srt

# 实时转录系统音频
yap listen

# 会议转录（系统音频 + 麦克风）
yap listen-and-dictate --vtt > meeting.vtt

# 麦克风听写
yap dictate > notes.txt

项目由 Finn Voorhees (finnvoor) 开发，采用 CC0-1.0（Creative Commons Zero） 协议开源，当前已获得 1.6k Stars。

项目地址：https://github.com/finnvoor/yap

更多此类实用开发者工具，欢迎来云栈社区交流。