附录 C：鸣谢与参考资料（Credits）

附录 C：鸣谢与参考资料（Credits）#

C.1 项目信息#

项目

信息

项目名称

GBrain

GitHub

https://github.com/garrytan/gbrain

当前版本

v0.22.5

License

MIT

描述

Postgres-native personal knowledge brain with hybrid RAG search

GBrain 是一个开源的个人知识大脑项目，采用本地优先（local-first）设计，数据存储在本地 Markdown 文件中，通过 Git 进行版本控制。

C.2 主要贡献者#

贡献者

角色

备注

Garry Tan (garrytan)

项目创始人

主要作者和维护者

GBrain 社区贡献者

代码贡献

通过 GitHub Issues 和 PR 参与

C.3 技术依赖#

GBrain 的核心依赖：

依赖

版本

用途

@electric-sql/pglite

0.4.3

嵌入式 PostgreSQL（WASM）

pgvector

0.2.0

向量存储和相似度搜索

@modelcontextprotocol/sdk

1.0.0

MCP 协议实现

openai

4.0.0+

Embedding 生成

tree-sitter-wasms

0.1.13

代码解析

marked

18.0.0

Markdown 解析

C.4 参考资料与延伸阅读#

核心文档#

技术主题#

主题

参考资料

RAG

LangChain 文档，Pinecone Blog

Vector Search

pgvector 官方文档

MCP

Anthropic MCP 官方文档

BullMQ

BullMQ GitHub（Minions 设计参考）

Reciprocal Rank Fusion

10.1145/1645953.1646033（原始论文）

C.5 本书写作说明#

目标读者#

本书面向个人开发者，特别是希望构建个人知识管理系统的工程师。需要具备：

  • TypeScript 基础

  • 基本的数据库概念（SQL、PostgreSQL）

  • 对 AI/LLM 应用有基本了解

写作风格#

  • 技术博客风格：直入主题，不讲废话

  • 首次出现的术语附英文：帮助读者阅读英文文档

  • 不讲安装/CLI用法：聚焦内部设计和实现原理

源码阅读建议#

推荐阅读顺序：
1. cli.ts — 理解命令分发到 Operation 的流程
2. operations.ts — 理解 Operation 的注册和执行机制
3. engine.ts — 理解 BrainEngine 的接口设计
4. pglite-engine.ts — 理解嵌入式存储实现
5. search/hybrid.ts — 理解混合搜索管线
6. search/two-pass.ts — 理解 Cathedral II 实现

文档更新#

本书随 GBrain 版本迭代更新。当前基于 v0.22.5。

C.6 反馈与勘误#

  • 发现错误请提交 GitHub Issue

  • 文档源码：https://github.com/garrytan/gbrain-book

GBrain v0.22.5 · 附录 C · 本书由 GBrain 社区编写