模型一次只能看到项目里的一小部分。当代码规模膨胀到一定程度，把所有文件喂给 AI 就不再是可行的做法——上下文很快被吃光，模型也容易迷失在细节里丢掉对整体的把握。
Graphify 可以会把代码、文档，以及视频、音频等媒体素材，一起构建成一份持久化的知识图谱。但是Graphify 偏向做高层信息抽取，
lat.md
（Agent Lattice）则是另一个方法，它更适合需要严格校验、并且要嵌入到现有工作流里的开发者。它并不只是绘制信息而是强制要求引用完整性：被记录下来的每一个概念，都必须与底层实现保持同步。
为什么简单文档随着项目变大就会失效
小项目里一份 README 就能应付。一旦项目扩展到数千个文件、涉及多个团队，这种做法会在三个方向上崩塌。
第一，文件本身已经超出 AI 一次能读取的范围；第二，文件里的内容很容易过时，因为没有机制去核对它是否还与代码一致；第三，简单文档往往只记录代码做了什么，却忽略它为什么这样写，以及背后需要遵守的约束。
lat.md
的处理方式是把文档拆分成更小、彼此关联的片段，再配上一套自动校验工具，让所有内容与代码保持一致。
第 1 步：搭建项目地图
上手
lat.md
不复杂，不需要繁琐的配置。安装好之后在项目根目录运行一条命令即可。
安装过程是交互式的。它会询问你使用的是哪些 AI 工具（如 Claude 或 Cursor），并帮你完成基本规则的设置。随后它会为项目建立一个专用的“地图”目录，并向你的 AI 工具中写入一条指令：让 AI 优先查阅这张地图，而不是每次都从零开始读取所有文件。
第 2 步：扫描代码
lat.md
启动后做的第一件事，是在本地完成代码扫描。整个过程不会把任何代码上传到网络，保留了开发工作的私密性。
工具支持 20 多种编程语言。它会识别代码中的主要构成单元，函数、类，以及它们之间的连接关系。由于扫描是自动完成的可以确认这份地图忠实反映了实际代码。
第 3 步：把文档连到代码
这是
lat.md
与常规文档最大的区别所在就是它允许你把笔记直接挂到代码的具体位置。
你也可以在代码中写入特殊注释，反向指回对应的笔记。
lat.md
内置了一条
check
命令，用于扫描这些链接：一旦发现链接失效，或某段代码缺少对应文档，工具会立刻给出提示。笔记与代码因此总能讲述同一个故事。
第 4 步：“摘要优先”规则
为了让地图保持可用，
lat.md
要求笔记的每个章节都以一段简短摘要开头，长度控制在几句话以内。
这条规则让AI 在地图中检索时会先借助摘要快速判断哪些章节相关。若某个章节缺失摘要
check
命令会把它标记出来，文档的质量由此得到保证人和 AI 在其中导航也更轻松。
第 5 步：自动校验
文档之所以经常被搁置是因为难以持续更新。
lat.md
的做法是把文档检查塞进日常开发流程里。
可以这样配置：每次保存新代码时
lat.md
自动扫描是否存在断链或缺失的笔记；一旦有问题，就阻止代码被保存直到修复为止，这套机制让项目地图不会逐渐变得“过期”或失真。
如何开始
不必一次性把整个项目都文档化。可以先从最关键的部分入手，比如用户登录或数据持久化逻辑：运行安装流程让 AI 协助写出前几份笔记，再打开自动校验。
不过，
lat.md
仍是一个演进中的项目。它速度很快、语言覆盖也广，但遇到极其复杂的代码时，偶尔会力有不逮。对绝大多数项目来说，它带来的组织度和准确度，是传统笔记难以达到的。
总结
lat.md
让我们不再停留在“搜索”信息，而是面向一张组织有序、经过校验的项目地图。把笔记直接挂到代码上，再让它们的一致性接受自动校验，AI 工具因此变得更聪明、更可靠。
这张地图就是 AI 理解项目的方式，其余的一切都只能算猜测。
如果你想测试只需要安装这个包，然后在任意项目文件夹下运行一次安装命令。一份好的地图能在多大程度上改善工作流，往往会超出预期。
https://avoid.overfit.cn/post/3f8e08b9d78043898fc48f887fbd1b03
作者：Ana Bildea, PhD
