给 AI agent 用的知识库,到底是什么
人们说「给 AI agent 用的知识库」时,可能指指令文件、自动记忆、检索,或一份可审查的 Markdown 项目大脑。它们是不同层。先对上工作,再选工具。
「先给 AI agent 搭一个知识库。」这句话听起来只有一个动作,底下却可能是四件不同的事。有人要的是一份每次 session 开头都会读的短说明;有人要工具自动记住纠正;有人要在一大堆文档里检索;还有人要一份眼下仍成立、也能被审查的答案——为什么这个项目选了 Postgres,哪些方案被排除了——好让下一轮 session 不用从零开始猜。
它们不是同一类产品里互相竞争的品牌,而是不同的层。把层混在一起,指令文件就会变成日记,个人记忆也会被误当成项目记录。飞书知识库、一份本地笔记,或一个向量检索库,都可能被叫做「知识库」;只有在工作被说清楚之后,才知道该不该把它们和项目大脑放在一起比。
指令文件
这一层告诉 agent,在这个仓库里该怎么工作。
Claude Code 的官方记忆文档 把 CLAUDE.md 和 AGENTS.md 写成由你来写的指令。它们会在 session 开始时被加载。因此适合放约定、命令和规则。也因此不适合用来堆积不断变长的历史:多出来的每一段,明天都要再付一次上下文的代价。
若决策目前就写在这份文件里,问题就不是「哪一个知识库最像 Notion」,而是怎样把简报写短,把决策放到别处。关于这次划分,我们已经写过AGENTS.md 不是决策日志 和 AGENTS.md 不是变更日志。这里不再展开。
自动记忆
这一层记下某次 session 学到的东西,而不需要你去维护一份文档。
Claude Code 的自动记忆是一个官方例子。同一页文档写明:Claude 会给自己做笔记,范围限定在某个仓库,并可在不同 worktree 之间共享;这些文件放在本机的 ~/.claude/projects/ 下,「不会在不同机器或云环境之间共享」。同事,或你换一台电脑,都不会看见它们,除非你另外搭一条路径。
Mem0 与 Claude Code 的集成 是另一种官方设计:边工作边捕获,抽取记忆,之后的 session 可以再取用。Mem0 同时描述了共享的项目记忆和个人偏好。它是检索与抽取产品,不是你在 pull request 里审阅的 Markdown 文件。
当你希望工具用很少的仪式感学会偏好和最近的上下文,自动记忆就是对的一层。若一份决策必须能被整个团队审计,就不应把自动记忆当成唯一副本。
检索到的上下文
这一层回答的是:在大量文档、工单或向量里,「找到相关的那段」。向量检索、企业搜索,以及许多「和你的文档聊天」的产品,都在这里。当 agent 需要去查一件事时,它们有用。但它们本身并不会告诉你,检索回来的哪一段才是当前决策,或更早的一条为什么被推翻。
这篇文章不给这些产品做评测,也不编一份榜单。若工作就是查找,就按查找工具自己的标准去选。
可审查的项目大脑
这一层是当前答案,加上通向它的来路,而且人和另一个 agent 都读得懂。
新会话看不见的,还算不上项目上下文。下一个会话从未见过的决策,常常是一次会议或一段聊天,从未变成记录。只有一个 agent 能看到的记忆,还不算项目记忆。能对应这些失败的形态,是项目大脑:当前结论可以在事实变化时被改写,来路则只追加、不覆盖。
BRAIN.md 是这种形态的开放本地约定。BRAIN.md 文件是协议入口。brain/ 目录存放根文档和页面;页面里保留 compiled_truth 和 timeline。它是可以进 git 的 Markdown,不是隐藏索引。它也不是 AGENTS.md。指令文件仍是简报;大脑保存的是决策。
Letta 的 Context Repositories 是邻近的一种官方设计:记忆以文件保存,并用 git 做版本管理,好让 agent 和人都能检查、更新。出现不止一种做法,正说明这件事是一个类别,而不是单一厂商。
MindMux 的项目大脑 是这一层的产品形态:一份可读的项目知识,让你的 coding agent 可以跨 session、跨工具共享。它不声称取代指令文件、自动记忆或向量检索,也不声称会自动摄入 GitHub、Slack 或 email。
先选层,再选工具
若你需要 agent 遵守规则,就写一份短的指令文件。若你需要它记住偏好或最近的纠正,就用一套会如实说明数据放在哪里、谁能看见的记忆系统。若你需要搜索一批材料,就用搜索。若你需要下一轮 session 读到当前决策,以及它背后的理由,你要的是项目大脑。
当最后这件事还需要云端产品时,请先注册 MindMux 账号。注册成功后,推荐用 MindMux CLI,通过 MCP 连接 Codex 或 Claude Code。安装 CLI 是连接步骤,不是注册本身。若你只想使用本地约定,从 BRAIN.md 开始,并把文件留在 git 里。
若你是从更宽的搜索进来的,划分方式是一样的。换 Notion 应该按工作来选,而不是按最像的克隆来选。Notion AI 是工作区助手,并不会自动变成项目大脑。换 Obsidian 有时是换一个笔记库,只有在某些时候,才是给 agent 一份能共用的依据。