Seed World 加载耗时分析:冷加载 59.8 s,主线程活跃 34.5 s
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
- Ambito
- frontend, performance
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
- 被测代码:
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。
- 每次页面加载,主线程都重新计算云天气图:
worley2D220 ms,stableHash114 ms,modulo82 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.prepare4.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。 definitiongetter 每次调用都执行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,TextureLoader181 ms。 - 加载期间的下载总量约 130 MB:GLB 37.8 MB,KTX2 34.4 MB,
.tex32.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. 建议的修改顺序
排序标准:测量成本大,并且修改范围小。每项收益都是上限。多项收益有重叠,不能相加。
- A2:把
status=ready移到拍照准备之前。status=ready最多提前 3.0 s 到 3.5 s。世界显示的时间不变。 - A1:缓存场景解析结果。主线程最多减少 2.3 s(冷加载)或 5.7 s(热加载)。
- B2:plan 就绪时发起岩石生成。最多减少 4.1 s 到 5.2 s。
- B1:对类型化数组计算字节哈希。栅格阶段最多减少 3.4 s,
water.prepare最多减少 1.4 s。修改前必须确认哈希值的兼容性。 - A3:把点选预热改成懒加载。所在阶段的 1.3 s 到 2.4 s 将减少一部分,具体数值未测量。
- A4:把预热的中心改成出生点。世界显示后约 1.2 s 的主线程工作和 2 s 的岩石 Worker 工作将移到加载期间,或不再需要。
- 之后是改动范围较大的项: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
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di galacean/engine
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 64/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 4/5 3-5 giorni Idoneità per principianti 52/100
I maintainer di solito rispondono entro 1 giorno
-
RFC: Adopt Unity-style Collider components and hierarchical Rigidbody ownershipForse già presa Una pull request collegata a questa issue è aperta o già unita. Aperta
Difficoltà 5/5 Più di una settimana Idoneità per principianti 20/100
I maintainer di solito rispondono entro 1 giorno
-
SkinnedMeshRenderer should derive default rootBone-space localBounds from mesh and skinForse già presa Una pull request collegata a questa issue è aperta o già unita. Apertaenhancement
Difficoltà 4/5 3-5 giorni Idoneità per principianti 42/100
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di galacean/engine
Issue simili
-
bug impact:low Team: SecuritySolution Team:Defend Workflows v9.6.0
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
elastic/kibana#306401 · 3 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
agentes-chat/agentes-chat#927 ·
I maintainer di solito rispondono entro 1 giorno
-
[Bug]: Webapp workspace fails to render in Safari — "Can't find variable: requestIdleCallback"Apertacomp/desktop P2 type/bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
NousResearch/hermes-agent#157702 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
I maintainer di solito rispondono entro 1 giorno
-
e2e-failure ready-to-code
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 72/100
redhat-developer/rhdh-plugin-export-overlays#4794 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno