OpenKnowledge：将 Markdown 文件夹变成 AI 智能体的智能知识库
我一直习惯在代码仓库中用纯 Markdown 文件来记录工作笔记和架构文档。一方面，这样很方便：所有内容都存储在本地，用 git 进行版本控制，可以用任何 IDE 打开。但另一方面，用原始标签和表格写长文本很快就会变得繁琐。你想要一个 Notion 或 Google Docs 级别的可视化编辑器，但又不想被绑定到别人的云服务和专有数据格式上。
当 Claude Code、Cursor 和其他终端智能体成为我日常工作流程的一部分时，情况变得更加复杂。你需要不断向它们提供上下文信息、请求重写某个部分，或根据代码库更新文档。
最近，Inkeep 团队开源发布了 OpenKnowledge。本质上，作者们试图将可视化文档编辑器与神经网络智能体的工作环境结合起来。
技术实现
OpenKnowledge 可以打开磁盘上包含 .md 或 .mdx 文件的任何本地文件夹。这可以是你的仓库根目录、技术文档文件夹，甚至是一个旧的 Obsidian 保险库。这里没有专有数据库：应用从磁盘读取文件并以纯格式保存更改。
同时，你获得了一个功能完整的所见即所得编辑器。标题、列表、链接、交互式表格和嵌入式 HTML 块在你输入时会即时格式化。你的眼睛不会被标记语法绊住，生成的文件仍然是标准 Markdown。
主要功能隐藏在侧边。编辑器有一个内置面板，可以通过模型上下文协议 (MCP) 和本地 CLI 工具与语言模型交互。该应用可以与 Claude、Codex、OpenCode、Pi 等智能体并肩工作。
主要编辑器功能
如果将这个项目拆解成各个组件，你会得到一组有趣的功能：
-
不妥协的真正所见即所得。你在便捷的视觉视图中编辑文档，应用会即时保存有效的 Markdown 或 MDX。支持可视化组件、页面间链接图（wiki 链接）、标签页和快速文件搜索。
-
与 AI 协作编辑。智能体在屏幕的另一半打开，可以看到你的文档结构。你可以请求模型创建架构计划、找出规格中的不一致之处，或在实时观察更改的同时重写某个部分。
-
开箱即用的集成协议。首次启动时，该工具会自动检测系统上安装的智能体（Claude Desktop、Cursor、Claude Code），并为你的本地知识库设置 MCP 服务器和搜索技能。
-
通过 Git 进行同步和团队协作。该项目不强制要求付费团队订阅。设备之间和同事之间的同步依赖于纯 Git 和 GitHub。
如何安装和运行
该项目有两种使用方式：现成的桌面应用或通过 Node.js 运行的本地 Web 界面。
macOS (Apple Silicon)、Windows 10+ 和 Linux (deb/rpm) 的桌面构建版本可在项目官网和仓库发布页面获取。
如果你在服务器上工作、使用 Intel Mac，或者只是更喜欢通过控制台启动工具，可以使用 CLI 客户端。它需要 Node.js 24 或更高版本：
# Устанавливаем CLI глобально
npm install -g @inkeep/open-knowledge
# Переходим в папку с документами или проектом
cd your-project
# Инициализируем проект и подключаем найденные AI-агенты
ok init
# Запускаем локальный веб-сервер и открываем браузер
ok start --open
ok init 命令会遍历系统，检查已安装的助手，并在它们和编辑器之间建立连接。
实际应用场景
作者们一开始就为这个工具定位了几个使用场景。
第一个明显的场景是技术文档和架构规格。当需要描述系统设计、编写 RFC 或准备报告时，可视化界面可以节省时间。同时，智能体可以通过 MCP 并行读取相邻的代码文件，并提供准确的函数签名建议。
第二个场景是个人知识库或"第二大脑"。如果你一直在用 LLM Wiki 概念（Andrej Karpathy 经常提到的）做笔记，即智能体帮助组织和链接零散的思考，OpenKnowledge 就充当了这个知识库的接口。全文本和语义搜索有助于通过提示快速检索所需的片段。
总结
OpenKnowledge 看起来是一个成功的尝试，它将 Markdown 编辑从纯文本编辑器的简陋环境中解放出来，同时又不将用户锁定在封闭的云服务中。
该代码以 GPLv3 许可证分发，使用 TypeScript 编写，社区正在积极发展。缺点是 Web 版本需要 Node.js 24+，这可能需要更新旧机器上的环境。但如果你经常处理本地规格文档，并希望让你的 AI 智能体方便地访问文档，这个项目绝对值得一试。
相关项目