文档版本

这份文档的版本号就是平台发版号，写在仓库 pom.xml 的 <version> 里。当前是 2026.06.30。页面 JSON 里面没有单独的 schema 版本字段：一份 JSON 能跑，是因为运行时认识那些键。

右上角的版本菜单用来在「现在这一版」和「已经冻结的旧版」之间切换。旧版是发版当时的文章副本，后面改字段说明不会改到它。

冻结当前版

在 docs/ 目录执行：

node scripts/snapshot.mjs 2026.06.30

脚本把 guide/、reference/ 和 zh/ 复制到 archive/2026.06.30/。文章之间用相对链接，复制之后仍指向同一版目录里的页面。中文旧版的菜单项链到 /archive/2026.06.30/zh/guide/what-is。

然后编辑 docs/.vitepress/config.mjs：

• 把 platformVersion 改成新的平台版本号。
• 在中文版本菜单里加一项，例如 { text: '2026.06.30', link: '/archive/2026.06.30/zh/guide/what-is' }。
• 在英文版本菜单里加一项，例如 { text: '2026.06.30', link: '/archive/2026.06.30/guide/what-is' }。

侧边栏始终指向当前版。打开旧版文章时，正文是旧的，侧边栏仍会跳到当前版。需要旧版目录时，从该版正文里的链接往下走。

平台版本号变了、字段说明还没改，只改 platformVersion，不必做副本。做副本的时机是：这一版已经交给别人用，下一版的字段说明要开始分叉。