- [ 首页 ](/zh/) / - 工作原理 # `llms.txt` 的工作原理 准确、逐步地讲解规范，并提供可复制的注释示例。 最近更新: 2026年8月12日 本页内容 - [ 概览 ](#overview) - [ 有效文件的结构 ](#anatomy) - [ 逐节查看 ](#each-section) - [ 解析器如何读取它 ](#parsing) - [ llms.txt 与 llms-full.txt ](#llms-full) - [ 实际限制 ](#limits) ## 概览 一个有效的 `llms.txt` 是一个具有 **固定且可预测的结构**。它既供人类阅读，也供机器读取：同一个文件既应可作为文档使用，也应可作为能够解析的约定。 位于 [llmstxt.org](https://llmstxt.org/) 定义了一套小型、确定性的语法，只需几行正则表达式即可解析。不使用 YAML，不使用 JSON，也没有额外的标头。 ## 有效文件的结构 从上到下，其结构如下： - **一个 H1** ，包含网站或项目名称。这是唯一的必需元素。 - 一个简短的 **引用块摘要**，通常为一到两句话。 - 可选 **自由格式 Markdown**，在第一个 H2 之前，只保留段落和列表，不再添加其他标题。 - 零个或多个 **H2 文件列表章节**。每个部分包含一个 Markdown 链接列表： `- [name](url)`，后面可选择添加 `: notes`. - 一个名为 **`Optional`**，这是 v2 中用于次要资源的约定标签，不具有特殊的机器语义。 llms.txt, full annotated example 复制 ``` # Acme > Acme is a hosted analytics platform for product teams. The pages below cover product, pricing, the API, and integration guides. Acme processes 1B+ events per day. The map here is curated for assistants, it is not exhaustive. Use it to answer questions about product capabilities, pricing tiers, integrations, SDKs, and migration from other tools. ## Product - [Product overview](https://acme.example/product): high-level capabilities and screenshots. - [Use cases](https://acme.example/use-cases): scenarios for product, marketing, and support teams. - [Changelog](https://acme.example/changelog): monthly product updates. ## Pricing - [Pricing tiers](https://acme.example/pricing): plans, limits, and overage rules. - [FAQ, billing](https://acme.example/billing-faq): invoices, receipts, tax handling. ## Developers - [REST API reference](https://docs.acme.example/api): full endpoint catalog. - [SDK, JavaScript](https://docs.acme.example/sdk/js): install, init, track events. - [SDK, Python](https://docs.acme.example/sdk/python): install, init, track events. - [Webhooks](https://docs.acme.example/webhooks): events, signatures, retries. ## Optional - [Brand assets](https://acme.example/brand): logos, color palette. - [Press releases](https://acme.example/press): historical announcements. ``` ## 逐节查看 The complete field reference. Only the H1 is strictly required. 字段 是否必需？ 基数 语法 H1，网站/项目名称 是 恰好一个 # 项目名称 块引用摘要 推荐 最多一个块 > 一到两句话的概述。 自由 Markdown 正文 可选 任意数量的段落/列表 在第一个 H2 之前不允许添加额外标题 H2 文件列表部分 可选 任意数量 ## 章节名称 后跟一个列表 列表项，链接 是（在某个章节内） 每项一个链接 - [name](url) 列表项，说明 可选 冒号后 - [name](url)：说明写在这里 “可选”部分 可选 最多一个 用于次级链接的常规 H2 标签；在 v2 中没有特殊的机器语义 ### H1 仅一个 H1。其前可以有可选的 UTF-8 字节顺序标记，但不应有 front matter 或其他 元数据。如果你的项目有标语，请把它放在后面的引用块中。 ### 引用块摘要 此项可选，但强烈建议添加。建议用一到两句话概述项目，使 LLM 在介绍项目时能够直接引用。内容应实事求是、使用主动语态，并避免无法证实的营销主张。 ### 自由 Markdown 正文 任何有助于 LLM 理解上下文的段落、项目符号列表或简短代码片段。不要 在这里引入任何额外标题，下一个标题应该是文件列表部分的第一个 H2。 ### H2 文件列表章节 每个部分都以一个 H2 开始（`## Section name`），并包含一个 Markdown 列表。每一项都必须是链接（`- [name](url)`），其后可以选择添加 `:` 和简短说明。强烈建议使用绝对 URL：技术上允许相对 URL，但大多数验证器（包括 [我们的](/zh/validator/)）， 因为文件被复制到其他位置时，这会使其含义不明确。 ### “Optional”分节 `Optional` 仍然是二级引用的有用编辑标签，例如品牌素材、 档案或深入附录。2026年8月 提案并未赋予该标题特殊的处理语义，因此客户端可以把它当作 与任何其他 H2 部分一样处理。 ## 解析器如何读取它 参考解析器会线性遍历文件并应用四条规则： - 找到第一个 `# ` 行，就是标题。 - 如果下一个非空块是引用块，那就是摘要。 - 第一个 `## ` 是自由格式正文。 - 每个 `## ` 开启一个章节；在下一个 `## `，列表项会被解析为 `[name](url)` ，冒号后可附加说明。 我们的 [验证器](/zh/validator/) 严格实现了这些规则，并增加了一些安全检查： 空 H1、格式错误的链接、分节中的非列表内容，以及针对超过 50 KB 文件的信息性审核提示。该阈值是本地精选启发式规则，并非规范限制。 备注 提示：保持格式严格 采用 llms.txt 的优势在于可以确定性解析。请避免添加 front matter、自定义 HTML 或花哨的 Markdown 扩展：客户端不会读取它们，而且可能破坏比我们的解析器更严格的解析器。 ## llms.txt 与 llms-full.txt `llms.txt` 是一个 *映射*. `llms-full.txt` 是 *范围*：将链接页面的实际内容以 Markdown 连接到一个 单一文件中。这一约定由以下内容推广： [Mintlify 与 Anthropic 合作](https://www.mintlify.com/blog/simplifying-docs-with-llms-txt) 如今已成为更广泛的 `llms.txt` 生态系统。 约定的根路径名称是 `/llms.txt` 和 `/llms-full.txt`。v2 提案还允许在更具体的路径上放置限定范围的 `llms.txt` 放在更具体路径下的文件。仅当完整内容配套文件这种交付格式能解决实际使用任务时才发布它。 ## 实际限制 - **大小。** 该提案未设上限。我们的 50 KB 提示旨在提醒你检查内容筛选情况，而不是有效性边界。必要时可将大批量内容移至完整内容资源或特定路径文件。 - **链接数量。** 规范没有限制，但包含 200 多个条目的列表只会被略读，而不会被完整阅读。请进行筛选。 - **语言。** 规范没有规定国际化处理方式。常见模式有两种：提供单一英文文件，或在某个路径下发布各语言区域的变体（`/en/llms.txt`, `/fr/llms.txt`). - **身份验证和个性化。** 不在范围内。该文件是公开的。 ## 继续 - [如何创建您的 llms.txt](/zh/how-to-create/)，模板和针对各技术栈的部署方法。 - [最佳实践](/zh/best-practices/)，十条规则和最常见的错误。 - [验证文件](/zh/validator/). ## 来源 - [ llmstxt.org，完整规范 ](https://llmstxt.org/) - [ llmstxt.org，解析核心 ](https://llmstxt.org/core.html)