# 文档维护

[协作索引](LLM.MD) · [站点构建说明](../../../docs-site/README.md)

## 内容来源

根目录、`docs/` 和 `tools/` 的 Markdown 在构建时自动收录。`docs/src/API.md` / `API.en.md` 按 `###chapter:` 拆分；新增或调整章节时同时更新站点章节映射，使中英文路由保持一致。

普通新增文档不需要手工写页面。正文、目录、搜索索引和下载文件一起生成。已有源文件不会被生成器改写。

## AI 层级

根 `LLM.MD` → `docs/ai/LLM.MD` → 模块 `LLM.MD` → 叶子文档。模块索引保持短小，复杂约定放在叶子页并链接 API / 实现。

`llms.txt` 自动列出源文档，`llms-full.txt` 自动拼接完整快照，文件中的版本模板在构建时替换。AI 指引的语义需要随实现维护，生成器不推断源码行为。

## 双语与验证

API 双语代码块行数、顺序保持一致，运行 `python tools/check_api_parity.py`。站点运行 `bun run check`、`bun test`、`bun run build`。单语维护文档保留原文，英文界面标明原文语言，不冒充已翻译。
