# S-28 · P2「渲染预算与微信复刻」审计报告

> 审计对象：`frontend-rebuild-hm040-city`（S-26 城市 demo 二轮工作树）
> 审计人：P2（审计工程师）· 审计时点：**2026-10-23 01:02–01:14（北京时间）**
> 结论口径：**默认低档（车 12 / 行人 24）+ 高档峰值（车 30 / 行人 60）**（按 Lead 2026-10-23 推进的档位定义）
> 四份机器可读证据（报告里所有数字都出自这几个 JSON，可重跑）：
> - `/tmp/s28/P2-budget.json` —— node 侧真实构建后读模块 `.stats` / `mesh.material` 对象身份 / `geometry.attributes` / 贴图字段（脚本 `/tmp/s28/P2-budget.mjs`）
> - `/tmp/s28/P2-render.json` —— 真实 Chromium（SwiftShader 软渲染）打开单文件 demo 后读 `window.__city.stats()`（= `renderer.info`），逐风格 × 逐档位（脚本 `/tmp/s28/P2-render.mjs`）
> - `/tmp/s28/P2-probe.json` —— 真实 WebGL2 上下文探针：`renderer.info.memory.textures/geometries/programs`、WebGL 能力、切档泄漏检查（脚本 `/tmp/s28/P2-probe.mjs` + 入口 `/tmp/s28/P2-probe-entry.ts`）
> - `/tmp/s28/P2-default.json` —— 真实**默认开局**（无 URL 参数）读数：B 风格 / 日间 / 低档 12 车 24 人 / **52,076 tri / 18 call / 可见材质 4**
>
> **审计快照（防止工作树漂移）**：几何/材质源文件 sha256 记录在 `P2-budget.json → sourceSha256`。
> 本报告数字对应的关键文件：`island.ts d1620065…`、`materials.ts 07594744…`、`props.ts cffd7c30…`、`style-a/b/c 9303586e…/9b2e1b4d…/924dc991…`、`layout.ts 4b961fd4…`、`traffic.ts 18855822…`（**S-26 旧版，P1 尚未交付新档位逻辑**）。
> 审计期间 `contract.ts / main.ts / hud.ts / tools/build-city-demo.mjs` 被 Lead 持续更新（最新值见文末「复现」一节），这几支不在我的写域，也不改变几何预算。

---

## 0. 结论速览

| # | 机主硬约束 | 判定 | 一句话证据 |
|---|---|---|---|
| 1 | 纯程序化几何、**零贴图** | **PASS** | 场景侧 `Texture` 引用 **0**；`renderer.info.memory.textures = 2` 且**全部来自阴影 RT**（关阴影 = **0**）；源码 grep 禁用 API **0 命中** |
| 2 | 每模块材质数 ≤3 且**共享材质** | **PASS** | 9 个模块全部 ≤2 个材质对象，全部 `=== materials.flat/glow/water` 或天空 ShaderMaterial；单帧可见材质 **4**，全场景创建 **5**（其中 `lit` 未被任何 mesh 使用，见 §9 建议） |
| 3 | 车/行人**必须 InstancedMesh** | **PASS** | 6 个 InstancedMesh（3 车型 + 3 行人类型），容量 10/10/10 + 20/20/20 = 90 实例槽位；实例矩阵 `DynamicDrawUsage`，每帧 `setMatrixAt`，`instanceColor` 初始化写一次 |
| 4 | **draw call ≤70、三角 ≤150k** | **PASS** | 默认低档 B：**18 call / 52,076 tri**（预算占比 26% / 35%）；高档峰值 B：**18 call / 63,884 tri**（26% / 43%）；纯几何口径 13 call / 30,096 tri |
| 5 | 单文件 demo 构建方式不变、零外链 | **PASS** | `esbuild → iife → 内联` 照旧；构建脚本自检「0 处外部资源引用」；浏览器实测 **console 报错 0、网络请求 0**（file/data 之外 0） |
| 6 | 微信小游戏 API 兼容性 | **条件 PASS（2 项需真机 verify）** | 用到的能力全部有对应实现；**P0 风险 1 项**：three@0.186.1 自 r163 起**硬性要求 WebGL2**（已核实 r186.1 源码直接 throw），小游戏必须能给出 `webgl2` 上下文；P1 风险 `onBeforeCompile` 字符串匹配（已在 r186.1 核实存在，但属版本耦合） |
| 7 | 内存 / 构建 | **PASS** | 三风格全建：几何对象 **21**、顶点 **191,787**、实例槽位 **90**、几何显存估算 **≈6.7 MiB**、构建耗时 **88 ms**；切档反复横跳 `geometries/textures/programs/材质数` **零增长**（无泄漏） |
| 8 | 预算对照表 | **PASS** | 见 §8（S-26 实测 vs 本审计 vs 预算 vs 余量；发现并修正 S-26 表里「车人 984」这条错误数字） |

