企业官网建设流程全解析

Quill CLI命令大全：doctor、install、run参数详解，新手也能玩转命令行

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

Quill 是一款完全在本地运行的 macOS 会议录音 + 语音转写工具：它把麦克风（你）和系统声音（对方）录成两条独立音轨，并在设备上用本地模型自动转写成带时间戳的"我 / 对方"文字稿，全程不上传任何数据。本文带你逐个吃透quill的三条核心命令——doctor体检、run启动、install开机自启，以及--out等常用参数，哪怕你是命令行小白也能快速上手。

🧭 先认识 Quill：一条命令，三种用途

整个 CLI 只封装在一个 Swift 可执行文件里（Quill.swift），默认行为是"直接启动录音守护进程"，因此quill本身就是一个命令：

quill # 等价于 quill run，启动菜单栏守护进程（^C 退出） quill run --out <dir> # 启动，并自定义录音保存根目录 quill doctor # 体检：麦克风、系统声音、录音目录、转写模型 quill install --launch-at-login # 登录时自动启动 quill install --uninstall # 移除开机自启

🚀 一步到位安装：从源码到 quill 命令

Quill 要求macOS 15+，推荐 Apple Silicon（转写速度更快）。先克隆仓库再执行构建与安装脚本：

</输出文章>

我注意到文章需要完整输出，以下是完整版本：

<输出文章>

Quill CLI命令大全：doctor、install、run参数详解，新手也能玩转命令行

Quill 是一款完全在本地运行的 macOS 会议录音 + 语音转写工具：它把麦克风（你）和系统声音（对方）录成两条独立音轨，并在设备上用本地模型自动转写成带时间戳的"我 / 对方"文字稿，全程数据不离开电脑。本文带你逐个吃透quill的三条核心命令——doctor体检、run启动、install开机自启，以及--out等常用参数，命令行小白也能快速上手。

🧭 先认识 Quill：一条命令，三种用途

整个 CLI 只封装在一个 Swift 可执行文件里（Quill.swift），默认行为是"直接启动录音守护进程"，所以裸敲quill就等价于quill run：

quill # 启动菜单栏守护进程（^C 退出） quill run --out <dir> # 启动，并自定义录音保存根目录 quill doctor # 体检：麦克风、系统声音、录音目录、转写模型 quill install --launch-at-login # 登录时自动启动 quill install --uninstall # 移除开机自启

🚀 一步安装：从源码到 quill 命令

先克隆仓库，再执行构建与安装脚本（需要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 # 可选

安装脚本 scripts/install-macos 会把 release 二进制装到/usr/local/bin/quill（可用环境变量QUILL_INSTALL_DIR覆盖目标目录）。装完后敲quill即可看到菜单栏出现羽毛图标，点击即可Start recording。

🩺 quill doctor：开会前的 30 秒体检

quill doctor是最值得养成的习惯：它会跑一遍 Doctor.swift 里的四项检查，用✓ / ! / ✗标出每项状态，失败项还会附一行修复建议。

两点小提醒：

• !（警告）不阻断启动，只有✗（硬失败，比如麦克风被拒绝）才会让doctor以退出码 1 结束；
• 录出来是静音时，去 系统设置 → 隐私与安全性 →屏幕与系统音频录制里给 quill 授权（或给你的终端授权）。

▶️ quill run：启动菜单栏录音守护进程

quill run是默认子命令。启动时它会先自动跑一遍 doctor 检查（Quill.swift），有硬失败就打印startup checks failed并退出，避免你带病开会；通过后输出类似：

quill up · recordings → /Users/you/Recordings · ^C to quit

随后进入菜单栏模式：录音中图标变红并显示计时，点Stop recording后自动开始转写，完成后系统通知你，文字稿落在会话目录里。

--out 参数：换个地方存录音

每次会话都会落到~/Recordings/<yyyy.MM.dd-HHmm>/（如mic.caf、system.caf、meta.json、transcript.md）。想换位置就用--out：

quill run --out ~/Meetings/2026

解析优先级是--out命令行 > 配置文件 >~/Recordings，逻辑见 Config.swift。

⚙️ quill install：一键登录自启与卸载

不想每次手动敲命令？quill install --launch-at-login会写一个 LaunchAgent（plist 位于~/Library/LaunchAgents/com.digimata.quill.plist）并通过launchctl bootstrap立即加载（Install.swift），之后每次登录 quill 都在后台待命，退出后自动拉起，日志写在/tmp/quill.out.log与/tmp/quill.err.log。

不想自启了？一行命令彻底移除：

quill install --uninstall

⚠️ 两个参数必须二选一，同时给或都不给都会报specify exactly one of ...（退出码 64）。

📄 补充：与 CLI 配合的配置文件

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

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

• recordings_dir：与--out等效的持久化目录设置；
• transcription.enabled设为false可只录音不转写；
• on_stop：转写完成后自动执行的 shell 命令，参数是本次会话目录，方便接归档、摘要等自动化。

🧯 新手常见问题速查

小结

记住三句话就够了：开会前quill doctor体检，平时quill（或install --launch-at-login）后台待命，想换录音目录就quill run --out <dir>。Quill 的命令行极简却完整，配合 macos/README.md 的完整文档和 docs/architecture.md 的架构说明，从入门到自动化都能一路走通。

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