Files
osmWorkflow/.trellis/tasks/archive/2026-09/09-17-cesium-export-performance/prd.md
T

1.6 KiB
Raw Blame History

Cesium 导出性能优化与产物一致性验证

Goal

将 Cesium 导出阶段从约 150 秒降至接近 15–20 秒,保持全部资产与视觉语义。用户在性能诊断之后明确同意优化,并要求每项操作有理论依据。

Requirements

  • 每项优化对应测量热点、Blender API/源码依据及可证伪的验证。
  • 保留主场景、分类资产、三个动态信号资产、材质、贴图、节点与地理锚点。
  • 不全局关闭依赖图更新;保留涉及修改器依赖的正确评估。
  • 不降低几何精度、不改材质、删资产或修改浏览器流程。
  • 不覆盖用户现有工作区修改;性能及 parity 产物写临时目录。

Acceptance Criteria

  • 同一输入、无 profiler 的前后基准,记录实际耗时与提升倍率;接近 10 倍是目标,不能牺牲正确性。
  • 全部 GLB 通过既有结构摘要契约;深入检查几何、UV、法线、切线及纹理,不能通过扩大忽略名单隐藏差异。
  • 至少两份真实区域输入及针对共享网格、无修改器、既有 UV 的 Blender 验证。
  • 未改动代码 control 复测;相关现有测试通过。
  • 理论依据、验证结果、限制记录到任务研究与长期规范。

Results

Nantaizi 173.227 → 15.905 秒(10.89x);Fengshu 36.891–41.396 → 5.638 秒(6.54–7.34x)。全部结构摘要通过。Nantaizi 解码属性零差异;Fengshu 仅树冠切线存在未改代码 control 已复现的一个四位小数舍入步长波动。详见 research/measurements.md,未扩展项目忽略名单。