feat: add Cesium semantic inspection mode

This commit is contained in:
2026-08-05 13:24:39 +08:00
parent 400525dd07
commit 607d8fc0b1
18 changed files with 542 additions and 56 deletions

View File

@@ -0,0 +1,28 @@
# 设计Cesium 语义资产检查
## 边界
Blender 场景已按集合组织要素。Cesium 导出器在不修改作者场景的前提下,复用现有导出材质处理,先生成完整主 GLB再按集合筛选对象生成道路、建筑、植被和水体四份辅助 GLB。主 GLB 继续是默认资产和兼容基线。
## 资产契约
metadata 保持现有 `asset` 字段指向主 GLB并将 `assets` 扩展为:
- `main`:完整场景,默认启用;
- `roads``buildings``vegetation``water`:语义检查资产,默认关闭。
每个资产提供稳定的 `id`、中文 `label``type: model`、相对 `url``enabled`。旧 metadata 缺少这些额外资产时,预览按现有单资产回退路径加载。
## 预览交互
主场景模式只显示主 GLB并保留现有 `Scene` 总开关。切入分类检查模式时隐藏主 GLB、显示四个类别复选项选择类别时加载并显隐对应资产。离开分类模式后恢复主场景避免完整模型和类别模型重叠渲染。
控制面板继续是贴边的紧凑工具面,不添加嵌套卡片。模式切换使用分段控件,类别开关按一行标签排列;窄屏时自然换行。颜色只用于状态和可访问性反馈,不做大面积装饰。
## 兼容与回滚
主 GLB、主 metadata 和既有预览文件名均不变。任意辅助 GLB 缺失时,预览记录该资产失败但完整场景仍可加载。回滚只需恢复旧 exporter/runtime主产物仍可使用。
## 风险
多次导出会增加 Cesium 阶段耗时与磁盘占用,但只影响验证辅助产物,不改变主 GLB。导出时需确保每份辅助资产保留与主 GLB 相同的局部 ENU 坐标和材质处理。