为什么Quill值得一试：一次点击搞定会议录音，自动产出带时间戳的对话纪要-开发者社区

为什么Quill值得一试：一次点击搞定会议录音，自动产出带时间戳的对话纪要

【免费下载链接】quillUltra-minimalist macOS recording + transcription.项目地址: https://gitcode.com/gh_mirrors/quill26/quill

Quill 是一款完全本地运行的 macOS 会议录音转写工具：菜单栏点一下开始录音，会议结束后自动在本机把语音转成文字，生成一份**带时间戳、区分「我 / 对方」**的 Markdown 会议纪要。全程不上传任何数据，适合在意隐私、又想要会后快速拿到纪要的人。

Quill 是什么：极简的本地录音转写工具 🪶

Quill 的 macОS 版是一个单文件 Swift 程序，没有 Dock 图标、没有主窗口，只有一个常驻菜单栏的羽毛图标，是名副其实的"极简"。

它的核心设计有 3 点：

双轨录音：麦克风（me）和系统外放/耳机播放的对方声音（them）分开录成两条音轨；
本地转写：使用 Parakeet TDT 0.6B v2 引擎（通过 Core ML 运行），在 Apple Silicon 上大约20 秒转写 1 小时音频；
说话人标注免费送：正因为分成 mic 和 system 两轨，转写后天然就是"我说了什么 / 对方说了什么"，不需要额外的说话人分离模型。

为什么分两轨？语音模型在干净的单源音频上表现更好，而且"麦克风 vs 系统音"就是免费的双方说话人识别。

项目整体思路可以在 docs/architecture.md 中查看，macOS 版完整说明见 macos/README.md。

一键会议录音：完整使用流程

整个流程只有 3 步，几乎零学习成本：

点击菜单栏羽毛图标 →Start recording（首次使用会请求麦克风和系统音频录制权限）；
录音中图标变红并显示计时；如遇到音频路由切换正在自动恢复，图标会变橙色提醒；
会议结束点击Stop recording，转写自动开始，完成后弹出通知。

每次会议会自动归档到一个按时间命名的文件夹~/Recordings/<yyyy.MM.dd-HHmm>/：

文件	内容
`mic.caf`	你自己这一侧的声音（AAC）
`system.caf`	Mac 播放的一切声音，即"对方"（AAC）
`meta.json`	起止时间、时长、分段与采集状态
`transcript.json`	规范版转写结果（时间轴 + 说话人标签）
`transcript.md`	可直接阅读的带时间戳纪要
`transcribe.log`	本次转写进度/错误日志

选 CAF 格式有个小细节：它不需要"收尾封包"，即使会议中途进程意外退出，已写入的音频也依然可读，不会白录。

带时间戳的对话纪要是怎么自动生成的 ⏱️

停止录音后，Quill 会进入转写流水线：

两条音轨分别独立转写，再按各自的起始偏移对齐到同一条会话时钟上；
按时间戳合并成一份me/them交替出现的纪要，录音缺口会如实体现在时间戳空隙里；
任务走串行队列，上一场还在转写时就能开始录下一场；
文件系统本身就是队列：有meta.json但没有transcript.json的会话，下次启动会自动补转，崩溃也不丢任务。

这套逻辑实现在 TranscriptionCoordinator.swift，引擎与协调器分别位于 Transcription/ 目录。

断线不断录：录音中断自动恢复

长时间会议里，摘下/戴上 AirPods、切换默认音频设备，都可能让系统悄悄停止某条音轨的采集。Quill 内置了守护机制（每秒检查回调进度 + 监听路由变化），发现某轨停顿时会自动在当前路由上重新开始采集，并写入新的分段文件（如mic-002.caf），已录内容绝不被改动。

停止录音时会得到明确的最终状态：

complete：全程无中断；
recovered：发生过中断但已恢复，缺口可见、依然可用；
incomplete：无法恢复，会话会标记提醒。

这些细节都记录在会话的meta.json（schema v2）里，可随时事后审查。相关修复与实现可参考 CHANGELOG.md 和 RecordingSession.swift。

隐私：录音和转写都不离开这台电脑 🔒

这是 Quill 最"值得一提"的地方：

录音、转写全部在设备上完成，没有任何云上传；
转写模型（约 600 MB）只在首次转写时下载一次，之后永久离线可用；
运行quill doctor可随时自检权限、录音目录和模型缓存状态，重要会议前跑一遍更安心。

自检命令的实现见 Doctor.swift。

安装步骤与快速配置

要求macOS 15+，Apple Silicon 推荐（转写更快）：

git clone https://gitcode.com/gh_mirrors/quill26/quill cd quill ./scripts/build-macos sudo ./scripts/install-macos quill install --launch-at-login # 可选：登录后后台自启

安装脚本逻辑很简单，可参考 install-macos。

可选配置写在~/.config/quill/config.json（示例见 macos/README.md），常用项：

recordings_dir：录音存放目录（默认~/Recordings）；
transcription.enabled：设为false则只录音不转写；
mic_voice_processing：开扬声器的会议建议开启回声消除，戴耳机则保持默认关闭；
on_stop：纪要写完后自动执行的命令，可接摘要、归档、索引等后续流程。

配置解析在 Config.swift。

平台支持情况一览

平台	状态	说明
macOS 15+	✅ 可用	完整菜单栏应用 + 本地转写
Windows 11	🔬 采集探针阶段	已完成 WASAPI 麦克风 + 进程回环采集探针，见 windows/README.md
Linux	📝 规划中	PipeWire 采集探针方案，见 linux/README.md

各平台是独立的原生实现，共享会话目录、纪要格式和行为契约（详见架构决策 ADR-001）。