IWE — 将你的思考转化为可查询的上下文

为你和你的 AI Agent 打造的 Markdown 知识图谱。

IWE 将 Markdown 文件目录转换为知识图谱——这是一种既能在编辑器中浏览，又能通过 CLI 让 AI 进行查询的连接结构。同一套文件，同样的链接，双重交互界面。无云端依赖，无数据库，无供应商锁定。一切皆通过 git 进行版本控制。

使用 Markdown 编写内容，通过链接构建结构，为 AI Agent 提供导航知识的 工具。IWE 本身不内置 AI，但它能与 Claude、Codex、Gemini 以及任何支持 Model Context Protocol 的工具协同工作。

你能获得什么

• 纯 Markdown，完全所有权。 你的笔记就是本地目录中的 .md 文件。随心阅读、编辑、git push。没有任何私有格式。
• 图谱而非文件夹树。 通过链接连接笔记，同一个笔记可以在不复制文件的情况下隶属于多个主题。（链接原理说明）
• 编辑器级 IDE 特性。 通过 LSP 集成，在 VS Code、Neovim、Zed 和 Helix 中实现搜索、重构、重命名、自动补全。
• 面向 AI Agent 的结构化访问。 CLI 工具 和 MCP Server 让 AI Agent 能够像你一样手动搜索、获取和重构笔记。
• 极速性能。 基于 Rust 构建，可在不到一秒内处理 20,000 个文件。

工作原理

IWE 将你的笔记视为一个连接的结构，你可以使用两种类型的链接来组织它们：

• 嵌套 (Nesting) — 独立行上的链接表示“该主题包含此子主题”。你的笔记形成了一个可浏览、可重构的树状结构。IWE 将其称为 包含链接 (inclusion links)。
• 交叉引用 (Cross-references) — 常规行内链接连接跨主题的笔记，构建起关系网。
• 多父节点 (Multiple parents) — 同一个笔记可以同时存在于多个位置。例如，“冥想”笔记可以同时属于“健康”和“生产力”，而无需复制文件。
• 父级上下文 (Context from parents) — 当你检索笔记时，IWE 可以包含层级中上方笔记的上下文。

这种结构使检索变得非常强大——无论是在编辑器中浏览，还是 AI Agent 通过 CLI 查询，只需一次调用即可获取主题及其完整上下文。

与 AI 协作

IWE 通过两个接口为 AI Agent 提供对笔记的结构化访问：用于脚本编写和基于 Shell 工作流的 CLI，以及用于与 AI 工具原生连接的 MCP Server。两者都支持相同的操作——搜索、获取、创建、重构——因此你可以选择最适合自己配置的方式。

集成服务器 (MCP)

IWE 包含一个服务器 (iwec)，让 Claude Desktop、Cursor 和 Windsurf 等 AI 工具能够使用 Model Context Protocol 直接处理你的笔记。该服务器会监视文件更改，因此你在编辑器中所做的修改会立即生效。

命令行工具 (CLI)

CLI 允许你（以及 AI Agent）从终端或脚本中操作笔记。

示例：为 AI 对话准备上下文

iwe find auth

iwe retrieve --key authentication --depth 2

iwe tree --key oauth

可用命令：

命令	描述
find	使用模糊匹配搜索笔记
retrieve	获取笔记及其子项和父级上下文
tree	显示从任意起点开始的层级结构
squash	将子树合并为一个文档
new	创建笔记（支持从 stdin 读取内容）
extract	将某部分提取为独立笔记
inline	将链接的笔记合并回其父节点
rename	重命名笔记；自动更新所有链接
delete	删除笔记并清理相关引用

更多信息：与 AI 协作 · CLI 参考 · MCP Server

编辑器集成

IWE 为你的编辑器提供 IDE 般的强大特性。