- [ 首页 ](/zh/) / - [ 博客 ](/zh/blog/) / - llms.txt v2 迁移：实用检查清单 # `llms.txt` v2 迁移：实用检查清单 版本 2 对发现机制和作用域的改变大于对文件语法的改变。此清单将必需结构与可选且可测试的改进分开列出。 最近更新: 2026年8月16日 本页内容 - [ llms.txt v2 有哪些变化？ ](#changed) - [ 更改任何内容前先盘点 ](#inventory) - [ 迁移顺序 ](#migrate) - [ 验证与限制 ](#verify) 版本 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 不赋予它特殊的处理语义。在根据已发布规则收紧验证器之前，请查看[格式参考](/zh/llms-txt-format/)。 ## 更改任何内容前先盘点 先记录所有当前文件、重定向、内容类型和使用者。今天返回 HTTP 200 的根文件，在迁移期间也应继续返回 200。仅为了采用 v2 而更改 URL，会破坏已经知道根约定的客户端。 将网站划分为真正不同的范围。文档树可能需要 `/docs/llms.txt`，五页的营销网站则很可能不需要。路径文件应减少无关上下文，而不是逐字重复根文件。 检查是否已经存在简洁的 Markdown。不要宣传一种单薄的转换、错误页面或过时内容作为替代版本。HTML 页面仍是搜索中的规范文档，Markdown 资源则是兼容客户端可读取的机器表示。 ## 迁移顺序 - 使用[llms.txt 验证器](/zh/validator/)验证现有根文件。 - 保留其稳定 URL，只修复真正的语法错误。 - 定义每个路径范围，只在内容边界真实存在时创建更小的文件。 - 从与 HTML 相同的源生成 Markdown，以防止编辑内容偏移。 - 将 `alternate` 和 `describedby` 关系添加到 HTML 模板。 - 在 CI 中测试 HTTP 状态、内容类型、重定向和链接 URL。 - 先在小范围发布，查看服务器日志，然后再扩大范围。 [最佳实践指南](/zh/best-practices/)介绍超越语法的内容整理和安全。对于生产模式，请与[已验证示例](/zh/examples/)比较，不要假设发布就证明有人消费。 ## 验证与限制 我们在 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 为规范版本，不要声称它能带来排名收益。 ## 来源 - [ llmstxt.org，/llms.txt 文件 v2 ](https://llmstxt.org/) - [ Google Search Central，生成式 AI 优化指南 ](https://developers.google.com/search/docs/fundamentals/ai-optimization-guide)