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

26 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Cesium 导出性能优化与产物一致性验证
## Goal
将 Cesium 导出阶段从约 150 秒降至接近 15–20 秒,保持全部资产与视觉语义。用户在性能诊断之后明确同意优化,并要求每项操作有理论依据。
## Requirements
- 每项优化对应测量热点、Blender API/源码依据及可证伪的验证。
- 保留主场景、分类资产、三个动态信号资产、材质、贴图、节点与地理锚点。
- 不全局关闭依赖图更新;保留涉及修改器依赖的正确评估。
- 不降低几何精度、不改材质、删资产或修改浏览器流程。
- 不覆盖用户现有工作区修改;性能及 parity 产物写临时目录。
## Acceptance Criteria
- [x] 同一输入、无 profiler 的前后基准,记录实际耗时与提升倍率;接近 10 倍是目标,不能牺牲正确性。
- [x] 全部 GLB 通过既有结构摘要契约;深入检查几何、UV、法线、切线及纹理,不能通过扩大忽略名单隐藏差异。
- [x] 至少两份真实区域输入及针对共享网格、无修改器、既有 UV 的 Blender 验证。
- [x] 未改动代码 control 复测;相关现有测试通过。
- [x] 理论依据、验证结果、限制记录到任务研究与长期规范。
## 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`,未扩展项目忽略名单。