Quill排障清单录音没声音、权限不生效的6个高频问题逐一解决【免费下载链接】quillUltra-minimalist macOS recording transcription.项目地址: https://gitcode.com/gh_mirrors/quill26/quillQuill 是一款极简的 macOS 本地会议录音 转写工具它把麦克风和系统音频分成两条独立轨道录制停录后在本地自动转写出带时间戳、区分「我 / 对方」的会议纪要全程不联网。本文整理 6 个高频排障问题录音没声音、麦克风权限不生效、转写不启动等帮你快速定位并解决。先做一步用 quill doctor 快速自检动手排查前先跑一次官方自带的体检命令quill doctor它会逐项检查麦克风权限、系统音频状态、录音目录可写性、转写模型是否已缓存并对每个问题直接给出修复提示。检查逻辑见 macos/Sources/quill/Doctor.swift。出现 ✗fail说明启动会被阻断出现 !warn则提示你首次录音时会补全。问题1录出来的 system.caf 全程静音症状会议录完了但system.caf对方说话的那条轨道没有声音。最常见原因macOS 的「屏幕与系统音频录制」权限没有给到 Quill。解决步骤打开 系统设置 → 隐私与安全性 → 屏幕与系统音频录制在列表中把 quill以及你运行它的终端应用的开关打开重新录一段测试。该权限没有公开 API 可查询首次录音时才会弹窗提示所以容易漏掉。相关说明见 macos/README.md 的 Gotchas 一节。问题2麦克风权限被拒denied症状点击「开始录音」后提示失败或quill doctor显示microphone: denied。解决步骤打开 系统设置 → 隐私与安全性 → 麦克风找到 quill 或你的终端Terminal / iTerm打开开关若列表里没有 quill先手动跑一次quill触发授权弹窗。注意在终端里运行时macOS 可能把权限请求算在终端应用头上所以终端和 quill 本体两处都建议开启避免「明明授权了却不生效」。问题3权限已开启重启后仍不生效症状开关明明是绿的录音却依然失败或升级 / 重装后突然失效。原因macOS 的 TCC 权限是绑定到可执行文件身份的。Quill 把 Info.plist 直接嵌入二进制__TEXT,__info_plist就是为了以 LaunchAgent 方式后台运行时权限也能归属到 quill 自身。一旦你替换了二进制重新编译、重装系统会把它视为新应用之前授予的权限作废。解决办法重新运行一次quill在弹出的新对话框中再次允许麦克风 / 系统音频若仍不行到对应隐私列表里删除旧条目再重新添加强制刷新授权。安装与后台启动方式参考 scripts/install-macos。问题4菜单栏羽毛图标变橙recovering / capture lost症状录制中图标从红色变橙显示◐ recovering microphone甚至提示capture lost。原因macOS 的音频路由在一场会议里并不稳定——接上 / 摘下 AirPods、切换默认输入设备都可能让某条轨道悄悄停写。Quill 内置看门狗1 秒级轮询 路由变更监听发现停写会自动最多重试 3 次把后续音频写进新的分段文件如mic-002.caf已录内容绝不覆盖。这套状态机的阈值与流程见 macos/Sources/quill/Audio/CaptureHealth.swift。怎么办变橙属正常自愈无需操作恢复后图标会回红出现⚠ capture lost说明重试预算用完本次该轨道会被标记 incomplete但会议剩余部分仍在正常录制想避免此类问题录会期间尽量不要中途插拔耳机。问题5停录后提示 recording incomplete纪要缺了一段症状收到「recording incomplete」通知transcript.md 中间缺时间戳。排查方法打开该次会话目录默认~/Recordings/日期-时间/查看meta.jsontracks[].segments每个分段文件的起止偏移与帧数可确认哪段缺失tracks[].interruptions每次中断的检测时刻、恢复时刻、尝试次数与原因route_change/callback_stalled/write_failedstatuscomplete/recovered可用但有缺口/incomplete尾部缺失或未恢复。转写对每个分段独立处理再按会话时钟对齐合并缺口会原样保留在时间戳里不会伪造连续内容。元数据 schema 与读写规则见 docs/architecture.md。预防会话目录要落在有写权限的位置若quill doctor报 recordings folder 不可写检查父目录权限或在 macos/Sources/quill/Config.swift 对应的~/.config/quill/config.json中改recordings_dir。问题6转写一直不启动或 transcribe.log 报错症状停录后等了很久没有收到「transcript ready」通知。按顺序排查模型没下载Parakeet TDT 0.6B v2 模型约 600 MB首次转写时才下载。跑quill doctor看 transcription 一项——若提示未下载联网录一段短测试即可触发下载之后本地缓存重要会议前不会再卡语言限制当前 Parakeet v2 仅支持英文其他语言需等 Whisper 引擎看日志会话目录下的transcribe.log记录每次转写的进度与失败原因。任务队列基于文件系统有meta.json但没有transcript.json即视为待处理下次启动会自动续跑不会丢失确认未关闭转写config.json 里transcription.enabled为false时只录音不转写。附赠扬声器开会时自己的话被转写两遍默认关闭回声消除若你通过扬声器开会播放会串进麦克风轨道被转写两份。在~/.config/quill/config.json中设置mic_voice_processing: true即可戴耳机则保持默认关闭更干净。快速对照表症状最可能原因解决动作system.caf 静音系统音频权限缺失隐私与安全性 → 屏幕与系统音频录制 → 开启mic 轨道失败麦克风权限被拒隐私与安全性 → 麦克风 → 开启终端 quill授权过仍无效二进制更换后 TCC 失效重新触发授权弹窗必要时删旧条目图标变橙音频路由切换属自动恢复少插拔耳机incomplete 通知轨道中断未完全恢复查 meta.json 的 interruptions无转写结果模型未下载 / 非英文联网录短测试查 transcribe.log以上问题的完整背景可查阅 macos/README.md 的「Capture recovery」「Gotchas」章节多平台设计细节见 docs/architecture.md。【免费下载链接】quillUltra-minimalist macOS recording transcription.项目地址: https://gitcode.com/gh_mirrors/quill26/quill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Quill排障清单：录音没声音、权限不生效的6个高频问题逐一解决
Quill排障清单录音没声音、权限不生效的6个高频问题逐一解决【免费下载链接】quillUltra-minimalist macOS recording transcription.项目地址: https://gitcode.com/gh_mirrors/quill26/quillQuill 是一款极简的 macOS 本地会议录音 转写工具它把麦克风和系统音频分成两条独立轨道录制停录后在本地自动转写出带时间戳、区分「我 / 对方」的会议纪要全程不联网。本文整理 6 个高频排障问题录音没声音、麦克风权限不生效、转写不启动等帮你快速定位并解决。先做一步用 quill doctor 快速自检动手排查前先跑一次官方自带的体检命令quill doctor它会逐项检查麦克风权限、系统音频状态、录音目录可写性、转写模型是否已缓存并对每个问题直接给出修复提示。检查逻辑见 macos/Sources/quill/Doctor.swift。出现 ✗fail说明启动会被阻断出现 !warn则提示你首次录音时会补全。问题1录出来的 system.caf 全程静音症状会议录完了但system.caf对方说话的那条轨道没有声音。最常见原因macOS 的「屏幕与系统音频录制」权限没有给到 Quill。解决步骤打开 系统设置 → 隐私与安全性 → 屏幕与系统音频录制在列表中把 quill以及你运行它的终端应用的开关打开重新录一段测试。该权限没有公开 API 可查询首次录音时才会弹窗提示所以容易漏掉。相关说明见 macos/README.md 的 Gotchas 一节。问题2麦克风权限被拒denied症状点击「开始录音」后提示失败或quill doctor显示microphone: denied。解决步骤打开 系统设置 → 隐私与安全性 → 麦克风找到 quill 或你的终端Terminal / iTerm打开开关若列表里没有 quill先手动跑一次quill触发授权弹窗。注意在终端里运行时macOS 可能把权限请求算在终端应用头上所以终端和 quill 本体两处都建议开启避免「明明授权了却不生效」。问题3权限已开启重启后仍不生效症状开关明明是绿的录音却依然失败或升级 / 重装后突然失效。原因macOS 的 TCC 权限是绑定到可执行文件身份的。Quill 把 Info.plist 直接嵌入二进制__TEXT,__info_plist就是为了以 LaunchAgent 方式后台运行时权限也能归属到 quill 自身。一旦你替换了二进制重新编译、重装系统会把它视为新应用之前授予的权限作废。解决办法重新运行一次quill在弹出的新对话框中再次允许麦克风 / 系统音频若仍不行到对应隐私列表里删除旧条目再重新添加强制刷新授权。安装与后台启动方式参考 scripts/install-macos。问题4菜单栏羽毛图标变橙recovering / capture lost症状录制中图标从红色变橙显示◐ recovering microphone甚至提示capture lost。原因macOS 的音频路由在一场会议里并不稳定——接上 / 摘下 AirPods、切换默认输入设备都可能让某条轨道悄悄停写。Quill 内置看门狗1 秒级轮询 路由变更监听发现停写会自动最多重试 3 次把后续音频写进新的分段文件如mic-002.caf已录内容绝不覆盖。这套状态机的阈值与流程见 macos/Sources/quill/Audio/CaptureHealth.swift。怎么办变橙属正常自愈无需操作恢复后图标会回红出现⚠ capture lost说明重试预算用完本次该轨道会被标记 incomplete但会议剩余部分仍在正常录制想避免此类问题录会期间尽量不要中途插拔耳机。问题5停录后提示 recording incomplete纪要缺了一段症状收到「recording incomplete」通知transcript.md 中间缺时间戳。排查方法打开该次会话目录默认~/Recordings/日期-时间/查看meta.jsontracks[].segments每个分段文件的起止偏移与帧数可确认哪段缺失tracks[].interruptions每次中断的检测时刻、恢复时刻、尝试次数与原因route_change/callback_stalled/write_failedstatuscomplete/recovered可用但有缺口/incomplete尾部缺失或未恢复。转写对每个分段独立处理再按会话时钟对齐合并缺口会原样保留在时间戳里不会伪造连续内容。元数据 schema 与读写规则见 docs/architecture.md。预防会话目录要落在有写权限的位置若quill doctor报 recordings folder 不可写检查父目录权限或在 macos/Sources/quill/Config.swift 对应的~/.config/quill/config.json中改recordings_dir。问题6转写一直不启动或 transcribe.log 报错症状停录后等了很久没有收到「transcript ready」通知。按顺序排查模型没下载Parakeet TDT 0.6B v2 模型约 600 MB首次转写时才下载。跑quill doctor看 transcription 一项——若提示未下载联网录一段短测试即可触发下载之后本地缓存重要会议前不会再卡语言限制当前 Parakeet v2 仅支持英文其他语言需等 Whisper 引擎看日志会话目录下的transcribe.log记录每次转写的进度与失败原因。任务队列基于文件系统有meta.json但没有transcript.json即视为待处理下次启动会自动续跑不会丢失确认未关闭转写config.json 里transcription.enabled为false时只录音不转写。附赠扬声器开会时自己的话被转写两遍默认关闭回声消除若你通过扬声器开会播放会串进麦克风轨道被转写两份。在~/.config/quill/config.json中设置mic_voice_processing: true即可戴耳机则保持默认关闭更干净。快速对照表症状最可能原因解决动作system.caf 静音系统音频权限缺失隐私与安全性 → 屏幕与系统音频录制 → 开启mic 轨道失败麦克风权限被拒隐私与安全性 → 麦克风 → 开启终端 quill授权过仍无效二进制更换后 TCC 失效重新触发授权弹窗必要时删旧条目图标变橙音频路由切换属自动恢复少插拔耳机incomplete 通知轨道中断未完全恢复查 meta.json 的 interruptions无转写结果模型未下载 / 非英文联网录短测试查 transcribe.log以上问题的完整背景可查阅 macos/README.md 的「Capture recovery」「Gotchas」章节多平台设计细节见 docs/architecture.md。【免费下载链接】quillUltra-minimalist macOS recording transcription.项目地址: https://gitcode.com/gh_mirrors/quill26/quill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考