**总判定：8 条硬约束 **8 PASS（其中第 6 条附 2 项真机复核项）**；本轮**无需修复**（理由见 §10），只提 4 条可选优化。

---

## 1. 材料与数据来源（可复现）

| 证据 | 生成方式 | 关键内容 |
|---|---|---|
| `P2-budget.json` | `node /tmp/s28/P2-budget.mjs` | esbuild 把 `src/render/city/*.ts` + three 打成 ESM，node 里真实 `buildIsland / buildTowers(A/B/C) / buildProps(A/B/C) / buildTraffic`，读 `.stats`、材质对象身份、几何属性、贴图字段、逐风格×逐档位预算、构建耗时 |
| `P2-render.json` | `node /tmp/s28/P2-render.mjs /tmp/s28/P2-demo.html` | 真实 Chromium（`--use-angle=swiftshader`）打开单文件 demo，`window.__city.setStyle/setDensity/setCars/setPeds` 后读 `renderer.info`（= S-26/HUD 同口径），并记录非 file/data 网络请求数 |
| `P2-probe.json` | `node /tmp/s28/P2-probe.mjs` | 自建最小 `main.ts` 等价页（1440×900，PCFShadowMap 2048，ACES=NoToneMapping），读 `info.memory.textures/geometries/programs`、`capabilities.isWebGL2`、切档泄漏序列、JS heap |
| `P2-default.json` | `node /tmp/s28/P2-default-check.mjs` | 真实 demo **无参数开局**读数：B / 日 / 低档 12 车 24 人 / 52,076 / 18 / 材质 4（夜间同画面 52,076 / 18 / 4，切换昼夜不改变量） |
| 单文件构建 | `node tools/build-city-demo.mjs --out /tmp/s28/P2-demo.html` | `620,941 B (606.4 KiB)` / gzip `166,144 B (162.3 KiB)` / sha256 `b3ad1e92…` / 零外链 |

**交叉验证强度**：`P2-budget.json` 的解析式预算（几何 + 阴影 pass）与 `P2-render.json` 的真实 `renderer.info` **在 12 个组合上逐位相等**（A/B/C × low/base/high，以及 S-26 基线 18/36 的 45,516 / 56,012 / 43,604），说明"预算模型 = 真实渲染器口径"，后面的所有预算判断都成立。

---

## 2. 表①·模块 × 几何三角形 / 网格数（纯几何口径）

来源：`P2-budget.json → measured`（三风格全部建好后的静态几何；与风格可见性无关）

| 模块 | mesh 数 | 三角 A | 三角 B | 三角 C | 说明 |
|---|---|---|---|---|---|
| 六边形岛（terrain + water） | 2 | 1,256 | 1,256 | 1,256 | terrain 1,254 + 水面 2；岛三风格共用 |
| 天空穹顶 | 1 | 720 | 720 | 720 | SphereGeometry 24×16，ShaderMaterial |
| 塔楼（opaque + glow） | 2 | 7,956 | 11,204 | 8,200 | 拆分：A 2,744+5,212 / B 9,992+1,212 / C 588+7,612 |
| 街道道具（opaque + glow） | 2 | 11,396 | 11,396 | 11,396 | 拆分：opaque 9,636 + glow 1,760；三风格同布局同三角，只换色 |
| 车 + 行人（6 个 InstancedMesh） | 6 | 5,520 | 5,520 | 5,520 | **默认低档 12 车 / 24 人**（车 2,352 + 人 3,168） |
| **单帧可见合计（默认低档）** | **13** | **26,848** | **30,096** | **27,092** | = 上面 5 行相加 |
| 车 + 行人（S-26 基线 18/36） | 6 | 8,280 | 8,280 | 8,280 | 每实例：sedan 180 / van 180 / bus 228；chubby 124 / tall 120 / kid 152 |
| 车 + 行人（高档 30/60） | 6 | 13,800 | 13,800 | 13,800 | 车 5,880 + 人 7,920 |

> 塔楼/道具的 `glow` 网格**不投影**（`castShadow=false`），所以三风格的「发光占比」差异（C 几乎全是 glow）会直接反映在阴影 pass 成本上：C 的阴影最便宜（见 §3）。

---

## 3. 表②·draw call / 三角形预算（含阴影 pass = `renderer.info` 口径）

**预算公式**（与 three 渲染流程一致，已被真实渲染器逐位验证）：
`renderer.info.calls = 可见 mesh 数（主 pass） + 可见且 castShadow 的 mesh 数（1 个方向光 → 1 次阴影 pass）`
`renderer.info.triangles = 主 pass 几何三角 + 阴影 pass 重复提交的三角`

阴影 pass 的 5 个 caster：`towers.<X>.opaque`、`props.<X>.opaque`、`car.sedan`、`car.van`、`car.bus`（岛 terrain=不投影、水面/天空/glow/行人都不投影，这是 S-26 刻意的省法，正确）。

