# S-40 命名与源码映射（编号发布后稳定，不因排序/改名重编号）

## 编号规则

```
RES-T{tier}-V{variant}    住宅      buildResidential      src/render/city/tier-residential.ts
COMB-T{tier}-V{variant}   商业楼    buildCommercial       src/render/city/tier-commercial.ts
COM-T{tier}-V{variant}    商业步行街 buildCommercialStreet src/render/city/commercial.ts
COMD-T{tier}-V{variant}   商业街区组合 buildCommercialDistrict src/render/city/commercial.ts
HALL-T{tier}-V{variant}   市政厅    buildHall             src/render/city/hall.ts
PARK-T{tier}-V{variant}   公园      buildPark             src/render/city/park.ts
LAND-T{tier}-V{variant}   地标      buildLandmark         src/render/city/landmark.ts
IND-T{tier}-V{variant}    工业      buildIndustry         src/render/city/industry.ts
PROP-{TREE|LAMP|BENCH|PLANTER}-01  道具（提取 InstancedMesh 单实例） src/render/city/props.ts
CAR-{SEDAN|VAN}-01                 车辆（同上）                    src/render/city/traffic.ts
PED-PEDESTRIAN-01                  行人（同上）                    src/render/city/pedestrians.ts
```

## 单项映射（前 30 条示例，全量见 `素材清单.json` / `素材总表.md`）

| 编号 | 中文名 | 源文件 | 源工厂 | 参数 |
| --- | --- | --- | --- | --- |
| SCN-BASE-01 | 基座石板 | src/render/city/city-contract.ts（内部函数，构建期虚拟导出；生产文件未改） | buildGround 基座 add → 原参数重放 | tier=null, variant=null, style=B, row=0, col=0 |
| SCN-FOUNTAIN-01 | 完整喷泉 | src/render/city/city-contract.ts（内部函数，构建期虚拟导出；生产文件未改） | buildPlazaWater 原样调用 | tier=null, variant=null, style=B, row=0, col=0 |
| SCN-GRASS-01 | 草地块面 | src/render/city/city-contract.ts（内部函数，构建期虚拟导出；生产文件未改） | buildGround 草地块面 add → 原参数重放 | tier=null, variant=null, style=B, row=0, col=0 |
| SCN-ISLAND-01 | 浮岛（草地台面 + 岩壁 + 沙滩环带 + 浅水环） | tools/city-demo/demo-main.ts（旧只读 demo 环境，非 src/render/city 内容库） | demo-main.ts buildIsland()（逐字提取，原函数实调） | tier=null, variant=null, style=B, row=0, col=0 |
| SCN-PLAZA-01 | 广场砖块面 | src/render/city/city-contract.ts（内部函数，构建期虚拟导出；生产文件未改） | buildGround 广场砖 add → 原参数重放 | tier=null, variant=null, style=B, row=0, col=0 |
| SCN-ROAD-MAIN-01 | 主路路面 | src/render/city/city-contract.ts（内部函数，构建期虚拟导出；生产文件未改） | buildGround 主路 add → 原参数重放 | tier=null, variant=null, style=B, row=0, col=0 |
| SCN-ROAD-MINOR-01 | 次路路面 | src/render/city/city-contract.ts（内部函数，构建期虚拟导出；生产文件未改） | buildGround 次路 add → 原参数重放 | tier=null, variant=null, style=B, row=0, col=0 |
| CAR-SEDAN-01 | 轿车 | src/render/city/traffic.ts | buildTraffic→InstancedMesh[0] | tier=null, variant=0, style=B, row=0, col=0 |
| CAR-VAN-01 | 厢式车 | src/render/city/traffic.ts | buildTraffic→InstancedMesh[0] | tier=null, variant=0, style=B, row=0, col=0 |
| PROP-BENCH-01 | 长椅 | src/render/city/props.ts | buildProps→InstancedMesh[0] | tier=null, variant=0, style=B, row=0, col=0 |
| PROP-LAMP-01 | 路灯 | src/render/city/props.ts | buildProps→InstancedMesh[0] | tier=null, variant=0, style=B, row=0, col=0 |
| PROP-PLANTER-01 | 花坛 | src/render/city/props.ts | buildProps→InstancedMesh[0] | tier=null, variant=0, style=B, row=0, col=0 |
| PROP-TREE-01 | 行道树 | src/render/city/props.ts | buildProps→InstancedMesh[0] | tier=null, variant=0, style=B, row=0, col=0 |
| COM-T0-V00 | 商业步行街 · 商业 步行街·直街 | src/render/city/commercial.ts | buildCommercialStreet | tier=0, variant=0, style=B, row=0, col=0 |
| COM-T0-V01 | 商业步行街 · 商业 步行街·T 字口 | src/render/city/commercial.ts | buildCommercialStreet | tier=0, variant=1, style=B, row=0, col=0 |
| COM-T0-V02 | 商业步行街 · 商业 步行街·小广场 | src/render/city/commercial.ts | buildCommercialStreet | tier=0, variant=2, style=B, row=0, col=0 |
| COM-T1-V00 | 商业步行街 · 商业 步行街·直街 | src/render/city/commercial.ts | buildCommercialStreet | tier=1, variant=0, style=B, row=0, col=0 |
| COM-T1-V01 | 商业步行街 · 商业 步行街·T 字口 | src/render/city/commercial.ts | buildCommercialStreet | tier=1, variant=1, style=B, row=0, col=0 |
| COM-T1-V02 | 商业步行街 · 商业 步行街·小广场 | src/render/city/commercial.ts | buildCommercialStreet | tier=1, variant=2, style=B, row=0, col=0 |
| COM-T2-V00 | 商业步行街 · 商业 步行街·直街 | src/render/city/commercial.ts | buildCommercialStreet | tier=2, variant=0, style=B, row=0, col=0 |
| COM-T2-V01 | 商业步行街 · 商业 步行街·T 字口 | src/render/city/commercial.ts | buildCommercialStreet | tier=2, variant=1, style=B, row=0, col=0 |
| COM-T2-V02 | 商业步行街 · 商业 步行街·小广场 | src/render/city/commercial.ts | buildCommercialStreet | tier=2, variant=2, style=B, row=0, col=0 |
| COM-T3-V00 | 商业步行街 · 商业 步行街·直街 | src/render/city/commercial.ts | buildCommercialStreet | tier=3, variant=0, style=B, row=0, col=0 |
| COM-T3-V01 | 商业步行街 · 商业 步行街·T 字口 | src/render/city/commercial.ts | buildCommercialStreet | tier=3, variant=1, style=B, row=0, col=0 |
| COM-T3-V02 | 商业步行街 · 商业 步行街·小广场 | src/render/city/commercial.ts | buildCommercialStreet | tier=3, variant=2, style=B, row=0, col=0 |
| COM-T4-V00 | 商业步行街 · 商业 步行街·直街 | src/render/city/commercial.ts | buildCommercialStreet | tier=4, variant=0, style=B, row=0, col=0 |
| COM-T4-V01 | 商业步行街 · 商业 步行街·T 字口 | src/render/city/commercial.ts | buildCommercialStreet | tier=4, variant=1, style=B, row=0, col=0 |
| COM-T4-V02 | 商业步行街 · 商业 步行街·小广场 | src/render/city/commercial.ts | buildCommercialStreet | tier=4, variant=2, style=B, row=0, col=0 |
| COMB-T0-V00 | 商业楼 · 商业 小卖部 | src/render/city/tier-commercial.ts | buildCommercial | tier=0, variant=0, style=B, row=0, col=0 |
| COMB-T0-V01 | 商业楼 · 商业 报刊亭 | src/render/city/tier-commercial.ts | buildCommercial | tier=0, variant=1, style=B, row=0, col=0 |

