yap：macOS 26 上的终极本地语音转写 CLI 工具，完全无需联网！

【免费下载链接】yap 🗣️ A CLI for on-device speech transcription using Speech.framework on macOS 26 项目地址: https://gitcode.com/gh_mirrors/yap6/yap

yap 是一款专为 macOS 26 设计的命令行语音转写工具，它利用系统内置的 Speech.framework 实现完全本地的语音识别功能，无需联网即可快速将音频转换为文本。无论是会议记录、语音笔记还是灵感捕捉，yap 都能为你提供高效、安全的语音转写体验。

🌟 核心优势：本地处理，安全高效

作为一款专注于本地语音转写的 CLI 工具，yap 带来了三大核心优势：

• 完全离线运行：所有语音处理均在本地完成，无需上传音频数据，保护你的隐私安全
• 低延迟响应：依托 macOS 原生 Speech.framework，实现毫秒级语音识别响应
• 轻量无依赖：纯命令行工具，无需安装庞大的语音模型，不占用额外系统资源

🚀 快速开始：简单三步上手

1️⃣ 安装准备

确保你的设备运行 macOS 26 或更高版本，然后通过以下命令克隆项目：

git clone https://gitcode.com/gh_mirrors/yap6/yap
cd yap

2️⃣ 构建项目

使用 Swift Package Manager 构建项目：

swift build -c release

构建完成后，可执行文件将位于 .build/release/yap 路径下。

3️⃣ 基本使用

最简单的语音转写命令：

yap transcribe

运行后，yap 将开始监听麦克风输入，完成录音后自动生成文本输出。

💡 实用功能详解

🎙️ 实时听写模式

通过 dictate 命令启用实时听写功能，边说边转换为文本：

yap dictate

此模式特别适合会议记录或灵感捕捉，语音输入将实时转换为文本并显示在终端中。

📂 音频文件转写

yap 支持处理本地音频文件，目前支持常见的音频格式：

yap transcribe --file path/to/audio.wav

📋 输出格式定制

通过 --format 参数指定输出格式，支持纯文本、JSON 等多种格式：

yap transcribe --format json

相关配置可在 Sources/yap/OutputFormat.swift 文件中查看详细实现。

🛠️ 技术架构概览

yap 的核心功能实现集中在以下几个关键文件：

• 语音引擎：Sources/yap/TranscriptionEngine.swift - 封装 Speech.framework 的核心识别逻辑
• 命令处理：Sources/yap/Yap.swift - 解析和处理 CLI 命令
• 音频录制：Sources/yap/Listen.swift - 麦克风音频捕获实现

❓ 常见问题

Q: yap 支持哪些语言？
A: 默认支持系统已安装的所有语音识别语言，可通过 macOS 系统设置添加更多语言包。

Q: 转写 accuracy 如何？
A: 依托 Apple 的 Speech.framework，识别准确率与 Siri 相当，日常对话场景识别率可达 95% 以上。

Q: 是否支持长音频文件处理？
A: 目前建议处理时长不超过 5 分钟的音频文件，过长可能导致内存占用增加。

📚 学习资源

• 项目源代码：Sources/yap/
• 命令参考：通过 yap --help 查看所有可用命令
• 扩展开发：Sources/yap/Extensions/ 目录包含可扩展功能示例

yap 作为一款轻量级本地语音转写工具，为 macOS 用户提供了隐私安全、高效便捷的语音处理解决方案。无论是开发者还是普通用户，都能轻松利用命令行体验强大的语音识别功能。立即尝试，开启你的本地语音转写之旅吧！

【免费下载链接】yap 🗣️ A CLI for on-device speech transcription using Speech.framework on macOS 26 项目地址: https://gitcode.com/gh_mirrors/yap6/yap