| 风格 | 档位（车/人） | 主 pass call | 主 pass 三角 | 阴影 call | 阴影三角 | **总 call** | **总三角** |
|---|---|---|---|---|---|---|---|
| A | **低 12/24（默认）** | 13 | 26,848 | 5 | 14,732 | **18** | **41,580** |
| A | 关 0/0 | 7 | 21,328 | 2 | 12,380 | **9** | **33,708** |
| A | 基线 18/36 | 13 | 29,608 | 5 | 15,908 | **18** | **45,516** |
| A | 高 30/60 | 13 | 35,128 | 5 | 18,260 | **18** | **53,388** |
| B | **低 12/24（默认）** | 13 | 30,096 | 5 | 21,980 | **18** | **52,076** |
| B | 关 0/0 | 7 | 24,576 | 2 | 19,628 | **9** | **44,204** |
| B | 基线 18/36 | 13 | 32,856 | 5 | 23,156 | **18** | **56,012** |
| B | 高 30/60 | 13 | 38,376 | 5 | 25,508 | **18** | **63,884**（峰值） |
| C | **低 12/24（默认）** | 13 | 27,092 | 5 | 12,576 | **18** | **39,668** |
| C | 关 0/0 | 7 | 21,572 | 2 | 10,224 | **9** | **31,796** |
| C | 基线 18/36 | 13 | 29,852 | 5 | 13,752 | **18** | **43,604** |
| C | 高 30/60 | 13 | 35,372 | 5 | 16,104 | **18** | **51,476** |

- **预算**：draw call ≤70、三角形 ≤150,000（均含阴影 pass）。
- **默认低档（B）**：18 / 52,076 → 用量 **26% / 35%**，余量 **52 call / 97,924 tri**。
  （真实浏览器**无参数开局**实测：`style=B / day / cars=12 / peds=24 / gear=low-low / triangles=52,076 / calls=18 / materials=4`，与上表逐位一致，见 `P2-default.json`）
- **高档峰值（B）**：18 / 63,884 → 用量 **26% / 43%**，余量 **52 call / 86,116 tri**。
- **关档（计划语义：0/0 + 车人组隐藏）**：车人贡献 **0 call / 0 tri**；整帧仍剩 **9 call / 44,204 tri**（岛 2 + 天空 1 + 塔楼 2 + 道具 2 + 塔/道具仅 opaque 投影 2）。
  ⚠️ **当前工作树 `traffic.ts` 还是 S-26 旧版**（`CARS_MIN=10 / PEDS_MIN=10`，`setDensity(0,0)` 会被夹到 10/10，且不会隐藏组）→ 浏览器实测「关档」实际是 18 call / 10 车 10 人 / B 49,404 tri。**P1 交付后必须复测**（本报告按计划语义给数，已在 §7 标注）。
- **低档比 S-26 基线更省**：默认低档 B 52,076 vs 基线 56,012（−3,936，−7%）；draw call 不变（18）。

---

## 4. 表③·模块 × 材质对象数 / 共享（对象身份）

判定依据：对每个 mesh 读 `mesh.material`，与 `getCityMaterials()` 返回的 4 个对象 + 天空材质做**引用相等**比较（`P2-budget.json → perModuleMaterials`）。

| 模块 | mesh 数 | 材质对象数 | 用到的材质（对象身份） | 全部共享？ |
|---|---|---|---|---|
| 岛 terrain+water | 2 | 2 | `materials.flat`（terrain）、`materials.water`（水面） | ✅ |
| 天空 | 1 | 1 | `sky.ShaderMaterial`（本模块唯一实例，非共享也满足"≤3"） | ✅（单例） |
| 塔楼 A / B / C | 各 2 | 各 2 | `materials.flat` + `materials.glow` | ✅ |
| 道具 A / B / C | 各 2 | 各 2 | `materials.flat` + `materials.glow` | ✅ |
| 车 + 行人 | 6 | **1** | `materials.flat`（6 个 InstancedMesh 全复用同一个对象） | ✅ |
| **单帧可见合计** | 13 | **4** | `flat` + `glow` + `water` + `sky` | ✅ |
| **全场景创建** | — | **5** | 上面 4 个 + `materials.lit`（**未被任何 mesh 使用**） | — |

- 没有任何 mesh `new` 材质：`perModuleMaterials.*.sharedOnly` 全为 `true`；所有模块 ≤2 ≤3 ✅
- `materials.lit`（平滑法线版 Lambert）从 S-26 起就没有 mesh 在用 → **无 draw call、无三角、不编译 shader**，只占一个 JS 对象。属"死材质"，建议 0.4.1 二选一：给岛体/水面用上（视觉提升），或从 `getCityMaterials()` 删掉（材质清单更诚实）。
- 需要区分两个口径（Lead 已确认）：
  - **全场景共享材质对象数 = 5**（`flat/lit/glow/water` + `sky`）
  - **单帧可见材质数 = 4**（`flat/glow/water/sky`；`lit` 不可见）

---

## 5. 表④·车/行人 InstancedMesh 明细

来源：`P2-budget.json → modules.traffic.meshes` + `traffic.ts` 源码。

