# S-40 城市模块库 · 性能表（C4）

- **本表 / 本次截图所用 HTML**：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm044-city/tools/city-demo/dist/city-demo.html`
- **HTML sha256**：`22b148daf7fcc7bb5e84034f2a9a52568ab7b7836f2b3b639698c7edfd30884b`
- **shot.mjs sha256（取证脚本）**：`a7fee7a5dba7a38046f280cbb568c71859d29af2231b4033303c06f51e8d9654`
- 生成时间：2026/10/27 21:38:12（北京时间）
- 视口：1440×900（DPR 1），Chromium headless + **swiftshader CPU 软渲染**
- 地块规划：`planBlocks(BLOCK_PRESETS.full85)` = **85 块 / 69 单元 / 0 占位**，hallTier=4，seed=42
- 页面：`file://` 单文件离线 HTML（0 外链）

## 口径声明（三套数字**不互相冒充**）

| 口径 | 数据源 | 含义 | 何时刷新 |
| --- | --- | --- | --- |
| **(a) 构建快照** | `city.stats` | 模块库自报 triangles / drawCalls / materials / meshes / instances / buildMs / units / placeholders | **只在 `buildCity()` 时定格**；`setTraffic/setPed/setNight` 后**不刷新** |
| **(b) 实时实例数** | `city.density` + **场景图遍历 `InstancedMesh.count` 求和** | 车 / 人 / 道具实际实例数 | `setTraffic/setPed` 后立刻生效；场景图求和是独立实测 |
| **(c) 整帧 renderer** | `renderer.info.render` | 真正提交的 draw call / triangles（含阴影 pass 与 demo 自建岛/水/天） | 每帧刷新 |

> 表里凡「实例数」列一律标来源：**快照**=`city.stats.instances`；**实测**=`city.density` 或场景图 `InstancedMesh.count` 求和。
> **改档后一律用 `city.density` + 场景图遍历**，不用 `city.stats`。

## (a) 构建快照 `city.stats`（A/B/C × 车人档）

| 画风 | 车/人档 | triangles（模块库） | drawCalls（模块库） | materials | meshes | instances（快照） | units | placeholders | buildMs | 重建总耗时 ms |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| A-清爽卡通 | 车0/人0 | 84,500 | 7 | 3 | 7 | 245 | 69 | 0 | 118.9 | 118.9 |
| A-清爽卡通 | 车1/人1 | 86,744 | 10 | 3 | 10 | 287 | 69 | 0 | 117.9 | 118 |
| A-清爽卡通 | 车2/人2 | 89,336 | 10 | 3 | 10 | 335 | 69 | 0 | 123.4 | 123.4 |
| B-细节派 | 车0/人0 | 84,500 | 7 | 3 | 7 | 245 | 69 | 0 | 121.8 | 121.9 |
| B-细节派 | 车1/人1 | 86,744 | 10 | 3 | 10 | 287 | 69 | 0 | 124 | 124 |
| B-细节派 | 车2/人2 | 89,336 | 10 | 3 | 10 | 335 | 69 | 0 | 130.2 | 130.2 |
| C-霓虹夜景 | 车0/人0 | 84,500 | 7 | 3 | 7 | 245 | 69 | 0 | 149.4 | 149.5 |
| C-霓虹夜景 | 车1/人1 | 86,744 | 10 | 3 | 10 | 287 | 69 | 0 | 123.4 | 123.4 |
| C-霓虹夜景 | 车2/人2 | 89,336 | 10 | 3 | 10 | 335 | 69 | 0 | 108.4 | 108.4 |

峰值：**triangles 89,336**（预算 150,000）／**draw call 10**（预算 70）／**材质 3**（预算 12） ⇒ **全部达标**

> `city.stats.triangles` 是构建快照；本表每格都 `rebuild()`，三档数字不同是因为车/人几何也进合并网格。
> `instances` 是构建时点值（车+人+道具），改档后不刷新，实时值见 (b)。

## (b) 实时实例数（`city.density` + 场景图 `InstancedMesh.count` 实测）

