llms.txt v2 迁移：实用检查清单
版本 2 对发现机制和作用域的改变大于对文件语法的改变。此清单将必需结构与可选且可测试的改进分开列出。
最近更新:
版本 2 不会把 llms.txt 变成 Google 排名因素。它将提案从一个根文件扩展为面向路径的代理发现系统。只有当兼容代理属于你的使用场景时才迁移，并在测试新部分时保留现有文件。
要点
- H1 仍是文件中唯一必需的部分。
- 更具体的路径文件只能描述该路径下的页面。
- Markdown 替代版本和
describedby是发现辅助机制，不是搜索信号。
llms.txt v2 有哪些变化？
提案现在允许在源根目录或任何路径使用 llms.txt。例如，/docs/llms.txt 可以描述 /docs/，而根文件描述更广泛的网站。当多个文件都可能适用时，代理应使用最具体的那个。
v2 还提出了页面的简洁 Markdown 版本。页面可以通过 rel="alternate" type="text/markdown" 提供该版本，并使用 rel="describedby" 标明适用的地图。这些关系可以出现在 HTML 中，也可以出现在 HTTP Link 标头中。
文件格式本身仍然刻意保持简小。H1 是必需的；摘要、解释性前言、H2 部分和链接描述都是可选的。Optional 仍是有用的编辑标题，但 v2 不赋予它特殊的处理语义。在根据已发布规则收紧验证器之前，请查看格式参考。
更改任何内容前先盘点
先记录所有当前文件、重定向、内容类型和使用者。今天返回 HTTP 200 的根文件，在迁移期间也应继续返回 200。仅为了采用 v2 而更改 URL，会破坏已经知道根约定的客户端。
将网站划分为真正不同的范围。文档树可能需要 /docs/llms.txt，五页的营销网站则很可能不需要。路径文件应减少无关上下文，而不是逐字重复根文件。
检查是否已经存在简洁的 Markdown。不要宣传一种单薄的转换、错误页面或过时内容作为替代版本。HTML 页面仍是搜索中的规范文档，Markdown 资源则是兼容客户端可读取的机器表示。
迁移顺序
- 使用llms.txt 验证器验证现有根文件。
- 保留其稳定 URL，只修复真正的语法错误。
- 定义每个路径范围，只在内容边界真实存在时创建更小的文件。
- 从与 HTML 相同的源生成 Markdown，以防止编辑内容偏移。
- 将
alternate和describedby关系添加到 HTML 模板。 - 在 CI 中测试 HTTP 状态、内容类型、重定向和链接 URL。
- 先在小范围发布，查看服务器日志，然后再扩大范围。
最佳实践指南介绍超越语法的内容整理和安全。对于生产模式，请与已验证示例比较，不要假设发布就证明有人消费。
验证与限制
我们在 12 2026年8月 进行的基准测试检查了来自 113 个 H1 优先根响应所链接的 294 个页面。其中 286 个可访问页面里有 31 个公布了 Markdown 替代版本，4 个公布了 rel="describedby"。这是可观测实现的基线，不是代理偏好任何一种关系的证据。
Google 表示，搜索不会使用 llms.txt 或其他特殊 AI 文本文件。因此，成功的迁移意味着资源稳定、范围正确、发现路径清晰，并且相关客户端的请求可测量；这不意味着排名提高。
我必须替换现有的根文件吗？
不。v2 保留根位置，并增加路径级选项。除非有记录在案的缺陷需要更改，否则保留稳定 URL。
每个 HTML 页面都必须有 Markdown 吗？
不。对于干净文本能帮助代理的页面，提议使用 Markdown 替代版本。视觉页面或交互页面可能没有有用的等价版本。
Google 应该将 Markdown URL 编入索引吗？
Google 可能会抓取许多文件类型，但不会给予这些文件特殊待遇。保持 HTML 为规范版本，不要声称它能带来排名收益。