用途:把 Granola 会议转录备份到本地磁盘并支持查询。Granola 本地存储加密且使用每次刷新即轮换的一次性认证令牌,因此关键做法是下载前始终从运行中的应用重新提取新令牌,内置 pull.py 流水线会自动完成。
主要能力:pull.py 一键完成提取令牌、下载新文档(按 document_id 跳过已下载)、把新文件夹重命名为 YYYY-MM-DD_HHMM_Subject_<id8>(本地时间,便于按时间排序),操作幂等,输出到 transcripts_output/。archive.py 提供 list_meetings、search_transcripts、get_transcript、stats 等读取能力;mcp_server/server.py 提供本地 stdio MCP 服务。
使用方式:先定位或安装 Granola-Download 仓库并准备 venv,之后用 $GRANOLA/.venv/bin/python 执行命令。默认拉取:"$GRANOLA/.venv/bin/python" "$GRANOLA/pull.py"。搜索、读取、统计可通过 archive 模块或 MCP 工具完成。若拉取报 400 或 Failed to obtain access token,说明令牌过期,重跑 pull.py 即可;若提取失败,确认 Granola 桌面应用已安装并登录。
限制:仅支持 macOS,需已安装并登录 Granola 桌面应用(令牌从其本地钥匙串条目解密)。config.json、transcripts_output/、.venv/ 已被 gitignore,切勿提交或粘贴其内容;令牌持续轮换,不要缓存,也不要将令牌打印到对话中。完整导出(含 AI 摘要与工作区/文件夹元数据)可用 granola/main.py。