# S-29 独立复核报告（B4b · 对抗验收 · 终版）

> 复核人：B4（子智能体 b4-landmark-industry）｜完成时间：2026-10-23 01:56（北京时间）
> 工作树：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm041-city2`（已冻结）
> 最终产物：`demo/city-content.html` 637,587 B ｜ sha256 `9e1c56561c06ed7dbc6c825e0c2d6c267ef4421057092b930c51dd514a8b4bad` ｜ `evidence/` 99 张（8.5 MB）
> 性质：**只读复核**，未修改任何交付文件；临时脚本/截图只写 `/tmp/s29/**`，本报告写在 `tasks-out/S-29/`。
> 口径：机主验收标准 + 冻结契约，不采信测试自证，所有数字为本次实测。

---

## 0. 结论摘要

| # | 检查项 | 结论 |
|---|---|---|
| A1 | 开工 sha256 清单比对（越界检测） | ✅ PASS（212 条：211 匹配 / 1 有意改动 / 0 缺失 / 14 新增全合规，P0=0） |
| A2 | contract.ts 变更与声明一致 | ✅ PASS（只增可选字段 CityContentStats + CityStats.content?） |
| A3 | 版本号 / package.json / 依赖 / 游戏源码未动 | ✅ PASS |
| B1 | `tsc --noEmit -p tsconfig.json` | ✅ PASS（exit 0） |
| B2 | `node --test test/city-content.test.mjs` | ✅ PASS（19/19，fail 0） |
| C1 | 6 线 × 2 档 × 3 风格造型抽查（36 单元） | ✅ PASS |
| C2 | 几何高度全量扫描（270 单元） | ✅ PASS（P1 修复后 0 个越 ±12%；此前住宅 T3/T4 曾 +26.1%/+22.7%） |
| D1 | 全城总装 × 3 风格 vs 审计口径 | ✅ PASS（结构指标全对；数字以本报告 §5 为准） |
| E1 | 最终页面随机 10 机位 + 6 特写（破面/穿模/悬空/浮窗/共面闪烁） | ✅ PASS（0 暴露问题，仅 2 条 P2 观感） |
| F1 | 预览页档位文案 | ✅ 已修（主 caption 现按类显示模块档名；尾部保留「通用档名」为设计选择） |
| F2 | grid 总览视图 draw call 91/70 | ⚠️ P2，仅 catalogue 视图，不进游戏 |

**最终结论：PASS 11 / FAIL 0（P0=0，P1=0；遗留 P2=2：grid 视图读数、观景轮侧视；另 2 项记录级）** —— 可以交付。

---

## 1. 边界检查（最高优先级）—— PASS，零越界

方法：以 `tasks-out/S-29/开工sha256.txt`（212 行）为基线逐文件重算 sha256；递归扫描整个工作树（排除 `node_modules`）找清单外新增文件。
证据：`/tmp/s29/b4-review/boundary.txt`（脚本 `/tmp/s29/boundary.mjs`）。

```
清单条目 212 ｜匹配 211 ｜不符 1 ｜缺失 0 ｜新增 14
✗ 不符 ./src/render/city/contract.ts  was a247df4fdda0  now 0fd31e8bdf6e  size 7931
新增文件（14）：
  src/city-demo/content-main.ts, src/city-demo/content.template.html
  src/render/city/{content,tier-residential,tier-commercial,commercial,hall,park,landmark,industry,blocks}.ts
  test/city-content.test.mjs
  tools/build-city-content.mjs, tools/city-content-shot.mjs
```

- **唯一改动的既有文件 = `src/render/city/contract.ts`**（允许的契约改动，见 §2）；其余 211 个清单文件 sha 全等。
- **无缺失、无清单外新增**（`package.json`/`tsconfig.json`/`package-lock.json`/`ISOLATION.md` 亦与基线一致，曾因路径规范化误报后修正）。
- 版本号未动（`src/game/build-version.d.ts` sha 一致）；游戏源码、其它工具、`docs/`、`tests/` 全部未动。
- 14 个新增文件逐条核对路径：`src/render/city/**`（9）、`src/city-demo/**`（2）、`test/city-content.test.mjs`、`tools/build-city-content.mjs`、`tools/city-content-shot.mjs` —— **全部合规**。

## 2. contract.ts 变更核对 —— PASS（与声明一致）

- 当前 sha `0fd31e8bdf6e…`（7,931 B），基线 `a247df4fdda0…`；**开工原件不在磁盘**（全盘只有 hm040-city 的另一 lineage 版本），无法做字节级 diff（遗留风险 R3）。
- 人工核对：S-29 只新增「内容库统计（只增，可选）」段 —— `export interface CityContentStats`（units/triangles/meshes/materials + 可选 instanced/byClass）与 `CityStats.content?: CityContentStats`；既有 BuildStats/BuildTraffic/CityStats/CityApi 保留。
- 反向证据：全项目既有消费者在 `tsc --noEmit` 下 0 报错，无破坏性改动。

## 3. 类型 + 测试 —— PASS

```
$ ./node_modules/.bin/tsc --noEmit -p tsconfig.json   → exit 0（/tmp/s29/b4-review/tsc.log）
$ node --test test/city-content.test.mjs             → tests 19 / pass 19 / fail 0（/tmp/s29/b4-review/test.log）
```
证据目录：99 张 PNG / 8.5 MB（90 单栋 + 6 三风格三联 + 3 满铺），全部由最终页面重出，0 console 报错。

## 4. Node 侧造型抽查（不依赖页面）

### 4.1 6 线 × t1/t4 × v1 × A/B/C = 36 单元（`/tmp/s29/b4-review.mjs` → `shape-review.txt`）

- 三角形：548（landmark A.t1）~ 2,324（park C.t4）≤ 2,600；唯一提示 `tier-residential A.t1` = 348 < 400（下限建议，Lead 已知，非硬指标）。
- 网格 ≤ 2、材质 ≤ 2（仅共享 `city.flat` / `city.glow`）；足迹 ≤ `footprintFor` 且 ≤ `MAX_UNIT_W`；X/Z ≤ 足迹半宽 + 0.06；**局部 minY 全部 = 0**；NaN = 0；同参二次构建 checksum 一致。
- 档间高比（每条线 5 档 × 3 风格）：全部 ≥ 1.2（公园/工业 ≥ 1.12）—— PASS。

### 4.2 全 270 单元「几何 maxY vs 承诺高度」全量扫描（`/tmp/s29/b4-height.mjs` → `height-audit2.txt`）

| 内容线 | 单元 | 几何 maxY 与 footprint.h 关系 | 判定 |
|---|---|---|---|
| 住宅 residential | 全部（T0–T4） | T0–T2 −3.9%~−4.5%；**T3 = 12.00 / T4 = 17.60（P1 修复后精确贴合）** | ✅ |
| 商业 commercial | 全部 | −2.4% ~ −7.2%（容差内） | ✅ |
| 公园 park | 全部 | A 风格 −3.2%（ico0 球冠包围盒非 1），其余 ≤ ±1% | ✅ |
| 地标 / 工业 / 市政 | 全部 | ≤ ±2% | ✅ |

> 47 个「偏差 >2%」单元全部落在 ±12% 容差内，**0 个越界**。该检查已由 Lead 并入 `content.auditUnit`（`|maxY − h| ≤ max(0.08, 12%h)`），以后会被测试自动锁死。

## 5. 全城满铺 × 3 风格 vs 审计口径（最终冻结代码实测）

| 指标 | 最终实测 | 判定 |
|---|---|---|
| 几何三角形 A / B / C | **63,240 / 73,156 / 72,076**（B 即预览页 caption 的 73,156） | ✅ 预算 48.8% |
| 建筑单元数 | 69（85 块 − 16 块广场/道路铺装，与设计一致） | ✅ |
| 实例化道具 | 158（3 × InstancedMesh） | ✅ |
| 网格（合批后） | 6（flat + glow + water + 3 instanced） | ✅ |
| 材质（内容库 / 浏览器） | 3 / 5 | ✅ |
| draw call（浏览器 city 模式） | 12 / 70 | ✅ |
| 渲染三角形（含阴影，city 平视/俯视） | **132,842**（夜景 124,194；低角度全景 113,394） | ✅ |
| 降级占位 / 缺失内容线 | 0 / 0 | ✅ |
| `planCity` 确定性 | 同参两次 plan 逐字段一致 | ✅ |

> 与 Lead 审计表（01:21 版：A 63,624 / B 73,540 / C 72,460；rendered 132,746）相比，各项结构指标（units 69 / instanced 158 / meshes 6 / materials 3 / calls 12）完全一致；三角数因 01:26~01:42 的最后一轮修形（hall 重构、住宅幕墙、公园树冠）整体 **−384**，rendered **+96** —— **以本表为准**，审计表数字建议同步更新（R1）。

## 6. 最终页面截图复核 —— PASS

页面：`demo/city-content.html` 637,587 B / sha256 `9e1c5656…`（与 Lead 定稿一致，`window.__content.ready` 正常）；统一 `?ui=0&stats=0&labels=0` 干净画面；页面 JS 报错 **0**、missing 模块 **0**。

### 6.1 随机 10 机位（`/tmp/s29/b4-shot3.mjs` → `shots3.json`，图 `/tmp/s29/b4-review/clean-*.png`）

`clean-city-level`、`clean-city-overview`（俯 38~48°）、`clean-city-top`（俯 82~86°）、`clean-city-night`（C 夜）、`clean-city-ground`（贴地 4°）、`clean-park-t4v2`、`clean-landmark-t4v0`（夜）、`clean-landmark-t4v2`、`clean-industry-t3v2`、`clean-residential-t4v1`。

### 6.2 重点特写（`/tmp/s29/b4-shot5.mjs` → `shots-final.json`，图 `final-*.png`）

`final-res-t4v1-close`、`final-res-t3v0-close`、`final-hall-t4v0-close`、`final-hall-t4v1-close`、`final-wheel-front`、`final-park-t4v1`。

### 6.3 逐项判定

| 判据 | 结论 | 依据 |
|---|---|---|
| 楼体穿地 / 悬空整栋 | ✅ 无 | 贴地机位与俯视均无；全部单元局部 minY=0（§4.1） |
| 窗户/幕墙浮离墙面 | ✅ 无（P1 修复后） | 住宅 T4 板式特写：玻璃条带与楼体贴合、只高出楼体 0.012~0.014，顶部不再冒出屋顶 |
| **住宅 T3/T4 幕墙条带** | ✅ 已修复 | T3 几何 12.00 / T4 17.60 精确等于承诺高度；`final-res-t4v1-close.png` 可见条带完整落在楼体高度内 |
| **市政厅钟塔与主楼衔接** | ✅ 正常 | `final-hall-t4v1-close.png`：主楼 8 层 + 钟塔（塔座/腰线/壁柱/红穹顶/天线）落在主楼屋面上，无错位/穿插 |
| 地块互相穿插 / 重叠 | ✅ 无 | `clean-city-top.png`：17×5 街区网格、街间距均匀，公园/地标/工业按分区落位 |
| 公园三件套可读性 | ✅ 已改善（P2-3 关闭） | 树冠缩小后 `final-park-t4v1.png` 可清楚看到喷泉池、铺装步道、长椅、路灯 |
| 水景/铺装共面闪烁 | ✅ 无 | 水面低于池沿、铺装高于草地 0.02，静态多角度无 z-fighting |
| 地标观景轮辨识度 | ⚠️ P2（不阻塞） | 正视可识别（`final-wheel-front.png`），但椭圆环无厚度 + A 字架极细，侧视角度退化成一条线 |

## 7. 问题清单（P0 / P1 / P2）

### P0（越界 / 数据损坏 / 崩溃）：无

### P1-1 住宅 T3/T4 幕墙条带悬空 + 几何超高 —— ✅ 已修复并复验（本次复核最有价值发现）

- 原问题：`tier-residential.ts` 的 `t>=3` 分支把底锚 `box()` 的 y 当成中心用（`yMid = baseH + bodyH*0.5 + 0.02`），导致玻璃条带底边在楼体半高、顶边伸出屋顶；T3 几何 15.134 vs 承诺 12（+26.1%）、T4 几何 21.594 vs 17.6（+22.7%），18 个单元受影响；19/19 测试之所以没抓到，是因为当时 `auditUnit` 不校验几何 maxY。
- 修复（Lead，01:42）：4 处条带改底锚 `baseH + (bodyH - sh) * 0.5`；hall 同类问题一并修；`auditUnit` 新增 `|maxY − 承诺 h| ≤ max(0.08, 12%)` 校验。
- 复验：本报告 §4.2 全量扫描 270 单元，**0 个越 ±12%**（住宅 T3 = 12.00、T4 = 17.60）；`final-res-t4v1-close.png` 条带贴合；官方 verify 270 单元全 PASS。

### P2-1 预览页档位文案（主 caption 已修，尾注保留通用档名）—— 不阻塞

- `content-main.ts` 现显示「住宅 · T4 档 · 变体 v1 ｜ 住宅塔·板式 ｜ T4 地标塔 足迹…」，主档名已按类正确；尾部的「T4 地标塔」为 `TIER_NAME` 通用档名，属故意保留的对照信息。
- 遗留观感：公园/工业等非住宅类看到「T4 地标塔」仍可能误解为档名 —— 建议下轮把尾注改为「通用档名：…」或按类取 `*_TIERS[tier].note`。

### P2-2 grid 总览视图 draw call 超预算显示 —— 不阻塞

- `grid` 模式（30 单元铺网格）浏览器读数 91 call > 70，UI 红字；这是 catalogue 视图，游戏内 city 模式 12 call，不影响交付。

### P2-3 地标 v2 观景轮侧视退化为线 —— 不阻塞（可选优化）

- 正视像观景轮（`final-wheel-front.png`），侧视像细塔；如需改善可加厚环（双环/管状）或加宽 A 字架截面。当前不影响功能、预算、验收。

### P2-4（记录）住宅 A.t1 三角形 348 < 400 下限

- 预算下限建议，`auditUnit` 不校验下限；Lead 已知。

## 8. 遗留风险

| # | 风险 | 等级 | 说明 / 缓解 |
|---|---|---|---|
| R1 | 审计表三角数/渲染数已过期 | 低 | 以本报告 §5 为准（A 63,240 / B 73,156 / C 72,076；rendered 132,842）；建议 Lead 更新 `微信复刻审计.md` |
| R2 | 几何高度曾无自动化守护 | 已缓解 | Lead 已把 maxY 校验并入 `auditUnit`，270 单元覆盖 |
| R3 | contract.ts 原版不在磁盘，无法字节级证明「只增」 | 低 | 已人工核对新增接口 + tsc 0 报错 + 无删除既有导出；如需强证可向 Lead 索取开工备份 |
| R4 | 软渲染截图 FPS 低（14~46）不代表真机 | 低 | 仅观感验收；性能以 Node 几何口径 + renderer.info 为准 |
| R5 | 观景轮侧视 P2 观感 | 低 | 可选优化，不阻塞交付 |

## 9. 复现命令

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

node /tmp/s29/boundary.mjs                          # ① 边界 sha256
./node_modules/.bin/tsc --noEmit -p tsconfig.json    # ② 类型
node --test test/city-content.test.mjs               # ③ 测试
node /tmp/s29/b4-review.mjs                          # ④ 36 单元造型抽查 + 全城对照
node /tmp/s29/b4-height.mjs                          # ⑤ 270 单元几何高度全量扫描
node /tmp/s29/b4-shot3.mjs                           # ⑥ 最终页面随机 10 机位
node /tmp/s29/b4-shot5.mjs                           # ⑦ 关键特写（住宅 T3/T4、市政厅钟塔、观景轮、公园）
```

## 10. 复核证据索引

| 类别 | 路径 |
|---|---|
| 边界 | `/tmp/s29/b4-review/boundary.txt`、`/tmp/s29/boundary.mjs` |
| 类型/测试 | `/tmp/s29/b4-review/tsc.log`、`/tmp/s29/b4-review/test.log` |
| 造型/全城 | `/tmp/s29/b4-review/shape-review.txt`（含全城 A/B/C 三段读数） |
| 几何高度 | `/tmp/s29/b4-review/height-audit.txt`（修复前）、`height-audit2.txt`（修复后） |
| 截图 | `/tmp/s29/b4-review/clean-*.png`（10）、`final-*.png`（6）、`shots3.json`、`shots-final.json` |
| 交付证据 | `tasks-out/S-29/evidence/` 99 张、`demo/city-content.html`（sha256 9e1c5656…） |
