The Papers

指南

什么是 llms.txt,如何将它用于您的文档?

llms.txt 是一项提议中的标准:位于 /llms.txt 的一个 Markdown 文件,为 AI 模型提供一份简短、精选的网站地图——一个标题、一段摘要,以及指向最有用内容的链接列表,这些内容最好是干净的 Markdown。对于文档而言,它就是一个索引,告诉智能体有哪些文件、每个文件是什么,以及去哪里读取文本版本,而不必解析 PDF。

提案的内容

llms.txt 提案(llmstxt.org)针对的是一个简单的问题:网站是为浏览器构建的,其中的导航、脚本和版式会浪费模型有限的上下文。位于已知地址的一个小型 Markdown 文件,能让模型快速找到重要内容。

  • 位置:网站根目录下的 /llms.txt(提案也允许放在子路径下)。
  • 一个包含项目或网站名称的 H1——这是唯一必需的部分。
  • 一个包含简短摘要的引用块。
  • 可选的段落或列表,提供更多细节。
  • 包含链接列表的 H2 章节,链接格式为 [name](url),后面可附简短说明。
  • 一个“Optional”章节,用于在上下文不足时可以跳过的次要链接。
  • 鼓励各页面在原 URL 后加上 .md,提供一个干净的 Markdown 版本。

一组文档的 llms.txt 是什么样的

对于一家公司的文档,llms.txt 就是给 AI 看的目录。一个简短示例:

# Example Co — Investor documents

> Current investor materials for Example Co. Figures are verified against source files.

## Documents

- [Q3 2026 investor update](https://example.com/docs/q3-update.md): quarterly results, unaudited

- [Pitch deck, October 2026](https://example.com/docs/deck.md): company overview and round terms

## Optional

- [Archive of earlier updates](https://example.com/docs/archive.md)

文档 llms.txt 的最佳实践

  • 链接到文本版本(.md),而不是 PDF——目的就是让智能体免于解析版式。
  • 每份文档写一行,说明它是什么以及所属期间:“Q3 2026,未经审计”远胜于“更新”。
  • 只列出当前版本;把已被取代的版本移到 Optional 或直接删除。
  • 保持 URL 稳定,让保存了链接的智能体和人都能看到最新版本。
  • 不要列出您不想公开的文档。llms.txt 是一个公开文件;任何受限内容都需要真正的访问控制。
  • 每当添加或替换文档时,都要更新它。

llms.txt 做不到的事

它只是一项提案,而非保证:它能帮助会去查找它的智能体,但您不应假定每个 AI 工具都会读取它。它也完全不涉及所链接的内容是否正确。如果某个被链接的 Markdown 文件是由丢掉了列标题的转换工具生成的,llms.txt 就会把智能体直接引向这个错误。

所以说,llms.txt 只是索引;它所指向内容的质量是另一个问题。

The Papers 如何使用它

The Papers 中的每个 AI 数据室都有一个位于 /{room}/llms.txt 的 llms.txt,以及一个位于 /{room}/index.md 的索引。它们列出数据室中的文档,并指向每份文档的 Markdown(/{room}/{doc}.md)和 JSON(/{room}/{doc}.json)格式 AI 版本,每个版本在发布前都已对照源文件核对。不公开列出和私密的文档不会向公众暴露。更新文档时 URL 保持不变,因此索引始终有效,分析数据还会显示 AI 智能体何时读取了 llms.txt。

常见问题

llms.txt 和 robots.txt 一样吗?
不一样。robots.txt 告诉爬虫可以访问哪些内容;llms.txt 建议哪些内容值得阅读,以及在哪里能找到干净的版本。
ChatGPT 和 Claude 会读取 llms.txt 吗?
这是一项提议中的约定;各工具的支持情况不一,也无法保证。发布它的成本很低,并且能帮助使用它的智能体。
llms.txt 应该链接到我的 PDF 吗?
优先链接 Markdown 版本。链接到 PDF 会重新带回 llms.txt 本想避免的提取问题。
我可以只为一个文件夹提供 llms.txt 吗?
提案允许把 llms.txt 放在子路径下,覆盖其下的页面——这适用于文档栏目或数据室。

为您的文档提供一个指向经保真核对文本版本的 llms.txt 索引。

来源

相关指南