信息架构
AI 友好型站点的信息架构目标，是让“一个 URL 对应一个稳定知识单元”，并让这个知识单元同时具备可读性、可抓取性和可验证性。
设计目标
信息架构的优先级不是导航美观，而是知识拆分是否足够稳定，能否被程序长期消费。
- 让每个页面聚焦一个核心问题，避免多主题混装。
- 让每个 section 可以单独被引用，而不失去上下文。
- 让抓取系统通过有限入口就能发现全部页面。
- 让页面更新时尽量不破坏已有链接和锚点。
目录模型
目录要按“格式角色”分层，而不是按视觉组件或运营栏目分层。
/docs/ HTML 文档入口
/docs/information-architecture/
/docs/url-conventions/
/docs/page-template/
/docs/json-schema/
/docs/retrieval-contract/
/raw/ 原始 Markdown
/api/pages/ 结构化 JSON
/schema/ 校验 Schema
/llms.txt 面向模型的索引
/sitemap.xml 面向爬虫的索引页面类型
并不是所有页面都承担同样职责。区分页面类型可以减少结构漂移。
目录页只负责发现和路由，不负责堆积大量事实。
主题页负责一个知识问题，并提供稳定 section 与元数据。
Schema 页和 schema 文件定义机器消费的合同。
索引文件负责发现，不承载语义解释，例如 `llms.txt`、`sitemap.xml`。
内容粒度
AI 系统通常按 chunk 读取内容，所以页面内部也必须有稳定边界。
- 标题层级不超过三级，避免深层嵌套导致 chunk 边界含混。
- 一个 section 先给摘要，再给正文和例子，方便快速抽取。
- 一段文字尽量只表达一个判断，减少跨段依赖。
- 表格和代码块要有前导说明，避免脱离上下文后失真。
变更策略
结构设计需要考虑多年后的可维护性，而不是一次上线的便利。
- 页面主题不变时，保持原 URL，不轻易改 slug。
- 仅当知识边界发生断裂时，才引入新页面或新版本路径。
- 旧路径下线前应保留映射关系，避免检索索引瞬间失效。
- 内容调整优先通过 `lastUpdated` 和 `version` 反映，而不是换新路由。