迁移到引用式 GUI 菜单

分类菜单不再自带布局。布局池、主布局、窗口类型和音效都放在由 menu 字段引用的 Open GUI 条目中。这样可以让编辑器更轻量，并避免大型页面发布缓慢。

旧页面会发生什么

启动时，扩展会查找仍然带有布局的分类菜单，并一次性转换它们：把布局移入一个新的底板（chassis）Open GUI，并设置 menu。只有当所有页面都转换成功时才会写入；否则会保持你的页面不变，并在下次启动时重试。更新之前请备份你的 pages 文件夹，并同时更新 Quest Codex 和 GUI。

仍然没有 menu 的分类菜单会在控制台中报告，因为打开它不会有任何效果。

手动迁移

对每个旧版分类菜单：

1. 创建一个 Open GUI，并把 guiType、audio、layoutPool 和 mainLayoutId 移入其中。
2. 将分类菜单的 menu 设为该条目。
3. 在分类菜单上保留 category、title、rows 和 sortDisplay。
4. 让 rows 与 Open GUI 的 size 一致。

Gap 语义

在 Quest Codex 0.3.0 之前，标记的 gap 表示间距。现在它是所有 GUI 扩展共用的步长：1 表示槽位相邻，2 表示中间隔一个空槽。若要恢复旧菜单原有的间距，请将步长加倍：gap 1 变为 2。

追踪存储

要实现持久的多任务追踪，请在 static 页面中放置一个 Quest Codex Tracking Data 条目，并在 trackingArtifact 中引用它。玩家开始使用后，请保持其 artifactId 不变，否则他们已追踪的任务会成为孤立数据。