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