GEOZ

用 llms.txt 给 AI 递张高精地图:网站适配实战教程

2026/9/5
用 llms.txt 给 AI 递张高精地图:网站适配实战教程

AIAI Summary (BLUF)

llms.txt是一种让网站AI友好的开放标准,通过在根目录放置一个Markdown文件,AI就能快速读取项目简介和核心文档链接,解决大模型上下文限制和文档过时的问题。本教程详细讲解创建步骤、Markdown页面配套以及集成到VitePress等框架的插件,适用于开发者和网站站长。

核心洞察

先说结论:llms.txt 值得配,成本几乎为零。往网站根目录放一个纯文本文件,AI 抓取时就能跳过广告和导航,直接读你指定好的 Markdown 文档。个人博客、开源项目、文档站都适用。唯一想较个真的是“准确率提升起码 80%”这个说法,原文没给出测试方法,参考就好。

核心结论

  1. llms.txt 由 Answer.AI 团队提出,实现方式是在网站根目录放置一个名为 llms.txt 的清单文件,AI 抓取时可跳过导航和广告,直接读取其中指定的 Markdown 文档,接入成本接近零。

  2. llms.txt 的核心内容结构包含三部分:项目简介、核心文档链接(建议直接指向 .md 文件)、可选补充信息(如更新日志),无需付费或安装额外软件。

  3. 常用框架已有现成集成方式:VitePress 使用 vitepress-plugin-llmsDocusaurus 使用 docusaurus-plugin-llmsDrupal 可搜索 llm_support 模块,可自动生成和维护 llms.txt。

  4. llms.txt 与 sitemap.xml 功能分离,不会影响百度、谷歌等搜索引擎对 HTML 页面的收录。

  5. 原文中“代码生成准确率提升起码 80%”这一说法未提供测试方法和数据来源,应视为参考性表述,而非可验证的量化结论。

为什么使用 llms.txt?

经常跟 AI 打交道的开发者,大概都见过这种场面:让 AI 基于一个新发布的库写代码,它能一本正经地编出一套不存在的 API。原因不复杂,它没读过这个库的文档。把几万字文档直接贴过去,上下文又塞不下。

现在的 LLM 虽然强,三个硬伤摆在那:

  • 上下文窗口有限,整个网站的内容根本装不下
  • HTML 页面太杂,JS、广告位、导航栏混在一起,AI 读起来费劲,Token 消耗也大
  • 知识有时差,刚更新的 API 和文档,它没见过就是没见过

llms.txt 的思路跟 robots.txt 有点像。在网站根目录放一个清单文件,等于给 AI 递了张高精地图:别在页面上瞎转悠了,这几个 Markdown 文件才是干货,直接读它们就行。

工具介绍

llms.txt 由 Answer.AI 团队提出,实现起来很简单。在网站根目录放一个同名 Markdown 文件,内容包含三部分:

  1. 项目简介,几句话讲清网站定位
  2. 详细文档的链接,最好直接指向 Markdown 文件
  3. 可选的补充信息,比如更新日志

获取方式

标准本身开源免费,不需要额外付费或安装软件。建一个文本文件,按下文格式填好丢到服务器根目录就行。想自动化管理,可以看看 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问题。

Roger深圳
本文由 Roger 审核,最后更新于 2026年9月5日
联系编辑 →
← 返回文章列表
分享到:微博

版权与免责声明:本文仅用于信息分享与交流,不构成任何形式的法律、投资、医疗或其他专业建议,也不构成对任何结果的承诺或保证。

文中提及的商标、品牌、Logo、产品名称及相关图片/素材,其权利归各自合法权利人所有。本站内容可能基于公开资料整理,亦可能使用 AI 辅助生成或润色;我们尽力确保准确与合规,但不保证完整性、时效性与适用性,请读者自行甄别并以官方信息为准。

若本文内容或素材涉嫌侵权、隐私不当或存在错误,请相关权利人/当事人联系本站,我们将及时核实并采取删除、修正或下架等处理措施。也请勿在评论或联系信息中提交身份证号、手机号、住址等个人敏感信息。