# 检索与抓取契约

Summary: AI 系统对网站的典型操作是发现入口、抓取正文、切块索引和回引 URL，站点必须主动为这条链路提供稳定信号。

Last updated: 2026-03-12  
Version: v1.0.0  
Docs URL: https://pingfanfan.github.io/OpenWebsite/docs/retrieval-contract/  
API URL: https://pingfanfan.github.io/OpenWebsite/api/pages/retrieval-contract.json

## 发现入口

- `/robots.txt`
- `/sitemap.xml`
- `/llms.txt`
- `/llms-full.txt`
- `/api/site.json`

## 切块规则

- 一个 section 只讲一个主题。
- 摘要句放在节首。
- 列表项尽量是完整句。
- 表格不要承载唯一事实。

## 引用规则

- 优先引用带 anchor 的文档 URL。
- 如需原始文本，引用对应 Markdown URL。
- 如需结构化字段，引用 JSON URL 和 schema 链接。
- 同一结论不要散落在多个页面里。

## 常见失败模式

- 正文藏在点击展开或滚动加载之后。
- 路径频繁变化且无映射。
- 同一规则在多个页面里表述冲突。
- 内容更新但日期和版本不变。