OpenKnowledge：Notion 遇上 VS Code，一个让 Claude 和 Codex 直接读写知识库的 AI-native Markdown IDE

OpenKnowledge：Notion 遇上 VS Code，一个让 Claude 和 Codex 直接读写知识库的 AI-native Markdown IDE

先收藏，回头一定用得上。

过去的知识管理，人和 AI 是分开的。

你在 Notion 或 Obsidian 里写文档，AI 在另一个聊天窗口里回答问题。你想让 AI 帮你整理知识库，得手动复制粘贴；AI 想读你的文档，得靠你一段段喂给它。文档是文档，Agent 是 Agent，两者之间没有真正的通道。

inkeep/open-knowledge 想把这两件事合成一件。这个 GitHub 上 4300+ stars 的开源项目，TypeScript 实现、GPL-3.0 协议，定位一句话——"Notion meets VS Code"：一个真正所见即所得的 Markdown IDE，同时把 Claude、Codex、OpenCode 这些 Agent 深度织进写作环境。它不是"编辑器里加个 AI 侧边栏"，而是把知识库本身变成 Agent 能直接读、直接写、直接协作的地方。

本文提纲

  1. 它是什么：一个 AI-native 的 Markdown IDE
  2. 核心能力拆解
  3. Agent 深度集成：MCP、Skills 与 ACP
  4. 桌面 + Web 双形态与 Git 同步
  5. 为什么这是"文档的 Agent 化"
  6. 清醒剂与适用边界

它是什么：一个 AI-native 的 Markdown IDE

官方定义很简洁：一个漂亮的 Markdown 编辑器，集成 Claude、Codex 和其他 harness，用于知识库、LLM wiki、spec 和笔记——私有、本地、免费。

出品方 Inkeep 本身做的就是 AI 搜索和知识基础设施，这解释了项目的核心取向：它不是又一个通用代码编辑器，而是专门围绕"知识"和"文档"构建。官网 openknowledge.ai，2026 年 6 月开源，三个月冲到 4300+ stars。

"Notion meets VS Code"这个比喻值得拆开看：
- Notion 那一半：真正的所见即所得，编辑 Markdown 像编辑 Google Doc 或 Notion 页面，没有传统 Markdown 编辑器那种"源码/预览"割裂；文件导航、搜索、标签页、wiki 双链图谱视图一应俱全。
- VS Code 那一半：它打开的是你本地真实的文件夹，能直接用在现有代码库、Obsidian vault、文档仓库上；并且面向工程场景，支持 spec、技术报告、嵌入 HTML 和丰富组件。

你可以只把它当一个漂亮的 WYSIWYG Markdown 编辑器用，也可以用它的 starter pack 搭建 LLM Wiki、第二大脑或结构化知识库——下限很低，上限很高。

核心能力拆解

真 WYSIWYG 编辑
全功能所见即所得，你写标题、列表、表格、代码块时，看到的就是最终排版效果，而不是 #、| 这些标记符。这是它对标 Notion/Google Doc 体验、区别于多数 Markdown 工具最直观的一点。编辑器底层是块（block）结构，带气泡菜单、剪贴板处理、资源调度，源码里能看到 block-ux、bubble-menu、asset-dispatch 等完整的块编辑子系统。

桌面 App + Web UI
桌面端支持 macOS（含 Apple Silicon）、Windows（x64/Arm64，per-user 安装免管理员）、Linux（deb/rpm，x64/arm64）。Web 端通过 CLI 在任意平台跑同一个编辑器，带文件导航、搜索、标签、wiki link 图谱查看。

并排 AI 编辑
真正的亮点：Claude、Codex、OpenCode、Pi 等 Agent 可以和你的文档并排工作——你看着 Agent 在同一环境里起草、改写、检索，而不是切到独立聊天框。而且不限定特定厂商，任何 harness/agent 都能通过 MCP 或 CLI 接入。

工程化表达
支持嵌入 HTML 和丰富组件，适合写工程 spec 和可视化报告。这对技术团队很实用：文档不再只是纯文字，可以带交互组件、数据展示。

Agent 深度集成：MCP、Skills 与 ACP

这一节是它区别于"带 AI 功能的编辑器"的关键。OpenKnowledge 在三个层面与 Agent 生态对接。

MCP（Model Context Protocol）
开箱即用的 MCP 支持。这意味着知识库可以作为 MCP 资源/工具暴露给 Agent，Agent 据此对文档做增强搜索和读写。我们反复讲过：MCP 解决"Agent 怎么连工具"，而 OpenKnowledge 让"整个知识库"成为 Agent 可连的对象——Agent 不必靠你复制内容，直接通过 MCP 检索、引用、更新文档。

Skills（技能）
内置 skills 体系，文档里专门有一整块讲 built-in skills、如何查找安装、团队 skills 安装。App 会自动检测你电脑上的 Agent harness，引导你为它们安装对应的 MCP 和 skills，目的是帮 Agent 获得更强的文档搜索和写作能力。这和我们持续跟踪的趋势一致：重复的知识工作流程正被编码成可复用的 skill。

