企业官网建设流程全解析

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

如果你还在用"文件夹套文件夹"管理笔记，一定会遇到这种尴尬：一篇讲"冥想"的笔记，明明同时属于"健康"和"效率"两个主题，却只能放进其中一个目录。iwe 的 inclusion links（包含链接）正是为解决这个问题而生——它是 iwe 这款 Markdown 知识图谱工具的核心特性，让你用一行普通的 Markdown 链接定义文档间的父子关系，一篇笔记可以同时挂在多个主题下，无需复制、无需文件夹。

📁 文件夹的困境：一篇笔记只有一个家

传统的目录组织方式把所有东西塞进"一棵唯一的树"里，这会带来三个经典问题：

• 被迫二选一：冥想.md到底放/health/还是/productivity/？怎么选都别扭
• 引用易断裂：文件夹一改，路径引用全断
• 杂物间泛滥：放不进任何分类的笔记，最终都堆进misc/文件夹

标签（tags）看似灵活，实则很浅：它没有顺序、没有层级、不解释主题之间的关系。一篇笔记被打上#健康 #效率 #正念三个标签后，读者依然不知道哪个是主主题、它们之间是什么联系。

而知识真正的价值恰恰出现在层级的交叉处——"色彩理论"同时属于艺术和物理，"游戏理论"连接数学与经济学。好的知识系统应该支持这种天然的交叉结构。

🔗 Inclusion Links 是什么：一行链接就是父子关系

规则简单到令人惊讶：把一个 Markdown 链接单独放在一行，iwe 就把它当作结构性关系——当前文档成为链接目标文档的"父节点"。

比如在photography.md中写：

# Photography Composition Lighting Post-Processing

这三行链接各自独占一行，于是photography.md就成了composition.md、lighting.md、post-processing.md的共同父文档。这条规则把纯文本 Markdown 变成了一个有结构、可导航的知识系统，而内部表示就是一棵二叉树：标题是节点，链接是指针。

完整的设计说明见 docs/inclusion-links.md。

✨ 核心能力一：一篇笔记，多个主题（多父层级）

这是 inclusion links 最直接的收益。在health-practices.md里写一行Meditation，再在productivity-tools.md里也写同一行——meditation.md就同时出现在两个主题下，内容零复制。

对比一下：

✨ 核心能力二：结构带"语义"

标签只是平铺的，而 inclusion links 支持排序、分组、加说明文字：

# Psychology ## Cognitive How we encode, store, and retrieve information Memory Biases, heuristics, and rational choice Decision Making

注意每条链接前后的说明文字——它不是子文档的一部分，而是父文档为"为什么这个子文档属于这里"提供的上下文。Psychology下的 "Memory" 和Computer Architecture下的 "Memory"，含义完全不同，父级上下文让这种差别一目了然。

✨ 核心能力三：层级可导航、深度可控

链接文档之间，就自然形成了可追溯的路径，例如Knowledge Base > Psychology > Cognitive > Memory。在终端里，iwe tree命令可以直接把整棵层级树打出来，用--depth控制展开深度：

iwe tree --depth 1 # 只看直接子文档 iwe tree --depth 3 # 展开到孙节点

参数细节见 docs/cli-tree.md。

🔍 和 Inline Links（行内链接）的区别

这一点新手最容易混淆，iwe 把它们分得很清楚：

• Inclusion Links（独占一行的链接）：定义结构。用于导航、--depth层级遍历，retrieve时会展开成完整内容
• Inline Links（正文中的链接）：定义概念引用。生成反向链接（backlinks），表示"这两个想法相关"，但不改变结构，检索时只保留为引用

所以一篇讲"习惯养成"的笔记，用行内链接提到"习惯回路"和"多巴胺通路"，读者能顺着引用跳转，但这两篇文档并不会变成它的子文档。结构与连接各司其职，这是 iwe 知识图谱设计的精妙之处。

🤖 给 AI Agent 的记忆检索也靠它

iwe 的 MCP 服务器和 CLI 都深度利用 inclusion links 做上下文检索。iwe retrieve可以沿包含边向上或向下扩展阅读范围：

# 读取文档并顺带拉入两级子文档和一级父文档 iwe retrieve -k habit-formation --expand-includes 2 --expand-included-by 1

查询语言还支持图操作符$includes/$includedBy，直接在过滤器里"走"包含关系，比如找出"同时被 alpha 和 beta 两个项目包含"的文档，或找出没有被任何文档包含的根文档。语法参考 docs/query-language.md，检索参数见 docs/cli-retrieve.md。

🚀 快速上手三步走

1. 初始化笔记库：在你的笔记文件夹里运行iwe init
2. 建一篇主题文档（如psychology.md），把子笔记的链接各占一行写进去
3. 运行iwe tree查看层级树；把同一条链接复制到另一篇主题文档里，这篇笔记就多了一个"家"

编辑器侧的体验（链接自动补全、反向链接、安全重命名）在 VS Code、Neovim、Helix、Zed 中都可用，见项目根目录的 README.md。

总结

Inclusion links 用一条极简规则，给 Markdown 带来了文件夹没有的灵活和标签没有的结构：

• ✅ 文档可以同时存在于多个主题下，零复制
• ✅ 顺序、分组、上下文说明全部显式可见
• ✅ 层级可导航、可查询、可被 AI Agent 按需扩展检索

如果你的笔记正被文件夹结构束缚，不妨试试这个"一行链接定层级"的方式——这正是 iwe 把一堆 Markdown 变成知识图谱的基石。

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