Seed World 加载耗时分析:冷加载 59.8 s,主线程活跃 34.5 s

Aperta
#3,168 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Refactoring
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
typescript

Direzione di ricerca

Start with the measured call sites, including runtime-scene-edit.ts:548, PlanningProjectSource.ts:116, and SeedWorldDemo.ts, then read the relevant sections of the report for verified findings and candidate optimizations. The report identifies several independent areas with different risks; begin by reproducing one measurement and isolating one change. Done means a measured improvement with existing behavior preserved; for hash changes, first establish whether hashes are persisted or compared across platforms.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

performance
  • 被测代码:experimental/engine-next 的提交 e755eeb20,加上 world/demos/seed-world/SeedWorldDemo.ts 的计时标记。
  • 测量日期:2026-11-11。
  • 本 issue 记录加载流程每个阶段的耗时、不需要做的工作和能够优化的工作。第 7 节记录 2 项修改的复测结果。

术语

术语 含义
冷加载 用全新的浏览器 profile 加载。没有 HTTP 缓存,没有已保存的工程
热加载 用同一个 profile 再次加载
加载完成 document.body.dataset.worldReady === "true"
计时标记 SeedWorldDemo.ts 中的 timed() 和 recordBootSpan()
CPU 采样 Chrome trace 中的 V8 CPU profiler 数据
已验证 测量数据和源码一致
候选 结论来自代码审查,和测量数据不矛盾。尚未做隔离实验
未验证 结论只来自代码审查。没有测量数据支持

1. 结论

  • 生产包冷加载用时 59.8 s。生产包热加载用时 46.4 s 和 47.2 s。
  • dev server 冷加载用时 58.9 s 到 61.3 s。生产包和 dev server 的用时接近。模块加载不是主要成本。
  • 主线程是瓶颈。冷加载的 59 s 中,主线程 CPU 活跃 34.5 s。热加载中,主线程 CPU 活跃 35.8 s。
  • 生产包冷加载有 68 个长任务,合计 22.7 s。
  • 4 个 Worker 依次运行,运行时间基本不重叠。测试机器有 8 个核。
    • 规划 Worker:7.1 s。
    • 栅格 Worker:7.0 s。
    • 岩石 Worker:加载完成前 4.4 s,世界显示后 2.0 s。
    • 建筑 Worker:2.6 s。
  • 加载流程没有跨加载的缓存。热加载重新计算规划、栅格、岩石、建筑编译和水体编译。
  • 热加载比冷加载少 13 s。减少的时间主要来自两项:建筑场景生成(6.6 s)和人口搜索。
  • orb.reveal 结束时,世界已显示,用户已能够移动。之后拍照准备再用 3.0 s 到 3.5 s,status=ready 才出现。

2. 测量条件

项 值
设备 Apple M2,8 核,16 GB
浏览器 Chrome,由 Playwright 启动(channel: chrome,headless,ANGLE Metal)
视口 1440×900
URL …/world/demos/seed-world/index.html?template=original&seed=1&agentTrace=1
生产包 pnpm exec vite build --config vite.config.mjs --outDir world/dist/perf-seed-world
生产包服务 vite preview,地址 127.0.0.1:5194
dev server pnpm --dir world dev,地址 127.0.0.1:5193
世界规模 1024×1024 m。高度图和权重图 1024²。62 个 POI,129 棵树,20 栋建筑,129 个岩体,3 个水体
测量方法
  • 1 个 Playwright 脚本加载页面,并等待加载完成。
  • 脚本记录阶段时间、计时标记、长任务和资源请求。
  • CPU 采样用 CDP 的 Tracing 录制,类别包含 disabled-by-default-v8.cpu_profiler。
  • 测量脚本和原始数据在本地,尚未提交。
