GBrain 知识库
GBrain - 给你的 AI Agent 一个大脑。搜索给你页面，GBrain 给你答案。
📚 文档导航
入门指南
| 文档 | 适合人群 | 阅读时间 |
|---|---|---|
| 快速入门 | 第一次接触 GBrain | 10 分钟 |
| 进阶使用 | 已了解基础，想深入 | 30 分钟 |
| 实战案例 | 想看实际应用场景 | 20 分钟 |
| Sync 命令详解 | 想深入了解数据同步 | 25 分钟 |
| MECE 整理指南 | 想理解自动整理机制 | 25 分钟 |
| 导出 vs 同步 | 想了解数据管理 | 15 分钟 |
🚀 快速开始
什么是 GBrain？
GBrain 是一个个人/团队知识库的"大脑"层。与传统笔记工具不同：
| 传统搜索 | GBrain |
|---|---|
| 给你一堆页面链接 | 直接给你答案 |
| 关键词匹配 | 语义理解 |
| 需要人工整理 | 自动合成 |
| 不知道缺什么 | 明确缺口分析 |
典型场景：
- "明天和 Alice 开会需要准备什么？" → 自动整理她的背景、上次谈话、待办事项
- "我们关于缓存优化的所有讨论" → 跨页面合成总结
- "谁介绍了我认识 Bob？" → 图遍历找到关系路径
5 分钟体验
# 1. 安装
bun install -g github:garrytan/gbrain
# 2. 初始化（2 秒完成）
gbrain init --pglite
# 3. 配置 API 密钥
gbrain config set openai_api_key sk-...
# 4. 提问
gbrain query "Alice 是做什么的？"
📖 学习路径
Level 1: 基础使用（新手）
目标：能够安装并使用基本查询功能
- ✅ 阅读 快速入门
- ✅ 完成安装步骤
- ✅ 尝试基础查询
- ✅ 导入自己的知识
核心命令:
gbrain init --pglite
gbrain query "问题"
gbrain import ~/my-knowledge
Level 2: 进阶功能（进阶）
目标：理解核心机制，使用高级功能
- ✅ 阅读 进阶使用
- ✅ 理解 Brain/Source 概念
- ✅ 配置自定义 Schema
- ✅ 使用图查询
核心概念:
- Brain vs Source
- Schema 和页面类型
- 事实提取
- 图遍历
Level 3: 实战应用（高手）
目标：在真实场景中发挥作用
- ✅ 阅读 实战案例
- ✅ 设计自己的 Schema
- ✅ 集成到工作流
- ✅ 优化性能
核心能力:
- 会议准备
- 研究分析
- 投资追踪
- 团队知识库
🎯 核心概念速查
架构概览
┌─────────────────────────────────────┐
│ 应用层：问答/搜索/分析 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 技能层：60+ 可调用能力 │
└─────────────────────────────────────┘
↓
┌─────────────────────────────────────┐
│ 存储层：PGLite/Postgres + pgvector │
└─────────────────────────────────────┘
关键术语
| 术语 | 含义 |
|---|---|
| Brain | 一个数据库（个人/团队） |
| Source | 大脑内的一个仓库 |
| Schema | 页面类型的定义 |
| Fact | 结构化的事实数据 |
| Edge | 实体之间的关系 |
| Skill | 可调用的能力模块 |
常用命令速查
# 安装与初始化
gbrain init --pglite # 初始化（PGLite）
gbrain init --postgres # 初始化（Postgres）
gbrain upgrade # 升级
# 查询
gbrain query "问题" # 基础查询
gbrain whoknows "主题" # 谁知道这个
gbrain graph-query id --depth 2 # 图遍历
# 数据管理
gbrain import ~/folder # 导入
gbrain export --format json # 导出
gbrain sync --watch # 实时同步
# Schema
gbrain schema add-type ... # 添加类型
gbrain schema sync --apply # 应用变更
# 运维
gbrain doctor # 健康检查
gbrain models doctor # 模型检查
🔧 典型应用场景
个人知识管理
场景：你有几千篇笔记，需要快速找到信息
GBrain 方案:
- 导入所有笔记
- 使用自然语言查询
- 自动跨笔记合成答案
会议助手
场景：准备重要会议，需要快速了解背景
GBrain 方案:
- 查询对方背景
- 自动整理上次谈话
- 识别待办事项
- 提示缺口信息
研究分析
场景：研究某个领域，需要梳理文献关系
GBrain 方案:
- 建立论文/作者 schema
- 自动提取引用关系
- 图遍历找到关键节点
- 生成领域地图
投资追踪
场景：管理投资组合，追踪公司进展
GBrain 方案:
- 结构化公司数据（MRR、估值）
- 追踪融资历史
- 分析增长轨迹
- 识别关系网络
团队知识库
场景：团队知识分散，新人 onboarding 困难
GBrain 方案:
- 共享团队大脑
- 追踪决策历史
- 知道谁知道什么
- 自动生成 onboarding 指南
📊 性能与成本
存储方案对比
| 方案 | 适用规模 | 成本 | 特点 |
|---|---|---|---|
| PGLite | < 1000 文件 | $0 | 无需服务器，2 秒启动 |
| Postgres | 1000-10K 文件 | $50/月 | 可扩展，高可用 |
| Supabase | 10K+ 文件 | $25/月起 | 全托管，pgvector |
API 成本估算
| 操作 | 调用次数 | 成本（OpenAI） |
|---|---|---|
| 查询 | 1-3 次 | ~$0.01/次 |
| 事实提取 | 写入时触发 | ~$0.005/页 |
| 重排序 | 每次查询 | ~$0.002/次 |
优化建议:
- 使用 ZeroEntropy（2× 速度，0.4× 成本）
- 配置本地 reranker
- 合理设置分块大小
❓ 常见问题
安装问题
Q: Bun 安装失败怎么办？
# 使用官方安装脚本
curl -fsSL https://bun.sh/install | bash
# 或者手动安装
wget https://github.com/oven-sh/bun/releases/download/bun-v1.1.0/bun-linux-x64.zip
Q: schema 迁移失败？
# 手动应用迁移
gbrain apply-migrations --yes
# 查看错误详情
gbrain doctor --json
使用问题
Q: 查询返回空结果？
- 检查是否有内容：
gbrain list | wc -l - 检查嵌入配置：
gbrain models doctor - 重新嵌入：
gbrain sync --reembed
Q: 如何添加自定义类型？
gbrain schema add-type my-type \
--primitive entity \
--prefix my-folder/ \
--expert
gbrain schema sync --apply
性能问题
Q: 查询太慢？
- 使用 reranker：
gbrain config set reranker llama-server - 调整分块大小：
gbrain config set chunk_size 500 - 使用更快的嵌入：ZeroEntropy > OpenAI
Q: 内存占用高？
- 清理孤儿页面：
gbrain orphans - 重建索引：
gbrain sync --reembed - 考虑迁移到 Postgres
🔗 相关链接
官方资源
技能系统
集成平台
📝 文档版本
- 创建时间：2026-05-27
- 基于 GBrain 版本：v0.40.x
- 维护者：html5zhan 文档团队
GBrain - 让你的知识真正发挥作用 🧠