企业官网建设流程全解析

3分钟上手Quill：Mac本地会议录音转写工具完整安装教程

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

Quill 是一款专为 macOS 打造的本地会议录音转写工具：它把麦克风声音和系统播放的声音分成两条独立音轨录制，会议结束后自动在设备上用 AI 转写成带时间戳的"我/对方"字幕稿。全程不联网上传，录音和文字永远只留在你的 Mac 上——这是它和其他云端录音转写工具最大的区别。本文带你用 3 分钟完成 Quill 录音转写工具的完整安装，并快速跑通第一次会议转写。

Quill 是什么？为什么适合本地会议录音

Quill 的定位是"极简 + 全本地"的会议录音转写器，核心特点有三点：

• 🎙️双轨录音：麦克风轨（me）记录你说的话，系统音频轨（them）记录对方说的话，天然完成"说话人分离"，无需复杂的声纹识别模型；
• ⚡设备端转写：内置 Parakeet TDT 0.6B v2 引擎（基于 Core ML），在 Apple Silicon 上约 20 秒转写一小时音频，模型约 600 MB，只在首次转写时下载一次；
• 🔒隐私优先：录音、转写、存储全部在本地完成，"Nothing leaves the machine"。

项目官方说明见 README.md，macOS 版完整文档见 macos/README.md。

环境要求：macOS 15 及以上版本，推荐使用 Apple Silicon 机型以获得更快的转写速度。

Quill 安装步骤：3条命令完成配置

安装过程非常简单，在终端中依次执行：

# 1. 克隆仓库 git clone https://gitcode.com/gh_mirrors/quill26/quill cd quill # 2. 构建 macOS 版本 ./scripts/build-macos # 3. 安装到系统目录（需要管理员权限） sudo ./scripts/install-macos

可选第 4 步——让 Quill 开机自动在后台运行：

quill install --launch-at-login

几点说明：

• 安装脚本 scripts/install-macos 会把编译好的二进制文件拷贝到/usr/local/bin/quill，之后在任意终端直接输入quill即可运行；
• 如果你遇到"release binary not found"提示，说明还没有执行第 2 步构建，先运行./scripts/build-macos再安装即可；
• 也可以不用安装脚本，直接在仓库里用cd macos && swift build -c release进行开发式构建。

第一次使用：一键录音与自动转写

安装完成后，使用流程只有三步：

1. 启动 Quill：终端输入quill（或依赖开机自启），菜单栏会出现一个"羽毛"图标；
2. 点击羽毛图标 → Start recording：首次使用会弹出麦克风和系统音频录制权限请求，点击允许。录音期间图标变红并显示计时，macOS 右上角也会出现紫色录制指示灯；
3. 会议结束 → Stop recording：转写自动开始，菜单栏显示进度，字幕稿写好后会推送通知。

每场会议会自动生成一个带时间戳的文件夹：~/Recordings/<yyyy.MM.dd-HHmm>/。

💡 一个贴心的设计：如果录音中途断开（比如连接/断开 AirPods），Quill 会自动恢复录音并写入新的分段文件（mic-002.caf等），已录好的音频绝不会被改动。

常用命令与自检：quill doctor

Quill 提供了一组简洁的命令行子命令，最常用的是quill doctor——它会检查麦克风权限、系统音频权限、录音目录和转写模型是否就绪，并给出修复建议（实现逻辑在 macos/Sources/quill/Doctor.swift）：

quill # 启动菜单栏常驻程序（^C 退出） quill doctor # 检查权限、录音目录、模型 quill run --out <目录> # 指定自定义录音根目录 quill install --launch-at-login quill install --uninstall # 卸载开机自启

建议在有重要会议前先跑一次quill doctor，确认转写模型已缓存，避免关键时刻临时下载。

进阶配置：改录音位置与关闭自动转写

配置文件是可选的，位于~/.config/quill/config.json（读取逻辑见 macos/Sources/quill/Config.swift）：

{ "recordings_dir": "~/Recordings", "transcription": { "enabled": true, "engine": "parakeet" }, "mic_voice_processing": false, "on_stop": "my-hook" }

• recordings_dir：录音存放位置；
• transcription.enabled：设为false就只录音不转写；
• mic_voice_processing：用扬声器开会的建议设为true，开启苹果回声消除，避免对方声音被录进你的麦克轨而"重复转写两遍"；
• on_stop：字幕稿生成后自动执行的命令，方便接上自动总结、归档等流程。

常见问题排查（Gotchas）

• 录出来是静音？检查"系统设置 → 隐私与安全性 → 屏幕与系统音频录制"，确认已授权 Quill（或你的终端）；
• 转写只支持英文？当前默认引擎 Parakeet v2 仅支持英语，多语言将随 Whisper 引擎支持；
• 系统音频轨会录下"所有播放声"：全局录制会包含通知提示音、音乐等，开会期间尽量不要播放 Spotify 之类的音乐；
• 想卸载开机自启：执行quill install --uninstall即可。

多平台支持现状

Quill 采用"一个仓库、各平台原生独立实现"的架构（设计决策见 docs/architecture.md 与 docs/decisions/001-multiplatform-repository.md）：

总结

3 条命令完成安装，3 次点击跑通第一场会议转写——这就是 Quill 作为 Mac 本地会议录音转写工具的全部门槛。双轨录音 + 设备端 AI 转写 + 隐私不出本机，让它成为远程办公场景下非常趁手的选择。安装完成后，建议先录一段测试会议验证~/Recordings中的transcript.md输出，然后就可以安心投入工作了。

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