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 代理的写入操作会根据模式和作用域保护机制进行验证，防止知识图谱意外损坏。