限制
  • 生产包测量了 1 次冷加载和 2 次热加载。dev server 的 CPU 采样测量了 1 次冷加载和 1 次热加载。
  • 第 3 节的测量没有做 A/B/A 对照。2 次热加载相差 0.8 s。
  • 全部测量在 localhost 上进行,网络成本接近 0。真实网络下,资源体积的成本将高于本报告的数字。
  • agentTrace=1 启用 GL 调用包装探针和长任务观察器。CPU 采样也有开销。没有单独测量这两项开销。
  • 测量环境是桌面 headless Chrome。测量结果不代表手机壳和小游戏环境。
  • 测量期间,同一台机器上的另一个浏览器标签页可能在运行同一场景。这一项没有控制。
  • 只有 A1 和 A2 做了“修改后复测”,结果在第 7 节。第 4 节到第 6 节的收益都是上限估计。多项收益有重叠,不能相加。

3. 耗时

3.1 阶段和子项

单位是 ms。数据来自生产包的 1 次冷加载和 1 次热加载。粗体行是阶段,其余行是该阶段的子项。

阶段或子项 冷加载 热加载
入口和引擎创建 2017 1782
准备 Seed 场景 9557 9488
openSeedWorldProject 995 157
createPlanningWorldSource(和主流程并行,决定本阶段的长度) 6919 5704
preparePlanningFarmingScene 295 3
planningStorage.migrateToSource 755 2785
installRuntimeProjectScripts 176 100
runtimeProject.resources 128 130
runtimeProject.save 43 121
注册启动 Shader 440 392
preloadTerrainPrecipitationShaders 85 76
场景资源、种群资源和环境 1770 1927
准备规划贴图 7102 6282
raster.run 6933 6135
玩家状态、地面种群和出生视角 168 147
创建 Seed 地形与植被 8640 9995
SeedWorldTerrainRuntime.create 411 311
rockFormations.prepare 4116 5204
prepareRockTextures 64 44
createPlanningSeedSolids 955 911
PlanningNaturalVegetationRuntime.create 2352 2705
applyAuthoringPopulationLayout(包含第 2 次地面种群投影) 741 815
生成全部房屋与围合构件(initializeBuildingScene) 6552 17
准备原生建筑与水体 6851 6924
nativeBuildingHost.prepare 4252 4444
water.prepare 2442 2330
岩石草和 warmupPopulationDetails 157 150
预编译场景渲染变体 3048 1608
准备世界画面(等待 IBL) 2364 1491
准备拾取与选中效果 2378 1269
“已就绪”到 status=ready 9343 5465
orb.reveal 2487 1658
lassoPanel.prepare 3459 3023
拾取准备和 prepareSnapshot 319 147
合计 59847 46406
3.2 每个线程的 CPU 时间

数据来自 dev server 冷加载的 CPU 采样。

线程 活跃时间(ms) 活跃窗口 主要函数(ms)
主线程 34538 全程 见下方列表
岩石 Worker 7325 24.9 s 到 59.9 s buildBoundedRockSurface 5059,simplifyRock 1364
规划 Worker 7196 5.0 s 到 35.6 s spatialWorldStages 6358
栅格 Worker 7020 17.3 s 到 54.2 s compilePlanningOcean 3808,planningHeightmap 1033
建筑 Worker 2634 40.7 s 到 49.5 s prepareBuildingCpu 1588,reply 574
KTX2 转码 Worker(4 个) 每个 254 到 434 — basis wasm
脚本编译 Worker 322 38.2 s TypeScript createProgram

compilePlanningOcean 的 3808 ms 中,hashStableValue 占 3406 ms。

主线程的 self 时间,按包统计:

包 ms
没有 URL 的原生代码 8857
packages/runtime-editor 4016
packages/world-planning 2879
packages/core 2806
world/demos/seed-world 2424
packages/building 2230
packages/water 2144
packages/vegetation 2074
packages/shader-parser 1958
packages/project 1177
packages/rhi-webgl 1080
packages/shader-compiler 1023
  • GC 用时 1680 ms。
  • (program) 用时 6904 ms。CPU 采样不能把这部分时间归到 JS 函数。

4. 不需要做的工作

