用途：把任意 wiki、笔记工具或知识系统迁移进 GBrain。迁移为增量式，绝不修改或删除源数据。
主要能力：支持 Obsidian（Markdown + [[wikilinks]]）、Notion（导出的 Markdown 或 CSV）、Logseq（含 ((block refs)) 的 Markdown）、纯 Markdown 目录、CSV（列映射到 frontmatter）、JSON（键映射到页面字段）、Roam（JSON 导出）。会把来源系统的 wikilink、块引用、标签转换为 GBrain 等价物。
使用方式：先评估来源格式与文件数，规划字段映射（type、title、tags、compiled_truth、timeline），用 5-10 个文件做样本测试并回读验证，再批量导入，最后做健康检查、统计核对与抽查。Obsidian 可用 gbrain extract links --source db --dry-run 预览、gbrain extract links --source db 提交，原生解析 [[relative/path]] 与 [[relative/path|Display Text]]。Notion 从 Settings > Export > Markdown & CSV 导出，需清理文件名中的 UUID。CSV 每行建一页，指定列作 slug 与 compiled_truth。
已有公司 Git 仓库时走专用流程：先读 skills/conventions/brain-routing.md 与 untrusted-content.md，用 gbrain sources inspect <path> --profile company-brain --json 检查，再用 gbrain sources connect <path> --brain <id> --source <id> --profile company-brain --json 获取预览，经操作者批准后加 --yes 执行；恢复用 gbrain sync --brain <id> --source <id> --no-embed --no-pull。该路径需可信 brain 主机，远程 OAuth 令牌不具管理权限。
限制与注意：导入后缺少 embedding 属预期，搜索在 embedding 生成前仅关键词模式；冲突或恢复拒绝不得删除来源或启用全局 schema 绕过；不得跳过样本测试与验证。具体错误码与完整行为见 docs/guides/company-brain-ingestion.md。