用途：诊断并修复 Granola 常见故障，覆盖音频采集、转写、日历同步与第三方集成错误。Granola 从设备系统音频输出采集声音（不走会议平台 API），因此多数问题源于音频权限或设备配置。
主要能力：按症状给出根因与分平台修复步骤，并提供错误快速对照表（症状、最可能原因、首选修复）。
使用方式：先做快速诊断，如 pgrep -l Granola 检查进程、读取版本、用 system_profiler SPAudioDataType 查看音频设备；再按症状处理。无音频/转写为空时，在 macOS 的“隐私与安全性 > 屏幕与系统音频录制”和“麦克风”中启用 Granola，改权限后重启应用；必要时执行 sudo killall coreaudiod。Windows 在隐私设置中启用麦克风并确认默认输出设备、关闭音频增强。转写中途停止多因电脑休眠或蓝牙掉线，保持唤醒并改用有线音频。会议未被检测时检查日历连接、事件是否含 Zoom/Meet/Teams/WebEx 链接，可手动开始录制。集成方面：Slack 需 /invite @Granola 并重连；Notion 只能写入其自建数据库；HubSpot 要求参会者邮箱匹配已有联系人；Zapier 需核对连接与文件夹名并加延迟。应用崩溃可 pkill -9 Granola 后重启、删除 ~/Library/Caches/Granola；更新后无法启动可清除偏好并 brew reinstall --cask granola。处理卡住通常需 1–2 分钟，长会议最多 15 分钟，可查状态页。
适用场景：个人或团队在会议记录前后排查 Granola 故障。
限制：资料未提供具体版本兼容范围、系统最低要求与官方支持渠道；部分命令需管理员权限，清除偏好会导致需重新登录。