现在很多人用 AI Agent 写代码、做方案、整理资料，已经不是一次性问答了。

问题也很明显：上下文太容易断。

今天让 Claude Code 写一份设计文档，明天让 Codex 接着改实现，后天又用 Cursor 查资料。每个工具都挺强，但项目背景、决策过程、资料链接、任务进度，很容易散在不同聊天记录里。

最后你会发现，真正麻烦的不是 Agent 不会写，而是它每次都要重新认识你的项目。

最近在 HN 上看到一个开源项目 OpenKnowledge，热度还不错。它的定位很直接：

一个给人和 AI Agent 一起用的 Markdown 知识库。

它有点像 Obsidian / Notion，但重点不是再做一个笔记软件，而是让 Claude、Codex、Cursor 这类 Agent 可以读、写、维护同一套知识库。

OpenKnowledge 是什么？

OpenKnowledge 是 Inkeep 开源的 AI-native Markdown 编辑器和 LLM Wiki。

简单说，它把三件事放在一起：

层次

作用

编辑器

像 Notion 一样编辑 Markdown，支持 WYSIWYG 和源码模式

知识引擎

通过 MCP、skills、搜索等能力让 Agent 读写知识库

文件系统

底层仍然是普通 Markdown 文件，可以进 Git

这点挺关键。

很多知识库工具看起来很智能，但资料一旦进去，就变成某个产品自己的数据库。OpenKnowledge 的思路更朴素：文件还是你的 Markdown，历史还是可以用 Git 管，编辑体验和 Agent 能力再叠上去。

官方文档里把它说成：

A markdown knowledge base your AI coding agents can read and edit.

这句话基本就够了。

它不是只给人看的知识库，而是给 Agent 也能操作的知识库。

为什么不是再用 Obsidian？

Obsidian 很强，Markdown、本地文件、双链、插件生态，都已经很成熟。

但 OpenKnowledge 想切的是另一个问题：

当 AI Agent 进入工作流以后，知识库不能只是“人类写给自己看”的地方。

比如你在项目里有这些内容：

• 产品需求；• 架构决策；• 接口约定；• 会议纪要；• 上线清单；• 竞品资料；• 任务交接记录。

以前这些主要是人来读。

现在 Agent 也需要读这些东西，而且不只是读，还要能在完成任务后写回新的结论、补充文档、更新进度、留下变更记录。

如果每次都把资料复制进聊天框，迟早会变成上下文搬运工。

更合理的方式是：

项目资料 -> Markdown 知识库
Agent 通过 MCP/skills 查询和编辑
人通过编辑器审阅和调整
Git 记录历史

这就是 OpenKnowledge 比较有意思的地方。

它不是要替代所有笔记工具，而是试图给 AI Agent 准备一个共享工作台。

它能和哪些 Agent 配合？

OpenKnowledge 官方重点提到的集成包括：

• Claude；• Cursor；• Codex；• OpenCode；• 其他支持 MCP 的 Agent。

它提供内置 MCP、Agent skills 和 agentic search。也就是说，Agent 可以通过工具调用去查知识库、写文档、维护链接和 frontmatter，而不是只靠“读整个目录”硬扫。

官网展示的场景也很明确：让 Agent 直接更新项目文档、决策记录、复盘、路线图，而人可以在同一个编辑器里看到和继续修改。

这类体验对技术团队尤其适合。

因为很多团队现在已经开始把代码、文档、任务和 Agent 放进同一个 Git 工作流里。OpenKnowledge 这类工具想解决的，就是“资料在 Markdown 里，人和 Agent 都能碰，但别把结构弄乱”。

适合拿来做什么？

我觉得最适合的不是普通日记，而是这些场景。

1. 项目 Wiki

把项目背景、模块说明、接口约定、部署说明、常用命令都放进去。

以后让 Agent 改代码前，先查项目 Wiki；改完之后，再让它补充相关文档或交接记录。

这比每次开新会话都重新解释项目历史舒服很多。

2. Agent 记忆库

如果你经常在 Claude Code、Codex、Cursor 之间切换，最需要一个独立于具体工具的记忆层。

OpenKnowledge 可以作为这个记忆层的一部分：让长期规则、决策记录、任务状态都落在 Markdown 文件里，而不是散在某个工具的聊天历史里。

3. 规格文档和 PRD

AI Agent 写代码之前，最好先有清楚的规格文档。