| 画风 | 改动档 | density 档位 | density 实测 | 场景图实例合计（实测） | triangles（快照） | 整帧 draw call | FPS 采样 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| A-清爽卡通 | 车流 关 | traffic=0 / ped=1 | 车 0 · 人 28 · 道具 245 | 273 | 86,744（快照，改档不变） | 21 | 8.4 |
| A-清爽卡通 | 车流 低 | traffic=1 / ped=1 | 车 14 · 人 28 · 道具 245 | 287 | 86,744（快照，改档不变） | 25 | 11.6 |
| A-清爽卡通 | 车流 高 | traffic=2 / ped=1 | 车 30 · 人 28 · 道具 245 | 303 | 86,744（快照，改档不变） | 25 | 11.2 |
| A-清爽卡通 | 行人 关 | traffic=1 / ped=0 | 车 14 · 人 0 · 道具 245 | 259 | 86,744（快照，改档不变） | 23 | 9.3 |
| A-清爽卡通 | 行人 低 | traffic=1 / ped=1 | 车 14 · 人 28 · 道具 245 | 287 | 86,744（快照，改档不变） | 25 | 10.9 |
| A-清爽卡通 | 行人 高 | traffic=1 / ped=2 | 车 14 · 人 60 · 道具 245 | 319 | 86,744（快照，改档不变） | 25 | 11.4 |
| B-细节派 | 车流 关 | traffic=0 / ped=1 | 车 0 · 人 28 · 道具 245 | 273 | 86,744（快照，改档不变） | 21 | 9.2 |
| B-细节派 | 车流 低 | traffic=1 / ped=1 | 车 14 · 人 28 · 道具 245 | 287 | 86,744（快照，改档不变） | 25 | 8.8 |
| B-细节派 | 车流 高 | traffic=2 / ped=1 | 车 30 · 人 28 · 道具 245 | 303 | 86,744（快照，改档不变） | 25 | 9.2 |
| B-细节派 | 行人 关 | traffic=1 / ped=0 | 车 14 · 人 0 · 道具 245 | 259 | 86,744（快照，改档不变） | 23 | 10.9 |
| B-细节派 | 行人 低 | traffic=1 / ped=1 | 车 14 · 人 28 · 道具 245 | 287 | 86,744（快照，改档不变） | 25 | 9.1 |
| B-细节派 | 行人 高 | traffic=1 / ped=2 | 车 14 · 人 60 · 道具 245 | 319 | 86,744（快照，改档不变） | 25 | 9.3 |
| C-霓虹夜景 | 车流 关 | traffic=0 / ped=1 | 车 0 · 人 28 · 道具 245 | 273 | 86,744（快照，改档不变） | 21 | 8 |
| C-霓虹夜景 | 车流 低 | traffic=1 / ped=1 | 车 14 · 人 28 · 道具 245 | 287 | 86,744（快照，改档不变） | 25 | 7.8 |
| C-霓虹夜景 | 车流 高 | traffic=2 / ped=1 | 车 30 · 人 28 · 道具 245 | 303 | 86,744（快照，改档不变） | 25 | 10.7 |
| C-霓虹夜景 | 行人 关 | traffic=1 / ped=0 | 车 14 · 人 0 · 道具 245 | 259 | 86,744（快照，改档不变） | 23 | 11 |
| C-霓虹夜景 | 行人 低 | traffic=1 / ped=1 | 车 14 · 人 28 · 道具 245 | 287 | 86,744（快照，改档不变） | 25 | 9.4 |
| C-霓虹夜景 | 行人 高 | traffic=1 / ped=2 | 车 14 · 人 60 · 道具 245 | 319 | 86,744（快照，改档不变） | 25 | 10.5 |

> 场景图实测 = 遍历 `city.root` 下所有 `InstancedMesh` 累加 `.count`（车 sedan/van + 行人 + 树/灯/长椅/花坛）。
> 期望：车 0/14/30、人 0/28/60、道具 245 ⇒ 实例合计 245 / 287 / 335。

## (c) 整帧 `renderer.info`（A/B/C × 车人档）+ 阴影 pass 拆解

| 画风 | 车/人档 | 整帧 draw call | 其中阴影 pass | 主 pass（关阴影实测） | 整帧 triangles | 主 pass triangles | 纹理数 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| A-清爽卡通 | 车0/人0 | 19 | +7 | 12 | 149,482 | 85,862 | 2 |
| A-清爽卡通 | 车1/人1 | 25 | +10 | 15 | 153,970 | 88,106 | 2 |
| A-清爽卡通 | 车2/人2 | 25 | +10 | 15 | 159,154 | 90,698 | 2 |
| B-细节派 | 车0/人0 | 19 | +7 | 12 | 149,482 | 85,862 | 2 |
| B-细节派 | 车1/人1 | 25 | +10 | 15 | 153,970 | 88,106 | 2 |
| B-细节派 | 车2/人2 | 25 | +10 | 15 | 159,154 | 90,698 | 2 |
| C-霓虹夜景 | 车0/人0 | 19 | +7 | 12 | 149,482 | 85,862 | 2 |
| C-霓虹夜景 | 车1/人1 | 25 | +10 | 15 | 153,970 | 88,106 | 2 |
| C-霓虹夜景 | 车2/人2 | 25 | +10 | 15 | 159,154 | 90,698 | 2 |

峰值整帧 draw call **25**、整帧 triangles **159,154**（含阴影 pass + demo 自建岛/沙/浅水/深水/天）。

### (c-2) 整帧 draw call 拆解（B · 车低人低，场景图按来源计数）

| 来源 | 数量 | 说明 |
| --- | --- | --- |
| 城市 solid | 1 | 85 块楼体/道路/铺装合并网格 |
| 城市 glow | 1 | 自发光/霓虹合并网格 |
| 城市 water | 1 | 喷泉/运河水面 |
| 道具 | 4 | 树/路灯/长椅/花坛 InstancedMesh |
| 车流 | 2 | sedan + van 两个 InstancedMesh |
| 行人 | 1 | 行人 InstancedMesh |
| demo 岛体 | 2 | 草地台面 + 沙滩 + 岩壁（demo 自建） |
| demo 水 | 2 | 浅水环 + 深水大平面（demo 自建） |
| demo 天空 | 1 | 天空穹顶（demo 自建） |
| 其它 | 0 | 阶梯模式基座地板等 |
| **主 pass 合计** | 15 | = 关阴影实测 draw call |
| **阴影 pass** | +10 | = 投影网格再画一遍 |