A1 每次查询场景都解析整份场景 JSON(已验证)
  • 位置:packages/runtime-editor/src/runtime-editor/scene/runtime-scene-edit.ts:548 的 read()。
  • read() 每次调用都执行 JSON.parse,输入是整份场景源文本。
  • queryComponents、readComponent、readEntity 和 list 每次调用都执行 read()。
  • 调用者是 readPlanningProjectSource.append。位置是 world/demos/seed-world/src/planning/spatial/runtime/PlanningProjectSource.ts:116。append 对每个实体执行这些查询。
  • validatePlanningProject 在每次工程提交时调用 readPlanningProjectSource。
  • 成本:冷加载时,read 的 self 时间是 2315 ms。这部分时间分布在 4 个阶段,每个阶段 530 ms 到 620 ms。
  • 成本:热加载时,read 的 self 时间是 5677 ms。原因是已保存的场景包含 20 栋建筑的实体。
  • 热加载的 migrateToSource 从 0.75 s 增加到 2.8 s。read 可能是主要原因(候选,没有单独拆分)。
  • 修改方向:在一次编辑事务内缓存解析结果。场景内容变化时,缓存失效。
A2 拍照准备推迟了 status=ready(已验证)
  • SeedWorldDemo.ts 先设置 ready = true,并启用导航输入。
  • 之后 SeedWorldDemo.ts 等待 4 个步骤:lassoPanel.prepare()、pickPreparation.flush、worldPicker.prepareSnapshot 和第 2 次 pickPreparation.flush。
  • 4 个步骤结束后,SeedWorldDemo.ts 才执行 tools.show()、loading.hidden = true 和 status = "ready"。
  • lassoPanel.prepare 用时 3023 ms 到 3459 ms。
  • 在这段时间内,世界已显示,用户已能够移动。屏幕中央仍显示“100%”。助手 HUD 和拍照按钮尚未显示。
  • 资源体积(已验证):polaroid-camera.glb 是 13.1 MB,polaroid-photo.glb 是 4.95 MB。
  • 资源内容(未验证):代码审查认为 polaroid-camera.glb 有 27 万个三角形。代码审查认为 polaroid-photo.glb 的主要内容是 1 张 4096² PNG,并且运行时替换了这张贴图所在的材质。
  • 懒加载路径已存在:SeedWorldInstantCamera.enter() 内部执行 await this.prepare()。
  • 修改方向:把 tools.show()、loading.hidden 和 status 移到这 4 个步骤之前。在后台执行这 4 个步骤,或在用户第 1 次点击拍照按钮时执行。
A3 运行模式执行了用不到的点选预热(可达性已验证,成本是候选)
  • 只有 debug=1 的调试侧栏能够把 worldPickingEnabled 设为 true。
  • 运行模式下,点击处理函数在调用 worldPicker.pick 之前返回。
  • 加载流程没有判断模式,每次都执行 worldPicker.warmup(...)。
  • worldPicker.warmup 做 3 件事:分配全画布的渲染目标,克隆材质,渲染 2 次。第 2 次渲染同步编译和链接 PICK_DEPTH 变体。
  • CPU 采样中,worldPicker.warmup 的渲染用时约 834 ms。
  • 所在阶段用时 1.3 s 到 2.4 s。这个阶段还包含第 2 次 warmupPopulationDetails。两者的时间没有拆分。
  • 另一个问题(未验证):RuntimePickPreparation 在引擎创建后开始工作。它为每个 Forward 变体编译 1 个拾取程序。代码审查认为,其中包括拾取渲染不绘制的 pass:后处理、天空和加载球。
A4 预热的中心是场景默认相机,不是出生点(位置和后果已验证,浪费量是候选)
  • SeedWorld.scene 的相机位置是 (0, 26.5, 265.6)。出生点是 (914, 95)。两者相距约 930 m。
  • 发布提交时,加载流程才把相机移到出生点。
  • 发布提交之前,以下 3 项预热使用相机位置:
    • 植被格:PlanningNaturalVegetationRuntime.create 中的 update(0)。
    • 草和花的细节格:warmupPopulationDetails。
    • 建筑细节 LOD:flush()。
  • 后果 1:世界显示后,主线程再用 1185 ms 编译植被格。调用链是 driver.tick → update → load → compileCell。
  • 后果 2:世界显示后,岩石 Worker 再活跃 1976 ms,生成伴生石。
  • 修改方向:在准备阶段,把预热的中心改成 cameraPose。
