# S-29 微信小游戏复刻审计（城市建筑内容库 · 模块化预算）

> 生成时间：2026-10-23（北京时间）｜工作树 `frontend-rebuild-hm041-city2`
> 口径：**纯程序化几何、零贴图**；所有数字都是实测（Node 几何口径 + Chromium/SwiftShader 渲染口径），不是估算。
> 复现命令见文末。

## 1. 单模块预算（6 条内容线 × 5 档 × 3 变体 = 90 种单元，×3 风格 = 270 种构建）

| 内容线 | 文件 | 导出 | 单元三角形 min / avg / max | 网格/单元 | 材质/单元 | 档位总高（t0→t4） |
|---|---|---|---|---|---|---|
| 住宅 | `tier-residential.ts` | `buildResidential` | 348 / **916** / 1,724 | 1 不透明 + 1 自发光 = 2 | 2（flat+glow） | 1.5 → 4.2 → 7.7 → 12.0 → 17.6 |
| 商业 | `tier-commercial.ts` | `buildCommercial` | 420 / **1,026** / 1,728 | 2 | 2 | 1.8 → 4.2 → 7.8 → 12.6 → 18.2 |
| 市政 | `hall.ts` | `buildHall` | 816 / **1,397** / 2,052 | 2 | 2 | 2.4 → 3.8 → 5.4 → 7.6 → 10.4 |
| 公园 | `park.ts` | `buildPark` | 528 / **1,362** / 2,580 | 1~2 | 1~2 | 1.60 → 1.80 → 2.02 → 2.27 → 2.55 |
| 地标 | `landmark.ts` | `buildLandmark` | 548 / **800** / 1,188 | 2 | 2 | 3.2 → 6.0 → 10.0 → 15.2 → 22.0 |
| 工业码头 | `industry.ts` | `buildIndustry` | 408 / **642** / 932 | 2 | 2 | 1.6 → 2.8 → 3.9 → 5.0 → 6.3 |

- 单元三角形上限（`CONTENT_BUDGET.unitTriangles`）**2,600**，全部单元实测 **≤ 2,580**（公园 T4 最贴近上限）。
- 每模块材质 ≤ 2（只有共享 `mats.flat` 与 `mats.glow`），全城材质合计 **3**（+ `mats.water`）。
- 每单元 draw call ≤ 2（不透明 1 + 自发光 1），没有第三个材质/网格。

## 2. 全城满铺（85 块）实测

布局：`planCity(BLOCK_PRESETS.full85)` = 17×5 = **85 块**（CBD 7 / 中圈 28 / 外圈 50；地标位 5：中心 1 + 四角 4；公园 16 块；路网 20 段）。

| 指标 | 实测值 | 预算 | 结论 |
|---|---|---|---|
| 建筑单元数 | **69**（其余 16 块是广场/道路铺装，不建楼） | — | — |
| 实例化道具 | **158**（行道树 / 路灯 / 长椅，3 个 `InstancedMesh`） | — | 已实例化 |
| 几何三角形（Node 口径，单次几何） | **73,156**（A 63,240 / C 72,076） | 150,000 | ✅ 49% |
| 渲染三角形（浏览器口径，含阴影 pass） | **132,842** | 150,000 | ✅ 89%（含阴影两次绘制） |
| draw call（浏览器实测） | **12**（6 网格 × 阴影 pass 2） | 70 | ✅ 17% |
| 网格数（合批后） | **6**（flat + glow + water + 3 × InstancedMesh） | ≤70 | ✅ |
| 材质数 | **3** | 每模块 ≤3 | ✅ |
| 顶点数 | 196,392 | — | 见 §5 内存 |
| 顶点属性内存 | **≈ 6.9 MiB**（pos+normal+color = 36 B/顶点） | — | 见 §5 |

**按内容线的三角形小计**（风格 B 全城 85 块，Node 几何口径，实测）：

| 内容线 | 三角形 | 占比 | 说明 |
|---|---|---|---|
| 公园 park | 19,484 | 26.6% | 16 块公园 + 实例化树/长椅/路灯，是最大头 |
| 商业 commercial | 13,276 | 18.1% | 12 块商业（含 T3/T4 幕墙竖梃） |
| 住宅 residential | 12,888 | 17.6% | 19 块住宅（阳台/空调外机最费） |
| 工业码头 industry | 11,908 | 16.3% | 17 块（锯齿屋顶/吊机/集装箱） |
| 地标 landmark | 5,208 | 7.1% | 5 个地标位（塔身细，反而省） |
| 市政 + 广场铺装 + 路网 | 10,392 | 14.2% | 1 座市政厅 + 16 块广场/道路铺装 |
| **合计** | **73,156** | 100% | = 预算 150k 的 48.8% |

> 关键设计：**重复单元不靠 InstancedMesh 而靠几何合批** —— 85 个地块的楼体全部按材质合并成 1 个 flat 网格 + 1 个 glow 网格，draw call 从 ~140 降到 2；只有「树/路灯/长椅」这类同形小件用 3 个 InstancedMesh。两条路一起用，才有 12 call 的读数。

## 3. 接进游戏后的预计总量（关键换算）

0.4.1 接入时的既有场景（S-26 实测，Node 几何口径）：

| 既有部分 | 三角形 | 网格 |
|---|---|---|
| 六边形岛 + 道路 + 水面 | 1,256 | 2 |
| 街道道具（风格 B） | 11,396 | 2 |
| 车流 + 行人 | 8,280 | 6 |
| 原 4 栋塔楼（将被内容库替换） | 11,204 | 2 |
| **S-26 实测渲染峰值（含阴影）** | **56,012** | **18 call** |

内容库替换 4 栋塔楼 + 加满 85 块后的三种接入方案：

