逐步編碼教程：實現GBrain——Y Combinator的Garry Tan為AI代理構建的自連線記憶層

您的AI代理雖然智能，但健忘。每個新會話都從零開始——不記得您見過誰、讀過什麼、上週二的決定。GBrain是為此打造的開源解決方案，由Y Combinator總裁兼CEO Garry Tan構建，用於驅動他自己的OpenClaw和Hermes部署。它是一個Markdown優先、基於Postgres的知識層，能夠攝入會議、郵件、推文和筆記，並在其上自動連線一個類型化知識圖譜——圖譜提取無需任何LLM調用。Garry實際代理背後的生產大腦目前包含146,646個頁面、24,585個人、5,339家公司和66個自動定時任務。在它自己的基準測試BrainBench（240頁豐富散文語料庫）上，GBrain的P@5達到49.1%，R@5達到97.9%，相比同代碼庫禁用圖譜層的版本，P@5領先31.4個百分點。

本教程是一份實操指南。您將本地安裝GBrain，導入一個小型筆記文件夾，運行真實搜索，觀察知識圖譜自我連線，並通過MCP將其連接到Claude Code。全程約20分鐘。以下終端輸出均來自GBrain v0.38.2.0的實時安裝。倉庫（MIT許可）位於github.com/garrytan/gbrain。

構建內容

教程結束時，您將擁有：

• 一個本地~/.gbrain/brain.pglite數據庫——嵌入式Postgres 17（通過WASM）和pgvector，零服務器配置。
• 一個包含人員、公司和概念Markdown筆記的小型“腦倉庫”。
• 一個可工作的混合搜索CLI，結合向量+BM25關鍵詞+倒數排名融合（RRF），默認帶有ZeroEntropy重排序器。
• 一個類型化知識圖譜（works_at、founded、invested_in、attended、advises、mentions），從筆記中自動提取。
• 一個暴露74個工具的MCP服務器，使Claude Code、Cursor和Windsurf可以直接讀寫大腦。

前提條件

• macOS或Linux（Windows用户請使用WSL2）。
• 代碼編輯器。
• Bun ≥ 1.3.10（GBrain的運行環境）。第1步將安裝它。
• 一個嵌入API密鑰：ZeroEntropy（默認）、OpenAI或Voyage。沒有的話仍可安裝並運行關鍵詞搜索，但混合搜索將無結果。
• 可選：Anthropic API密鑰，用於搜索時的多查詢擴展。

第1步：安裝Bun和GBrain

GBrain用TypeScript編寫，運行在Bun上。先安裝Bun：

curl -fsSL https://bun.sh/install | bash
exec $SHELL
bun --version

然後全局安裝GBrain：

bun install -g github:garrytan/gbrain
gbrain --version

第2步：初始化大腦

gbrain init --pglite會在~/.gbrain/中創建一個本地PGLite數據庫。PGLite是完整Postgres編譯到WASM——無需服務器，無需Docker，約兩秒即可就緒。本教程中我們先推遲嵌入提供者配置，第6步再連接：

gbrain init --pglite --no-embedding

第3步：創建小型腦倉庫

腦倉庫只是一個Markdown文件目錄。每個文件遵循GBrain的“編譯真理+時間線”模式：頂部為當前最佳理解部分，下方為僅追加的證據軌跡。注意：wikilinks必須使用完整路徑（如[[people/alice-chen]]），否則圖譜提取器無法解析。

mkdir -p ~/my-brain/people ~/my-brain/companies ~/my-brain/concepts
cd ~/my-brain

創建人員頁面、公司頁面和概念頁面。

第4步：導入並連線

gbrain import將整個腦倉庫同步到數據庫，運行Markdown解析器和正則表達式圖譜提取器：

gbrain import --dir ~/my-brain

實時輸出顯示自動鏈接提取過程。

第5步：探索知識圖譜

使用gbrain graph-query和gbrain backlinks查看圖譜。這就是向量搜索與結構化檢索的區別。“誰在Acme AI工作？”現在是一個一跳類型化邊遍歷，而不是相似度分數。

第6步：運行搜索

GBrain提供兩個搜索動詞：gbrain search（僅關鍵詞）和gbrain query（完整混合管道）。配置嵌入提供者並運行混合搜索：

export OPENAI_API_KEY=sk-...
gbrain config set embedding_model openai:text-embedding-3-large
gbrain embed --all
gbrain query "who works on small-model inference?"

第7步：通過MCP連接到Claude Code

GBrain通過標準I/O暴露74個MCP工具。規範設置是單個命令：

claude mcp add gbrain -- gbrain serve

然後Claude Code即可搜索大腦。Cursor和Windsurf也支持。若要遠程訪問，使用HTTP模式。

第8步：讓大腦自我運行

GBrain配備自動導航循環。gbrain doctor --remediate計算依賴排序的修復計劃並自動執行。或作為守護進程運行gbrain autopilot --install。健康大腦兩次檢查之間休眠60分鐘。Minions隊列處理殼作業和LLM子代理作業。

整體架構

Markdown倉庫是記錄系統，GBrain是檢索+圖譜層，代理通過兩者讀寫，人類可直接編輯任何.md文件，gbrain sync會拾取變更。

下一步

• gbrain capture快速記錄想法。
• 當大腦超出本地限制時遷移到Supabase。
• 攝入真實數據：語音、郵件、日曆等。
• 運行基準測試。
• 編寫自定義技能。

GBrain的深層理念是：瘦運行時、胖技能，優於胖代理背後的瘦技能。運行時保持小巧；智能存在於決策時代理讀取的Markdown文件中。每次對腦倉庫的提交都成為代理下次喚醒時的永久上下文。運行時間越長，它越聰明。