A5 每次加载都重新下载水体内置贴图(下载已验证,下载后的处理是候选)
  • 热加载的“准备 Seed 场景”阶段仍请求 16 个 Water/Textures/*.ktx2 文件,共 14.5 MB。
  • 代码审查的结论:loadPlanningWaterDefaults 先下载全部文件。之后 installPlanningWaterDefaults 才跳过工程中已有的文件。
  • 代码审查的结论:加载流程把这些贴图的字节写入工程包。之后工程包的克隆、逐字节比较和 IndexedDB 写入都包含这些字节。
  • CPU 采样的相关数据:
    • sameResourceContent:316 ms 和 184 ms。
    • sameStoredContent:209 ms 和 106 ms。
    • cloneRuntimeProjectContent:173 ms。
A6 规划结果没有保存,冷加载生成约 5 次世界(已验证)
  • 冷加载:prepareSeedPlanningDocument → preparePlanningPopulation → solve 用时 4373 ms。solve 为每个人口候选完整生成 1 次世界。候选数量的上限是 24。
  • 冷加载:之后 client.run 再生成 1 次世界,用时 1168 ms。
  • 热加载:不执行人口搜索。client.run 仍重新求解 1 次,spatialWorldStages 用时 3532 ms。
  • 人口搜索是新世界的设计行为。能够优化的是 2 项:保存规划结果,以及避免热加载重新求解。
A7 每次加载都执行 migrateToSource(用时已验证,原因是候选)
  • 冷加载用时 755 ms。热加载用时 2785 ms 到 3134 ms。
  • 代码审查的结论:PlanningProjectStorage.initialize 每次都把标记写成 version 1。
  • 代码审查的结论:migrateToSource 只在标记是 version 2 时跳过。因此 migrateToSource 每次都重写规划源,并触发 2 次完整提交。
A8 启动时写入建筑使用了完整的编辑器事务(运行已验证,分项成本是候选)
  • initializeBuildingScene 依次执行 beginEdit、prepare、commit 和 activate。
  • 该阶段的主线程活跃时间:dev server 冷加载是 4626 ms,阶段总长是 5683 ms。
  • CPU 采样显示,脚本编译 Worker 已启动,并执行了 TypeScript createProgram(181 ms)。
  • 代码审查的结论:工程没有脚本资源。
  • 代码审查的其他结论:
    • 加载流程编译了 3 次全工程资源。
    • 每栋建筑执行 1 次 reparent。每次 reparent 都解析并序列化整份场景。
    • 建筑编辑期间,水体校验再执行 1 次。
A9 加载了建筑的全部素材(体积已验证,“没有被采样”未验证)
  • 加载流程下载 29 个 .tex 文件。传输体积是 32.0 MB,解码后是 151.4 MB。
  • .tex 文件的格式是未压缩的 RGBA8,带完整的 mip。主线程同步上传这些贴图。
  • 加载流程还下载 104 个 mesh、16 个 shaderc 和 115 个 prefab。
  • 每栋建筑只引用 kit。kit 引用全部 303 个文件。没有按建筑划分的依赖集。
  • 代码审查的结论(未验证):所有渲染路径都设置了 whiteBase。约 55 MB 的彩色贴图变体没有被采样。修改前必须确认没有其他使用方。
  • 代码审查的结论(未验证):22.4 MB 的石板地面贴图只在建筑部件有 stonePaving 时才绑定。
  • 代码审查的结论:建筑场景生成只使用 prefab 的包围盒、占用和屋顶轮廓。建筑场景生成不需要 GPU 资源。
A10 加载了没有实例的种群资源(请求已验证,“没有实例”是候选)
  • “场景资源、种群资源和环境”阶段加载了以下资源:
    • 莲花:6 个 GLB 和 2 个 KTX2,约 1 MB。
    • 蘑菇 LOD。
    • 树木 impostor 和 Billboard.shaderc(402 KB)。
    • 枯树。其中法线贴图是 16 位 RGBA 的 PNG,2.9 MB。
  • 代码审查的结论:这条加载路径的 decorations 是空数组,treeInstances 是空数组。全仓库没有代码读取 library.treeImpostor。
  • 另一个问题(候选):SeedWorldTreeLodRenderer 为枯树构建了 LOD 网格。这条加载路径的布局没有枯树实例。
A11 构建了未激活的天气内容,并重新计算能够预生成的噪声(运行已验证)
  • 默认天气是晴天,时间是正午。
  • 加载流程构建了以下内容:
    • 雨:4 个粒子渲染器和 1 张图集。
    • 雪的 prefab。
    • 闪电的网格。
    • 512² 的涟漪图集。buildRippleNormalAtlasPixels 用时 149 ms。
  • 每次页面加载,主线程都重新计算云天气图:worley2D 220 ms,stableHash 114 ms,modulo 82 ms。
  • 默认种子的云天气图是确定值。修改方向:预生成,或移到 Worker。
A12 重复执行的工作(每项成本较小)
  • 地面种群投影执行 2 次。第 2 次的结果完整替换第 1 次的结果。第 2 次是 1 个不让出主线程的任务。applyAuthoringPopulationLayout 的计时标记是 741 ms 到 815 ms(用时已验证)。
  • buildingAssets() 快照构建 2 次(候选)。代码审查的原因:准备阶段的实例被销毁,WeakMap 缓存没有命中。
  • 建筑设计执行 2 次(候选):主线程 1 次,建筑 Worker 1 次。
  • runtimeProject.resources() 连续执行 2 次。计时标记合计约 230 ms 到 300 ms。
  • publish() 再次执行以下 3 个函数:
    • setSurfaceColorTuning:第 2 次调用只设置 uniform。
    • applyPlanningWeather:第 2 次调用不做任何工作。
    • applyPresentation:第 2 次调用可能触发 1 次多余的 IBL 烘焙(候选,见 B10)。

5. 能够优化的工作

B1 hashStableValue 把类型化数组当作 JSON 文本计算哈希(已验证)
  • 位置:packages/water/src/water/compiler/shared/determinism.ts:98。
  • hashStableValue 为类型化数组的每个元素写出 "index":value 字符串。之后 hashStableValue 逐字符计算哈希。
  • 栅格 Worker 的成本:3406 ms。输入是 2 个数组,每个数组有 100 万个元素。每次编译计算 2 次哈希。
  • 主线程的成本:1375 ms,位于 water.prepare。其中 createRiverResourceMetadata 占 892 ms,sourceIdentity 占 181 ms。
  • 修改方向:对类型化数组直接计算字节的哈希。
  • 注意:这项修改改变哈希值。代码注释说明,当前实现有意保持旧的哈希值。修改前必须确认:这些哈希值是否已持久化,以及是否用于跨端比较。
B2 Worker 依次运行(时序已验证,收益是估算)
  • 岩石生成只依赖 plan。加载流程在 raster.run 和地形创建之后才发起岩石生成。
  • “创建 Seed 地形与植被”阶段,主线程等待 rockFormations.prepare 4.1 s 到 5.2 s,没有执行其他工作。
  • 修改方向:plan 就绪时发起岩石生成。岩石生成将和 raster.run(6 s 到 7 s)同时运行。
  • 栅格 Worker 在第 1 次 run 时才创建。plan 在“准备 Seed 场景”阶段结束时已就绪。两者之间有 2 s 到 3 s 的场景和环境工作。
  • 岩石生成之后有 3 个依次执行的步骤:岩石贴图、实体和桥、植被创建。植被创建不需要岩体网格。植被的素材加载能够和岩石生成并行。
  • nativeBuildingHost.prepare 和 water.prepare 不读取对方的结果。加载流程依次等待两者。
  • 规划 Worker 在 openSeedWorldProject 结束后才启动。规划 Worker 不需要引擎,也不需要工程。
B3 岩石生成(成本已验证,方案是候选)
  • 岩石生成使用 1 个 Worker,每次执行 1 个任务。
  • 129 个岩体用时 4.3 s。另有约 80 到 90 个伴生石。
  • 每个岩体先构建约 5000 个三角形,再简化到 1000 个以内。buildRock 用时 5277 ms,simplifyRock 用时 1364 ms。
  • 每块伴生石都是单独生成的网格,约 1000 个三角形。代码审查估计每块用时 43 ms。石头变体只有 4 种。
  • 内存缓存的键由 id、seed、origin、guides 和 settings 组成。内存缓存不持久化。每次加载的 cached 都是 0。
  • 修改方向:
    • 使用 Worker 池。
    • 按到出生点的距离排序。先生成近处的岩石,再生成远处的岩石。
    • 伴生石共享网格。
    • 持久化缓存。
B4 没有跨加载的缓存(已验证)

热加载重新计算以下结果:

结果 用时
规划 3.5 s
栅格 6.1 s
岩石 5.2 s
建筑编译 4.4 s
水体编译 2.3 s
  • 这些结果的输入都由种子和文档决定。
  • 高度图、岩体和建筑编译结果已有内容键或签名。
  • 持久化缓存的键必须包含生成器版本。
B5 主线程在运行时编译 ShaderLab 源码(已验证)

Shader._createFromSource 合计用时 2762 ms。

来源 ms
ShaderLoader 以源码加载 lake.shader、river.shader 和 ocean.shader(每个约 150 KB) 695
水体 Shader 模块(高度场水面和河面) 488
农场地块 Shader 和农场土壤 Shader 385
meshPickShader(引擎创建后立即编译) 274
岩石材质 205
建筑远景视图 138

工程已有 .shaderc 预编译流程。上表的来源没有使用预编译流程。

B6 场景 Shader 预热(数据已验证,原因是候选)
  • 预热编译 106 个变体,用时 832 ms 到 2128 ms。
  • 预热按帧限速:每帧的预算是 6 ms,最多 8 个程序同时编译,每次让出主线程都等待 1 个 requestAnimationFrame。
  • 预热后的第 1 帧仍同步编译和链接 12 个变体。这 1 帧用时 403 ms。其中 getProgramParameter 阻塞 340 ms。
  • 代码审查的结论:预热只遍历 candidate.root 和水体根节点。建筑、风曝光、农场和 SSR 不在遍历范围内。
  • 代码审查的结论:仓库有 1 份 47 KB 的静态变体清单。清单的注释是“在等待 Worker 之前编译”。实际的加载路径没有引用这份清单。
  • 修改方向:
    • 在加载早期,用清单或上次运行的记录做 1 次非严格预热。
    • 把遗漏的根节点加入遍历范围。
B7 建筑准备(成本已验证,原因是候选)
  • 加载流程在第 1 帧之前完整编译全部 20 栋建筑。加载流程没有判断建筑到出生点的距离。出生点视野中的建筑覆盖率是 0。
  • 每栋建筑依次执行 3 步:建筑 Worker 设计,主线程创建远景视图,主线程加载资源。主线程和建筑 Worker 交替等待。
  • “准备原生建筑与水体”阶段,建筑 Worker 活跃 2.6 s,主线程活跃 5.1 s。
  • 建筑 Worker 的结果是 number[] 对象图。结果通过结构化克隆回到主线程。主线程 worker.onmessage 的 self 时间是 438 ms。建筑 Worker 的 reply 用时 574 ms。
  • definition getter 每次调用都执行 structuredClone。get definition 的 self 时间是 239 ms。
  • 代码审查估计:每组建筑约执行 6 次 collectBuildingParts,合计 6 万到 7 万次克隆。
  • 代码审查的结论:Shader 源码的改写按 draw 执行,不按程序执行。约有 200 个 draw。
B8 主线程内联编译河流和湖泊(已验证)
  • water.prepare 用时 2.3 s 到 2.8 s,全部在主线程。其中 compileRiver 用时 1074 ms。
  • 仓库有 HeightfieldWaterCompileWorkerClient 和 RiverCompileWorkerClient。
  • 这条加载路径注册水体后端时没有传入 compile 选项。因此这条加载路径没有使用这 2 个 Worker 客户端。
B9 资源体积和解码(体积已验证)
资源 体积 说明
建筑 .tex(29 个) 传输 32 MB,解码后 151 MB 见 A9
farmlands-bridge-parts.glb 16.9 MB 在第 1 帧之前加载,加载流程等待它完成
农场道具 KTX2(16 个) 15.4 MB 世界发布时全部下载,下载时间和 orb.reveal 重叠
水体 KTX2(16 个) 14.5 MB 见 A5
拍立得 GLB(2 个) 18.1 MB 见 A2
岩石 PNG(2 个) 4.0 MB 代码审查的结论:16 位灰度的位移图被用作基色贴图
枯树法线 PNG 2.9 MB 16 位 RGBA
  • 代码审查的结论(未验证):farmlands-bridge-parts.glb 的 99% 是 6 张内嵌 PNG。网格只有约 4400 个顶点。
  • glTF 贴图用 new Image() 解码。主线程的 setImageSource 用时:glTF 贴图 543 ms,TextureLoader 181 ms。
  • 加载期间的下载总量约 130 MB:GLB 37.8 MB,KTX2 34.4 MB,.tex 32.0 MB,PNG 13.6 MB,其余是模块、JSON、wasm 和 mesh。
B10 等待 IBL(用时已验证,原因未验证)
  • “准备世界画面”阶段用时 1.5 s 到 2.4 s。非调试模式下,这个阶段只等待 waitForEnvironmentIBLIdle()。
  • 这个阶段最长的长任务是 1.3 s 到 2.4 s。
  • 代码审查的结论 1:云缓存每完成 1 次扫描,revision 加 1。IBL 烘焙签名包含这个 revision。因此烘焙器从约 17 s 起持续重新烘焙。waitForEnvironmentIBLIdle() 等待的可能是 1 次例行刷新,不是第 1 次烘焙。
  • 代码审查的结论 2:publish() 中的第 2 次 applyPresentation 可能产生 A→A′→A 的重复烘焙请求。
  • 代码审查的结论 3(没有量化):整个构建期间,世界相机都在不透明的加载球下方渲染。
  • 下一步:记录日志,确认 waitForEnvironmentIBLIdle() 等待的是哪个 revision。
B11 其他
  • KTX2 转码器:加载流程在第 1 次加载 KTX2 时才从 CDN 下载 basis_transcoder.wasm。dev server 上,这个请求用时 852 ms。此前的 14 s 没有预先下载。WebGLEngine.create 没有传入 ktx2Loader。
  • PhysX:生产包从 CDN 下载 PhysX wasm(2.9 MB),用时 584 ms。
  • 打开工程:代码审查的结论是加载流程逐个下载约 273 个文件。冷加载的 openSeedWorldProject 用时 995 ms。真实网络下,用时随请求往返次数增加。
  • orb.reveal:设计时长至少 1.6 s(1 s 展开,0.6 s 收束)。帧时间超过 100 ms 时,动画的实际时长增加。代码审查的结论:动物资源在 orb.reveal 结束后才开始加载。
  • 植物库(未验证):
    • 3 个 LOD 依次加载。
    • 每个条目执行 1 次 setTimeout(0)。代码审查估计约 200 次,浏览器把每次延迟到至少 4 ms。
    • 19 张材质贴图依次 await。
  • 入口模块(未验证):
    • 入口的静态导入图中,约 170 个模块属于聊天、Agent 和编辑器。世界显示之前不使用这些模块。
    • 2 张河流贴图以 base64 字符串打进主包,每张 1.4 MB。

6. 建议的修改顺序

排序标准:测量成本大,并且修改范围小。每项收益都是上限。多项收益有重叠,不能相加。

  1. A2:把 status=ready 移到拍照准备之前。status=ready 最多提前 3.0 s 到 3.5 s。世界显示的时间不变。
  2. A1:缓存场景解析结果。主线程最多减少 2.3 s(冷加载)或 5.7 s(热加载)。
  3. B2:plan 就绪时发起岩石生成。最多减少 4.1 s 到 5.2 s。
  4. B1:对类型化数组计算字节哈希。栅格阶段最多减少 3.4 s,water.prepare 最多减少 1.4 s。修改前必须确认哈希值的兼容性。
  5. A3:把点选预热改成懒加载。所在阶段的 1.3 s 到 2.4 s 将减少一部分,具体数值未测量。
  6. A4:把预热的中心改成出生点。世界显示后约 1.2 s 的主线程工作和 2 s 的岩石 Worker 工作将移到加载期间,或不再需要。
  7. 之后是改动范围较大的项:B4(持久化缓存)、B3(Worker 池)、B7(建筑准备)、A9 和 B9(资源格式)、B5(Shader 预编译)。

每项修改后,用同一个场景脚本测量 1 次冷加载和 1 次热加载。比较以下指标:

  • 加载完成的时间。
  • 长任务的总和,以及最长的长任务。
  • orb.reveal 结束的时间。

7. 修改和复测(A1、A2)

7.1 修改

A1 和 A2 已在本地修改,尚未提交。

项 文件 内容
A1 packages/runtime-editor/src/runtime-editor/scene/runtime-scene-edit.ts 只读查询共用 1 份解析结果。场景文本变化时重新解析。返回值仍是独立副本
A2 world/demos/seed-world/SeedWorldDemo.ts 先执行 tools.show()、loading.hidden = true 和 status = "ready"。之后在后台执行拍照准备

A2 的行为变化:改动前,拍照准备失败时,整个世界加载失败。改动后,世界保持可用,加载流程设置 photoPreparation = "error"。

7.2 测量方法
  • 基线包:不包含 A1、A2 和计时标记。
  • 改动包:包含 A1、A2 和计时标记。
  • 2 个包交替加载。每个包使用单独的浏览器 profile。
  • 每次加载完成后等待 10 s,再关闭页面(--settle 10000)。
  • 测量期间的 load average 是 8 到 14。
7.3 结果

单位是 ms。

指标 基线冷加载 改动后冷加载 基线热加载(2 次) 改动后热加载(2 次)
加载完成 58063 43061 51577、49048 40485、38656
准备 Seed 场景 8807 8107 10712、9806 6234、5730
生成全部房屋与围合构件 7820 5024 23、35 32、19
准备原生建筑与水体 7713 6277 7333、7607 7295、7758
预编译场景渲染变体 2166 1066 1916、1620 1360、1096
“已就绪”到 status=ready 9476 2393 8532、7525 1770、2336
拍照准备用时 7551 2132 6637、5371 3982、1937
  • 冷加载:加载完成的时间从 58.1 s 减少到 43.1 s。
  • 热加载:加载完成的时间从 51.6 s 和 49.0 s 减少到 40.5 s 和 38.7 s。
  • “已就绪”到 status=ready 减少 5.2 s 到 7.1 s。这是 A2 的效果。
  • “已就绪”之前的阶段合计:冷加载减少 7.9 s,热加载减少 4.3 s 到 5.2 s。这个数字大于 A1 的预估上限(冷加载 2.3 s)。原因尚未确定。
  • 6 次加载的页面错误数都是 0。
  • 后台的拍照准备在 3 次改动包加载中都已完成,photoPreparation 是 ready。
7.4 限制
  • 冷加载只有 1 组对比。热加载有 2 组对比。
  • 2 个包的构建时间相差约 2 分钟。构建期间,工作区有其他未提交的 packages/building 改动。2 个包可能包含不同版本的这些文件。
  • 长任务总和不能直接比较。测量脚本在加载完成时采集长任务。基线包的拍照准备在加载完成之前,改动包的拍照准备在加载完成之后。
  • 另有 1 轮对比在 load average 19 到 53 下进行,没有等待 10 s。那一轮的总时长不用于结论。
  • 没有检查拍照功能本身。没有自动化测试覆盖 A2。
Lingua principale
TypeScript
Stelle
5.9k
Fork
413
Merge medio
16h 17m
PR unite (30g)
41

Preparare l'ambiente

  • Nessun Dockerfile né file Docker Compose
  • Ha un modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di galacean/engine

Tutte le issue di galacean/engine

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.