跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

站点级 GEO/SEO 检查清单(9 项)

页面级 15 件套由 scripts/doc_lint.py 自动检测;本清单是站点级、一次性/周期性核查项,不进 linter。 参考:Mintlify GEO 指南 + SEO 指南

一次性配置(首次设置后基本不变)

1. docs.json 启用全量索引

{
  "seo": {
    "indexing": "all"   // 让隐藏页也进 AI 上下文
  }
}
验证:grep "indexing" docs.json 命中。

2. mint scorerobotsTxtAllowsAI 通过

npx mintlify@latest score
预期输出含 robotsTxtAllowsAI: pass。Mintlify 默认放行 OpenAI / Anthropic / Perplexity / Google-Extended 等 AI bot,自托管 robots.txt 不能写 User-agent: * Disallow: / 需放行的 AI 用户代理清单:
  • GPTBotOAI-SearchBotChatGPT-User(OpenAI)
  • ClaudeBotClaude-User(Anthropic)
  • PerplexityBot(Perplexity)
  • Google-Extended(Gemini)

3. /llms.txt 200

curl -sI https://docs.aihubmix.com/llms.txt | head -1
Mintlify 自动生成。本仓库 public/llms.txt 是自定义覆盖版,删除后会回到自动版。

4. /llms-full.txt 200

curl -sI https://docs.aihubmix.com/llms-full.txt | head -1
包含全站 Markdown 整合,专供 AI 工具作为 context 使用。

5. /.well-known/llms.txt 200(备用路径)

curl -sI https://docs.aihubmix.com/.well-known/llms.txt | head -1
部分 AI 工具走 .well-known 路径发现资源。

6. /sitemap.xml 200 + 已提交 Google Search Console

curl -sI https://docs.aihubmix.com/sitemap.xml | head -1
GSC 提交位置:Google Search Console → 左侧 Sitemaps → 填 sitemap.xml。Mintlify 自动生成与更新,提交一次永久有效。

周期性核查(每月一次)

7. 死链扫描

npx mintlify@latest broken-links
预期 0 命中。若有命中,修死链或更新引用。

8. 孤立页面审查

无入链的页面对 SEO 和 AI 引擎都不友好。每月看一遍导航 + 站内搜索,找出存在但没人链接到的页面:
  • 要么补入链(在相关上游页加链接)
  • 要么决定是否下架

9. AI 引擎抽测

scripts/doc/probe-log.md 里的 3 道标准题,记录命中率与引用准确性。AI 答错通常意味着文档存在歧义、缺失或矛盾。

检查记录模板

每次跑完站点级检查,在 commit message 或 PR description 里贴一行:
site-check 2026-05-29: indexing✓ mint-score✓ llms.txt✓ llms-full.txt✓ .well-known/llms.txt✓ sitemap✓ broken-links✓(0) orphans-checked probe-log✓
不通过的项必须修,不能放行。