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

- 生成时间：2026/10/27 22:05:54（北京时间）
- 运行时：Node v24.15.0 / esbuild 0.28.2
- 文档：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm044-city/src/render/city/CITY_API.md
- 文档 sha256：587d095b95da35bfc040ca916a942dd25c59d3742d0caaeaee8e8c993d66d68c
- 抽取代码块 sha256：aef5582da46d0c3e2762948682ff1168fc431cdc5ec40f9da93a843a67ddb04e
- 抽取代码行数：14 行（非空非注释）
- 路径解析：仅把示例里两条 import（游戏侧 './render/city/*'）解析到本树实际文件，示例逻辑与语句未改
- 打包产物：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/tasks-out/S-40/Lead/runtime/assembly-example.mjs（sha256 dcdc967b4e001b125b39a918597abf457581b513234083c1d2f9dab059306ccb）
- 期望点选：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 | 86420 {"traffic":1,"cars":14,"ped":1,"pedestrians":28,"props":241}
```

## 断言

| 断言 | 结果 | 实测 |
|---|---|---|
| 示例代码行数 ≤ 20（按非空非注释行计） | ✅ | 14 行 |
| 退出码 0（无抛错） | ✅ | exit=0 |
| 换城后指向新实例（city !== old 为 true） | ✅ | 新实例: true | 在场景: true | 点选: b2-8 | 86420 {"traffic":1,"cars":14,"ped":1,"pedestrians":28,"props":241} |
| 新实例已在场景（root.parent === scene） | ✅ | 新实例: true | 在场景: true | 点选: b2-8 | 86420 {"traffic":1,"cars":14,"ped":1,"pedestrians":28,"props":241} |
| 点选结果精确等于 blocks[42].id = b2-8（不是宽松非空） | ✅ | 新实例: true | 在场景: true | 点选: b2-8 | 86420 {"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 | 86420 {"traffic":1,"cars":14,"ped":1,"pedestrians":28,"props":241} |

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