graincrawl
将 Granola 笔记数据归档到本地 SQLite 的工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：graincrawl。 它的用途是：将 Granola 笔记数据归档到本地 SQLite 的工具 完整的 Skill 内容见：https://321skill.com/skills/graincrawl/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我想把 Granola 里的所有笔记都备份到本地，并且能离线浏览。” 它会指导你安装 graincrawl，通过 `graincrawl sync` 同步数据，然后用 `graincrawl tui` 在终端里浏览所有归档的笔记和转录稿。你还可以用 `graincrawl export markdown` 将笔记批量导出，方便在其他软件中使用。
介绍
graincrawl 是一款专注于将 Granola 笔记、转录稿、面板、人员、工作空间及同步元数据归档到本地私有 SQLite 数据库的工具。它采用本地优先、对 Granola 只读的设计原则，确保用户数据的私密性和独立性。
使用 graincrawl，你可以通过 Granola 的私有桌面 API 或离线缓存文件同步数据，将笔记导出为 Markdown 格式，并通过内置的终端用户界面（TUI）浏览所有已归档的内容。其命令行工具提供了从初始化、同步、状态检查到数据导出的完整工作流。
这款工具非常适合需要长期保存、离线访问或对 Granola 笔记进行二次处理的用户，如内容创作者、学术研究者或任何希望将云端笔记数据本地化的个人。它让你完全掌控自己的知识资产。
需要注意的是，graincrawl 是一个只读归档工具，不会向 Granola 写入任何数据。它支持从加密的 JSON 缓存中导入数据，但明确不支持 OPFS。建议在初次使用时运行 graincrawl doctor 检查环境，并定期使用快照功能备份归档库。
核心特点
与通用笔记导出工具不同，graincrawl 深度集成了 Granola 的私有 API 和数据结构，能完整归档笔记、转录稿、人员关系等复杂元数据，并提供了基于 crawlkit 框架的统一终端浏览和快照迁移体验。
注意事项
不适合需要实时双向同步或直接编辑 Granola 源数据的场景，仅用于本地只读归档。
常见问题
graincrawl 会修改我的 Granola 笔记吗？
不会，它是一个严格的只读归档工具，只从 Granola 读取数据并保存到本地，不会进行任何写入或修改操作。
如何将归档的笔记导出到其他笔记软件？
可以使用 `graincrawl export markdown` 命令将所有笔记导出为 Markdown 文件，然后轻松导入到 Obsidian、Logseq 等支持 Markdown 的软件中。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/graincrawl/raw/index.md 读取 graincrawl 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/graincrawl/raw/index.md（查看排版版本）