企业官网建设流程全解析

• 人工智能
• Agent 记忆
• MCP 服务
• CLI
• 知识管理
• 开发工具

🤔 用过不少笔记工具后，你可能发现一个矛盾：结构太死板，写起来像填表格；结构太自由，积累一年后就是一堆找不到东西的"文件坟场"。开源项目iwe选择了一条中间路：它是一个基于 Markdown 知识图谱的文本图管理工具（LSP + CLI + MCP 三合一），不规定你的笔记结构，却帮你把维持结构一致性的体力活全部自动化。

这篇文章带你拆解 iwe 官方文档 docs/design-principles.md 中写明的3 条设计原则，看看"拒绝规定笔记结构"背后，究竟藏着一套怎样的思考。

先看懂前提：iwe 把笔记当作"图"

在讲原则之前，需要一个关键概念：iwe 在你打开工作区的那一刻，就会把整个目录的 Markdown 文件读进内存，构建出一张图（Graph）——每个标题、段落、列表、引用都变成图上的节点，链接变成节点之间的边。

正是这个数据模型，决定了 iwe 能"不管你怎么写，都能帮你打理"。官方文档 docs/data-model.md 用一张图说明了结构如何映射为二叉树状的图：

图节点的实现代码在 crates/liwe/src/graph/builder.rs，这也是 LSP、CLI、MCP 三种界面共享的同一个核心模型。

💡 一句话理解：文件是你的，结构是你的，iwe 只是那个帮你维护图的"隐形管家"。

设计原则一：不假设任何结构，命名权完全交给你

官方文档 docs/design-principles.md 的第一条原则原文只有两句话，却足够"激进"：

Do not assume any particular graph structure or file naming convention. It is up to the user to decide on these details.

不要假设任何特定的图结构或文件命名约定，这些都由用户自己决定。

这意味着 iwe 故意不做很多工具会做的事：

那"没有结构"怎么导航？iwe 的答案是包含链接（Inclusion Links）：一个独占一行的 Markdown 链接，就表示"当前文档是它的父文档"。同一个笔记可以同时属于多个父文档——"冥想"既可以放在/health/下，也可以放在/productivity/下，而文件夹天然做不到这点。细节见 docs/inclusion-links.md。

设计原则二：把重复劳动压到最低，格式化全部自动化

第二条原则的目标是：让"保持图的一致性"所需的人工投入降到最低。

The goal is to minimize routine operations. Keeping the graph consistent should require the least possible amount of effort. The text formatting needs to be automated.

落到实际体验上，iwe 在你保存文件时自动完成这些繁琐操作（详见 docs/feature-auto-format.md）：

• ✏️链接标题同步：目标笔记改了标题，所有引用它的链接文字自动跟着更新
• 🔢有序列表自动重排号：手动改完顺序，编号自动变回 1、2、3
• 📑标题层级修正：#之后突然冒出####？自动拉平成合理的树结构
• 🧹空白清理与缩进归一：多余空行、错乱的列表缩进原地修复

你只管写内容，"让链接不烂、编号不错、层级不乱"这些事，交给保存时的自动格式化。配置文件在.iwe/config.toml，全部可选项见 docs/configuration.md。

设计原则三：做"积木"，而不是做"功能"

第三条原则最有意思：

Focus on building blocks, not specific features. All simple operations as a "daily note" can be implemented at the editor level.

翻译过来就是：iwe 只打磨"图的基本操作"，不内置具体功能。像"每日笔记"这种场景化功能，官方认为用编辑器层面的配置就能搭出来（通过attach动作 + 模板变量，见 docs/configuration.md），所以不做成硬编码功能。

iwe 提供的是这些"积木"，你可以自由组合：

• 🔍搜索：模糊匹配 + BM25 双路排序融合，CLI、编辑器、AI 三方读同一个索引
• ✂️Extract / Inline 重构：把一段拆成新笔记，或把引用的笔记并回来，所有受影响链接自动重写
• 🧩查询语言：MongoDB 风格的 YAML 过滤，作用于 frontmatter 和图上的边
• 🤖MCP 服务：把同样的图操作暴露给 AI 代理（14 个工具）

"积木"而非"功能"的哲学，还体现在官方自我对比里——iwe 自己承认在日记模板、实时诊断、移动端上不如某些竞品，因为它选择不做那些"规定你怎么用"的部分。完整对比见 docs/comparison.md。

3 条原则一张表看懂

总结：自由的结构 + 零成本的维护 = iwe 的答案 🎯

回到标题的问题：为什么 iwe 拒绝规定笔记结构？

因为对 iwe 来说，"结构"是你和你的 AI 代理共同演进出来的资产，而不是工具预设的模板。它把三件事做到极致——结构归你（原则一）、维护归它（原则二）、能力做基础积木（原则三）——从而让一个普通的 Markdown 文件夹，既可以是你的日记本，也可以是 AI 的共享记忆。

如果你想动手体验，可以从 docs/how-to-install.md 开始，或阅读官方文档总目录 docs/index.md。

• 人工智能
• Agent 记忆
• MCP 服务
• CLI
• 知识管理
• 开发工具