llms.txt 完整文档索引请参见 llms.txt
← 返回

AI 友好度检测报告

www.yixiaoer.cn

综合评分

0

/ 100

等级D

通过 8 / 23 项检测

检测于 2026/7/22 06:04:04

7 大类别检测结果

内容可发现性
00/7
llms-txt-exists未通过

在以下候选位置均未找到 llms.txt 文件(https://www.yixiaoer.cn/cli/llms.txt, https://www.yixiaoer.cn/llms.txt, https://www.yixiaoer.cn/docs/llms.txt)

llms-txt-valid跳过

已跳过:依赖检查未通过

llms-txt-size跳过

已跳过:依赖检查未通过

llms-txt-links-resolve跳过

已跳过:依赖检查未通过

llms-txt-links-markdown跳过

已跳过:依赖检查未通过

llms-txt-directive-html未通过

在1个页面的HTML中均未找到 llms.txt 指令

llms-txt-directive-md未通过

无法获取1个页面中的任何一个的 markdown;1个页面没有 markdown 版本

Markdown 可用性
00/2
markdown-url-support未通过

没有页面支持 .md URL(测试0/1个页面)

content-negotiation未通过

服务器忽略 Accept: text/markdown 标头(0/1个页面返回 markdown)

页面体积
753/4
rendering-strategy通过

所有1个页面都包含服务器渲染的内容

page-size-markdown跳过

已跳过:依赖检查未通过

page-size-html通过

所有1个页面字符数低于50K(中位数:74K HTML → 3K markdown(96% 样板内容))

content-start-position通过

所有1个页面的内容均在前10%位置开始(中位数2%)

内容结构
672/3
tabbed-content-serialization通过

在1个页面中未检测到标签页内容

section-header-quality通过

未找到标签页内容;标题质量检查不适用

markdown-code-fence-validity跳过

网站不提供 markdown 内容;无需分析

URL 稳定性
501/2
http-status-codes未通过

1个页面中的1个对不存在的 URL 返回 200(软 404)

redirect-behavior通过

在1个页面中未检测到重定向

可观测性
331/3
llms-txt-coverage跳过

已跳过:依赖检查未通过

markdown-content-parity跳过

已跳过:依赖检查未通过

cache-header-hygiene通过

所有1个端点具有适当的缓存标头

鉴权要求
501/2
auth-gate-detection通过

所有1个页面均可公开访问

auth-alternative-access跳过

所有文档页面均可公开访问;无需替代访问路径

改善建议(6 项)

1.

在以下候选位置均未找到 llms.txt 文件(https://www.yixiaoer.cn/cli/llms.txt, https://www.yixiaoer.cn/llms.txt, https://www.yixiaoer.cn/docs/llms.txt)

在您网站的根目录创建 llms.txt 文件,包含 H1 标题、块引用摘要以及指向关键文档页面的 markdown 链接。这是改善 Agent 访问您文档的单一最高影响改进。

llms-txt-exists · content-discoverability
2.

在1个页面的HTML中均未找到 llms.txt 指令

在测试的任何页面的HTML中未检测到指向 llms.txt 的面向 Agent 的指令。在每个页面顶部附近添加一个视觉隐藏元素(例如,使用 CSS 剪裁矩形的 div),包含指向您 llms.txt 的链接。如果您的网站提供页面的 markdown 版本,也请在指令中提及,以便 Agent 知道请求它。

llms-txt-directive-html · content-discoverability
3.

无法获取1个页面中的任何一个的 markdown;1个页面没有 markdown 版本

在测试的任何页面的 markdown 中未检测到 llms.txt 指令。在每个 markdown 页面的顶部附近添加一个块引用(例如,“> 有关完整的文档索引,请参见 [llms.txt](/llms.txt)”)。

llms-txt-directive-md · content-discoverability
4.

没有页面支持 .md URL(测试0/1个页面)

您的页面在 URL 后追加 .md 时不返回 markdown。请配置您的文档平台,为所有文档页面提供 .md 变体。

markdown-url-support · markdown-availability
5.

服务器忽略 Accept: text/markdown 标头(0/1个页面返回 markdown)

您的服务器忽略 Accept: text/markdown 并返回 HTML。某些 Agent(Claude Code、Cursor、OpenCode)通过此方式请求 markdown。请配置您的服务器以支持内容协商。

content-negotiation · markdown-availability
6.

1个页面中的1个对不存在的 URL 返回 200(软 404)

您的网站对不存在的页面返回 200(软 404)。Agent 会尝试从错误页面内容中提取信息,而不是识别页面不存在。请配置您的服务器,对不存在的页面返回 404。

http-status-codes · url-stability
综合0/100D

总体评价

www.yixiaoer.cn 的综合评分为 0/100(等级 D),表明该站点在 AI Agent 友好度方面几乎未采取任何针对性优化。最关键的措施——提供 llms.txt 文件——完全缺失,且服务器不支持通过 .md URL 或内容协商返回 Markdown 内容,导致 Agent 无法通过当前主流的标准化途径发现和获取结构化文档。此外,由于缺少 llms.txt,内容可发现性与可观测性下的多个细项检查被跳过,无法完整评估站点的全貌。

尽管如此,站点在基础技术层面仍表现出一些积极特征:页面体积控制良好,内容结构简洁,URL 重定向正确,缓存标头规范,且所有文档均公开可访问。这些方面为后续优化提供了必要的基础。整体而言,该站点当前处于 Agent 友好度的起步阶段,底层文档质量尚可,但亟需补全面向 Agent 的关键出口(如 llms.txt 和 Markdown 支持),才能实现从“可被访问”到“可被高效消费”的跨越。

优势分析

  • 页面体积控制优秀(A 级,75/100):所有测试页面均采用服务端渲染,HTML 中位数体积不足 50KB,且内容从页面顶部约 2% 的位置开始。样板代码占比低使得 AI Agent 可在极少的传输量内定位到有效内容,大幅提升信息提取效率。
  • 内容结构简洁(B 级,67/100):页面未检测到标签页(tabbed content)这类需交互才能完整显示内容的组件,文档以线性方式呈现,Agent 无需模拟交互即可一次性获取全部信息。同时,标题结构检查自动通过(因无标签页而豁免),反映出页面没有因复杂 UI 导致的标题碎片化,有利于 Agent 构建层级理解。
  • URL 重定向处理正确:正常文档 URL 无多余重定向,Agent 可直接访问目标资源,避免了跟随跳转带来的额外开销与状态管理复杂度。
  • 缓存标头设置规范:所有文档端点均返回恰当的 Cache-Control 标头,允许 Agent 或中间缓存重用内容,减少重复请求,降低带宽消耗,尤其适合 Agent 的批量抓取场景。
  • 文档完全公开:所有页面无需认证即可访问,Agent 无需处理登录、令牌等鉴权流程,降低了首次接入的门槛,也避免了因凭证失效导致的爬取中断。