1,419· 60 forks· TypeScript· GPL-3.0开源替代

OpenKnowledge - AI 原生 Markdown 编辑器与 LLM 知识库

inkeep/open-knowledge

对标 Obsidian/Notion 的开源 AI 编辑器,真 WYSIWYG 体验,原生集成 Claude/Codex,支持 MCP 协议与智能体技能系统

成熟度维护活跃,最近提交今日,10个开放 issues,2天前刚发 v0.19.2

项目体检

部署 · 无 Docker,macOS 下载 DMG 直接安装;Linux/Windows 通过 npm 全局安装 CLI 后 ok start 启动本地 Web 服务(默认端口 5173 可通过 VITE_PORT 自定义)

成本 · 开箱即用无需外部 Key,所有环境变量可选;AI 功能需自行配置 Claude/Codex 等 LLM 服务;Node.js 24+ 必需

技术 · TypeScript + Vite 前端,Bun 运行时,支持 MDX 渲染与 MCP 协议集成

许可 · GPL-3.0-or-later 协议,可商用但修改后的衍生作品必须开源并保持相同协议

活跃 · 2天前发布 v0.19.2,12位贡献者,今日仍有提交,活跃度高

解决什么

传统 Markdown 编辑器(如 Typora)缺乏 AI 能力,而 Notion 等商业工具数据锁定在云端。OpenKnowledge 定位为"AI 原生"的本地知识库方案:用户在本地文件夹编辑 Markdown/MDX 文件,同时获得类似 Notion 的所见即所得体验,并能直接调用 Claude、Codex 等 AI 助手协作写作。核心痛点是让开发者和知识工作者在保持数据主权(本地文件)的前提下,享受 AI 辅助与现代化编辑界面。

为何火

HN 讨论达 374 点、170 条评论,热度来自三点:1) UI 颜值,多位用户直言"被漂亮界面吸引";2) 互操作性,直接打开 Obsidian vault 或现有代码库文件夹即可使用,无需迁移;3) AI 集成深度,内置 MCP(Model Context Protocol)服务器,可作为 Claude Desktop、Cursor 等智能体的"技能库"。争议点在于 macOS 独占桌面应用(Linux/Windows 仅 Web 版),以及缺乏 Obsidian 插件生态(如 Dataview 数据库视图)。

核心功能

  • 真 WYSIWYG 编辑:Markdown 语法实时渲染为富文本,编辑体验接近 Google Docs,支持 Obsidian 的 wikilink 语法
  • AI 协作编辑:与 Claude Code、Codex、Cursor 桌面应用深度集成,可通过 MCP 协议让任何 AI 智能体读写知识库
  • LLM Wiki 模式:内置智能体搜索与技能系统,可作为 AI 的"第二大脑"提供上下文
  • Git 自动同步:底层用 Git/GitHub 实现团队共享与版本控制,对用户透明
  • 嵌入式组件:支持在 MDX 中插入 HTML、图表等富组件,适合工程规格文档
  • 内置 TUI:桌面应用含终端界面,Web 版也可通过 CLI 操作

安装

macOS 用户:下载 DMG 安装包,拖入 Applications 文件夹即可。Linux/Windows/Intel Mac 用户需通过 npm 安装 CLI(需 Node.js 24+):

npm install -g @inkeep/open-knowledge
cd 你的项目目录
ok init    # 初始化配置,自动检测本地 Claude/Codex
ok start --open  # 启动 Web 编辑器并打开浏览器

可直接打开现有 Markdown 文件夹(如 Obsidian vault)使用,也可选择官方模板创建新项目。

适合谁

  1. 需要 AI 辅助写作的开发者:写技术文档、项目规格时可随时调用 AI 补充内容
  2. Obsidian 重度用户:想要更现代的编辑界面,但不愿放弃本地 Markdown 文件
  3. 构建 AI 智能体的团队:通过 MCP 协议让智能体访问结构化知识库
  4. 隐私敏感用户:数据完全本地存储,AI 调用需自行配置 API Key

不适合:依赖 Obsidian 插件生态(如 Dataview 数据库)的用户,以及需要移动端同步的场景(暂无 Android/iOS 应用)。

社区评价

HN 社区对 UI 设计高度认可,多位用户表示"颜值即正义"。核心争议集中在平台支持:Linux/Windows 用户抱怨只能用 Web 版,开发者回应称"CLI + Web 实测体验不错",并建议社区反馈 Electron 打包需求。迁移成本是另一焦点:Obsidian 用户担心失去 Dataview 等插件功能,开发者承认"数据库视图暂不支持,但会以更好的方式实现"。正面评价包括与 Slite 等工具互操作(Markdown 导入导出)、Obsidian vault 直接打开无需迁移。有用户质疑"号称本地却不支持本地 LLM",开发者澄清 MCP Server 理论上兼容本地模型,但文档待完善。

选型对比

vs Obsidian:OpenKnowledge 胜在 AI 原生集成与现代 UI,Obsidian 胜在插件生态(社区插件 1000+)与全平台支持。若需数据库视图、复杂查询选 Obsidian;若优先 AI 协作与团队同步选 OpenKnowledge。

vs Notion:OpenKnowledge 数据本地存储(Markdown 文件),Notion 云端锁定;前者开源免费,后者商业订阅。Notion 胜在协作体验与模板市场,OpenKnowledge 胜在隐私与可扩展性(可接入任何 AI 模型)。

vs Logseq:两者都支持本地 Markdown 与双向链接,Logseq 侧重大纲笔记,OpenKnowledge 侧重 AI 辅助长文写作。

已知坑

  1. 平台限制:桌面应用仅 macOS,Linux/Windows 需通过浏览器访问本地服务,体验打折扣
  2. AI 依赖外部服务:需自备 Claude API Key 或 Codex 账号,暂无内置开源模型支持,国内用户可能需梯子
  3. 插件生态缺失:不支持 Obsidian 插件,Dataview 等高级功能需等官方实现
  4. 移动端空白:无 iOS/Android 应用,移动场景只能通过浏览器访问(需设备在同一局域网)
  5. Git 同步学习成本:虽然对用户透明,但多人协作时仍可能遇到合并冲突,需基本 Git 知识
  6. Node.js 版本要求高:需 24+ 版本,部分 Linux 发行版默认源可能不满足

安装方式:npm