vercel-labs/lat.md

解决的问题

解决使用单个扁平文件（如 AGENTS.md）来为 AI 代理文档化代码库时的可扩展性问题。随着项目规模增长，单体文档变得不切实际，导致设计决策被埋没、业务逻辑未被记录，以及因缺少上下文而引发代理幻觉。

工作原理

该工具创建一个由存储在 lat.md/ 目录中的相互连接的 Markdown 文件组成的知识图谱。它使用一种特定的链接系统：Markdown 部分通过 [[wiki 链接]] 相互链接，并链接到特定的源代码符号；反过来，源代码文件通过 // @lat: 注释链接回知识图谱。CLI 工具提供初始化图谱、验证引用一致性（lat check）以及使用本地 WebAssembly 嵌入模型或 OpenAI 等托管服务进行语义搜索的功能。

适用人群

专为需要在代码库中以结构化、可维护方式跟踪架构、业务逻辑和测试规范的开发者和 AI 编码代理设计，以确保上下文在会话间得以保留。

主要亮点

• 双向链接：将高层文档直接连接到源代码中的实现细节。
• 强制一致性：lat check 命令会标记损坏的链接或缺失的代码引用（针对必需的测试规范）。
• 离线语义搜索：内建本地嵌入模型（all-MiniLM-L6-v2），无需 API 密钥即可进行搜索。
• 代理优化工作流：提供 lat expand 等 CLI 命令，帮助代理解析提示中的引用，并提供 MCP 服务器以实现编辑器集成。