| 网格 | 容量 | 默认低档实到 | 高档实到 | 三角/实例 | 投影 | 更新方式 |
|---|---|---|---|---|---|---|
| `car.sedan` | 10 | 4 | 10 | 180 | ✅ | `instanceMatrix.setUsage(DynamicDrawUsage)`；每帧 `setMatrixAt` + `instanceMatrix.needsUpdate = true`；`instanceColor` 初始化 `setColorAt` 一次；`frustumCulled=false` |
| `car.van` | 10 | 4 | 10 | 180 | ✅ | 同上 |
| `car.bus` | 10 | 4 | 10 | 228 | ✅ | 同上 |
| `ped.chubby` | 20 | 8 | 20 | 124 | ❌（行人 0.5 高，投影几乎不可见 → 省 3 个阴影 draw call） | 同上（矩阵含 bob/sway/rotation.z） |
| `ped.tall` | 20 | 8 | 20 | 120 | ❌ | 同上 |
| `ped.kid` | 20 | 8 | 20 | 152 | ❌ | 同上 |

- 实例槽位合计 **90**（30 车 + 60 人），几何只建 **6** 份原型；数量切换只改 `mesh.count` + 重排弧长，**不重建几何、不换材质、不加 draw call**（`P2-budget.json` 三个档位下 call 恒 18）。
- 三角/实例实测值比 `traffic.ts` 头部注释（144/156/204/100/120/110）偏高，注释是 S-26 早期的粗估，**建议 P1 顺手改正**（不影响预算）。
- 6 个 InstancedMesh 是「3 车型 + 3 行人类型」的下限，已经是省 draw call 的写法（不能合并成 1 个，几何不同）；保持现状。

---

## 6. 表⑤·单文件 demo 构建 / 零外链（约束 5）

| 检查 | 结果 | 证据 |
|---|---|---|
| 构建方式不变 | ✅ esbuild `bundle → iife → minify` → 内联进 `index.template.html` 的 `<!--CITY_BUNDLE-->` | `tools/build-city-demo.mjs` |
| 外部资源引用 | **0** | 构建脚本打印「外链扫描 : 0 处外部资源引用」；`P2-render.json → netRequests = []`（浏览器实录非 file/data 请求 0） |
| 内联 script | ✅ 单个 `<script>` classic script，无 `src=` | 同上扫描项 3 |
| `fetch / XHR / Worker / import(http)` | **0** | 构建脚本扫描项 6；源码 grep 0 命中 |
| 第三方库内部 URL 字面量 | 2 处，已转义为等价 JS 字符串，不加载任何东西 | `http://www.w3.org/1999/xhtml`（createElementNS 命名空间）、`jcgt.org`（GLSL 注释） |
| console 报错 | **0** | `P2-render.json → consoleErrors = []`；探针页 `console 0 条 / pageerror 0` |
| 体积 | `620,941 B (606.4 KiB)` / gzip `166,144 B (162.3 KiB)` | 本次重构（审计时点），单文件体积主要就是 three.js 本身 |

---

## 7. 表⑥·微信小游戏 API 兼容性逐项（约束 6）

> 判定方式：**three@0.186.1 源码核实**（`node_modules/three`）+ 实际 WebGL2 上下文探针（`P2-probe.json`，`isWebGL2=true / maxTextures=32 / maxVertexAttribs=16`）。
> 微信侧口径：小游戏 Canvas 支持 WebGL1/2（取决于基础库与机型）、没有 DOM、有 `wx.createCanvas / onTouch* / getSystemInfoSync / getLaunchOptionsSync`。

