# S-29 城市建筑内容库 · 说明

> 生成：2026-10-23（北京时间）｜工作树：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm041-city2`
> 一句话：**给城市补齐「从村舍到地标塔」的 6 条内容线（5 档 × 3 变体 × 3 风格），外加一条 85 块满铺的街区布局规则和一个可独立打开的预览页。**

---

## 1. 怎么打开（10 秒）

```
双击：/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/tasks-out/S-29/demo/city-content.html
```
- 单文件 **622.6 KiB**（637,587 B，gzip 170,586 B），零外链、零网络请求，`file://` 直接可开。
- 默认 **B 细节派**风格；顶部栏切「单栋 / 按类 / 按档 / 总览 / 街区 85 块」，右侧切风格 A/B/C、夜景、线框、透视、统计。
- 拖拽旋转、滚轮缩放；快捷键 `1-5` 切模式、`A/B/C` 换风格、`N` 夜景、`W` 线框、`X` 透视、`S` 统计、`R` 复位。
- URL 参数（截图/自动化用）：`?mode=city&style=B&night=0&cls=park&tier=3&variant=1&ui=0&stats=0&labels=0`。
- 自动化 API：`window.__content.setView(...) / setCamera({yaw,pitch,dist,targetY}) / screenshotReady() / stats() / view() / labels()`。

## 2. 内容清单（6 类 × 5 档 × 3 变体 = 90 种单元）

| 内容线 | T0 | T1 | T2 | T3 | T4 |
|---|---|---|---|---|---|
| **住宅** `tier-residential.ts` | 村舍：1~2 层坡顶 + 烟囱 + 院墙栅栏 + 院中小树 | 低层小楼：4~5 层 + 女儿墙 + 水箱 + 单元门头 + 晾衣杆 | 多层公寓：10 层 + 阳台阵列 + 空调外机 + 屋顶机房 + 天线 | 高层住宅：16 层板式/点式 + 密集竖窗 + 裙房 + 塔冠 + 直升机坪 | 住宅塔：24 层瘦高 + 冠部收分 + 避难层色带 + 空中花园 + 尖顶 |
| **商业** `tier-commercial.ts` | 小卖部/报刊亭/奶茶店：单层 + 大橱窗 + 遮阳棚 + 竖招牌 + 门外冰柜 | 2 层底商：通高玻璃 + 遮阳棚阵列 + 二层招牌带 + 台阶 | 3~4 层商场：玻璃横窗带 + 入口雨棚/自动门 + 屋顶广告牌 + 机组 | 12~14 层写字楼：玻璃幕墙 + 密集竖梃 + 楼冠 + 女儿墙机房 | 22~24 层商业塔：退台冠 + 竖向霓虹条带 + 顶部大屏 + 空中大堂挑台 |
| **市政** `hall.ts` | 村镇办事所：单层 + 小广场 + 一根旗杆 | 镇政厅：两层 + 门廊方柱 + 矮钟塔 | 市政厅：三层 + 对称正立面 + 钟塔四面钟盘 + 广场花坛 | 市议会：四层 + 大台阶 + 六柱柱廊 + 高钟塔 + 两侧旗杆 | 都会市政厅：五层 + 两翼 + 主塔收分 + 尖顶 + 四旗杆 + 灯柱广场 |
| **公园** `park.ts` | 街角绿地：草地 + 小喷泉 + 1 长椅 + 3 树 | 社区公园：环形步道 + 喷泉 + 3 长椅 + 5 树 | 城市公园：铺装广场 + 中央喷泉 + 十字步道 + 树篱 + 路灯 | 中央公园：大喷泉 + 环形步道 + 树阵 + 雕塑 + 长椅阵列 | 都会公园：台地 + 喷泉群 + 观景平台 + 密林 + 灯带 |
| **地标** `landmark.ts` | 钟楼/小灯塔（石台阶 + 钟面 + 挑台 + 尖顶） | 观景塔（细身塔 + 全景挑台） | 电视塔雏形（收分圆塔 + 圆盘观景舱 + 多段天线） | 电视塔/地标塔（双层观景舱 / 幕墙竖梃 + 发光冠带） | 都会地标塔 / 观景轮（22 高，悬挑观景台 / 椭圆观景环 + 10 吊厢） |
| **工业码头** `industry.ts` | 小作坊（单跨锯齿 + 小烟囱） | 仓库（长条坡顶 + 装卸平台 + 通风帽） | 厂房 + 烟囱（多跨锯齿 + 砖烟囱 + 灰烟团） | 厂区 + 龙门吊（+ 集装箱 + 小仓库） | 码头综合体（2 垛×4 层集装箱 + 大龙门吊 + 仓库 + 烟囱） |

