Quill快速开始指南：从菜单栏羽毛图标到第一份转写文稿只需3步

Quill快速开始指南从菜单栏羽毛图标到第一份转写文稿只需3步【免费下载链接】quillUltra-minimalist macOS recording transcription.项目地址: https://gitcode.com/gh_mirrors/quill26/quillQuill是一款超极简的macOS 本地录音转写工具点一下菜单栏的羽毛图标即可开始录音它会把你的麦克风和系统音频对方说话的声音录成两条独立音轨停止后在设备本地自动转写生成带时间戳、区分me/them说话人的transcript.md会议纪要——所有数据都不离开你的电脑。本指南带你完成安装并用 3 步拿到第一份转写文稿。一、30秒了解 Quill为什么本地转写值得用完全本地录音、转写全在设备内完成会议内容不上传任何云端️双轨录音麦克风我和系统音频对方分开录制天然实现两方说话人分离无需语音识别模型区分身份⚡转写飞快Apple Silicon 上每小时音频约 20 秒即可转写完成输出友好每个会话生成可读的 Markdown 文稿 标准 JSON直接用于笔记或二次处理要求macOS 15建议使用 Apple Silicon 机型以获得最佳转写速度。二、一键安装步骤3 条命令完成 macOS 部署获取代码git clone https://gitcode.com/gh_mirrors/quill26/quill cd quill构建并安装到/usr/local/bin./scripts/build-macos sudo ./scripts/install-macos可选设置开机后台自启quill install --launch-at-login安装脚本 scripts/install-macos 会把编译好的quill二进制装入系统路径安装后即可在终端运行quill启动菜单栏守护进程。平台细节可参考 macos/README.md。三、3 步拿到第一份转写文稿第 1 步点击菜单栏羽毛图标 → Start recording启动quill后菜单栏会出现一个羽毛图标实现见 macos/Sources/quill/UI/MenuBarController.swift。点击它选择Start recording首次使用会弹出麦克风和系统音频录制两个权限请求都点允许录音中图标变红并显示运行中的计时如● recording · 28:11macOS 右上角同时出现紫色录制指示点第 2 步会议结束 → Stop recording转写自动开始点击羽毛图标选择Stop recording。转写任务自动排队执行菜单栏会显示进度转写完成时弹出一条通知——你可以直接开下一场会的录音互不阻塞。第 3 步打开 transcript.md查看 me/them 文稿每个会话落在~/Recordings/yyyy.MM.dd-HHmm/目录核心文件如下文件内容mic.caf你这一侧的录音AACsystem.caf电脑播放的全部内容——即对方AACtranscript.md 带时间戳、区分 me/them 的可读文稿transcript.json标准结构化转写结果含引擎信息与分段时间meta.json会话起止时间、音轨段与录音完整性状态transcribe.log本次转写的进度/错误日志打开transcript.md就是你要的第一份转写文稿 ✅四、进阶配置让 Quill 更贴合你的工作流可选配置文件位于~/.config/quill/config.json解析逻辑见 macos/Sources/quill/Config.swiftrecordings_dir自定义录音存放目录默认~/Recordingstranscription.enabled设为false只录音不转写mic_voice_processing用扬声器开会时建议设true开启回声消除避免对方声音被二次录进我的轨道on_stop转写完成后自动执行的 shell 命令以会话目录为参数可接摘要、归档等流程常用 CLI 命令quill # 运行菜单栏守护进程^C 退出 quill run --out dir # 指定自定义录音根目录 quill doctor # 自检权限、录音目录、模型缓存 quill install --uninstall # 卸载默认转写引擎为Parakeet TDT 0.6B v2英语Core ML 端侧运行见 macos/Sources/quill/Transcription/ParakeetEngine.swift模型约 600MB首次转写时下载一次quill doctor可确认模型是否已缓存。五、常见问题录音静音或转写失败怎么排查现象排查方法录音是静音的检查 系统设置 → 隐私与安全性 → 屏幕与系统音频录制 权限自检逻辑见 macos/Sources/quill/Doctor.swift转写结果只有英文Parakeet v2 目前仅支持英语多语言将由后续 Whisper 引擎带来文稿里有杂音提示音、音乐全局系统音轨会录下 Mac 播放的一切开会时避免放音乐想确认录音完整性运行quill doctor查看会话目录meta.json中各轨道statuscomplete/recovered/incomplete小结从克隆仓库到打开第一份transcript.mdQuill 只需装 3 条命令 → 点羽毛开始录 → 停止后等通知。全程本地、零配置即可上手会议纪要从此不再依赖云端。多平台架构与共享契约详见 docs/architecture.md版本演进记录见 CHANGELOG.md。【免费下载链接】quillUltra-minimalist macOS recording transcription.项目地址: https://gitcode.com/gh_mirrors/quill26/quill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考