<!-- Generated from zh/blog/llms-txt-subpaths-benchmark/index.html. The canonical document is the HTML page. -->

- [ 首页 ](/zh/) 
/
- [ 博客 ](/zh/blog/) 
/
- llms.txt 子路径：113 个站点的基准测试            
# `llms.txt` 子路径：113 个站点的基准测试

路径级文件是 llms.txt v2 的核心。可复现抓取表明它们已经存在，但需要谨慎解读结果。

最近更新: 2026年8月20日

本页内容

- [ 基准测试发现了什么？ ](#result)
- [ 测试是如何进行的 ](#method)
- [ 子路径文件何时有用 ](#scope)
- [ 限制与实施检查清单 ](#limits)            
路径级 llms.txt 可以为代理提供比单一全源文件更小、更相关的地图。我们的首次基准测试发现，在已经提供经过验证的根文件的 113 个主机中，有 21 个在测试过的常见子路径上至少有一个独立文件。

**要点**

- 21 个主机至少在一个测试路径上返回了独立的 H1 文件。

- 测试覆盖了四个常见路径，而不是所有可能的位置。

- 只有代表真实内容边界时，子路径才有用。

## 基准测试发现了什么？

在 12 2026年8月，113 个已验证根文件主机中有 21 个还在以下一个或多个位置返回了以 H1 开头的独立文本文件：`/docs/llms.txt`、`/documentation/llms.txt`、`/help/llms.txt` 或 `/api/llms.txt`。测试排除了重定向、HTML 备用页面、不含 H1 的响应以及正文与根文件相同的情况。

这是观测数量，不是全球采用率。分母有意只包含已经出现在[已验证目录](/zh/examples/)中的主机，分子只包含四条测试路径。主机可能在其他位置发布文件，因此对本测试不可见。

## 测试是如何进行的

脚本从固定的目录快照开始，而不是搜索引擎样本。它为每个源请求四条路径，并附带面向文本的 `Accept` 标头，跟随重定向；只有响应成功且包含 Markdown H1 时才计入结果。

H1 检查可以减少自定义 404 页面和单页应用备用页面造成的假阳性，但不能证明整个文件都正确。使用[验证器](/zh/validator/)检查结构，并在依赖它之前手动检查响应。

原始汇总发布于 [`v2-adoption-stats.json`](/v2-adoption-stats.json)。固定输入样本和目录方法仍然公开，便于后续运行使用相同的分母。

## 子路径文件何时有用

当某个路径下的内容拥有自己的受众、词汇或发布周期时，单独的文件才有意义。文档、API 参考、支持中心和课程区域都是常见候选。兼容的代理在 `/docs/` 中工作时，可以选择 `/docs/llms.txt`，而不是加载一张无关的全公司地图。

不要仅仅因为提案允许就创建路径文件。重复文件会增加维护成本并产生相互冲突的描述。明确所有权，从同一内容源生成链接，并让根文件保持足够宽泛，以便把代理引向专业地图。

[v2 迁移清单](/zh/blog/llms-txt-v2-migration/)说明了安全的发布过程。[最佳实践指南](/zh/best-practices/)介绍了确定范围后的内容整理。

## 限制与实施检查清单

基准测试无法说明代理是否发现或使用了任何文件。它没有测试每条路径、经过身份验证的区域、所列源之外的子域名，也没有测试返回地图的语义质量。它同样无法将搜索表现归因于路径级文件。

对于实现：

- 选择具有稳定信息边界的路径。

- 将文件保持在该路径内，只链接相关资源。

- 在可行时，将 `rel="describedby"` 添加到所覆盖的页面。

- 针对嵌套路由测试“最具体文件”规则。

- 在日志中监控请求，不要假定已经采用。

### 我可以只发布 `/docs/llms.txt` 吗？

是的。v2 提案支持位于源根目录以下的文件。客户端能否发现它，取决于客户端的实现和你的发现信号。

### 子路径文件应该重复根列表吗？

通常不会。重复会消除上下文优势。保留根文件作为路由器，让路径文件保持具体。

### 路径文件能帮助 Google 将该部分编入索引吗？

Google 表示，搜索不会把 llms.txt 当作特殊信号。对于搜索，应使用站点地图、内部链接、可抓取性和有用内容。

## 来源

- [ llmstxt.org，路径作用域文件 ](https://llmstxt.org/)
- [ llmtxt.info，v2 基准数据 ](https://llmtxt.info/v2-adoption-stats.json)
