内容来源
根目录、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。单语维护文档保留原文,英文界面标明原文语言,不冒充已翻译。