TapCub 正式上线:统计、分析、客服一个平台免费用

免费工具 llms.txt 检查:逐行校验格式

把网站 /llms.txt 的内容贴进来。工具按 llmstxt.org 描述的结构从头读到尾,列出每个问题和所在行号:缺标题或简介、解析器读不懂的链接、相对网址和重复链接、空分组。

  • 问题带行号
  • llmstxt.org 格式
  • 本地运行
检查工具

贴上 llms.txt,看问题清单

浏览器打开 https://你的域名/llms.txt,全选复制粘贴到这里。示例里故意留了三个错误,清单会随输入更新。

Markdown 格式,开头带 BOM 也可以。

分组

3

H2 标题数。

链接

6

解析器能读出的列表项。

错误

0

不符合格式。

警告

3

能读,但容易丢信息。

问题

  • 警告第 10 行链接后面的文字没有冒号。说明要跟在「: 」后面,如「- [标题](网址): 说明」。注意用英文冒号。
  • 警告第 11 行「/docs/webhooks.md」是相对网址。单独读取 llms.txt 的工具补不出域名;提案的示例都用完整网址。
  • 警告第 16 行https://yunfan.example/docs/quick-start.md 在第 9 行已经列过。
  • 说明第 18 行Optional 分组有 1 个链接。按约定,AI 工具上下文不够时可以跳过它们。

各分组概况

分组链接其他内容行号
文档3只有链接7
产品2只有链接13
Optional1只有链接18
全部在你的浏览器里计算。这里输入的任何内容都不会上传,TapCub 也不会保存。

版本 v1.0更新于 更新记录

结果怎么读

错误、警告和说明

四个数字概括整份文件,清单逐条解释。

错误

文件根本不符合格式:没有 H1、H1 不在最前面、返回的是 HTML 网页,或者链接没有可用的网址。先改这些。

警告

解析器能读,但会丢信息:链接说明前没有「: 」、相对网址、重复链接、分组里夹着大段文字、空分组、缺简介。

说明

不算错,值得知道:Optional 分组可能被跳过、「*」列表符号参考解析器不认、没有提供 Markdown 版页面。

各分组概况

每个 H2 一行:有几个链接、有没有夹杂别的文字。整段都是文字的分组,内容一般应该挪到前面的补充说明里。

检查通过只代表文件符合提案格式,不代表有 AI 会读它:目前没有哪家主要 AI 公司确认它的爬虫会读取 llms.txt。

怎么用

三步用完

手写的、插件生成的、文档平台导出的文件都能查。

  1. 1

    复制线上文件

    浏览器打开网站的 /llms.txt。如果看到的是网页或 404,这就是第一个要解决的问题。

  2. 2

    粘贴、看清单

    错误和警告都带行号,回到你的编辑器用「跳转到行」就能找到。

  3. 3

    改完再查

    改好后重新粘贴,直到只剩「正常」和说明。想从头生成,用 llms.txt 生成器。

检查规则

逐行对照 llmstxt.org 格式

提案(llmstxt.org,2024 年 9 月)规定了文件的顺序。本工具照它检查,链接按它的参考解析器所用的正则来认。

  • 最前面:带名称的 H1(必需),之前只允许 BOM
  • 然后:一行引用块简介,再往下是任意非标题的 Markdown
  • 然后:若干 H2 分组,每组是 - [名称](网址) 列表,后面可跟 : 说明
  • 名为 Optional 的分组放可以跳过的链接。其余检查(相对网址、重复链接)是好习惯,不是提案的硬性规定
常见 llms.txt 写法的判定
这一行识别为结果
# 云帆客服标题(H1)在第一行就正常
> 面向中小团队的…简介紧跟 H1 就正常
- [价格](https://…/pricing): 各版本带说明的链接正常
- [API 文档](https://…/api.md) 接口地址链接,说明没加冒号警告
- [Webhook](/docs/webhooks.md): …相对网址的链接警告
* [博客](https://…/blog)用 * 的列表项说明
### 使用指南H3 标题警告
价格 | https://…/pricing分组里的普通文字警告
举个例子

示例里的三个错误

示例文件能解析,但有三行会丢信息。下面逐条给出问题和改法。

示例 llms.txt 里发现的问题
行号问题改法
10API 文档链接后的说明没有冒号,解析器会丢掉它…api.md): 接口地址和鉴权方式
11/docs/webhooks.md 是相对网址https://yunfan.example/docs/webhooks.md
16「产品」里又列了一次快速开始(第 9 行已有)删掉重复的,或换成另一个页面

第 18 行 Optional 那条只是说明,博客链接放在那里没问题。另外注意说明前的冒号要用英文半角「:」,中文全角「:」解析器不认。

常见错误

llms.txt 通常坏在哪

出问题的文件大多来自手工修改,或者各种工具自己发明的写法。

返回的是 HTML

单页应用或伪静态规则把 /llms.txt 也转给了首页。要看原始响应,不能只看浏览器里显示的样子。

写成大段文字

H2 下面的段落参考解析器会忽略。分组保持链接清单,背景写进每条链接的说明。

用了中文冒号

- [标题](网址):说明 用的是全角冒号,解析器只认半角 :,说明会丢。

嵌套标题

H3 小节不在格式里。拆成几个并列的 H2 分组。

常见问题

llms.txt 检查常见问题

还有其他问题?

直接和 TapCub 团队聊聊——工作日通常几小时内回复。

怎么知道我的 llms.txt 写得对不对?

贴到上面。没有错误和警告时只显示一条「正常」,表示文件符合 llmstxt.org 的格式:H1 在最前,接着是简介引用块,然后是由 Markdown 链接组成的 H2 分组。

llms.txt 的格式要求是什么?

只有写网站或项目名的 H1 是必需的。之后提案期望有一行引用块简介、可选的非标题 Markdown,以及若干 H2 分组,分组里每项写成 - [名称](网址),可加 : 说明。

llms.txt 里的链接必须是完整网址吗?

提案没有明说,但它的示例全是完整网址,而且脱离网站单独读取时 /docs 补不出域名。所以本工具对相对网址给出警告。

为什么我写的说明没被识别?

多半是冒号的问题:要写 - [标题](网址): 说明,冒号是英文半角。漏了冒号或用了中文全角冒号,链接后面的文字都会被丢掉。

llms.txt 写对了,就能被 AI 搜索引用吗?

没有公开证据。Google 说 Google 搜索不需要 llms.txt,OpenAI、Anthropic 的爬虫文档也没有提到它,国内大模型厂商同样没有公开说明。格式正确只能保证会读它的工具能正确解析。

能检查 llms-full.txt 吗?

本工具检查的是 llms.txt 的结构。llms-full.txt 是一些文档平台放全文的做法,没有固定格式,这里的大部分规则不适用。

我贴的内容会上传吗?

不会。全部在浏览器里运行,这个工具也没有分享链接,粘贴的内容不会离开页面。

更新记录

更新记录

这个工具的新功能、修复和数据更新,最新的在前。

  1. · v1.0

    首次上线首次上线。

缺功能或发现错误?告诉我们,常被提到的会排进下次更新。 全部工具更新

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie