# S-40 · 资源生命周期实测（dispose 全链路）

- 生成时间：2026/10/27 22:57:34（北京时间）
- 运行时：Node v24.15.0
- 城市模块库打包 sha256：c82157856bfad16499644ae08f9742c7fc235ff07e89c33c802face4fa933c9f
- 场景：full85 / hallTier=4 / style=B / traffic=2 / ped=2 / seed=42

## 生命周期与所有权（结论）

| 资源 | 谁拥有 | `city.dispose()` | `disposeCityMaterials()` |
|---|---|---|---|
| 合并楼体几何（solid/glow/water） | 城市实例 | 释放 | — |
| 道具/车/人 InstancedMesh 几何 | 城市实例 | 释放 | — |
| 点击代理几何（1 个共享 unitBox 的克隆）× N | 城市实例 | 释放 | — |
| 点击代理材质（每实例 1 个，invisible） | 城市实例 | 释放 | — |
| 共享材质 `flat/lit/glow/water` | **进程（模块单例）** | **不释放（多城共享）** | 释放 4 个 + 清缓存 |
| 天空穹顶（若宿主调用 createSkyDome） | 宿主 | —（宿主自己 dispose） | — |

> 结论：**完整结束路径 = 每个实例 `city.dispose()` + 应用收尾时 `disposeCityMaterials()`**。
> 前者清实例独占资源（root 归零），后者清进程级共享材质；两者都幂等、可重复 build。
> Node 中无法直接观测 GPU 显存：本证据只能证明「CPU 侧对象与 dispose 事件」，
> GPU 侧释放依赖 three 在 renderer 上下文里响应 dispose 事件（生产代码已按此约定实现）。

## 实测读数

| 阶段 | 几何 | 材质 | 网格 | 实例 | dispose 事件（几何/材质） | 共享材质缓存 |
|---|---:|---:|---:|---:|---|---:|
| build 后（实例 1） | 11 | 4 | 10 | 335 | 构建期 5962/0 | 4 |
| 再 build 第二座城 | 11 | 4 | 10 | 335 | — | 4 |
| city.dispose() 后 | 0 | 0 | 0 | 0 | 11/1 | 4 |
| 重复 dispose() | — | — | — | — | 0/0 | 4 |
| disposeCityMaterials() | — | — | — | — | 0/4 | 0 |
| 释放后重建（新对象组=true） | 11 | 4 | 10 | 335 | — | 4 |
| 二次 disposeCityMaterials() | — | — | — | — | 0/0 | 0 |

### 3 轮 build→dispose（无累积迹象）

| 轮 | 构建几何 | 构建材质 | 构建网格 | dispose 几何事件 | dispose 材质事件 | 共享材质 | dispose 后 root 几何 |
|---|---:|---:|---:|---:|---:|---:|---:|
| 1 | 11 | 4 | 10 | 5973 | 1 | 4 | 0 |
| 2 | 11 | 4 | 10 | 5973 | 1 | 4 | 0 |
| 3 | 11 | 4 | 10 | 5973 | 1 | 4 | 0 |

> 每轮 dispose 材质事件 = 1（点击代理材质），共享材质 0 —— 与上表一致，说明**实例级清理不误释放共享资源**。

## 断言

| 断言 | 结果 | 实测 |
|---|---|---|
| 构建期间不释放材质（材质 dispose = 0） | ✅ | 材质 0；几何中间件 dispose=5962（合并后释放临时几何，属正常清理） |
| 构建期间会有中间几何清理（>0，说明不攒垃圾） | ✅ | 5962 个中间几何 dispose |
| 共享材质对象跨两次构建保持同一组（真共享） | ✅ | 同一组 4 对象 |
| 多实例构建后共享材质仍 4 个 | ✅ | 4 |
| 实例 dispose 后 root 资源归零 | ✅ | {"geometries":0,"materials":0,"meshes":0,"instances":0,"triangles":0,"drawCalls":0} |
| 实例 dispose 释放了本实例几何（>0） | ✅ | 11 个几何 dispose |
| 实例 dispose 只释放点击代理材质（1 个），不碰共享材质 | ✅ | 1 个材质 dispose（代理 hitMat） |
| 共享材质 dispose 事件在 city.dispose 时为 0 | ✅ | 0 |
| 共享材质缓存数量不变（4） | ✅ | 4 |
| 重复 dispose 幂等（不再释放） | ✅ | geo=0 mat=0 |
| dest city 释放后另一实例几何仍有效（未被误释放） | ✅ | 第二城几何=11 |
| disposeCityMaterials 释放 4 个共享材质 | ✅ | matDispose=4 事件=4 |
| 释放后缓存已空（二次释放 0 事件即证；getCityMaterialList 会懒建故不作空判据） | ✅ | 二次 disposeCityMaterials 事件=0 |
| 释放后可重建（懒建 4 个**新**材质 + 几何正常） | ✅ | mats=4 新对象=true geo=11 |
| 3 轮 build→dispose：每轮释放量一致 & 共享材质不增长 | ✅ | geo5973/shared4 geo5973/shared4 geo5973/shared4 |
| 3 轮后 root 资源均为 0 | ✅ | 0/0/0 |
| 收尾二次释放幂等（0 事件） | ✅ | 0 |

**总结论：dispose 全链路符合设计（实例级清理 + 进程级释放 + 幂等 + 可重建 + 无累积）**
