> ## 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.

# Site check

# 站点级 GEO/SEO 检查清单（9 项）

页面级 15 件套由 `scripts/doc_lint.py` 自动检测；本清单是**站点级、一次性/周期性**核查项，不进 linter。

参考：Mintlify [GEO 指南](https://www.mintlify.com/docs/zh/guides/geo) + [SEO 指南](https://www.mintlify.com/docs/zh/guides/seo)。

***

## 一次性配置（首次设置后基本不变）

### 1. `docs.json` 启用全量索引

```jsonc theme={null}
{
  "seo": {
    "indexing": "all"   // 让隐藏页也进 AI 上下文
  }
}
```

验证：grep `"indexing"` docs.json 命中。

### 2. `mint score` → `robotsTxtAllowsAI` 通过

```bash theme={null}
npx mintlify@latest score
```

预期输出含 `robotsTxtAllowsAI: pass`。Mintlify 默认放行 OpenAI / Anthropic / Perplexity / Google-Extended 等 AI bot，自托管 `robots.txt` 不能写 `User-agent: * Disallow: /`。

需放行的 AI 用户代理清单：

* `GPTBot`、`OAI-SearchBot`、`ChatGPT-User`（OpenAI）
* `ClaudeBot`、`Claude-User`（Anthropic）
* `PerplexityBot`（Perplexity）
* `Google-Extended`（Gemini）

### 3. `/llms.txt` 200

```bash theme={null}
curl -sI https://docs.aihubmix.com/llms.txt | head -1
```

Mintlify 自动生成。本仓库 `public/llms.txt` 是自定义覆盖版，删除后会回到自动版。

### 4. `/llms-full.txt` 200

```bash theme={null}
curl -sI https://docs.aihubmix.com/llms-full.txt | head -1
```

包含全站 Markdown 整合，专供 AI 工具作为 context 使用。

### 5. `/.well-known/llms.txt` 200（备用路径）

```bash theme={null}
curl -sI https://docs.aihubmix.com/.well-known/llms.txt | head -1
```

部分 AI 工具走 .well-known 路径发现资源。

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

```bash theme={null}
curl -sI https://docs.aihubmix.com/sitemap.xml | head -1
```

GSC 提交位置：Google Search Console → 左侧 **Sitemaps** → 填 `sitemap.xml`。Mintlify 自动生成与更新，提交一次永久有效。

***

## 周期性核查（每月一次）

### 7. 死链扫描

```bash theme={null}
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✓
```

不通过的项必须修，不能放行。