| # | 能力 | three 里的用法 | 微信小游戏能不能用 | 风险 | 0.4.1 要做什么 |
|---|---|---|---|---|---|
| 1 | **WebGL2 上下文** | `WebGLRenderer` 自 **r163** 起**硬性要求 WebGL2**（r186.1 源码：`WebGL 1 is not supported since r163` 直接 throw） | 取决于机型/基础库：新机 √，老机/低基础库可能只给 WebGL1 → **直接黑屏** | **P0 高** | ① 真机矩阵测（iOS ≥2 台 + 安卓 ≥3 台 + 低端机）；② 启动即查 `renderer.capabilities.isWebGL2`，失败给友好降级页；③ 若必须支持 WebGL1：锁 three `≤0.162` 分支（并重验本表其余项） |
| 2 | `MeshLambertMaterial` | flat/lit/glow/water 4 个共享材质 | ✅ 内置材质 | 低 | 无 |
| 3 | `vertexColors`（Float32 `color` attribute） | 所有合并几何 `position/normal/color` 三属性，无 uv | ✅ 普通顶点属性 | 低 | 无 |
| 4 | `flatShading` | flat 材质开启（片元用 `dFdx/dFdy`） | ✅ WebGL2 核心（WebGL1 才需要 `OES_standard_derivatives`） | 低 | 无（若降级 WebGL1 需查该扩展） |
| 5 | `InstancedMesh` | 6 个（车 3 + 人 3） | ✅ WebGL2 核心（`vertexAttribDivisor / drawElementsInstanced`）；WebGL1 需 `ANGLE_instanced_arrays` | 中（依赖第 1 项） | 同第 1 项；真机上确认车/人正常出图 |
| 6 | `InstancedBufferAttribute.instanceColor` | 车身色/衣服色；three 在 `color_vertex` chunk 里 `vColor.rgb *= instanceColor.rgb`（已核实 r186.1 源码） | ✅ 普通 instanced 属性；需 `vertexColors:true` 的 flat 材质（已满足） | 低-中 | 真机看一眼：车是否按 `CAR_COLORS` 上色（若适配层丢 instanced attribute 会全白） |
| 7 | `onBeforeCompile` 改 Lambert fragment（`emissive * vColor` 实现"emissive 顶点色"） | `glow.onBeforeCompile` 把 `vec3 totalEmissiveRadiance = emissive;` 替换掉；已 `customProgramCacheKey` 区分程序 | ✅ 小游戏侧无额外限制；**r186.1 已核实待替换字符串存在**（`meshlambert.glsl.js:93`） | **中**（版本耦合：升级 three 或替换失败会静默退化成"全白发光"） | ① 锁死 three 版本；② 加一条单测：构建后 shader 里必须出现替换后的标记；③ 真机夜景检查窗/霓虹是否按顶点色发光 |
| 8 | `ShaderMaterial` 天空（渐变 + 程序化星星） | 自写 GLSL1 语法，`BackSide`、`depthWrite=false`、`fog=false`，1 draw call、无贴图 | ✅ WebGL2 接受 GLSL ES 1.00；小游戏只是转发编译 | 低-中 | 真机看渐变/星星是否正常；星星用 `sin` 精度哈希，移动 GPU 可能图案略变（不影响正确性，0.4.1 可换整数哈希） |
| 9 | `PCFShadowMap` + 方向光阴影 | 1 个光、`mapSize 2048²`、阴影相机 34×34、`bias/normalBias` 已调 | ✅ WebGL2 深度纹理可用；但显存/带宽重：2048² 阴影 RT ≈ **32 MiB**（颜色 16 + Float 深度 16） | **中（性能）** | 移动端档位：`1024²`（≈8 MiB）/ 低端 `512²`；阴影相机 34→26 提精度；可只在「日间 + 高画质档」开阴影 |
| 10 | `DynamicDrawUsage` | 6 个 `instanceMatrix` | ✅ 只是 buffer usage 提示 | 低 | 无 |
| 11 | `SRGBColorSpace`（`outputColorSpace`） | 渲染器输出 sRGB | ✅ | 低 | 无 |
| 12 | `Fog` | `THREE.Fog(fogColor, near, far)`，每风格×昼夜一套 | ✅ | 低 | 无 |
| 13 | **DOM HUD** | `hud.ts` 是纯 DOM（建 style 标签 / 按钮 / 读数，18 处 DOM 调用） | ❌ 小游戏无 DOM | **P0 高（集成必改）** | HUD 拆两层：`HudModel`（数据/状态）+ `HudRenderer`（DOM 实现给小游戏外的网页、Canvas 2D 实现给小游戏，`wx.createCanvas()` 第二个 canvas 做 2D 层） |
| 14 | **交互** | `pointerdown/move/up`、`wheel`、`touchstart/move`、`contextmenu` | ❌ 无 DOM 事件 | 中 | 换 `wx.onTouchStart/Move/End/Cancel`；滚轮缩放改成双指捏合 + UI 按钮；`pointer capture` 去掉 |
| 15 | **窗口/设备/启动参数** | `window.innerWidth/innerHeight/devicePixelRatio`、`location.search`、`URLSearchParams`、`requestAnimationFrame`、`performance.now` | ⚠️ 需适配层 | 中 | `wx.getSystemInfoSync()` 取窗口/像素比；`wx.getLaunchOptionsSync().query` 替代 URL 参数；`requestAnimationFrame/performance` 用适配层（需 verify） |
| 16 | **渲染档位** | `setPixelRatio(min(dpr, 2))`、`antialias: true`、`powerPreference: 'high-performance'` | ⚠️ 移动端过重；小游戏可能忽略部分参数 | 中 | 移动端默认 `pixelRatio = 1.5`（可降 1）、`antialias: false`（用像素比换清晰度）、阴影降档、`powerPreference` 不管 |
| 17 | **资源形态** | 零贴图 / 零外部模型 / 零网络 / 零 Worker | ✅ 小游戏最省事的一种：**不需要配任何下载域名、不需要 `wx.downloadFile`** | 低 | 保持「纯程序化」纪律，后续别引入贴图/模型 |
| 18 | **构建产物** | 单文件 HTML（内联 iife）是"网页 demo 专用" | ❌ 小游戏不用 HTML | 低 | 小游戏侧：`three` 作 npm 依赖 + 同一批 `src/render/city/**` 源码 + esbuild 打 CommonJS/ESM 分包（代码 100% 复用；tonic 入口换成 `game.js`） |