OpenKnowledge 支持富文本编辑体验，又保留 Markdown 底层，适合写需求说明、设计文档、接口草案、上线计划。

人负责判断方向，Agent 负责补齐结构、维护链接、生成初稿和更新变更记录。

4. 团队知识库

官方也提到 Git-backed sync 和 team sharing。

这意味着它不是只想做个人本地工具，也想覆盖团队协作：知识库内容同步到底层 Git/GitHub，保留历史和归属。

这件事对团队很重要。

很多协作文档工具好用，但历史、权限、迁移和 Agent 接入都容易变复杂。Markdown + Git 至少给了一个更透明的底座。

怎么上手？

如果你是 macOS 用户，可以直接下载桌面 App。

其他系统可以用 CLI 跑本地 Web 应用。官方 README 给的基本命令是：

npm install -g @inkeep/open-knowledge
cd your-project
ok init
ok start --open

这里有个细节：它不是让你新建一个孤立笔记库，而是可以在项目目录里初始化。

这样知识库天然贴着项目走。

比如你可以在一个代码仓库里维护：

docs/
specs/
decisions/
runbooks/
retros/

然后让 OpenKnowledge 提供编辑器和 Agent 工具层。

我的建议是先别把私人笔记全迁进去。更适合从一个可控项目开始试：

• 一个正在开发的小产品；• 一个内容选题库；• 一个开源项目文档；• 一套团队 SOP；• 一个长期写作资料库。

先验证 Agent 是否真的能帮你维护知识，而不是只多开一个编辑器。

需要冷静看待什么？

这个项目今天有热度，但还不能无脑吹。

HN 评论里也有人提到一个很现实的问题：如果 AI 体验还需要在 OpenKnowledge 和 Claude/Codex 之间来回切，整体体验可能没有想象中丝滑。

也有人关心本地模型支持、跨平台成熟度，以及它相比 Obsidian 插件到底多了多少不可替代价值。

这些质疑都合理。

我觉得目前更准确的判断是：

OpenKnowledge 的方向很对，但它还在早期，需要看后续集成体验能不能做顺。

它最有价值的不是“又一个漂亮 Markdown 编辑器”，而是几个趋势叠在一起：

• Agent 需要长期记忆；• 项目知识需要可被机器读写；• Markdown 和 Git 仍然是透明、可迁移的底座；• 人和 Agent 会越来越多地协作编辑同一批文档。

如果你只是想写个人日记，Obsidian、Notion、Apple Notes 都已经够用。

但如果你已经在认真使用 Claude Code、Codex、Cursor 做项目，那 OpenKnowledge 这种“Agent 可读写知识库”就值得关注。

我会怎么用？

如果让我现在试，我不会一上来迁移全部资料。

我会先建一个独立项目，比如：

agent-workspace/
README.md
docs/
decisions/
prompts/
tasks/
handoff.md

然后让不同 Agent 都围绕这个目录工作：

• 开始任务前先读 README.md 和 handoff.md；• 做技术选择时写入 decisions/；• 发现常用提示词就放进 prompts/；• 任务结束前更新 handoff.md；• 重要改动通过 Git 留痕。

OpenKnowledge 在这里扮演的角色，就是让这个目录不只是文件夹，而是一个更适合人和 Agent 共同维护的知识工作台。

这个使用方式比较克制，也更容易判断它有没有真的提高效率。

小结

AI Agent 越强，越需要一个稳定的知识底座。

聊天框适合临时对话，但不适合长期承载项目记忆。

OpenKnowledge 有意思的地方在于，它没有把知识库做成一个封闭系统，而是回到 Markdown、Git、MCP、Agent skills 这些更开放的组合。

它现在还不是“Obsidian 终结者”，也不一定会替代 Notion。

但它抓住了一个很真实的需求：

未来的知识库，不只给人看，也要给 AI Agent 读、写、搜索和维护。

如果你已经在用多个 AI 编程工具，或者正在搭自己的 Agent 工作流，这个项目值得放进观察清单。

别再把所有资料都塞进聊天框了。

让 Agent 有一个能回去查、能继续写、能留下历史的地方，可能才是长期使用 AI 工具的正确姿势。

资料来源• GitHub：inkeep/open-knowledgehttps://github.com/inkeep/open-knowledge• OpenKnowledge 官网https://openknowledge.ai/• OpenKnowledge 文档https://openknowledge.ai/docs/get-started/overview• Hacker News 讨论：Show HN: OpenKnowledgehttps://news.ycombinator.com/item?id=48675435