## seed 语义（如实）

- 建筑：`BuildUnitOpts` **不接收外部 seed**；`unitRng(cls, tier, variant, row, col)` 派生微差。清单写「不适用」，不假填 seed=42。
- 道具/车/人：原型几何与 seed 无关；整城实例数由 `buildCity({seed:42, traffic:1, ped:1})` 派生。seed 改变布局/数量/朝向/实例缩放与染色，属"无限变化维度"，不穷举。
- `buildCity.seed` 仅在 block 未指定 variant 时参与变体选择；本目录每个建筑条目都显式指定 variant，故与 seed 无关。

## 变体 canonical 范围

- 每个建筑类 canonical 变体 = **3**（variant 0/1/2），由工厂内部 `variant === 0/1/2` 分支实现；
- 超出 0..2 的 variant 只产生 rng 微差（几何签名可能不同），**不列为 canonical 素材**；
- 三画风 A/B/C 为同一几何的配色配置，不重复计数（`city-contract` 测试断言三画风顶点逐位一致）。

## 单位与方向说明

尺寸为原CITY_API §3的世界单位；不把1世界单位等同1米，未对数值或模型做缩放转换。旧字段尺寸米已改为尺寸世界单位（schemaVersion=2）。四视图按统一世界坐标的+Z/-Z/+X/+Y方向取景；提取原实例保留原instanceMatrix朝向，因此长椅等物品的使用正面与统一轴向标签可能不一致，此项已由U1-04交机主裁量，未自动转动原型。
