iwe-org/iwe

解決的問題

IWE 提供了一種將本地 Markdown 檔案目錄轉換為可查詢知識圖譜的方法。它允許使用者以純文字形式完全擁有自己的筆記，同時提供結構化、類似資料庫的檢索能力，滿足人類在編輯器中瀏覽的需求，以及 AI 代理透過命令列或 API 查詢的需求。

工作原理

IWE 使用兩種類型的連結將 Markdown 檔案視為一個連接的結構：「包含連結」用於嵌套（建立層級／樹狀結構），交叉引用用於建立關係網路。單一筆記可以擁有多个父節點，意味著它可以在不複製檔案的情況下屬於多個主題。

對於 AI 代理，它提供 CLI 和 MCP（模型上下文協定）伺服器，使代理能夠搜尋、檢索和重構筆記。透過「expect」保護機制驗證變更的影響範圍，並透過文件模式驗證前端元資料和結構，確保安全性。系統使用 Rust 建構，效能極高，可在一秒內處理超過 20,000 個檔案。

適用對象

• 知識工作者：使用基於 Markdown 的筆記系統，並希望在 VS Code、Neovim、Zed、Helix 等編輯器中獲得類似 IDE 的功能（搜尋、重構、自動補全）。
• AI 代理開發者：希望為其代理提供長期、人類可讀的記憶系統，該系統透過 Git 進行版本控制，避免向量資料庫的「相似性猜測」問題。
• AI 編程代理使用者（如 Claude Code）：希望為專案上下文提供結構化記憶的使用者。

核心亮點

• 純 Markdown 所有權：無專有資料庫或雲端鎖定；所有內容均以 .md 檔案形式儲存。
• 支援模型上下文協定 (MCP)：與 Claude Desktop、Cursor、Windsurf 等 AI 工具原生整合。
• 基於圖譜的檢索：單次呼叫即可取得筆記及其父級上下文和子節點，而非依賴簡單的相似性搜尋。
• LSP 整合：透過語言伺服器協定（LSP）為多個編輯器提供類似 IDE 的功能。
• 受保護的變更操作：AI 代理的寫入操作會根據模式和作用域保護機制進行驗證，防止知識圖譜意外損壞。