#文档站维护说明

#栈

#目录约定

docs/
├── zh/             # 默认语言（路由无前缀）
│   ├── guide/
│   ├── dev/
│   ├── api/
│   └── reference/sdk/   # TypeDoc 生成（gitignore）
├── en/             # 英文（/en/...）
├── includes/       # 缩写等（不进路由）
└── superpowers/    # 内部规格（route.exclude）
website/            # rspress.config.ts、组件、插件
i18n.json

#常用命令

pnpm install
pnpm run docs serve
pnpm run docs build

#配置入口

• website/rspress.config.ts — 站点、插件、base、i18n
• typedoc.json — 与 plugin setup 对齐的 TypeDoc 选项参考
• docs/zh|en/**/_meta.json、_nav.json — 导航
• i18n.json — 顶栏文案键

#新增手写页面

1. 在 docs/zh/<section>/ 加 .md / .mdx
2. 写入该目录 _meta.json
3. 含 <Tabs> 时从 @rspress/core/theme 导入 Tabs/Tab

#扩展 TypeDoc 入口

在 website/rspress.config.ts 的 pluginTypeDoc({ entryPoints }) 与根目录 typedoc.json 同步追加 SDK 公开入口。