# 信息架构

Summary: AI 友好型站点的信息架构应保证一个 URL 对应一个稳定知识单元，并同时满足可读、可抓取和可验证。

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

## 设计目标

- 每个页面聚焦一个核心问题。
- 每个 section 可以单独被引用。
- 抓取系统能通过有限入口发现全部页面。
- 页面更新时尽量不破坏已有 URL 和锚点。

## 目录模型

```text
/docs/
/raw/
/api/pages/
/schema/
/llms.txt
/sitemap.xml
```

目录按格式角色分层，而不是按视觉组件分层。

## 页面类型

- Hub: 目录页，只负责发现和路由。
- Document: 主题页，承载稳定知识单元。
- Schema: 定义 JSON 合同。
- Index: 提供爬虫和模型入口，例如 `llms.txt` 和 `sitemap.xml`。

## 内容粒度

- 标题层级不超过三级。
- 一个 section 先给摘要，再给正文。
- 一段文字尽量只表达一个判断。
- 表格和代码块需要前导说明。

## 变更策略

- 页面主题不变时保持原 URL。
- 主题边界变化时保留旧路径映射。
- 版本优先通过元数据表达，而不是换新 slug。