{
  "$schema": "https://pingfanfan.github.io/OpenWebsite/schema/knowledge-page.schema.json",
  "format": "knowledge-page",
  "id": "docs-home",
  "url": "https://pingfanfan.github.io/OpenWebsite/docs/",
  "rawUrl": "https://pingfanfan.github.io/OpenWebsite/raw/docs-home.md",
  "apiUrl": "https://pingfanfan.github.io/OpenWebsite/api/pages/docs-home.json",
  "schemaUrl": "https://pingfanfan.github.io/OpenWebsite/schema/knowledge-page.schema.json",
  "title": "AI 友好型网站文档总览",
  "summary": "定义站点契约、页面地图、扩展方式和发布要求。",
  "lastUpdated": "2026-03-12",
  "version": "v1.0.0",
  "audience": ["ai-agent", "crawler", "developer", "human"],
  "sourceOfTruth": "站点结构与发布合同",
  "tags": ["overview", "site-contract", "publishing"],
  "sections": [
    {
      "id": "site-contract",
      "title": "站点契约",
      "summary": "定义所有公开页面都必须满足的机器消费合同。",
      "content": [
        "正文必须在首次 HTTP 响应中直接可得，不依赖客户端脚本拼接。",
        "每个主题同时提供 HTML、Markdown 和 JSON 三种同步表示。",
        "每个页面必须显式声明更新时间、版本、来源和相关页面。"
      ]
    },
    {
      "id": "doc-map",
      "title": "文档地图",
      "summary": "说明站内关键页面分别负责什么主题。",
      "content": [
        "信息架构页面定义目录布局、页面类型和内容粒度。",
        "URL 规范页面定义 slug、锚点和生命周期策略。",
        "页面模板、JSON Schema 和检索契约页面分别负责模板、合同和抓取链路。"
      ]
    },
    {
      "id": "extension-model",
      "title": "扩展模型",
      "summary": "新增主题时必须同步新增三种表示和全站索引。",
      "content": [
        "新增主题时需要同时创建 docs 页面、Markdown 文件和 JSON 文件。",
        "新页面还需要补充到 api/site.json、llms.txt 和 sitemap.xml 中。",
        "每个一级 section 都应设计稳定锚点，便于回引。"
      ]
    },
    {
      "id": "release-checklist",
      "title": "发布检查单",
      "summary": "发布前应优先检查可抓取性、结构稳定性和 schema 验证。",
      "content": [
        "确认页面无需登录、无需滚动触发或客户端脚本即可读取正文。",
        "确认标题层级和 anchor 命名稳定，元数据字段完整。",
        "确认 JSON 文件通过 schema 校验，索引入口能发现新页面。"
      ]
    }
  ],
  "relatedPages": [
    {
      "id": "information-architecture",
      "title": "信息架构",
      "url": "https://pingfanfan.github.io/OpenWebsite/docs/information-architecture/"
    },
    {
      "id": "url-conventions",
      "title": "URL 规范",
      "url": "https://pingfanfan.github.io/OpenWebsite/docs/url-conventions/"
    },
    {
      "id": "retrieval-contract",
      "title": "检索与抓取契约",
      "url": "https://pingfanfan.github.io/OpenWebsite/docs/retrieval-contract/"
    }
  ]
}