Petal：macOS 菜单栏语音转写

项目简介

Petal 是一款原生 macOS 菜单栏应用，主打快速、本地优先的音频转写，界面干净简洁。项目使用 Swift 与 SwiftUI 编写，以 MIT 许可证开源。README 中还提供了 Windows 版本与 iOS 版本的下载入口，本仓库本身面向 macOS。

主要功能

• 菜单栏常驻，随时开始转写，无需切换窗口。
• 本地整理模型 Petal W1：从 Qwen3.5-2B 微调而来，可在约 0.2 秒内把啰嗦的听写整理成你真正想说的简短消息，并保留你自己的语气。README 给出的对比数据中，Petal W1 v1.4 在 120 条真实听写上的无错误输出为 47%，每条听写的语义错误为 0.56，长段啰嗦内容的压缩比例为 55%。
• 云模型整理：可使用自己的 OpenAI、Anthropic 或 OpenRouter 密钥，也可接入任何 OpenAI 兼容服务，例如 Ollama、LM Studio。在 Settings > Intelligence 中选择 Cloud Model 即可。
• 预设与自定义提示词：内置 Clean Up、Email、Notes、Professional、AI Prompt、Assistant 等预设，也可以自己写 system prompt，并在 Try It 中测试效果。
• 变量填充：提示词中可插入 {{name}}、{{first_name}}、{{app}}、{{window}}、{{language}}、{{region}}、{{time_zone}}，由 Petal 在 Mac 上实时填入。
• 日期与时间：开启后可以把「下周五」这类说法换算成具体日期。
• 联网搜索：开启 Web Search 后，模型可以查询你要求的事实信息。
• 屏幕上下文：开启 Screen 后，每次听写会附带一张屏幕截图，帮助模型拼写屏幕上出现的名字、理解「这个」指代什么。
• 按应用路由：在 Settings > Router 中，可以为每个应用或网站单独指定使用的智能能力（Apple Intelligence、Petal W1 或 Cloud Model），而不必沿用默认设置。
• 隐私：密钥保存在 macOS 钥匙串中，转写文本（以及在开启 Screen 时的截图）只会发送给你选择的提供商。

安装与使用

1. 从 Releases 下载最新的 Mac 版本并安装。
2. 在菜单栏中打开 Petal 开始听写与转写。
3. 如需使用云端整理，进入 Settings > Intelligence，选择 Cloud Model 并填入自己的密钥或 OpenAI 兼容服务地址。
4. 如需按应用区分处理方式，进入 Settings > Router 为不同应用或网站配置路由。

注意事项

• Screen（屏幕截图）功能需要授予屏幕录制权限，并且不适用于自定义服务器。
• 云模型功能需要自备 API 密钥或可访问的 OpenAI 兼容服务。
• 仓库同时存在 Windows 与 iOS 版本，但它们不在本仓库中，功能与安装方式请以对应页面为准。

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