**微信复刻的净结论**：代码形态（纯几何 + 顶点色 + 共享材质 + InstancedMesh + 零贴图）是**小游戏最友好的形态**，逻辑层可 100% 复用；必须先解决的只有两件**工程**事：**① WebGL2 真机可用性（P0）**、**② HUD/交互/窗口 API 适配层（P0/P1）**。渲染本身不需要为微信重写。

---

## 8. 表⑦·内存 / 构建（约束 7）

| 指标 | 实测 | 来源 / 说明 |
|---|---|---|
| 几何对象数（全部建好） | **21** | island 2 + sky 1 + 塔楼 3×2 + 道具 3×2 + 车人 6（`P2-budget.json → uniqueGeometries`；浏览器 `info.memory.geometries` 在三风格都渲染过后恒为 21，**默认开局只有 13 = 惰性上传，不是泄漏**） |
| 材质对象数 | 创建 **5** / 可见 **4** | `flat/lit/glow/water` + sky；`lit` 未被使用（§4） |
| **纹理数** | **素材纹理 0**；运行期 `renderer.info.memory.textures = 2`（阴影 RT：2048² 颜色 + Float 深度），**关阴影实测 = 0** | `P2-probe.json → runs[].textures / textureAttribution / noShadowRenderer`；场景侧 `Texture` 引用 0 |
| 顶点总数（三风格全建） | **191,787** | 非索引几何，`position` count 累加 |
| 几何显存估算 | **≈6.7 MiB**（191,787 × 36 B：pos+normal+color 各 3×f32；uv 已在 `MeshBuilder` 删除） | `geometryBytesEstimate = 6,904,332 B` |
| 实例矩阵 | 90 槽位 × 64 B ≈ **5.6 KiB** | `instanceBytesEstimate = 5,760 B` |
| 阴影贴图显存 | 2048²：颜色 16 MiB + Float 深度 16 MiB ≈ **32 MiB** → 降 1024 ≈ **8 MiB**，512 ≈ **2 MiB** | three 源码：`WebGLShadowMap` 建 `WebGLRenderTarget(2048,2048)` + `DepthTexture(Float)` |
| JS heap（整场景 + three，Chromium） | **22.6 MiB used** / 4.1 GiB limit | `P2-probe.json → heap.usedJSHeapSize = 22,606,924` |
| 初始化构建耗时（node，三两风格全建 + 车人） | **88 ms**（岛 11 / 塔 A18 B15 C9 / 道具 A12 B7 C9 / 车人 7） | `P2-budget.json → buildMs` |
| 三风格全建会不会爆内存 | **不会**：几何 ≈6.7 MiB + 实例 5.6 KiB + JS heap ≈23 MiB，主成本是阴影 RT（32 MiB）；21 个几何对象在移动端完全可接受 | 同上。若 0.4.1 要再省：按需惰性建风格（88 ms 可接受），省 ~4.5 MiB 常驻几何 |
| **切档泄漏检查**（Lead 点名） | 三风格建好后反复切 `关/低/高/关/高/低`：`geometries` 恒 **21**、`textures` 恒 **2**、`programs` 恒 **9**、可见材质恒 **4** → **不随档位增长，无泄漏** | `P2-probe.json → leak`（6 次切换全同） |
| shader program 数 | **9**（无阴影 renderer = 5） | `P2-probe.json → programs`；9 = 4 主材质程序 + 阴影深度/instancing 变体 |
| 单文件体积 | **620,941 B / gzip 166,144 B**（≈606 KiB / 162 KiB） | 本次构建（`/tmp/s28/P2-demo.html`，sha256 `b3ad1e92…`） |

---

## 9. 表⑧·预算对照表（S-26 实测 vs 本审计实测 vs 预算 vs 余量）