| 方案 | 内容库策略 | 内容库渲染三角形（实测） | draw call | + 岛/道具/车流（≈34k 渲染） | 预计总量 | 结论 |
|---|---|---|---|---|---|---|
| **A（推荐首版）** | 85 块，**只关键楼投影** `shadowMode:'key'`（tier≥3 或 landmark/civic，17 个投影体） | **100,610** | 13 | +34,000 | **≈ 135,000** | ✅ 留 10% 余量 |
| B | 85 块，全部投影（当前 demo 口径） | **132,842** | 12 | +34,000 | ≈ 167,000 | ❌ 超 150k（需关道具/车流阴影或减块） |
| A' | 85 块，不投影 `shadowMode:'none'` | **73,878** | 8 | +34,000 | ≈ 108,000 | ✅ 最省，但楼体没影子 |
| C | 49 块（7×7 小城），全部投影 | ≈ 76,500（实测几何 42,504 × 1.8） | — | +34,000 | ≈ 110,000 | ✅ 小城阶段可用 |
| D | 33 块（11×3 商业带），全部投影 | ≈ 58,000（几何 31,832 × 1.8） | — | +34,000 | ≈ 92,000 | ✅ 最省 |

- **draw call 账**：内容库 6~7（key 模式多一个关键楼网格）+ 岛 2 + 道具 2 + 车流 6 + 天空 1 + 水面 1 + 地面 1 = **19~20**（渲染读数 key 模式 13）→ 远低于 70。
- **材质账**：`city.flat` / `city.glow` / `city.water` 三个共享 Lambert + 天空 ShaderMaterial 1 + 地面 1 = **5**；内容库自身只增 0 个材质。
- **三角形账**：150k 预算下，建议进 0.4.1 用方案 A；若机主要「全阴影」观感，用方案 C/D 换块数，或把街道道具/车流阴影关掉（省 ~20k 渲染三角形）。

## 4. 微信小游戏可复刻性逐条核对

| 要求 | 现状 | 证据 |
|---|---|---|
| 纯程序化几何、**不用贴图** | ✅ 源码静态扫描 0 处 `new THREE.*Texture` / `map:`；测试 `内容模块：无贴图…` 断言 | `test/city-content.test.mjs` |
| 共享材质（每模块 ≤3） | ✅ 全库只用 `mats.flat` / `mats.glow`，每单元材质数 1~2 | `verify` 输出 `材质 max 2` |
| 实例化 | ✅ 树/路灯/长椅 158 个实例 3 个 `InstancedMesh`；楼体用几何合批（draw call 更省） | `buildCityContent` 返回 `instanced:158` |
| 总 draw call ≤70 | ✅ 实测 12（全城满铺含阴影 pass） | `evidence/metrics.json` |
| 三角形 ≤150k | ✅ 渲染口径 132,842（含阴影），几何口径 73,156 | `evidence/读数.md` §一 |
| 无 BigInt / ES2020 兼容 | ✅ 内容库只用 number / Math（无 BigInt 字面量）；demo bundle 已 `target:'es2020'` | `tools/build-city-content.mjs` |
| 单文件产物体积 | 637,587 B（gzip 170,586 B）＝ 622.6 KiB，零外链、file:// 可开 | build 输出 |
| 确定性（同参数同结果） | ✅ 所有随机走 `hash2/pickVariant/unitRng`；`verify` 对每个单元跑两遍比对三角形/高度 | `verify` |

## 5. 内存与首帧成本（给 0.4.1 的提前量）

- 顶点属性：196,392 顶点 × 36 B（position 12 + normal 12 + color 12）= **6.90 MiB** GPU/内存；无 index（全部 non-indexed）。
- 首帧构建：Node 侧 `buildCityContent` 85 块实测 **69~124 ms**（三风格 B 最快，A 最慢）；微信真机预计 0.3~0.8 s。
- 建议：进游戏后按「城市等级」分档构建（小城 33 块 → 中城 49 块 → 满城 85 块），把首帧成本摊到升级瞬间；合批结果可缓存（同一 plan + style 只建一次，切风格时复用 plan）。
- 若内存吃紧：把顶点色从 `Float32` 降为 `Uint8`（three 支持 normalized color attribute）可省 ~2/3 的 color 内存（约 2.3 MiB），需要改 `MeshBuilder`（geom.ts，属公共文件，改动需评估 S-26 回归）。

## 6. 复现命令

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

# 单模块自检（3 风格 × 5 档 × 3 变体 = 45 单元/模块）
node /tmp/s29/verify.mjs src/render/city/tier-residential.ts buildResidential residential
node /tmp/s29/verify.mjs src/render/city/tier-commercial.ts buildCommercial commercial
node /tmp/s29/verify.mjs src/render/city/hall.ts buildHall civic
node /tmp/s29/verify.mjs src/render/city/park.ts buildPark park
node /tmp/s29/verify.mjs src/render/city/landmark.ts buildLandmark landmark
node /tmp/s29/verify.mjs src/render/city/industry.ts buildIndustry industry

# 总装 + 预览页 + 全套测试
node /tmp/s29/budget2.mjs              # 各规模总装读数
node /tmp/s29/geom-mem.mjs             # 顶点/内存读数
node tools/build-city-content.mjs      # 单文件预览页
node --test test/city-content.test.mjs # 全部断言（含预算/纪律/截图齐全）
```

**审计结论**：内容库本身在「85 块满铺 + 全阴影」下 132,842 渲染三角形 / 12 draw call，单看达标；但与既有岛/道具/车流同屏需选接入方案 A（只关键楼投影，实测 100,610 → 预计 135k / ~20 call）。**是否接受方案 A 的阴影取舍，请机主在《说明.md》第 5 节的待确认问题里裁决。**
