# S-40 · CITY_API 装配示例运行日志

- 生成时间：2026/10/29 01:19:24（北京时间）
- 运行时：Node v24.15.0 / esbuild 0.28.2
- 文档：/tmp/director-s40-web-20261029-0112/audit-engine/src/render/city/CITY_API.md
- 文档 sha256：f746973a6d32db992af27ed07911396cc9a5814bd7de7de6a4f2710c2bba6bfe
- 抽取代码块 sha256：aef5582da46d0c3e2762948682ff1168fc431cdc5ec40f9da93a843a67ddb04e
- 抽取代码行数：14 行（非空非注释）
- 路径解析：仅把示例里两条 import（游戏侧 './render/city/*'）解析到本树实际文件，示例逻辑与语句未改
- 打包产物：/tmp/director-s40-web-20261029-0112/audit/assembly-output/runtime/assembly-example.mjs（sha256 e12f272dff35afaba1346e2aa0146fd2bce4b7f34d17995c1822d19a63cf8a32）
- 期望点选：blocks[42] = id `b2-8`（坐标 x=0, z=0；由 layout.planBlocks(full85) 计算）

## 示例原文（从 CITY_API.md §2.3 原样抽出）

```ts
import * as THREE from 'three';
import { buildCity } from './render/city/city-contract';
import { planBlocks, BLOCK_PRESETS } from './render/city/layout';

const scene = new THREE.Scene(), raycaster = new THREE.Raycaster();
const settings: { style: 'A' | 'B' | 'C'; traffic: 0 | 1 | 2; ped: 0 | 1 | 2; hallTier: 0 | 1 | 2 | 3 | 4; seed: number } = { style: 'B', traffic: 1, ped: 1, hallTier: 3, seed: 20261027 };
const blocks = planBlocks(BLOCK_PRESETS.full85).blocks;
let city = buildCity({ blocks, ...settings });
scene.add(city.root);
const rebuild = () => { const next = buildCity({ blocks, ...settings }); scene.remove(city.root); city.dispose(); city = next; scene.add(city.root); };
const pick = (x: number, z: number) => { scene.updateMatrixWorld(true); raycaster.set(new THREE.Vector3(x, 200, z), new THREE.Vector3(0, -1, 0)); return raycaster.intersectObjects(city.pickables.map((p) => p.object), false)[0]?.object.userData.blockId ?? null; };
const old = city; settings.style = 'C'; rebuild();   // 换城 = dispose + 重建：之后一律用新实例
for (let i = 0; i < 30; i++) city.update(1 / 60);     // 更新也必须调新实例
console.log('新实例:', city !== old, '| 在场景:', city.root.parent === scene, '| 点选:', pick(blocks[42].x, blocks[42].z), '|', city.stats.triangles, city.density);
city.dispose();
```

## 实际运行输出

```text
新实例: true | 在场景: true | 点选: b2-8 | 95216 {"traffic":1,"cars":14,"ped":1,"pedestrians":28,"props":241}
```

## 断言

| 断言 | 结果 | 实测 |
|---|---|---|
| 示例代码行数 ≤ 20（按非空非注释行计） | ✅ | 14 行 |
| 退出码 0（无抛错） | ✅ | exit=0 |
| 换城后指向新实例（city !== old 为 true） | ✅ | 新实例: true | 在场景: true | 点选: b2-8 | 95216 {"traffic":1,"cars":14,"ped":1,"pedestrians":28,"props":241} |
| 新实例已在场景（root.parent === scene） | ✅ | 新实例: true | 在场景: true | 点选: b2-8 | 95216 {"traffic":1,"cars":14,"ped":1,"pedestrians":28,"props":241} |
| 点选结果精确等于 blocks[42].id = b2-8（不是宽松非空） | ✅ | 新实例: true | 在场景: true | 点选: b2-8 | 95216 {"traffic":1,"cars":14,"ped":1,"pedestrians":28,"props":241} |
| 示例通过 tsc --strict 类型检查（0 错） | ✅ | exit 0 |
| 反例（配置写死 as const 再赋 C）能被 tsc 抓出（TS2322/2345） | ✅ | 已报错 |
| 构建统计为真实数字（三角形 ≥ 10000） | ✅ | 新实例: true | 在场景: true | 点选: b2-8 | 95216 {"traffic":1,"cars":14,"ped":1,"pedestrians":28,"props":241} |

**结论：示例可原样执行，换城后 update/pickables 指向新实例（root.parent===scene 为 true，且点选到真实 blockId）**
