AI 友好度（AISO）修复说明

总览

入口：AI 友好度测评。 提交域名后可查看综合分、7 大类别、改善建议，以及（若已生成）AI 解读中的「总体评价 / 提升建议」。

改善建议每一项旁有「如何修复」；AI 解读里也可能带有指向同一深链的链接。点击后在报告页打开侧栏，展示该 checkId 的静态 Markdown 指南。

报告深链

在已有报告 URL 上追加查询参数 check，即可直接打开对应修复侧栏，例如：

/reports/aiso/c456.com?check=llms-txt-exists

关闭侧栏会清除 check，并保留其余查询参数（如历史版本 v）。 下列每项摘要末尾均给出对应深链示例；完整步骤请在报告页打开「如何修复」侧栏。

内容可发现性

对应 afdocs content-discoverability：Agent 如何找到并导航你的文档索引。

llms-txt-exists

在常见候选路径提供可直接访问（HTTP 200）的 llms.txt，避免仅靠跨主机跳转。失败时多项依赖检查会跳过，综合分也可能被上限压到 D。 深链示例：/reports/aiso/你的域名?check=llms-txt-exists。

llms-txt-valid

按 llmstxt.org 约定组织：H1、引用块摘要、分区标题与 Markdown 链接。有可解析链接但结构不规范为警告；空文件或无链接为失败。 深链示例：/reports/aiso/你的域名?check=llms-txt-valid。

llms-txt-size

控制索引体积，避免超出 Agent 截断窗口。过大时拆成根索引 + 分区 llms.txt。 深链示例：/reports/aiso/你的域名?check=llms-txt-size。

llms-txt-links-resolve

保证索引内链接返回 200。建议构建时生成索引，防止页面改名后索引漂移。 深链示例：/reports/aiso/你的域名?check=llms-txt-links-resolve。

llms-txt-links-markdown

索引应指向 Markdown（如 .md），而不是仅 HTML。Agent 不会自行发现 Markdown 变体。 深链示例：/reports/aiso/你的域名?check=llms-txt-links-markdown。

llms-txt-directive-html

在文档 HTML 正文靠前位置加入指向 llms.txt 的指引（可视觉隐藏，须服务端渲染）。侧栏「介绍 llms.txt」的导航不算。 深链示例：/reports/aiso/你的域名?check=llms-txt-directive-html。

llms-txt-directive-md

在 Markdown 页首用引用块指向索引，例如「完整文档索引见 llms.txt」。站点未提供 Markdown 时本项跳过。 深链示例：/reports/aiso/你的域名?check=llms-txt-directive-md。

Markdown 可用性

对应 markdown-availability：Agent 能否以 Markdown 拿到正文。

markdown-url-support

文档 URL 追加 .md 应返回有效 Markdown，而非 HTML 壳或 404。 深链示例：/reports/aiso/你的域名?check=markdown-url-support。

content-negotiation

对 Accept: text/markdown 返回 Content-Type: text/markdown 及 Markdown 正文。 深链示例：/reports/aiso/你的域名?check=content-negotiation。

页面体积

对应 page-size：控制转换后体积与正文出现时机，避免截断。

page-size-html

降低 HTML 转文本后的体积与样板占比；精简导航、侧栏与内联噪音。 深链示例：/reports/aiso/你的域名?check=page-size-html。

page-size-markdown

控制 Markdown 单页体积，必要时拆页，避免超出常见 Agent 截断上限。 深链示例：/reports/aiso/你的域名?check=page-size-markdown。

content-start-position

让正文尽早出现在转换结果中，避免导航与样式残留占满截断窗口。 深链示例：/reports/aiso/你的域名?check=content-start-position。

rendering-strategy

启用 SSR/SSG，确保无 JavaScript 的抓取也能拿到实质正文（Critical 项）。 深链示例：/reports/aiso/你的域名?check=rendering-strategy。

内容结构

对应 content-structure：对人类友好、对 Agent 易踩坑的版式模式。

tabbed-content-serialization

选项卡在源码中会展开全部变体，体积过大时后半变体对 Agent 不可见。可拆页或用查询参数只返回一种变体。 深链示例：/reports/aiso/你的域名?check=tabbed-content-serialization。

section-header-quality

选项卡扁平化后，标题需带语言 / 工具等上下文（如「步骤 1（Python）」），避免多套「Step 1」无法区分。 深链示例：/reports/aiso/你的域名?check=section-header-quality。

markdown-code-fence-validity

Markdown 代码围栏必须正确闭合；未闭合会使其后整段被当成代码，语义失效。 深链示例：/reports/aiso/你的域名?check=markdown-code-fence-validity。

URL 稳定性

对应 url-stability：无效 URL 与跳转是否可被 Agent 正确理解。

http-status-codes

不存在的路径应返回 4xx，避免软 404（200 +「未找到」页）。友好提示可放在 404 响应体中，但状态码仍须正确。 深链示例：/reports/aiso/你的域名?check=http-status-codes。

redirect-behavior

优先同主机 HTTP 301/302；跨主机跳转部分 Agent 不跟随；纯 JS 跳转对 Agent 无效。 深链示例：/reports/aiso/你的域名?check=redirect-behavior。

可观测性

对应 observability：索引与 Markdown 是否随站点持续准确。

llms-txt-coverage

衡量文档页在 llms.txt 中的覆盖率。建议构建时生成索引；刻意精选时可调阈值或排除模式。 深链示例：/reports/aiso/你的域名?check=llms-txt-coverage。

markdown-content-parity

Markdown 与 HTML 内容应基本一致，避免分源漂移。人类专属块可用 data-markdown-ignore 标记。 深链示例：/reports/aiso/你的域名?check=markdown-content-parity。

cache-header-hygiene

为 llms.txt 与 Markdown 设置合理 Cache-Control，并配合 ETag / Last-Modified，避免过激缓存或完全无头。 深链示例：/reports/aiso/你的域名?check=cache-header-hygiene。