AI 友好度 / GEO 检测报告
doccharm.com
正在进行：内容 / GEO 评估 · 约 30 秒
结果将自动刷新
综合评分
0
/ 100
技术
0D
内容评估进行中
技术检测通过 7 / 23 项
检测于 2026/7/22 02:02:21
技术检测（0 · D）
llms-txt-exists未通过在任何候选位置均未找到 llms.txt（https://doccharm.com/llms.txt，https://doccharm.com/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-url-support未通过没有页面支持 .md URL（测试 0/1）
content-negotiation未通过服务器忽略 Accept: text/markdown 头部（0/1 页面返回 markdown）
rendering-strategy通过所有 1 个页面均包含服务端渲染内容
page-size-markdown跳过已跳过：依赖检查未通过
page-size-html通过所有 1 个页面字符数低于 50K（中位数 41K HTML → 8K markdown，模板代码占比 80%）
content-start-position通过所有 1 个页面的内容均在前 10% 内开始（中位数 3%）
tabbed-content-serialization通过在 1 个页面中未检测到标签页内容
section-header-quality通过未发现标签页内容；标题质量检查不适用
markdown-code-fence-validity跳过站点未提供 markdown 内容；无需分析
http-status-codes未通过1 个页面中有 1 个对不存在的 URL 返回 200（软 404）
redirect-behavior通过在 1 个页面中未检测到重定向
llms-txt-coverage跳过已跳过：依赖检查未通过
markdown-content-parity跳过已跳过：依赖检查未通过
cache-header-hygiene未通过1 个端点中有 1 个具有激进的缓存或缺少缓存头部
auth-gate-detection通过所有 1 个页面均可公开访问
auth-alternative-access跳过所有文档页面均可公开访问；无需替代访问路径
改善建议（7 项）
在任何候选位置均未找到 llms.txt（https://doccharm.com/llms.txt，https://doccharm.com/docs/llms.txt）
在站点根目录创建一个 llms.txt 文件，包含一个 H1 标题、一个引用块摘要和指向关键文档页面的 markdown 链接。这是对代理访问文档影响最大的改进。
llms-txt-exists · content-discoverability在任意 1 个页面的 HTML 中均未找到 llms.txt 指令
在所有测试页面的 HTML 中均未检测到指向 llms.txt 的代理指令。在每个页面顶部附近添加一个视觉隐藏元素（例如，使用 CSS clip-rect 的 div），其中包含指向 llms.txt 的链接。如果您的站点提供页面的 markdown 版本，也请在指令中提及，以便代理知道请求它。
llms-txt-directive-html · content-discoverability无法获取任意 1 个页面的 markdown；1 个页面没有 markdown 版本
在所有测试页面的 markdown 中均未检测到 llms.txt 指令。在每个 markdown 页面顶部附近添加一个引用块（例如，“> 有关完整的文档索引，请参见 [llms.txt](/llms.txt)”）。
llms-txt-directive-md · content-discoverability没有页面支持 .md URL（测试 0/1）
您的页面在 URL 后附加 .md 时不返回 markdown。配置您的文档平台以提供所有文档页面的 .md 版本。
markdown-url-support · markdown-availability服务器忽略 Accept: text/markdown 头部（0/1 页面返回 markdown）
您的服务器忽略 Accept: text/markdown 并返回 HTML。某些代理（Claude Code、Cursor、OpenCode）通过此方式请求 markdown。配置您的服务器以进行内容协商。
content-negotiation · markdown-availability1 个页面中有 1 个对不存在的 URL 返回 200（软 404）
您的站点对不存在的页面返回 200（软 404）。代理尝试从错误页面内容中提取信息，而不是识别页面不存在。配置您的服务器对不存在的页面返回 404。
http-status-codes · url-stability1 个端点中有 1 个具有激进的缓存或缺少缓存头部
1 个端点具有激进的缓存（>24 小时）或缺少缓存头部。将 max-age 设置为小于 3600 或添加 must-revalidate 以及 ETag/Last-Modified，以便内容更新及时到达代理。
cache-header-hygiene · observability内容 / GEO 评估
正在分析…
将评估以下内容维度
好的，作为一名 AI Agent 友好度分析专家，我根据您提供的检测结果，为您出具以下分析报告。
总体评价
doccharm.com 的 AI 友好度综合评分为 0/100，等级为 D，这意味着该站点目前基本不具备被 AI Agent 有效发现和消费的能力。尽管站点在静态页面构建（页面体积、内容结构）方面表现尚可，但它在与 AI 代理协作的核心基础设施上存在严重缺失。特别是 内容可发现性 和 Markdown 可用性 这两个关键类别均为 0 分，表明代理无法通过标准协议（如 llms.txt）或内容协商机制获取到结构化、纯净的文档内容，这是导致总体评分极低的根本原因。
优势分析
尽管整体情况不佳，但在基础文档站建设方面，doccharm.com 仍表现出一些值得肯定的亮点，这些是后续提升 AI 友好度的坚实基础：
-
页面体积（A，75/100）：该类别得分很高，多项检查均通过。所有页面均采用服务端渲染，内容在 HTML 中占比较高，且主体内容在页面开始位置即出现。这对于 AI Agent 而言是极大利好，意味着无需执行复杂的客户端脚本，便可以快速、高效地从 HTML 中提取核心文档内容，极大地降低了消费成本。
-
内容结构（B，67/100）：此项测试表现出色，未检测到标签页（tabbed content）等不利于信息提取的 UI 元素。这确保了页面内容是线性、连续的文本，避免了代理在抓取时丢失关键信息。这一点对保证内容完整性至关重要。
-
鉴权要求（C，50/100）：检测确认所有页面均可公开访问，无需登录。这消除了 AI Agent 访问文档的首要障碍，是一个基本的、必要的优势条件。
-
渲染策略与内容定位：
rendering-strategy和content-start-position两项检查通过，进一步印证了该站点在内容交付上的高效性。代理可以直接从服务端返回的 HTML 中定位并抓取有效内容，节省了大量时间与计算资源。
结论
doccharm.com 拥有良好的 HTML 文档基础，但其与 AI 代理协作的“接口层”几乎完全缺失。当前最核心的问题在于站点没有提供 ai-friendly 协议入口（llms.txt），也无法响应 Agent 对原始 Markdown 的请求。这使得前端友好的文档变成了对 AI 不友好的“黑盒”。未来提升的重点应是面向 AI Agent 重构数据接口，而不是调整前端表现。