| 指标 | S-26 说明.md（0.4.0） | 本审计实测 | 预算 | 余量（默认低档 / 高档峰值） | 判定 |
|---|---|---|---|---|---|
| 岛三角 | 1,256 / 2 mesh | **1,256 / 2 mesh** | — | — | 一致 ✅ |
| 天空三角 | 720 / 1 mesh | **720 / 1 mesh** | — | — | 一致 ✅ |
| 塔楼 A / B / C 三角 | 7,956 / 11,204 / 8,200（各 2 mesh） | **完全一致**（各 2 mesh） | 单风格 ≤25k~30k（测试内控） | 充裕 | 一致 ✅ |
| 道具三角 | 11,396 / 2 mesh | **11,396 / 2 mesh**（三风格同） | ≤20k（测试内控） | 充裕 | 一致 ✅ |
| 车 + 行人三角 | **984 / 6 mesh** ❌ | **8,280**（18 车 36 人基准）/ **5,520**（默认低档）/ **13,800**（高档） | ≤20k（测试内控） | 充裕 | **S-26 数字错**（见下） |
| 几何合计（单风格） | 22,312 / 25,560 / 22,556 ❌ | 默认低档 **26,848 / 30,096 / 27,092**；基线 18/36 **29,608 / 32,856 / 29,852** | — | — | **S-26 合计偏低** |
| **峰值渲染三角（renderer.info）** | 56,012（B，18/36，实测） | 基线 18/36：**45,516 / 56,012 / 43,604（与 S-26 逐位相同 ✅）**；默认低档 B **52,076**；高档峰值 B **63,884** | **≤150,000** | **97,924 / 86,116** | **PASS（43% 峰值）** |
| **draw call（renderer.info）** | 18（实测） | 默认低档 **18**；高档 **18**；关档 **9** | **≤70** | **52 / 52** | **PASS（26%）** |
| 材质对象数 | 4（flat/lit/glow/water）+ 天空 1 | 创建 **5**、单帧可见 **4**、每模块 ≤2 | 每模块 ≤3 | 宽裕 | PASS ✅ |
| 纹理数 | 0 | 素材 **0**；运行期 2（阴影 RT） | 0 素材纹理 | — | PASS ✅ |
| 单文件体积 | 614,191 B / gzip 163,936 B | **620,941 B / gzip 166,144 B** | — | — | 基本持平（+1%；HUD/档位代码增加） |

**S-26 表格里那条错误数字的说明（必须写清，避免 0.4.1 引用错数）**：
S-26 说明.md §3 写「车流 + 行人 984 三角」，但同页的截图实测 `56,012`（B 风格）只有用 **8,280** 才能算出（`32,856 几何 + 23,156 阴影 = 56,012`）。
984 是早期"按单个原型近似"的旧估值，实际每实例三角是 sedan **180** / van **180** / bus **228** / chubby **124** / tall **120** / kid **152**（`P2-budget.json` 实测）。
结论：**S-26 的「实测 renderer.info」数字是对的（本审计逐位复现），错的是那张按模块拆分的几何表**。0.4.1 引用请用本报告 §2/§3 的数。

---

## 10. 本轮修复：**无需修复**

逐条核对后没有触发「超预算 / 违反硬约束」：

- draw call 18 ≤ 70（26%）、三角峰值 63,884 ≤ 150,000（43%），余量充足；
- 每模块材质 ≤2、全部共享、无 `new` 材质；车/人 100% InstancedMesh；
- 零贴图、零外链、零网络、零 Worker；
- 三风格全建内存可接受、切档无泄漏。

按「不为凑 KPI 乱改」的纪律，**未改动任何源文件**（`materials.ts / props.ts / island.ts` 一字未动）。
下面只列**可选优化**（供 Lead/0.4.1 决策，不在本轮执行）：

| # | 可选优化 | 收益 | 成本/风险 | 建议 |
|---|---|---|---|---|
| O1 | 删掉未使用的 `materials.lit`（或用于岛体平滑法线） | 材质清单从 5→4，口径更干净 | 极低 | 建议 0.4.1 做 |
| O2 | 移动端阴影 2048→1024（低端 512）+ 阴影相机 34→26 | 省 ~24 MiB 显存 + 阴影 pass 填充率 | 低（画质略降） | 建议 0.4.1 随画质档做 |
| O3 | 移动端 `pixelRatio 2→1.5`、`antialias:false` | 像素填充率 −44%，帧率最直接 | 低 | 建议 0.4.1 做 |
| O4 | 关档时真的把车人组 `visible=false`（P1 正在做）+ `stats().gear` 如实显示 | 关档 draw call 从 18→9 | 已在 P1 范围 | 交付后复测 |

> 说明：**不建议**为了再省 draw call 去合并 3 车/3 行人原型（几何不同，合并不了；当前 6 个是下限），也不建议砍道具（11,396 三角只占预算 8%，视觉收益大）。

---

## 11. 风险清单（按优先级，0.4.1 直接照着做）