**每档 3 变体**：住宅 点式/板式/带裙房（T0 独栋/联排/带院）；商业 平顶/退台/转角 L 形；市政 对称主塔/带两翼/穹顶塔冠；公园 绿地林荫/喷泉广场/水景步道；地标 地标塔/电视塔/观景轮；工业 厂房/仓库/堆场吊机。
变体由 **确定性哈希** 选：`pickVariant(cls, row, col, 3)` → 相邻地块必然不同（同档不重样）。

**三风格**（同一套几何 + 三套色板/造型倾向，全部可跑）：
- **A 清爽卡通**：暖米色墙 + 圆润坡顶 + 厚块面 + 高饱和点缀
- **B 细节派（默认）**：冷灰蓝墙 + 竖向窗格/阳台/空调外机/栏杆/招牌小构件最密
- **C 霓虹夜景**：深色墙 + 发光条带/大屏/航标灯 + 夜间最亮（glow 顶点色，不用贴图）

## 3. 街区布局规则（`blocks.ts`，机主点名的「布局规则」）

- **规模**：`BLOCK_PRESETS.full85` = 17×5 = **85 块**（机主要的满铺规模），另有 `island9`（9×9=81）、`cbd3`（7×7=49）、`strip`（11×3=33，商业带）。
- **分区**：按归一化半径 `r = hypot((col-cx)/(cols/2), (row-cy)/(rows/2))`：
  `r<0.38` → **CBD**（tier 3~4 高楼）｜`0.38≤r<0.72` → **中圈**（tier 2~3 商业/公寓）｜`r≥0.72` → **外圈**（tier 0~2 住宅），滨水最后一排 → 工业/码头。
  → 满铺实测：CBD 7 / 中圈 28 / 外圈 50，档位计数 T0 19 / T1 18 / T2 24 / T3 18 / T4 6（由中心向外递减）。
- **绿地穿插**：每 5 块留 1 块公园（相位由 seed 定），CBD 四周留广场；满铺实测公园 **16 块**、广场 16 块。
- **地标位**：中心 1 个 + 四角各 1 个 = **5 个**。
- **路网**：地块间距 `pitch = 3.2 + 0.9 = 4.1`；每 3 列/行一条主路（宽 1.4），其余次路 0.9；满铺 20 段（主路 6）。
- **变体去重**：相邻地块变体撞车时 `+1` 重算。
- **可映射回六边形岛**：`fitToIsland(plan, scale)` 等比缩放（full85 → `scale=0.335`，85×4 个地块角全部落在岛内切圆内）。
- **纹理化输出**：`planCity()` 是纯函数（同参数逐字段一致），可在 Node 里单测、可序列化给存档。

## 4. 性能与微信复刻（详见 `微信复刻审计.md`）

- 单单元：三角形 348~2,580（上限 2,600）、2 网格、2 材质（共享 flat + glow）。
- 全城 85 块：几何 **73,156** 三角（A 63,240 / C 72,076）/ 合批 6 网格 / 158 个实例化道具 / 材质 3；浏览器实测（含阴影 pass）**132,842 三角、12 draw call**；`shadowMode:'key'` 时 100,610 三角 / 13 call。
- 接进游戏的三方案：85 块 + 只关键楼投影 **100,610**（推荐，含既有场景约 135k）；85 块全投影 132,842（+既有 ≈ 167k 超）；49/33 块全投影 ≈ 110k / 92k。
- 纯程序化、零贴图、无 BigInt；顶点属性内存 ≈ 6.9 MiB；首帧构建 Node 0.1~0.6 s。

