当前位置：首页 > news >正文

GBrain 项目详解：你的个人 AI 知识大脑（Memex）

news 2026/6/2 15:36:54

GBrain 项目详解：你的个人 AI 知识大脑（Memex）—— 详细教程 + 完整归纳总结

GBrain（https://github.com/garrytan/gbrain）是由 garrytan 开发的开源个人知识管理系统，专为 AI Agent（如 OpenClaw、Hermes）设计。它将你的 Markdown 文件仓库作为“真相之源”（source of truth），通过 Postgres + pgvector 实现混合搜索（keyword + vector + RRF），让 AI Agent 能够实时读写、自动维护知识，实现知识复利增长（compounding intelligence）。

作者 Garry 将其描述为“Vannevar Bush 想象的 Memex”，专为“靠思考谋生的人”打造：它不是简单的笔记工具，而是让 AI Agent 在你睡觉时自动扫描对话、丰富实体、修复引用、合并记忆，让大脑每天醒来都比前一天更聪明。

项目核心数据（真实生产案例）：

10,000+ Markdown 文件
3,000+ 人物档案 + 关系图谱
13 年日历（21,000+ 事件）
5,800+ Apple Notes（2009 年至今）
280+ 会议转录 + AI 分析
300+ 原创想法（按论题组织）

一句话总结：GBrain = Markdown Git 仓库（人类可直接读写） + 薄 CLI/MCP 检索层 + Agent Skillpack（让 AI 自主维护大脑）。无需 Postgres 即可起步，规模化后切换到向量数据库，实现毫秒级跨文件智能查询。

一、核心原理与架构（为什么 GBrain 能让知识“复利增长”）

1. 知识模型（Compiled Truth + Append-only Timeline）

每页 Markdown 分为两部分：
- 顶部 Compiled Truth：当前最佳理解（证据变化时重写）。
- 底部 Timeline：永不修改的证据链（时间戳 + 来源 + 原始引用）。
MECE 目录结构（推荐 schema）：
- people/、companies/、deals/、meetings/、originals/、concepts/、ideas/ 等。
人类永远是最终权威：直接编辑 Markdown 文件后，执行 gbrain sync 即可同步。

2. Brain-Agent 核心循环（Compounding Thesis）

信号到来（会议、邮件、推文、链接）↓
实体检测（人、公司、原创想法）↓
READ：先查大脑（gbrain search / get / query）↓
带上下文回应↓
WRITE：更新大脑页面（编译新信息、追加 Timeline、创建交叉引用）↓
Sync：gbrain 索引变更↓
下次信号到来时，Agent 已更聪明

3. 架构图

Brain Repo (Git Markdown)  ←→  GBrain (Postgres + pgvector 混合搜索)↔   AI Agent (Skills 定义读写规则)

GBrain 定位：

世界知识层（人、公司、会议、想法）→ gbrain 命令查询
与 OpenClaw 的 operational memory（memory_search）互补
技能完全用 Markdown 编写，Agent 无需硬编码逻辑

4. 为什么需要 Postgres？

500 个文件：grep 够用
10,000+ 文件：grep 失效 → 需要增量索引、混合搜索、毫秒级查询

二、安装与初始设置（Step-by-Step 教程）

1. 前置条件

Supabase 账号（推荐，免费层够用）或自有 Postgres + pgvector
OpenAI / Anthropic API Key（用于嵌入和 Agent）
Bun（推荐）或 Node.js
Git 仓库（你的 Brain Repo）

2. 安装 GBrain CLI

# 全局安装（推荐）
bun add -g gbrain# 或作为项目依赖
bun add gbrain

3. 初始化大脑

# 引导式向导（推荐 Supabase）
gbrain init --supabase# 或使用自定义 Postgres URL
gbrain init --url "postgresql://..."

向导会自动：

创建 Supabase 项目
设置环境变量（.env）
初始化 schema

4. 首次导入现有 Markdown

# 导入目录（跳过嵌入以加速）
gbrain import /path/to/your/brain --no-embed# 后续补全向量嵌入
gbrain embed --stale

5. 文件存储管理（可选，二进制文件迁移）

gbrain files mirror     # 镜像附件
gbrain files redirect   # 重定向到外部存储
gbrain files clean      # 清理

6. 升级与日常维护

bun update gbrain          # 或 clawhub update gbrain
gbrain check-update        # 检查更新

环境变量（.env 示例）：

OPENAI_API_KEY=...
ANTHROPIC_API_KEY=...
SUPABASE_URL=...
SUPABASE_ANON_KEY=...

三、推荐 Schema 与 Markdown 规范（GBRAIN_RECOMMENDED_SCHEMA.md 精华）

目录严格 MECE（互斥且穷尽）
每页采用 Compiled Truth + Timeline 格式
自动交叉引用、backlinks
支持 Obsidian/Notion/Logseq/Roam 迁移（见 skills/migrate/SKILL.md）

四、Agent Skillpack 详解（最重要文档！GBRAIN_SKILLPACK.md）

Skillpack 是“玩法说明书”，教 Agent 如何使用 GBrain（不是命令列表，而是生产级参考架构）。

关键技能模块（位于 skills/）：

ingest/：会议/文档/文章摄入 → 更新 Compiled Truth + 追加 Timeline
query/：分层搜索（keyword → vector → 结构化）+ 带引用合成答案
maintain/：定期健康检查（矛盾、过期、孤儿页面）
enrich/：7 步外部 API enrichment 流水线（分层 API 花费）
briefing/：每日简报（会议上下文、交易更新、活跃线程）
setup/、migrate/ 等

核心协议：

Entity Detection：每条消息都启动轻量子 Agent（用 Claude Sonnet），优先捕获原创思考 → 存入 originals/{slug}.md
Brain-First Lookup：任何外部 API 前必须先查 gbrain
Dream Cycle（夜间 cron）：扫描当日对话 → 丰富实体 → 修复引用 → 合并记忆（OpenClaw 内置，Hermes 可手动 cron）

生产级 cron 参考（20+ 任务）：

每日梦循环
每周健康检查
每月 embedding 回填

五、日常使用教程（CLI + Agent 示例）

CLI 常用命令（核心）：

gbrain search "Pedro Diana"          # 关键字搜索
gbrain query "shame and founder performance"  # 语义搜索
gbrain get people/jordan             # 获取单页
gbrain sync                          # 同步 Markdown 变更

Agent 查询示例（直接复制到你的 Agent）：