| 等级 | 风险 | 影响 | 处置（0.4.1 行动项） |
|---|---|---|---|
| **P0** | **three@0.186.1 要求 WebGL2**，小游戏老机型/低基础库可能只给 WebGL1 | 整方案黑屏，无法复刻 | ① 真机矩阵测 `webgl2` 可用性（iOS 2 台 / 安卓 3 台含低端机）；② `renderer.capabilities.isWebGL2 === false` 时给降级页；③ 若必须覆盖 WebGL1 → 评估锁 three ≤0.162（**改动大，先测再定**） |
| **P0** | HUD 是纯 DOM（`hud.ts` 18 处 DOM 调用），小游戏没有 DOM | 集成时必须重写 UI | 把 HUD 拆 `HudModel + HudRenderer`，新增 Canvas 2D 实现（`wx.createCanvas()` 第二块画布），DOM 实现保留给网页 |
| **P1** | `onBeforeCompile` 依赖 Lambert fragment 里的一行字符串 | three 升版本会静默失效 → 夜景窗/霓虹全变白 | 锁 three 版本 + 加单测断言（shader 含替换标记）+ 真机夜景目视检查 |
| **P1** | 交互/窗口/启动参数全是浏览器 API（pointer/wheel/location/URLSearchParams/dpr） | 小游戏里拖拽/缩放/URL 参数全失效 | 写一层 `Platform` 适配（touch 事件、`getSystemInfoSync`、`getLaunchOptionsSync().query`、rAF/now） |
| **P1** | 阴影 2048² 在移动端显存/带宽偏重（≈32 MiB + 每帧重绘） | 低端机掉帧/发烫 | 画质档：阴影 1024/512、阴影相机 26、可关阴影；配合 `pixelRatio 1.5`、`antialias:false` |
| **P1** | 当前树 `traffic.ts` 仍是 S-26 旧版（下限 10、无 `setGear`、不隐藏组） | 「关档」被夹成 10/10、draw call 不归零；`contract.ts` 新档位 API 未落地 | P1 交付后**重跑 `/tmp/s28/P2-budget.mjs` 与 `/tmp/s28/P2-render.mjs` 复核**（本报告已给计划语义的数） |
| **P2** | `materials.lit` 未使用（死材质） | 材质计数口径争议（5 vs 4） | 删或启用（O1） |
| **P2** | `traffic.ts` 注释里的三角数（144/156/204…）与实测（180/180/228…）不符 | 文档误导 | P1 顺手改注释 |
| **P2** | S-26 说明.md §3 「车人 984」+「合计 22,312/25,560/22,556」是错的 | 后续文档继续引用会算错预算 | 0.4.1 文档统一引用本报告 §2/§3 |
| **P2** | 天空星星用 `sin` 精度哈希 | 不同 GPU 星图略不同（不影响功能） | 可选：整数哈希 |

---

## 12. 0.4.1 复刻清单（照做即可）

**保持不动的部分（已验证可直接复用）**
1. `src/render/city/**` 全部模块（layout / island / materials / style-a/b/c / props / traffic）：纯 TS + three，无 DOM、无浏览器 API（grep 0 命中），逻辑层 100% 可迁移。
2. 材质纪律：`flat / lit / glow / water` 四件套 + 天空，全场景共享；每模块 ≤2。
3. 几何纪律：`MeshBuilder` 合并 + 顶点色 + 删除 uv；零贴图。
4. 车/人：6 个 InstancedMesh + `DynamicDrawUsage` + `instanceColor`。
5. 阴影纪律：只有塔楼/道具/车投影（glow/行人/岛体不投影）——这是 draw call 只有 18 的关键，别破坏。

**必须新做的部分**
1. `Platform` 适配层：canvas/WebGL2、touch、rAF/now、systemInfo、launch query。
2. HUD：Canvas 2D 实现（数据模型复用）。
3. 画质档：`pixelRatio 1.5`、`antialias:false`、阴影 1024/512、可关。
4. 构建：小游戏侧 `three` npm + esbuild 打 ESM/CJS 分包；不需要单文件内联（那是网页 demo 的形态）。
5. 启动自检：`isWebGL2`（P0）、`info.memory.textures === 0`（素材纹理 0）、`info.render.calls ≤ 70`、`info.render.triangles ≤ 150k` 打日志（可直接复用本报告口径）。

---

## 13. 复现方法（任何人可重跑）

```bash
export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH
cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm040-city

# 1) 几何/材质/预算（node，不需要 GPU）
node /tmp/s28/P2-budget.mjs          # → /tmp/s28/P2-budget.json + 人类可读表

# 2) 单文件构建（零外链校验）
node tools/build-city-demo.mjs --out /tmp/s28/P2-demo.html

# 3) 真实 renderer.info（Chromium + SwiftShader 软渲染；FPS 不可当真机）
node /tmp/s28/P2-render.mjs /tmp/s28/P2-demo.html   # → /tmp/s28/P2-render.json

# 4) WebGL2 探针（纹理数 / program 数 / 切档泄漏 / WebGL 能力）
node /tmp/s28/P2-probe.mjs            # → /tmp/s28/P2-probe.json

# 5) 禁用 API 第二证据（应为 0 命中）
grep -rnE "Texture|TextureLoader|CanvasTexture|ImageBitmap|data:image|fetch\(|XMLHttpRequest|new Worker" \
  src/render/city/ src/city-demo/ | grep -v '^[^:]*:[0-9]*: \*'
```

> **FPS 口径声明**：本机无 GPU，Chromium 走 SwiftShader 软渲染，**FPS 不代表真机**（S-26 记录 8.5~22.3）。三角数 / draw call / 纹理数 / 材质数与硬件无关，是本报告采用的验收指标；真机帧率请 0.4.1 集成后按画质档实测并如实标注。

---

*审计人：P2 · 2026-10-23 01:02–01:14（北京时间）· 工作树 `frontend-rebuild-hm040-city`（未改动任何源文件）*