ACP（Agent Client Protocol）组件
源码里有专门的 components/acp 目录，说明它实现了 Agent Client Protocol——和 Zed 推动的 Agent 通信标准对齐。ACP 定义编辑器/IDE 如何与编码 Agent 通信（消息、工具调用、权限）。加上 handoff（人机交接）组件，OpenKnowledge 在协议层把"文档环境"和"Agent 运行时"标准化地连了起来。

一个命令能看清这套设计的自动化程度：ok init 会扫描并 wire up 你机器上所有 AI 编辑器（Claude Code、Claude Desktop、Cursor、Codex、OpenCode、OpenClaw），一次性把 MCP 和 skills 装好。这正是你喜欢的"一个命令搞定全链路"风格——不用一个个 Agent 去手动配置。

桌面 + Web 双形态与 Git 同步

两种使用形态：

桌面 App 从 openknowledge.ai/download 下载，覆盖三大操作系统。

Web App 适合服务器或不想装桌面端的场景，通过 CLI（要求 Node.js 24+ 和 git）：

npm install -g @inkeep/open-knowledge
cd your-project
ok init           # 脚手架 + 连接各 AI 编辑器
ok start --open    # 启动 Web 编辑器并在浏览器打开

Git/GitHub 驱动的同步与分享：
无需配置复杂后端，团队分享和自动同步在底层用 Git/GitHub 实现。这是个聪明的设计取舍：文档已经是纯文本 Markdown，Git 天然是最成熟的版本控制和协作工具——把它作为同步层，既免费可靠，又自带版本历史、分支、code review。文档可以选择性启用同步，私有本地和团队共享之间灵活切换。

为什么这是"文档的 Agent 化"

把 OpenKnowledge 放在我们持续跟踪的技术图景里，能看到一个清晰的趋势。

过去一年，我们拆过 harness（Agent 怎么跑）、MCP（Agent 怎么连）、本体（Agent 怎么理解数据语义）。OpenKnowledge 补上了另一块：Agent 怎么与"知识"本身共处。

传统软件的逻辑是"人用工具生产文档"。OpenKnowledge 的逻辑是"人和 Agent 在同一个环境里共同生产和维护知识"。文档不再是 Agent 之外的静态产物，而是 Agent 能读、能写、能引用、能持续更新的活对象。当 Agent 通过 MCP 直接检索知识库、通过 skills 掌握写作流程、通过 ACP 与编辑器实时通信时，知识库就从"人写给人看"变成"人和 Agent 共建、也供 Agent 使用"的双向资产。

这对企业尤其重要。一个组织最有价值的积累之一是文档和知识，但它们常常散落在各处、过时、难检索。当 Agent 能直接读知识库拿到准确上下文（而不是每次重新 RAG 或靠人喂），并能主动帮你整理、更新、链接时，知识才真正流动起来。这也解释了为什么做 AI 搜索起家的 Inkeep 会做编辑器——入口决定数据，让 Agent 从文档生产的源头就接入，比事后去检索更有效。

清醒剂与适用边界

几句实在话。

协议是 GPL-3.0，不是 MIT——这对使用没影响，但如果你想把它深度集成进闭源商业产品再分发，GPL 的传染性需要法务评估，这和我们见过的多数 MIT/Apache 项目不同。

它的核心仍是 Markdown 编辑器，不是"自动帮你建好知识库"的魔法。 Agent 能帮你整理、起草、检索，但"知识该怎么组织、什么内容有价值"仍需人判断。Git 同步虽方便，也要求你接受 Git 的工作方式，非技术团队可能需要适应。

Agent 集成的深度依赖你本地的 harness 生态——它能 wire up Claude Code、Codex 等，但这些 Agent 本身的订阅/配置仍要你自己准备好。项目还在快速迭代（changeset 里大量在做权限疲劳、Agent 面板、桌面 worktree 等细节打磨），部分能力可能变动。

但方向是明确的：写作环境和 Agent 运行时正在合流。 未来的 IDE 不只是写代码的地方，也是人和 Agent 共同思考、共同沉淀知识的地方。OpenKnowledge 是这个方向目前完成度很高的开源样本。

想动手，路径很简单：装桌面 App 或 npm i -g @inkeep/open-knowledge → ok init 自动连接你的 Agent → 打开一个现有文档文件夹 → 让 Agent 并排帮你整理。一个下午就能体验"文档和 Agent 共处"是什么感觉。

参考链接

你的知识库现在是"人写给人看"，还是已经让 Agent 能直接读写？还在手动复制内容喂 AI 吗？评论区聊聊你的工作流。觉得有用点个赞，让更多做知识管理和做 Agent 的人看到这个项目。

作者: itech001
来源: 公众号：AI人工智能时代(the-ai-era)
网站: https://www.theaiera.top/
关注每日最新AI新闻和技术博客，主页有更多的文章的AI 技术参考：https://www.theaiera.top

本文首发于 AI人工智能时代，转载请注明出处。

posted @ 2026-09-24 09:06  iTech  阅读(5)  评论(0)    收藏  举报