如何创建 llms.txt 文件
发布:
编写一个 llms.txt 文件大约只需十分钟。本指南按顺序逐一讲解每个部分,最后给出一个你可以直接粘贴并按需修改的文件。
1. 从 H1 标题开始
第一行必须是单个 H1——也就是你的项目或网站名称。它是该格式中唯一严格要求的元素。
# Acme Docs
2. 添加引用块摘要
紧接在标题下方,添加一两句话的引用块。这是语言模型最先读取的上下文,所以要写得具体:说明这个网站是什么、面向谁。
> Acme is a payments API. This file links to the docs an LLM needs to integrate and debug Acme.
3.(可选)添加几行说明文字
在任何章节标题之前,你可以添加普通段落,提供额外的引导说明。这里不要使用标题——保持一两句话即可。
4. 将链接归入 H2 章节
每个章节是一个 H2 标题,后面跟着一个 markdown 列表。每一项都是一个链接,冒号后可附上可选的描述。
## Docs - [Quickstart](https://acme.com/docs/quickstart): Integrate in five minutes - [API reference](https://acme.com/docs/api): Every endpoint and parameter ## Examples - [Sample app](https://acme.com/examples/app): A working end-to-end example
使用绝对 https URL,并让描述聚焦于开发者或模型真正需要的信息——而不是营销文案。
5. 用 "Optional" 章节放置锦上添花的内容
一个名称恰好为 ## Optional 的章节具有特殊含义:当需要更短的上下文时,其中的链接可以被跳过。把更新日志、博客文章和次要参考资料放在这里。
6. 托管在根目录
将文件托管在 https://yourdomain.com/llms.txt,并设置 Content-Type: text/plain。大型站点通常还会发布一个 llms-full.txt,包含完整展开的内容。
7. 发布前先验证
将你的域名粘贴到验证器中。它会检查结构、确认每个链接都能真正解析,并列出确切的修复项。目标是拿到 100/100。