## 5. 待机主确认的 5 个问题（影响 0.4.1 接入）

1. **默认风格**：0.4.1 是否就定 **B 细节派**为默认（A/C 保留可切）？B 构件最多、单城三角形也最高（73.5k），A 最低（63.6k）。
2. **阴影策略**：85 块满铺时，接受「只关键楼投影」（地标/市政/tier≥3，预计 115~130k，留 13~23% 余量）吗？还是要全场阴影（需减块到 49/33，或关街道道具/车流阴影）？
3. **摩天轮**：地块足迹上限 2.96 摆不下「真圆大轮」，现在 T3/T4 的 v2 是**竖向椭圆观景环 + 高 A 字架**的观景轮塔（T0/T1 是真圆轮）。要么保持现状，要么给地标单独开放的 4×4 地块（我可加）。
4. **档位映射**：游戏内建筑等级 → 内容库档位，建议 `L1→T0、L2→T1、L3→T2、L4→T3、L5+→T4`（区块等级决定该地块 tier，升级时换模型）。是否按这个映射接？
5. **市政厅与公园的地块位置**：现在市政厅固定在 CBD 中心、公园按「每 5 块 1 块」确定性穿插。是否要求市政厅固定在地图正中 / 公园必须成片？以及招牌要不要**文字**（当前全是几何色块，无文字纹理，微信可复刻）。

## 6. 已知限制（不影响验收）

- 住宅 T0 最简变体 348 三角（低于自定「≥400」的下限建议，属观感取舍，不是预算超标）。
- 「报告高度 vs 实际几何」已用 `auditUnit` 的 `|maxY−h| ≤ max(0.08, 12%)` 校验锁死（270 个单元全 PASS）。
- 商业区 `buildCommercialDistrict` 是 3×3 地块组合体（9.6×9.6），**不进 blocks.ts 单地块循环**；单地块商业请用 `buildCommercial` 或 `buildCommercialStreet`（步行街足迹 2.92，属「地块级」单元，按 `footprintFor` 严格校验需豁免）。
- 公园档高在 `CLASS_HEIGHT.park` 的 ±12% 内微调为 2.02/2.27/2.55（原曲线相邻比 1.09 会被「肉眼可分」判据卡住）。
- 招牌/门牌无文字（几何色块），摩天轮非真圆（见问题 3）。
- 预览页是**独立入口**，S-26 原 demo（`tasks-out/S-26/demo/`）未改动、仍可打开。

## 7. 验证与证据

- 预览页：`demo/city-content.html`（构建命令 `node tools/build-city-content.mjs`）。
- 截图证据：`evidence/`（**99 张**：90 张 6 类 × 5 档 × 3 变体 + 6 张三风格三联 + 3 张街区满铺 day/night/top；读数见 `evidence/读数.md` 与 `evidence/metrics.json`）。
- 测试：`node --test test/city-content.test.mjs`（契约/六线/档位/布局/预算/静态纪律/预览页/截图齐全）。
- 自检器：`/tmp/s29/verify.mjs <模块> <导出> <类>`（3 风格 × 5 档 × 3 变体 = 45 单元逐条审计）。
- 子智能体报告：`子智能体报告/B2.md`、`B3-park.md`、`B4.md`、`B5.md`；独立复核：`独立复核报告.md`（B4b 对抗验收：**PASS 11 / FAIL 0，P0=0、P1=0**；212 条 sha 边界比对 211 匹配 + 仅 contract.ts 有意改动；随机 10 机位 + 6 特写无穿模/悬空）。
- 复核截图：`evidence/independent/`（16 张随机机位/特写 + 边界/高度审计日志）。
- 微信复刻审计：`微信复刻审计.md`（含复现命令与接入换算）。
