garrytan/gbrain

如果你已经在用某个 agent、每次都要重新交代同样的背景，GBrain 值得一看；但它不是人人可上手的开箱方案，最完整的路径要求 Bun 和一定的 MCP 配置能力。

解决什么问题

开会前你想让助手直接回答“见 Alice 之前我该知道什么”，而不是丢回五个文件名让你自己点开。现在这些背景散落在笔记、过去的会议和聊天记录里，每换一个 agent 就得重讲一遍。GBrain 改变的是取回这一步：你提问，agent 带出处地取出明确事实并组织成答案。结果是记忆可以跟着你换 agent，而不必在每个工具里重建。

有什么不同

它的核心是“带来源的明确事实”，外加纠正与撤回，而不是一团无法解释的向量。这让记忆可核查：发现某条记错时，你能指出并撤销它。无密钥的关键词检索开箱即用，语义检索、综合与后台富化属于按需加装，所以第一次跑不需要 API 花费。技能与知识放在同一内容根目录下，agent 可以加入经授权的目录，只有被批准的编辑者能发布。

代价是它对基础设施有明确主张。完整的“常驻”体验假设 agent 部署在服务器上，跑 24/7 定时任务，还有在你睡觉时给记忆做富化的“夜间整理”；README 自己说这是成本最高的路径——一台 8GB+ 内存的服务器，加上随 agent 使用强度增长的 API 消耗。轻量路径绕开了这些，但你就得在几种行为不同的方案里做选择。另外包装警告要留意：npm 上的 gbrain 包与之无关，只有文档给出的安装方式是对的。

谁值得试

适合：你每天都用某个 agent（Claude Code、Codex、OpenClaw、Hermes），想要一份自己掌控、能在它们之间共用的记忆；或者一个小团队需要共享 brain 技能，同时只允许经批准的人编辑。从编程 agent 接入开始是最不打扰的方式，因为它保留你 agent 原有的身份，记忆存在 agent 自己的环境里，不需要新建私有仓库。

不适合：你想要的是装完即用的托管成品（README 提供托管选项，但那是另一种投入）；或者你还没有 agent 工作流，只是对“记忆”好奇。如果你不能或不愿安装 Bun，也不适合，因为 CLI 和 setup 路径都依赖它。

使用条件与边界

CLI 要求 Bun 1.4.0 或更新版本。本地默认起步用 PGLite 加 --no-embedding，不装服务端、不用 Docker，也不会从免费滑向付费，但语义检索要等你加上 embedding 才可用。setup 命令会写入 MCP 条目和读取上下文的钩子并做冒烟测试；接受前先确认它解析出的 brain、来源和归属，想先看效果可以用 --dry-run 预览。

日常维护不能忽略：schema 迁移可能让 brain 落在旧版本（README 指向 issue #218 及修复步骤），已有 worker 安装升级前要先照着授权与队列指南处理，再重启服务。出问题先跑 gbrain doctor，具体故障再用 db-repair 和 engine status --probe。偏重的服务器路径会带来实际的主机与 token 开销，README 明说这远超一份聊天订阅。

HotRepo 点评

目前唯一的带日期观测是 2026-10-25 登上一次日榜，当天 31,180 星、+38；HotRepo 自 2026-10-24 开始追踪，单个样本不足以判断热度是在上升还是消退。项目大约 202 天，仅凭年龄也看不出长期维护状况。真要采用，先对照迁移与授权升级说明检查你现有安装，那正是文档里写明的升级易断之处。

项目源码与说明