> `renderer.info.render.triangles` 含阴影 pass，约为模块库 triangles 的 2 倍左右，属正常。
> 模块库自报 drawCalls=7~10、整帧 22~30，差额 = 阴影 pass + demo 岛/水/天 4~5 个 draw。

## (d) FPS（swiftshader **CPU 软渲染**，只做相对比较）

| 维度 | 取值 | FPS 采样（3 s） |
| --- | --- | --- |
| 画风 | A-清爽卡通 | 10 |
| 画风 | B-细节派 | 10 |
| 画风 | C-霓虹夜景 | 10.6 |
| 车流 | 关 | 10.3 |
| 车流 | 低 | 9.2 |
| 车流 | 高 | 10.2 |
| 行人 | 关 | 9.8 |
| 行人 | 低 | 10.4 |
| 行人 | 高 | 10.3 |

> **口径**：无 GPU（`--use-angle=swiftshader`），FPS 是 CPU 光栅化吞吐，**绝对值无意义**。
> 只用于三画风之间、车人三档之间的**相对比较**；有 GPU 的真机显著更高。同一档两次采样 ±2 fps 属噪声。

## (e) 贴图 / 外链 / 报错（按来源分列）

### (e-1) 四道预算门槛

| 门槛 | 实测峰值 | 预算 | 判定 |
| --- | --- | --- | --- |
| 三角形 triangles（`city.stats`） | 89,336 | 150,000 | PASS |
| draw call（`city.stats.drawCalls`） | 10 | 70 | PASS |
| 材质 materials | 3 | 12 | PASS |
| 构建 buildMs（`city.stats.buildMs`） | 177.8 ms | 300 ms | PASS |

### (e-2) 贴图

| 项目 | 读数 | 说明 |
| --- | --- | --- |
| 城市模块贴图 | **0** | 模块库纯程序化几何、无贴图（`test/city-contract.test.mjs` 静态扫描断言） |
| demo 自身贴图（CanvasTexture） | 6 | 阶梯模式 T0..T4 标注芯片（每张阶梯图 5 个芯片） |
| `renderer.info.memory.textures` | 2 | 整帧纹理数（含 demo 芯片；城市部分 0） |

### (e-3) 请求与报错（**新采集器**，2026-10-27 复核后补全）

| 来源（采集器） | 真实页读数 | 目标 | 说明 |
| --- | --- | --- | --- |
| 外网请求 `page.on('request')` 全量 | 0 | 0 | 含成功 200；排除 file:/data:/about:/blob:/chrome-extension: |
| 请求失败 / HTTP>=400 `requestfailed`+`response` | 0 | 0 | 404 / 加载失败 |
| 未捕获 JS 异常 `page.on('pageerror')` | 0 | 0 | 独立于 console |
| `console.error`（`window.__errors` 聚合，demo 39–46 行） | 0 | 0 | 按来源聚合，语义成立 |
| 页内 `__errors` 合计（含 error 事件/console.error） | 0 | 0 | 页面自报聚合 |

### (e-4) 采集器校准页（自检，非真实页）

| 探针 | 实测 | 期望 | 判定 |
| --- | --- | --- | --- |
| 本地 mock 200 外网请求 | external=1 / mockHits=1 / 200 S40_LOCAL_MOCK | ≥1 且 200/S40_LOCAL_MOCK | PASS |
| console.error 探针 | 1 | ≥1 | PASS |
| pageerror 探针 | 1 | ≥1 | PASS |
| `__errors` 聚合含探针 | 含 | 含 | PASS |

> **旧采集器漏报证明**（复核方实跑）：`tasks-out/S-40/续接调度/外网请求漏报失败证明.log` —— mock 200 请求 observedRequests=1，旧采集器 oldCollector=[]（漏报），新采集器本表 external=1。
> 真实页与新采集器读数：外网请求 0 / pageerror 0 / console.error 0 / 请求失败 0。


## 结论（C4）

1. **装配闭环**：`buildCity` 单次返回 85 块 / 69 单元 / 0 占位，A/B/C × 车人三档全部可用；
2. **预算**：triangles 峰值 89,336 ≤ 150,000、draw call 峰值 10 ≤ 70、材质 3 ≤ 12 ⇒ 全部达标；
3. **三口径分离**：构建快照 / 实时 density+场景图 / 整帧 renderer 三列互不混用；
4. **零外链零报错**（真实页，新采集器）：外网请求=0、pageerror=0、console.error=0、请求失败=0；
5. **截图**：30 张，全部来自同一 HTML sha256 `22b148daf7fcc7bb…` + shot.mjs sha256 `a7fee7a5dba7a380…`（逐张 sha 见 `C4/metrics.json`）；
6. **采集器自检**：校准页 mock 200 外网请求 / console.error / pageerror 三探针全部 PASS（见 (e-4) 与 `C4/取证监听器校准.md`）。
