AI 评分
Jamdesk 根据开放 AFDocs 标准评估文档对 AI 代理的可读性，并在每次构建后提供评分。
AI 助手越来越多地直接根据您的文档回答产品相关问题，但前提是它们确实能够读取这些内容。AI Score 就是用于衡量这一点的工具。每次构建后，Jamdesk 都会根据开放的 AFDocs 代理就绪度标准扫描您已发布的网站，并提供 0–100 分的评分、字母等级以及可供您采取行动的逐项问题明细。
屏幕截图显示的是英文界面。
先在任意网站上试用。 免费的 AI Score 工具 会根据相同标准为任意文档 URL 评分，AI Score Chrome 扩展 则会在您浏览网站时为其评分。在 Jamdesk 中，评分会自动针对您自己的文档运行。
评分方式
AI Score 会自动运行，无需设置。每次构建成功后，Jamdesk 会等待新版本上线，然后扫描您已发布的文档并记录结果。
- 每次构建都会运行。 每次部署都会重新评估您的网站，因此回归问题会在上线时立即显示。
- 0–100 分和字母等级（从 A+ 到 F），根据开放的 AFDocs 标准衡量。它使用的引擎与免费的公共工具相同。
- 随时重新运行。 打开项目的 AI Score 页面，然后点击 Run score now，即可再次为线上网站评分，无需等待构建。
您可以在仪表板的项目下找到它 → AI Score。
查看评分
AI Score 页面包含三个部分：
- 评分圆环。 显示当前评分和等级，以及与上次构建相比的变化。
- 趋势线。 显示最近几次构建中的评分，因此评分下降时可以一目了然。
- 类别卡片。 将您的检查分为七个领域，每个领域都有自己的等级。展开其中一个类别，即可查看具体检查及其通过、警告或失败状态。
页脚会注明扫描的内容、抽样的页面数量以及 AFDocs 规范版本。
评分衡量的内容
每个类别都会汇总相关的代理就绪度检查：
| 类别 | 涵盖内容 |
|---|---|
| 内容可发现性 | llms.txt 以及将代理指向您内容的信号 |
| Markdown 可用性 | 供代理读取的每个页面的干净 Markdown 版本 |
| 页面大小与截断风险 | 足够小、可以容纳在代理上下文窗口中的页面 |
| 内容结构 | 标题、排序以及页面开头就出现的内容 |
| URL 稳定性与重定向 | 稳定的 URL 以及正确的同主机重定向 |
| 可观测性与内容健康度 | 状态码、缓存，以及读者与代理所看到内容之间的一致性 |
| 身份验证与访问权限 | 代理是否完全能够访问页面 |
修复问题
每项发出警告或失败的检查都会附带通俗易懂的说明，并根据您的 MDX 和 docs.json 提供修复建议。结果分为两类：
- 需要您在内容中修复的问题。 例如，页面的实际内容开始得太靠后、应拆分的超大页面，或由交互式组件渲染但未出现在页面 Markdown 中的内容。修复文本会说明下一步操作以及适用的页面。
- Jamdesk 会为您处理的问题。
llms.txt、Markdown 导出、状态码和缓存都会自动生成。如果其中一项失败，通常意味着临时构建问题，因此请在下一次构建后重新运行评分；如果问题持续存在，请联系支持团队。
复制修复提示
每项可修复的检查都有一个 Copy prompt to fix 按钮。该按钮会复制一段可直接粘贴的提示，其中包含检查项目、发现的问题以及如何在 MDX 或 docs.json 中解决问题。将其粘贴到 AI 编码代理（Claude Code、Jamdesk Claude 插件、Cursor 或 Codex）中，让它完成编辑，然后推送更改以重新构建并重新评分。
评分变化时接收邮件
您的团队不必一直查看仪表板。每当构建首次生成评分、评分变化达到或超过 3 分，或评分恢复到满分 100 分时，Jamdesk 都会向项目成员发送包含新评分和最重要待修复问题的邮件。
- 按项目切换。 Email team when score changes 开关位于 AI Score 页面顶部，默认开启。
- 小幅波动不会打扰您。 单独的一两分变化不会触发邮件，但也不会被遗忘：Jamdesk 会将每个新评分与上次发送邮件时的评分进行比较，因此逐渐累积的变化达到 3 分时，您仍会收到通知。
手动重新运行和由构建触发的评分都可能发送邮件；回填评分和公共工具扫描永远不会发送。
故障排除
如果您的网站暂时无法访问、返回错误或阻止扫描器，扫描结果可能为空。Jamdesk 不会保存这些结果，因此短暂的故障不会固定错误评分或影响趋势线。系统会继续显示您上一次的有效评分；点击 Run score now 再试一次。
AI 代理无法读取密码保护页面，因此评分会反映这一情况。如果设置访问限制是有意为之（例如内部文档或预发布文档），那么这里的低评分是预期结果，无需担心。
设置为 noindex 的项目没有供 Jamdesk 扫描的站点地图，因此 AI Score 会跳过而不会运行——没有可靠的衡量依据。这不会影响 AI 代理：它们仍可通过 llms.txt 读取您的文档，因为无论 noindex 如何设置，该文件都会保持发布状态。如果您希望再次获得评分，请从 docs.json 中的 seo.metatags.robots 移除 noindex。
某些检查涵盖 Jamdesk 负责的平台行为（llms.txt、Markdown 导出、状态码和缓存）。这些功能按设计应当通过，因此失败几乎总是意味着临时构建问题。请在下一次构建后重新运行评分；如果问题持续存在，请联系支持团队。