大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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 即可起步，规模化后切换到向量数据库，实现毫秒级跨文件智能查询。

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 失效 → 需要增量索引、混合搜索、毫秒级查询

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=…

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

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

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

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

核心协议：

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

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

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

CLI 常用命令（核心）：

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

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

• “谁应该邀请共进晚餐？他们同时认识 Pedro 和 Diana。”
• “我对 shame 与创始人绩效的关系说过什么？”
• “Series A 自周二以来有什么变化？”
• “30 分钟后帮我准备和 Jordan 的会议。”

• OpenClaw 原生支持（openclaw.plugin.json）
• Hermes：通过 MCP Server + nightly cron + Skillpack 实现
• 完全兼容任何能读写文件的 Agent

优势：

• 人类友好：Markdown + Git，随时手动编辑
• Agent 友好：Skillpack 提供完整 playbook
• 可扩展：从零 Postgres 到万级文件无缝过渡
• 复利效应：每一次对话都在让大脑变聪明
• 完全开源（MIT），社区驱动

适合人群：

• 知识工作者、创始人、投资人、思考型职业者
• 已经使用 Obsidian / Notion 但想让 AI 真正“懂你”的人
• 希望构建个人 Memex、实现“永不重复劳动”的人

快速上手建议：

1. 先用纯 Markdown + Skillpack 跑通 Agent 循环（无需 Postgres）
2. 阅读 docs/GBRAIN_SKILLPACK.md（必读！）
3. 阅读 docs/GBRAIN_RECOMMENDED_SCHEMA.md
4. 运行 gbrain init + gbrain import
5. 设置 nightly cron → 开启 Dream Cycle

项目链接：

• GitHub: https://github.com/garrytan/gbrain
• 关键文档：/docs/GBRAIN_SKILLPACK.md、GBRAIN_RECOMMENDED_SCHEMA.md
• 作者 OpenClaw: https://openclaw.com

GBrain 不是又一个笔记工具，而是把 AI 变成你第二个大脑的操作系统。一旦跑通 Brain-Agent 循环，你会发现：知识不再是静态文件，而是每天都在自主进化的活的智力资产。

开始构建你的 Memex 吧——从今天的一条 Markdown 开始，明天你的 Agent 就会比今天更聪明。🚀

（本文基于 2026 年 4 月最新仓库 master 分支内容整理，如有更新请以 GitHub 为准）