用 llms.txt 给 AI 递张高精地图:网站适配实战教程
AIAI Summary (BLUF)
llms.txt是一种让网站AI友好的开放标准,通过在根目录放置一个Markdown文件,AI就能快速读取项目简介和核心文档链接,解决大模型上下文限制和文档过时的问题。本教程详细讲解创建步骤、Markdown页面配套以及集成到VitePress等框架的插件,适用于开发者和网站站长。
核心洞察
先说结论:llms.txtA standardized file format that allows website owners to communicate AI training and usage policies to AI crawlers, language models, and AI-driven search engines. 值得配,成本几乎为零。往网站根目录放一个纯文本文件,AI 抓取时就能跳过广告和导航,直接读你指定好的 MarkdownA lightweight markup language for creating formatted text using a plain-text editor. 文档。个人博客、开源项目、文档站都适用。唯一想较个真的是“准确率提升起码 80%”这个说法,原文没给出测试方法,参考就好。
核心结论
llms.txt 由 Answer.AIA company whose co-founder Jeremy Howard proposed the LLMs.txt standard. 团队提出,实现方式是在网站根目录放置一个名为
llms.txt的清单文件,AI 抓取时可跳过导航和广告,直接读取其中指定的 Markdown 文档,接入成本接近零。llms.txt 的核心内容结构包含三部分:项目简介、核心文档链接(建议直接指向
.md文件)、可选补充信息(如更新日志),无需付费或安装额外软件。常用框架已有现成集成方式:VitePress基于Vue的静态网站生成器,常用于构建技术文档网站。 使用
vitepress-plugin-llms,Docusaurus开源的文档网站生成器,可通过docusaurus-plugin-llms插件集成llms.txt。 使用docusaurus-plugin-llms,Drupal开源内容管理系统,可通过llm_support模块生成llms.txt。 可搜索llm_support模块,可自动生成和维护 llms.txt。llms.txt 与 sitemap.xml 功能分离,不会影响百度、谷歌等搜索引擎对 HTML 页面的收录。
原文中“代码生成准确率提升起码 80%”这一说法未提供测试方法和数据来源,应视为参考性表述,而非可验证的量化结论。
为什么使用 llms.txt?
经常跟 AI 打交道的开发者,大概都见过这种场面:让 AI 基于一个新发布的库写代码,它能一本正经地编出一套不存在的 API。原因不复杂,它没读过这个库的文档。把几万字文档直接贴过去,上下文又塞不下。
现在的 LLM 虽然强,三个硬伤摆在那:
- 上下文窗口有限,整个网站的内容根本装不下
- HTML 页面太杂,JS、广告位、导航栏混在一起,AI 读起来费劲,Token 消耗也大
- 知识有时差,刚更新的 API 和文档,它没见过就是没见过
llms.txt 的思路跟 robots.txt 有点像。在网站根目录放一个清单文件,等于给 AI 递了张高精地图:别在页面上瞎转悠了,这几个 Markdown 文件才是干货,直接读它们就行。
工具介绍
llms.txt 由 Answer.AI 团队提出,实现起来很简单。在网站根目录放一个同名 Markdown 文件,内容包含三部分:
- 项目简介,几句话讲清网站定位
- 详细文档的链接,最好直接指向 Markdown 文件
- 可选的补充信息,比如更新日志
获取方式
标准本身开源免费,不需要额外付费或安装软件。建一个文本文件,按下文格式填好丢到服务器根目录就行。想自动化管理,可以看看 llms_txt2ctx 这个开源项目。
详细安装/使用教程
第一步:创建 llms.txt 文件
在网站根目录新建文件,路径像这样:www.your-site.com/llms.txt。内容模板如下:
# 项目名称
> 一句话简介,让 AI 快速定位项目是干嘛的。
这里写核心规则,比如:本项目不兼容 React,只支持原生 JS。
## 核心文档
- [快速开始](https://your-site.com/docs/quickstart.md): 介绍如何 5 分钟上手
- [API 详解](https://your-site.com/docs/api.md): 包含所有接口参数说明
## 可选内容
- [更新日志](https://your-site.com/docs/changelog.md): 详细的迭代历史
第二步:提供 Markdown 版本的网页
这步算进阶操作。建议给每个 HTML 文档配一个同名 .md 版本,比如 docs/intro.html 旁边放一个 docs/intro.html.md。AI 抓取时直接读纯文本,省去解析复杂页面的开销,内容也更精准。
第三步:集成到现有框架(可选)
常用的几个框架都有现成插件:
- VitePress 用 vitepress-plugin-llms
- Docusaurus 用 docusaurus-plugin-llms
- Drupal 搜索 llm_support 模块
装好后自动生成 llms.txt,不用手动维护。
使用效果
适配完成后,你的用户在用 Claude、GPT-4o 这类支持联网搜索或文档读取的 AI 时,直接对它说:
请参考 https://your-site.com/llms.txt 帮我写一个登录功能的 Demo。
AI 会跳过杂乱导航和广告,直接找到你在 llms.txt 里标出的 Markdown 文档。代码生成准确率提升起码 80%。
常见问题与踩坑
AI 还是读不到
先看服务器有没有拦住爬虫,很多安全插件会顺手把 AI 的抓取请求挡掉。再检查 llms.txt 开头的 H1 标题是否写对。
会影响 SEO 吗
不会。它和 sitemap.xml 各干各的,专门为 AI 准备,不影响百度、谷歌对 HTML 页面的收录。
必须放根目录吗
推荐放根目录。AI 抓取工具和智能体默认都会来这里找,放别处容易找不到。
总结与资源获取
AI 友好这件事,正在变成网站维护的常规需求。llms.txt 轻量、免费、接入成本低,真心建议文档站和开源项目都配上。想省事就用 llms_txt2ctx 这类工具自动生成,不想折腾的话,手动复制模板改一改也就几分钟。
常见问题(FAQ)
llms.txt是什么?有什么用?
llms.txt是一种开放标准,在网站根目录放一个Markdown文件,让AI直接读取项目简介和核心文档链接,解决上下文限制和文档过时问题,提升AI回答准确率。
如何创建llms.txt文件?
在网站根目录新建llms.txt文件,包含项目简介、核心文档链接(指向Markdown文件)及可选内容。可用框架插件自动生成,如VitePress的vitepress-plugin-llms。
llms.txt会影响SEO吗?
不会。llms.txt专门为AI设计,与sitemap.xml互补,不影响百度、谷歌对HTML页面的收录,无需担心SEO问题。
版权与免责声明:本文仅用于信息分享与交流,不构成任何形式的法律、投资、医疗或其他专业建议,也不构成对任何结果的承诺或保证。
文中提及的商标、品牌、Logo、产品名称及相关图片/素材,其权利归各自合法权利人所有。本站内容可能基于公开资料整理,亦可能使用 AI 辅助生成或润色;我们尽力确保准确与合规,但不保证完整性、时效性与适用性,请读者自行甄别并以官方信息为准。
若本文内容或素材涉嫌侵权、隐私不当或存在错误,请相关权利人/当事人联系本站,我们将及时核实并采取删除、修正或下架等处理措施。也请勿在评论或联系信息中提交身份证号、手机号、住址等个人敏感信息。


