Quill CLI命令大全doctor、install、run参数详解新手也能玩转命令行【免费下载链接】quillUltra-minimalist macOS recording transcription.项目地址: https://gitcode.com/gh_mirrors/quill26/quillQuill 是一款完全在本地运行的 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 runquill # 启动菜单栏守护进程^C 退出 quill run --out dir # 启动并自定义录音保存根目录 quill doctor # 体检麦克风、系统声音、录音目录、转写模型 quill install --launch-at-login # 登录时自动启动 quill install --uninstall # 移除开机自启 一步安装从源码到 quill 命令先克隆仓库再执行构建与安装脚本需要macOS 15推荐 Apple Silicongit 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 里的四项检查用✓ / ! / ✗标出每项状态失败项还会附一行修复建议。检查项含义常见结果microphone麦克风权限已授权 ✓未触发过请求 !被拒绝 ✗system audio系统声音录制权限首次使用前状态不可知始终提示 !recordings folder录音目录可写自动创建目录不可写则 ✗transcription转写模型是否已缓存未下载约 600 MB时提示 !首次转写会自动下载两点小提醒!警告不阻断启动只有✗硬失败比如麦克风被拒绝才会让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。想换位置就用--outquill run --out ~/Meetings/2026解析优先级是--out命令行 配置文件 ~/Recordings逻辑见 Config.swift。⚙️ quill install一键登录自启与卸载不想每次手动敲命令quill install --launch-at-login会写一个 LaunchAgentplist 位于~/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 命令参数是本次会话目录方便接归档、摘要等自动化。 新手常见问题速查现象处理doctor显示 microphone ✗系统设置 → 隐私与安全性 → 麦克风 → 为 quill或你的终端开启录音是静音检查屏幕与系统音频录制权限启动时报startup checks failed按终端输出的建议逐项修复再跑一次quill doctor转写时突然下载大文件约 600 MB 的 Parakeet 模型首次自动下载提前跑一次quill doctor可确认已缓存想彻底停用自启quill install --uninstall小结记住三句话就够了开会前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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考