OpenKnowledge: 一款以 AI 為核心的 Obsidian 與 Notion 開源替代方案

OpenKnowledge: 一款以 AI 為核心的 Obsidian 與 Notion 開源替代方案

OpenKnowledge 是一款開源的「所見即所得」(WYSIWYG) Markdown 編輯器,旨在作為 Obsidian 與 Notion 等工具的 AI 優先替代方案。它透過將「本地優先」的文件結構與主流 AI agent 的直接整合相結合,為團隊提供無縫的寫作體驗,實現用於規格書撰寫與知識管理的協作式「AI 第二腦」。

原生 AI Agent 整合

OpenKnowledge 與傳統 Markdown 編輯器的不同之處在於,它提供了與 Claude、Codex 與 Cursor 桌面應用程式的深度原生整合。與其他工具中的社群插件不同,這些整合允許 AI agent 在其嵌入式網頁瀏覽器中開啟 OpenKnowledge 編輯器,從而創造出一種並排體驗,讓 agent 可以即時與文件進行互動。

為了支援這些 agentic workflows,該平台包含:

  • 內建 MCPs 與 Skills: 針對 LLM-wiki 場景的專門能力。
  • RAG Support: 整合了檢索增強生成 (Retrieval-Augmented Generation) 以提升 AI 驅動的知識檢索準確度。
  • AI 驅動的協作: 一個讓使用者可以精確看到 AI agent 在 Markdown 文件中修改了什麼的系統。

技術架構與工程實作

OpenKnowledge 建立在現代開源技術棧之上,旨在解決富文本編輯與純文本 Markdown 忠實度之間的衝突。

技術棧 (The Tech Stack)

  • 編輯器核心: Tiptap/ProseMirror 與 CodeMirror。
  • 並行處理: 使用 yjs (CRDT) 進行即時協作與狀態同步。
  • 應用程式框架: Electron (目前僅提供 macOS 版本)。
  • 搜尋與解析: Orama, remark, rehype, micromark, 與 mdast。

工程挑戰

開發團隊解決了兩個主要的技術障礙,以確保該工具能成為專業文件撰寫的可靠替代方案:

  1. 無損 Markdown 轉換: 團隊開發了一套流程,可將 ProseMirror ASTs 雙向轉換為 Markdown 且不失位元忠實度,確保底層文件保持乾淨的 Markdown。
  2. 雙觀察者 CRDT (Dual-Observer CRDT): 為了保持 ProseMirror 狀態與 Markdown 狀態同步,實作了雙觀察者 CRDT。這種架構結合 Git,實現了版本歷史、復原/重做功能以及協作編輯。

團隊協作與數據隱私

OpenKnowledge 利用 Git 與 GitHub 作作為其底層的同步與版本控制層。這種方法讓非技術背景的團隊成員能擁有「無程式碼」(no-code) 的體驗,同時確保數據保持私密且具備版本紀錄。透過使用 Git 作為後端,OpenKnowledge 避免了與專有雲端知識庫相關的供應商鎖定問題。

社群回饋與限制

雖然其 UI 與 AI 優先的方法受到了好評,但 Hacker News 社群指出了幾個需要改進的關鍵領域與目前的限制:

  • 平台可用性: 該應用程式目前僅限於 macOS,使用者對 Windows、Linux 與 Android 的支援表達了強烈的需求。
  • LLM 靈活性: 使用者指出該工具目前與特定的專有服務 (Claude, Codex, Cursor) 綁定。為了符合「開源」哲學,對於支援本地 LLM 與 OpenAI-compatible providers 的需求非常顯著。
  • 遷移路徑: 潛在使用者詢問了從 Notion 或 Obsidian 等既有工具遷移的可用路徑,以降低切換成本。

"對於很長一段時間以來,我一直在尋找一種可以輕鬆分享與同步簡單知識庫的方法... 使用 Git 作為同步/版本控制層,且不需要太過技術化,也不會陷入供應商鎖定... 如果能有內建的 AI 整合,且不依賴於不穩定的插件,那簡直是錦上添花。"

存取與安裝

OpenKnowledge 提供 macOS 應用程式與 CLI 工具。安裝桌面應用程式後,該工具會透過 .zshrc 或 fish 設定檔將 ok 加入系統 PATH,以透過嵌入式終端機啟用 TUI-first workflows。

Sources