S-40-U1

# S-40 · U1「玩家视角锐评」（只评画面与可玩感，不判通过/不通过）

> **评审绑定（稳定快照）**：`C4/metrics.json` 的 `generatedAt=2026/10/27 21:38:12（北京时间）`、`shot.mjs sha256=a7fee7a5dba7a38046f280cbb568c71859d29af2231b4033303c06f51e8d9654`、`HTML sha256=22b148daf7fcc7bb5e84034f2a9a52568ab7b7836f2b3b639698c7edfd30884b`。
> 30 张正式截图逐张 sha256 见 `U1/输入快照sha256.txt`；只读快照副本在 `U1/输入快照/`（30 图 + metrics.json + 性能表.md + 覆盖矩阵.md，共 33 文件，与源文件逐个 `cmp` 一致；其中性能表为**勘误后版本**，见文末「输入绑定与版本」）。
> **未引用中间刷新轮次**：我读图时工具返回的 sha 与本报告定稿时的快照 sha **30/30 一致**（含 21:35–21:38 出图的 01–30），因此本报告全部结论直接绑定上述最终快照。
> 证据裁剪图全部由**已有截图**用 ImageMagick 裁剪/放大生成（不重跑 demo、不改源图、不重建 HTML）；源系统无 PIL，故未用 Python。
> 生成时间：**2026-10-27 22:00（北京时间，`date` 实读输出原样写入）**；性能表勘误版绑定见文末「输入绑定与版本」。

## 一句话总评（玩家视角）

**这是一座"远看挺能打、拉近就露怯"的卡通岛**：白天 A/B 画风认楼和天际线成立，车走车道、人走人行道；但 **C 夜景黑到不可用**（俯视 96.7% 像素近黑），**满岛俯视读不出中心区和主次路网**，**"滨水码头"没有码头**，**车流/行人关低高三档在默认视角下基本无感**；点击语义文档大体够用，但"85 块 vs 69 个代理"等 3 个坑必须在 S-31 接线前说清。整体：**骨架合格、卖点打折、夜景拖后腿**。

---

## Q1 认楼：六类能否分辨？tier0..4 有没有等级感？

**结论：勉强。**（低档可认；高档"住宅/商业/写字楼"混淆；公园、工业的档位等级感弱；"码头"认不出）

**现象**

- **能认的**：
  - **住宅**低档（T0/T1）：坡屋顶村舍、小二层楼，满岛里成排橙色坡顶一眼是"住宅区"（`01-全景__A__车低人低.png` 画面中下部两排便道房；`06-全景__B__车低人低.png` 同区）。
  - **商业**低档（T0/T1）：雨棚 + 店面 + 竖招牌（`26-阶梯商业T0至T4__B.png` 左侧 T0/T1 芯片上方建筑），可认"商铺"。
  - **市政厅**：钟塔 + 金色钟面 + 前广场，全城唯一（`27-阶梯市政厅T0至T4__B.png`；`23-市政厅满级特写__B__车低人低.png` 画面中央塔身；`09-市政厅广场__B__车低人低.png` 中央钟塔）。
  - **公园**：绿地 + 树 + 步道 + 长椅，绿色方块在满岛里跳出来（`28-阶梯公园T0至T4__B.png`；`22-满岛85块俯视__B__车高人高.png` 网格里的绿色块）。
  - **地标**：摩天轮 / 电视塔 / 观景轮 / 超高塔，形态独一份，一眼"地标"（`29-阶梯地标T0至T4__B.png`；`06` 全景右端摩天轮、左侧电视塔）。
  - **工业**：锯齿屋顶厂房 + 烟囱，可认"工厂/仓库"（`30-阶梯工业码头T0至T4__B.png`；`10-滨水码头__B__车低人低.png` 前排三座锯齿顶厂房）。
- **认不出的 / 弱项**：
  - **高等级住宅 vs 商业塔**：`25-阶梯住宅T0至T4__B.png` 的 T2/T3/T4 是玻璃幕墙塔（无阳台、无住宅符号），`26` 的 T3/T4 也是玻璃塔（多橙色腰带/广告位）；并排放能靠橙色配件区分，混进满岛后玩家分不清哪栋是住宅哪栋是写字楼（`03-街区近景__A__车低人低.png` 两侧高楼同理）。
  - **"工业码头"不是码头**：`30` 的 T1–T4 全是锯齿顶仓库/厂房（无栈桥、无泊位、无吊机、无船），只有 T0 有一副小吊架；满岛滨水行（`05`/`10`/`22`）也没有任何伸向水面的结构 ⇒ 玩家只会读成"水边的厂房区"。
  - **等级感（矮→高、简→繁）**：
    - 住宅 1.5→17.6、商业 1.8→18.2、市政厅 2.4→10.4、地标 3.2→22.0：**高度阶梯成立**（`25`/`26`/`27`/`29`，五档肉眼可排出）。
    - **工业 T1→T3 几乎同款**：`30` 里 T1/T2/T3 都是同一座锯齿顶厂房放大 + 烟囱略高，只有 T4 明显换形态；"简→繁"不单调（T0 反而有吊架）。
    - **公园 T0→T4**：`28` 五座高度几乎一样（1.6→2.55），只能靠树/花坛数量辨别；且 T0–T2 的差别在整图尺度上很难看见（`28-公园全档-2x.png` 裁剪里 T0/T1 仍近似）。
    - **地标"物种跳变"**：摩天轮（T0/T1）→ 电视塔（T2）→ 观景轮（T3）→ 玻璃超高层（T4），见 `29-地标T2T3T4-1.5x.png`。高度等级清楚，但"同一个地标升级"的叙事断了，T4 还和商业塔撞脸。

**证据（截图 + 画面区域）**

| 判断 | 文件 | 区域 |
|---|---|---|
| 住宅低档可认 | `01-全景__A__车低人低.png` | 岛中下部两排橙色坡顶房（约 x 380–700, y 470–610） |
| 住宅 T2–T4 是玻璃塔 | `25-阶梯住宅T0至T4__B.png` | T2/T3/T4 三座（x≈650–1200, y≈330–760）；详图 `证据/25-住宅T2T3T4-2x.png` |
| 商业低档有招牌/雨棚 | `26-阶梯商业T0至T4__B.png` | T0/T1（x≈300–560, y≈610–700） |
| 商业 T3/T4 玻璃塔 | 同上 | T3/T4（x≈830–1200, y≈300–700） |
| 市政厅可认 | `27`、`23`、`09` | 钟塔 + 金色钟面（`09` x≈680–760, y≈100–620） |
| 公园档位差别弱 | `28-阶梯公园T0至T4__B.png` | 五座全排（x≈290–1230, y≈600–740）；详图 `证据/28-公园全档-2x.png` |
| 地标跳变 | `29-阶梯地标T0至T4__B.png` | T2 电视塔 / T3 观景轮 / T4 玻璃塔（x≈700–1200）；详图 `证据/29-地标T2T3T4-1.5x.png` |
| 工业同款 | `30-阶梯工业码头T0至T4__B.png` | T1–T4（x≈470–1230, y≈540–740）；详图 `证据/30-工业T1T2T3T4-2x.png` |
| 滨水排无码头形态 | `10-滨水码头__B__车低人低.png` | 前排厂房与岸线（x≈0–720, y≈540–740）；详图 `证据/10-滨水-前排-2x.png` |

**复现步骤**：打开 `tools/city-demo/dist/city-demo.html`（file://）→ 画风 B；**阶梯没有 UI 按钮，只能在地址后加 URL 参数 `?ladder=<类别>`** 进入（类别名：`residential`=住宅、`commercial`=商业、`civic`=市政厅、`park`=公园、`landmark`=地标、`industry`=工业码头；也接受中文类别名）→ 对照五档标签 T0..T4；满岛看 HUD 机位「全景/俯视」（这两个是按钮）。

**建议（玩家视角，不写实现方案）**
- 给住宅 T2–T4 加"一看就是住人"的符号（阳台/晾衣/屋顶花园/小窗密集），给商业 T3/T4 更重的商业符号（招牌、LED、雨棚一直做到高层）——**玩家要的是"扫一眼就知道这栋是什么、升没升级"**。
- 公园的升级要给一个"远远就能看见"的锚点（喷泉/雕塑/广场灯），而不是只在树的数量上加。
- 工业码头需要"临水"的硬符号：栈桥/泊位/吊机/船/岸壁，让玩家知道这片是靠水吃饭的。
- 地标要么统一成同族递进（每次升级加一个可指认部件），要么在 UI 里明说是"不同地标槽位"。

---

## Q2 满岛辨识：85 块全景里路网/街区/滨水/中心区能否一眼读出？

**结论：勉强。**（街区格子能读；**中心区读不出**、**主次路网读不出**；滨水只有"最后一排 + 水环"能读，且那排是仓库不是码头）

**现象**

- **85 块俯视（`22`）**：5 行 × 17 列的格子铺满长条岛，能看出"规划整齐的街区网格"；但：
  - **主次路无差别**：主路 1.4 / 次路 0.9（`CITY_API.md` §3），图上是同色同感的灰蓝条带，无标线、无路缘强调，3x 放大（`证据/22-满岛-路网3x.png`）也只能看到"格子缝"，读不出哪条是主干道；
  - **阴影把路面切成明暗段**：22 里大片平行斜向暗带压过街区（`截图说明.md` §6 已解释为楼体投影），玩家第一眼看到的是"斜纹"而不是路网（对比 `24-俯视关阴影__B__参照非验收.png` 同区：无阴影时街区/道路干净清楚，见 `证据/24-路网3x.png`）；
  - **中心区读不出**：正交俯视只有屋顶（`截图说明.md` §2），塔楼与村舍在图上都是小方块；CBD 的"中心高"完全无法从 22 读出，反而 16 块广场圆盘（灰圆环水池）看着像"空地/待开发地"；
  - 滨水：最后一排 + 沙环 + 水环可读，但那排是锯齿顶仓库（见 Q1/P1-3），不像码头。
- **全景（`01`/`06`）**：反向——中心塔群、滨水水线、地标位置靠天际线能读，但**路网被楼群挡掉**，只能读"街区团块"和街道峡谷（`03`/`08`）。
- 一句话：**俯视能读"格子"不能读"中心/主次路"，全景能读"中心"不能读"路网"。**

**证据**

| 判断 | 文件 | 区域 |
|---|---|---|
| 街区格子可读 | `22-满岛85块俯视__B__车高人高.png` | 全岛网格 x≈197–1240, y≈290–610 |
| 主次路同色、无标线 | 同上 | 中部任一路口（x≈560–860, y≈380–540）；`证据/22-满岛-路网3x.png` |
| 阴影切割路网 | 同上 | 全岛平行斜暗带；与 `24`（关阴影参照）同区对比 `证据/24-路网3x.png` |
| 中心区无高度信息 | 同上 | 中心 3×3（x≈620–820, y≈400–500）；`证据/22-满岛-中心区-2x.png` 对比 `证据/24-参照关阴影-中心区-2x.png` |
| 全景读中心/读不到路网 | `06-全景__B__车低人低.png` | 中央塔群（x≈600–900, y≈280–520）；街道被楼体遮挡（x≈500–700, y≈450–620） |
| 广场盘像空地 | `22` / `24` | 网格中多个"白底 + 灰圆盘"块（如 x≈540,y≈452） |

**复现步骤**：demo → 画风 B → 点 HUD 机位「俯视」（正交）看 85 块全图；**当前 UI 没有"关阴影"入口**，无阴影对照只能看取证参照图 `24-俯视关阴影__B__参照非验收.png`（截图脚本关闭 `renderer.shadowMap` 取证，非玩家可操作），用 22（默认带阴影）与 24（无阴影）同区比较判断阴影对可读性的影响；最后点「全景」看中心区与路网。

**建议（玩家视角）**：俯视图本质是"经营地图"，玩家要在 1 秒内看出"哪块空地、哪块 CBD、哪条是主街"——建议地图模式下压掉/弱化楼影，主次路用色差或中线区分，中心和地标给一个图例/色标；广场空地要让人看得出"这是广场不是空地"。

---

## Q3 夜景明暗：C 夜景是否过暗/过花？A/B 白天是否寡淡？

**结论：C 夜景"不行（过暗）"；"过花"不成立但近景偏刺眼；A/B 白天"可"，不算寡淡（A 略发白）。**

**现象**

- **C 过暗（硬数据）**：对整图做灰度统计（含 HUD 与控制条）：
  - `12-俯视__C__车低人低.png`：平均亮度 **4.1%**，**96.7%** 像素低于 8% 灰阶 ⇒ 画面几乎全黑，只能看到零星霓虹点，**路网、地块、植被、车人全部不可读**；
  - `11-全景__C__车低人低.png`：平均 **5.9%**，**94.1%** 像素 <8% ⇒ 城市只剩"霓虹轮廓"，体块全黑；
  - `13-街区近景__C__车低人低.png`：平均 26.7%、66.5% 像素 <8% ⇒ 楼体大面积纯黑，仅窗带发青光，地面/树/车/人几乎看不见；
  - `14`（市政厅广场 C）同量级（25.7%、65%）⇒ 市政厅主体黑成剪影，只剩粉色钟面和青色柱；
  - `15-滨水码头夜景__C__车低人低.png`：平均 10%、86.5% 像素 <8% ⇒ 天际线可看，但滨水细节全黑。
- **"过花"判断**：C 的发光条带边界清晰、没有 bloom 糊成一团（swiftshader 无 bloom），所以**不是"糊"**；但 `13`/`14` 近景里青/品红发光面几乎占满立面、主体全黑，对比偏刺眼——是"过艳"不是"过糊"。
- **A/B 白天**：`01`（A）平均亮度 73.4%、`06`（B）69.7%，对比度正常，**不算寡淡**；A 的奶油色 + 浅海天光偏粉彩，远处楼群与天空都发白、层次弱于 B（B 冷灰蓝 + 深窗格，立面细节更清楚）。

**证据**

| 判断 | 文件 | 区域 / 读数 |
|---|---|---|
| C 俯视全黑 | `12-俯视__C__车低人低.png` | 全图；mean 4.1%，96.7% <8% |
| C 全景只剩霓虹 | `11-全景__C__车低人低.png` | 全图；mean 5.9%，94.1% <8% |
| C 近景楼体纯黑 | `13-街区近景__C__车低人低.png` | 左右楼体立面（x≈450–1440, y≈0–700） |
| C 市政厅成剪影 | `14-市政厅广场__C__车低人低.png` | 中央钟塔（x≈620–820, y≈100–650） |
| C 滨水细节丢失 | `15-滨水码头夜景__C__车低人低.png` | 前排与岸线（x≈0–720, y≈540–740） |
| A 白天不寡淡但偏白 | `01-全景__A__车低人低.png`、`03-街区近景__A__车低人低.png` | 全图 / 楼体 |
| B 白天层次更好 | `06`、`08-街区近景__B__车低人低.png` | 全图 / 楼体 |

**复现步骤**：demo → HUD「画风 C」→ 机位「俯视」「全景」「街区近景」「市政厅广场」「滨水码头」（即 11–15）；再用「画风 A/B + 白天」看 01–10 对照。

**建议（玩家视角）**：夜景要把"能看懂城市"放第一位——至少让道路/水面/屋顶轮廓在夜里也分得出来（月光/城市环境光/路面反光），车灯与窗光作为点缀而不是唯一光源；给玩家一个"夜景亮度"选项。近景的发光面可以少一点、留一点低亮墙色，避免整面墙都在放电。

---

## Q4 车人：三档在画面上可区分吗？车像在路上吗？行人像在人行道吗？

**结论：行人"可"（近景），车流"勉强"；两者在默认全景/俯视下几乎无感；车基本在车道、朝向正确；行人基本在人行道，未穿楼、未站马路中央，个别贴花坛。**

**现象**

- **车流 关/低/高（`16`/`17`/`18`，B 全景，HUD 写着 0/14/30 辆）**：在 1440×900 全图上车体只有约 3–5 px，三张并排几乎看不出差别；把城区同区放大 4 倍（`证据/16-18-车流三档-城区同区-4x.png`）后，能看出"关=该区 0 车"、"低/高=路面上有橙色/红色小方块"，但**低 vs 高在同一小块区域分不出数量差**，要整城扫视 + 数点才行。玩家在默认视角不可能感知档位。
- **行人 关/低/高（`19`/`20`/`21`，B 街区近景）**：全图上行人也只有约 8–12 px；放大 4x（`证据/19vs21-行人关vs高-4x.png`）后差别明确：关=街道空；低=零星 2–3 人；高=成排人沿街往返。**但同样需要拉近才看得见**；C 夜景里车人几乎不可见（见 Q3）。
- **车像不像在路上**：`证据/21-行人高-人行道5x.png`（`21` 的 5x 裁剪）里——橙色轿车正对镜头、沿街方向摆放；紫色轿车侧向、与街道平行；两车都在灰色路面带内，未见压斑马线/穿楼。**唯一小瑕疵**：紫色车贴左侧路缘，约 1/3 车身视觉上压着路缘石（车道偏置 0.46×半路宽 + 车宽导致），近距离看略"蹭路牙"。
- **行人像不像在人行道**：同 5x 图里行人成排走在道路两侧、树列内侧的浅色人行道上，朝向沿街往返（有步态/朝向变化），**未见穿楼、未见站到马路正中**；一处米色行人紧贴绿色花坛/树池（脚部被挡），轻微穿模感（`证据/21-行人高-个体5x.png` 右中）。
- 另：**满岛俯视 22（车高人高）**里车/人只是路面上的彩色小点，能看出"有活动"，但分不出档位（依赖 HUD 数字）。

**证据**

| 判断 | 文件 | 区域 |
|---|---|---|
| 车流三档全景不可辨 | `16-车流关__B__全景.png`/`17-车流低__B__全景.png`/`18-车流高__B__全景.png` | 全城路面；放大对照 `证据/16-18-车流三档-城区同区-4x.png`（x≈520–880, y≈380–560 原图区） |
| 行人三档放大可辨 | `19-行人关__B__街区近景.png`/`20-行人低__B__街区近景.png`/`21-行人高__B__街区近景.png` | 街道纵深（x≈580–960, y≈560–770）；`证据/19vs21-行人关vs高-4x.png`、`证据/19-21-行人三档-街道同区-3x.png` |
| 车沿路朝向/位置 | `21-行人高__B__街区近景.png` | 黄橙色车（原图 x≈700–780, y≈720–770）、紫色车（x≈640–700, y≈780–830）；`证据/21-行人高-人行道5x.png` |
| 行人走人行道/贴花坛 | 同上 | 两侧树列内侧；`证据/21-行人高-个体5x.png`（x≈700–840, y≈600–720） |
| 俯视车人只是点 | `22-满岛85块俯视__B__车高人高.png` | 全岛路面小色点 |

**复现步骤**：demo → B → 车流依次 关/低/高（16–18，全景）；行人依次 关/低/高（19–21，街区近景）；要看清车人请放大原图或把相机拉近（demo 本身没有更近机位，这也是证据缺口）。

**建议（玩家视角）**：既然设置了"关/低/高"，玩家就应该在**默认视角**看出变化——可以让高档车流出现路口排队/车灯长龙、让行人档位带来广场人气/路口聚集，而不是只加几个小点；夜间给车尾灯/路灯下人形补光，否则夜景下车人等于不存在。车的贴路缘问题建议按车道宽收一点车宽或加大车道偏置。

---

## Q5 三画风：同机位 A/B/C 能否一眼看出区别？区别是否只在配色/灯光？

**结论：C 与 A/B 一眼可辨；A vs B 勉强（单看一张说不出，得并排/看 HUD）。区别确实只在配色/灯光，几何一致。另发现"画风与昼夜"两个变量被绑死，A/B 夜间、C 白天的组合没有截图。**

**现象**

- `01`(A)/`06`(B)/`11`(C) 同机位：C 是夜、A/B 是昼 ⇒ **C 与 A/B 差异巨大**；A/B 同为白天，A 奶油暖 + 绿顶 + 橙坡顶、B 冷灰蓝 + 橙配件 + 深窗格，并排能看出，但单看一张要靠 HUD 才知道是 A 还是 B。
- 同机位成对比较（`02/07/12`、`03/08/13`、`04/09/14`、`05/10/15`）：**楼体轮廓、窗格数量、屋顶/钟塔/摩天轮/厂房形态完全对应**，变化只有墙色/窗色/屋顶色、发光强度、天空/雾/水色 ⇒ "几何应完全一样"在画面上成立。Lead 侧 `预算实测.txt` 表 3 也给出三画风 position SHA256 相同（A/B/C 均 `245468f0cd16`）——与画面一致。
- **但**：11–15 全是 C=夜，01–10 全是 A/B=昼；**没有任何 A/B 夜景、C 白天的同机位图**。如果游戏里"画风"与"昼夜"是两个独立设置（`CITY_API.md` §2.1 `night?` 可选），那"C 画风白天"和"A 画风夜晚"长什么样，玩家没有证据——这正是 `性能表.md`/`覆盖矩阵.md` 口径的盲区。

**证据**

| 判断 | 文件 | 区域 |
|---|---|---|
| A vs B 差异小 | `01` vs `06`（全景）、`04` vs `09`（市政厅）、`05` vs `10`（滨水） | 全图并排；HUD「画风」行 |
| C 差异大（夜） | `11`–`15` | 全图；HUD「画风 C / 昼夜 夜」 |
| 几何一致 | `02/07/12`、`03/08/13`、`04/09/14`、`05/10/15` | 同机位楼体轮廓/窗格逐对核对 |
| 缺 A/B 夜、C 昼 | 01–15 的 HUD | 所有 HUD 都是「A/B=白天」「C=夜」 |

**复现步骤**：demo → 固定机位（如「市政厅广场」）→ 画风 A/B/C 依次切；再把「昼夜」单独切「夜晚/白天」看 A/B 夜、C 昼（页面支持，截图未覆盖）。

**建议（玩家视角）**：三种画风要能被玩家当成"三种皮肤"而不是"两种皮肤 + 一个夜景模式"——A/B 再拉开一档（窗色/屋顶色/铺装色的差异），或者明确把"C=夜景"写进画风描述；若昼夜是独立开关，请补 A/B 夜与 C 昼的样张，否则玩家选「C + 白天」时看到的可能不是宣传里的样子。

---

## Q6 可迁移点击语义：按 CITY_API 的 pickables 契约，"S-31 点楼→开抽屉"有没有明显坑？

**结论：契约语义成立，但有 3 个会直接导致"点不动/点错/回退后还响应"的坑，必须在 S-31 接线前写清；另有 3 个次要坑。**

**依据（只读文档 + 代码核对）**：`CITY_API.md` §6/§2.3/§7.5；`city-contract.ts` 617–643（代理生成）、357–378/534（hall 合并）；three 0.186.1 `src/core/Raycaster.js` 240–264（Raycaster 只查 layers，不查 visible）；`layout.ts` planBlocks 分类（plaza 无内容线）。

**坑（按严重度）**

1. **数量口径坑：85 块 ≠ 85 个代理。** 契约 §6 写"每个**有内容**的地块一条（plaza/grass/water/road 没有）"；演示满岛 `stats.blocks=85 / units=69 / placeholders=0`（`性能表.md`、所有 HUD 均显示"85 块 · 69 单元"）⇒ 实际 **pickables=69 条**，16 块 plaza 点不到。而 `迁移就绪清单.md` §3.4 写"85 个对象射线检测成本≈0.05ms"——口径不一致。**S-31 若断言 `pickables.length===85`、或直接沿用演示 `planBlocks` 的 kind 映射，就会有 16 块"点了没反应"**（玩家会以为点击坏了）。
2. **递归命中坑：只能对 pickables 数组射线，不能对 scene/root 递归。** 契约 §6 给了正确写法 `intersectObjects(pickables.map(p=>p.object))`，但没警告反例：城市楼体是**合并网格**（solid/glow/water）+ 道具/车人 InstancedMesh + demo 岛面，递归 `intersectObjects(scene.children, true)` 会先命中这些没有 `blockId` 的对象 ⇒ 抽屉拿不到 blockId，表现为"点楼没反应"或"偶尔能点、偶尔点不动"。
3. **回退可见性坑：`root.visible=false` 不能真正关掉点击。** 代理是 `material.visible=false`（不是 `object.visible=false`），three 0.186.1 的 Raycaster **完全不看 visible**（`src/core/Raycaster.js` 240–264 只查 layers）⇒ 按 §10 的 `rollback=classic` 用 `city.root.visible=false` 隐藏城市时，代理仍可被射线命中，抽屉还会打开旧城池块、甚至与老建筑高亮叠加。接线时必须"回退时同时跳过/移除 pickables"。
4. **市政厅高亮坑（与特写链路相关）**：`CITY_API.md` §2.2 说 `hall` "可挂升级确认高亮"；实现里 `hall = unit.group`，但该 group 的几何已在 `mergeUnit` 合并进 flat 网格并 `dispose`，group 本身没有进场景（`city-contract.ts` 357–378、534）。往 `hall` 上挂可视高亮**不会渲染**——只能拿它的 position 当锚点，由游戏侧自己画高亮。
5. **代理高度坑**：代理高 `h = CLASS_HEIGHT[kind][tier] × 1.05`；实际单元允许 ±12%（`content.ts` `heightRange` 0.88~1.12）⇒ 楼体最高约 6.7% 的高度在代理外（地标 T4≈1.5 单位、住宅 T4≈1.2 单位）。点楼身没问题，**点尖顶/屋顶最高一截可能 miss**。
6. **示例射线坑**：§2.3 示例里的 `pick(x,z)` 是"从 y=200 向下"的**俯视测试射线**；游戏点击必须 `raycaster.setFromCamera(ndc, camera)`。直接照抄示例当点击处理会全错（`性能表`/`Lead` 的装配示例断言 `blocks[42]→b2-8` 用的是这种俯视射线，只能证明语义，不证明点击实现）。
7. **换城/切画风 = dispose+重建**：旧 `city` 的 `pickables/update/density` 全部作废（§2.3 已写"两个真会踩的坑"）；S-31 若缓存了代理对象引用，换画风后点击会指向已释放的网格——需重建后重新取 pickables。

**证据**

| 判断 | 依据 |
|---|---|
| pickables 69 条（demo full85） | HUD「85 块 · 69 单元 · 0 占位」（`01`–`24` 等全部截图左下）；`性能表.md` §(a) `units=69`；另用 esbuild 把 `layout.ts` 打进 U1 临时文件实测：`planBlocks(full85)` = blocks 85 / roads 20 / byKind{residential19, commercial12, park16, industry17, landmark4, civic1, **plaza16**}/ byTier[19,18,24,19,5]，建筑类地块 **69**（= pickables 条数），临时文件已删 |
| 只能对 pickables 射线 | `CITY_API.md` §6、§10 点击清单；`迁移就绪清单.md` §3.1 |
| visible=false 代理仍可 raycast | three 0.186.1 `node_modules/three/src/core/Raycaster.js` 240–264（仅 `layers.test`） |
| hall 已合并/未入场景 | `city-contract.ts` 357–378（mergeUnit 合并并 dispose）、534（hall=unit.group） |
| 代理高 ×1.05 vs 实际 ×1.12 | `city-contract.ts` 622–625；`content.ts` `heightRange` |
| 示例 pick 是俯视射线 | `CITY_API.md` §2.3 代码块 |

**复现步骤**：打开 `CITY_API.md` §6 + §2.3；或在 demo 里数"85 块 / 69 单元"HUD；点 plaza 圆盘块（如 `22` 中部的灰圆盘块）——demo 未接点击，需按上面代码/文档口径在 S-31 侧实测。**这不是截图能证明的项，属接线坑，故单列。**

**建议（玩家视角 + 接线提醒）**：玩家不会关心"代理"，只会用行为判断——**"能点的必须点得动，不能点的要给反馈"**。建议 S-31：点楼给抽屉、点广场/马路给轻提示（"这里不能操作"）；楼顶点得中；回退 classic 时城市点击彻底静默；市政厅升级的高亮/特写别依赖 `hall` 节点，自己按地块坐标做。

---

## P0 · 阻断体验（机主裁量项，未裁量前不填 0）

- **P0-1｜C 画风（夜）整体过暗，城市不可读。** 证据：`12-俯视__C__车低人低.png` 平均亮度 4.1%、96.7% 像素 <8% 灰阶；`11-全景__C__车低人低.png` 5.9%/94.1%；`13`/`14` 楼体纯黑（66.5%/65% 近黑）；`15` 10%/86.5%。现象：切到 C 画风后分不清地块/道路/楼，车人消失（Q3/Q4）。复现：demo → 画风 C → 俯视/全景/街区近景。建议：夜景先保可读性（环境光/路面/水面轮廓），发光只做点缀；提供夜景亮度选项。**若 C 只作氛围彩蛋则可降级，但作为三画风之一上线即算阻断。**

## P1 · 明显扣分

- **P1-1｜满岛俯视读不出中心区和主次路网。** 证据：`22-满岛85块俯视__B__车高人高.png`（阴影斜带切割路面；主路 1.4/次路 0.9 同色无标线；正交无高度，CBD 与村舍同貌）；`24-俯视关阴影__B__参照非验收.png` 同区无阴影时明显更清楚（`证据/24-路网3x.png` vs `证据/22-满岛-路网3x.png`）。复现：demo → B → 俯视。建议：地图模式默认弱化/关阴影、主次路色差或中线、中心/地标图例；广场盘与空地要能区分。
- **P1-2｜车流/行人三档在默认视角几乎无感。** 证据：`16`/`17`/`18` 车体 3–5 px，并排几乎一样，4x 放大才见 0 vs 14/30（`证据/16-18-车流三档-城区同区-4x.png`）；`19`/`20`/`21` 行人 8–12 px，4x 后才清晰（`证据/19vs21-行人关vs高-4x.png`）；C 夜更看不见。复现：demo → B → 车流/行人 关低高 + 全景/街区近景。建议：把档位差做成"一眼可见"（路口聚集/车灯长龙/广场人气），夜间补车尾灯与人形轮廓光。
- **P1-3｜"滨水码头"没有码头。** 证据：`05`/`10`/`15` 滨水机位、`22` 最外行都是锯齿顶仓库/厂房（`证据/10-滨水-前排-2x.png`）；`30` T1–T4 无栈桥/泊位/吊机/船（`证据/30-工业T1T2T3T4-2x.png`）。复现：demo → 滨水码头机位 / 阶梯 `?ladder=industry`。建议：滨水行固定给临水硬符号（栈桥、岸壁、吊机、船），让玩家一眼知道这片是码头。
- **P1-4｜高等级住宅与商业/写字楼难分。** 证据：`25` T2–T4 玻璃塔无阳台/住宅符号（`证据/25-住宅T2T3T4-2x.png`）；`26` T3/T4 同是玻璃塔，仅橙色带/广告位；满岛混合（`01`/`06`/`22`）后玩家分不清。建议：住宅加阳台/晾衣/屋顶花园/小窗，高层商业加招牌/LED 到顶。
- **P1-5｜"三画风"实测是"C 夜景"一个变量，A/B 夜与 C 昼无样张。** 证据：01–15 的 HUD 全部是「A/B=白天」「C=夜」；`CITY_API.md` §2.1 `night?` 表明昼夜可与画风独立。复现：demo 画风 C 切「白天」/A 切「夜晚」（页面支持但截图未覆盖）。建议：补 A/B 夜、C 昼同机位图，或把"画风绑定昼夜"写死并在 UI 说明。
- **P1-6｜点楼→抽屉的 3 个接线坑（Q6 前 3 条）。** 证据：pickables=69/85（HUD"85 块·69 单元"、`迁移就绪清单.md` §3.4 却写 85 个对象）；合并网格会被递归 raycast 先命中；`visible=false` 代理在 three 0.186.1 仍可命中（回退 classic 会"幽灵点击"）。建议：S-31 只对 `pickables` 数组射线、回退时跳过/移除代理、契约补"85 vs 69"和"勿递归全场景"两条警告。

## P2 · 锦上添花

- **P2-1｜公园/工业阶梯等级感弱 + 阶梯图标签挡主体。** 证据：`28` T0–T2 差别小（`证据/28-公园全档-2x.png`），标签芯片正好压在基座中心前；`30` T1–T3 同款放大（`证据/30-工业T1T2T3T4-2x.png`）。建议：每档给一个"可指认的新部件"；标签移到基座外侧/下方。
- **P2-2｜地标档位形态跳变。** 证据：`29-阶梯地标T0至T4__B.png` 摩天轮(T0/T1)→电视塔(T2)→观景轮(T3)→玻璃塔(T4)（`证据/29-地标T2T3T4-1.5x.png`）。建议：同族递进，或 UI 明说是不同地标槽位。
- **P2-3｜市政厅广场/特写取证机位挡主体（取证问题，非产品问题）。** 证据：`04`/`09`/`14` 前景高楼 + 底部控制条挡住广场与基座（`证据/09-市政厅广场-底部遮挡-1.5x.png`）；`23` 左右楼夹住。建议：取证时机位抬高/绕开或隐藏 HUD，否则"广场"卖点无法自证。
- **P2-4｜夜景近景"过艳"倾向。** 证据：`13`/`14` 立面几乎全被青/品红光带占满、主体全黑（非糊团）。建议：夜间保留部分低亮墙色，发光面别铺满整面墙。
- **P2-5｜A/B 白天区分度偏小。** 证据：`01` vs `06`、`04` vs `09`、`05` vs `10` 并排才明显（A 奶油暖 vs B 冷灰蓝）；单看图要靠 HUD。建议：窗色/屋顶色/铺装色再拉开一档（几何不动）。
- **P2-6｜行人贴花坛轻微穿模 + 车贴路缘。** 证据：`21-行人高__B__街区近景.png` 5x 裁剪（`证据/21-行人高-人行道5x.png`、`证据/21-行人高-个体5x.png`）一名米色行人紧贴绿色花坛/树（脚被挡）；紫车约 1/3 车身视觉压路缘。建议：行人路径避让树池花坛，车道偏置/车宽微调。
- **P2-7｜Q6 剩余次要坑**：代理高 ×1.05 覆盖不到实际最高 ×1.12（点尖顶可能 miss）；§2.3 示例 `pick(x,z)` 是俯视射线（别直接当点击）；切画风/换城后旧 pickables 引用作废（需重建后重取）。

---

## 未能从截图判断（不硬编）

1. **A/B 夜景、C 白天的实际观感**：01–15 无此组合（Q5）。
2. **车辆"所有时刻都在车道内"**：全景车仅 3–5 px，只有 `21` 放大的 2 辆车可判断朝向/位置；无法证明全城/全时段无压线。
3. **行人是否全程不穿楼**：静态图只能看当帧；本次未见穿楼/站马路中央，但存在贴花坛 1 处。
4. **点击代理的真实命中率**：代理不可见，属代码/实测口径；本报告只做文档+源码核对（未见 S-31 真机点选证据）。
5. **三画风几何是否逐顶点一致**：截图只能证明同机位轮廓一致；逐位一致由 Lead `预算实测.txt` 表 3 的 position SHA256 相同支撑（A/B/C 均 `245468f0cd16`），属代码口径。
6. **阴影开/关对可读性的量化影响**：`24` 是"参照非验收"，只用于对比；正式验收仍以 `22`（带阴影）为准，本报告对 22 的批评不受 24 影响。

## 附录 A · 证据裁剪图（`U1/证据/`，全部裁自上述正式截图）

| 文件 | 来源截图 | 用途 |
|---|---|---|
| `22-满岛-中心区-2x.png` / `24-参照关阴影-中心区-2x.png` | 22 / 24 | 满岛中心区与阴影影响对比 |
| `22-满岛-路网3x.png` / `24-路网3x.png` | 22 / 24 | 主次路网/路口同区对比 |
| `16-18-车流三档-城区同区-4x.png` | 16/17/18 | 车流三档同区并排放大 |
| `19-21-行人三档-街道同区-3x.png`、`19vs21-行人关vs高-4x.png` | 19/20/21 | 行人三档对照 |
| `21-行人高-人行道5x.png`、`21-行人高-个体5x.png`、`20-行人低-人行道5x.png` | 20/21 | 车人位置/朝向/人行道判定 |
| `25-住宅T2T3T4-2x.png` | 25 | 住宅高档形态 |
| `28-公园全档-2x.png` | 28 | 公园五档差异 |
| `29-地标T2T3T4-1.5x.png` | 29 | 地标档位形态跳变 |
| `30-工业T1T2T3T4-2x.png` | 30 | 工业/码头形态 |
| `10-滨水-前排-2x.png` | 10 | 滨水前排"厂房非码头" |
| `09-市政厅广场-底部遮挡-1.5x.png` | 09 | 广场被控制条/前景楼遮挡 |

> 方法：ImageMagick 6（`convert -crop/-resize`）裁剪已有 PNG；亮度统计 `convert <png> -colorspace Gray -format '%[fx:mean]' info:`；未安装 PIL，未重跑 demo、未改源图、未重建 HTML。`U1/输入快照/` 为 30 张正式图的只读副本（33 文件与源 cmp 一致），`U1/输入快照sha256.txt` 记录逐图 sha256。

---

## 输入绑定与版本（定稿 2026-10-27 22:00，北京时间）

- **稳定快照**：`C4/metrics.json` `generatedAt=2026/10/27 21:38:12（北京时间）`；`shot.mjs sha256=a7fee7a5dba7a38046f280cbb568c71859d29af2231b4033303c06f51e8d9654`；`HTML sha256=22b148daf7fcc7bb5e84034f2a9a52568ab7b7836f2b3b639698c7edfd30884b`。
- **性能表（勘误后版本）**：`sha256=c1b054b51d4ee26a3d67f2406ff15f37b7936d9ae1ad38f6c05089a0679809b8`，勘误时间 **2026-10-27 21:55:12（北京时间）**，版本记录见 `C4/性能表版本.txt`；旧版 `b5ce88b3a4acd637c57e21cfc89db054ea304a75a44399a285e74294adbec0ea` 作废留痕。C4 本次为**纯文档勘误**（未改图 / HTML / shot.mjs）。
- **输入快照与 sha 清单**：`U1/输入快照/`（30 张正式截图 + metrics.json + 性能表.md + 覆盖矩阵.md，共 33 文件，与源文件 `cmp` 一致）；逐图/逐文件 sha256 见 `U1/输入快照sha256.txt`（内含勘误后重绑补记：新 `c1b054b5…`、旧 `b5ce88b3…`、勘误时间 21:55:12 及旧版作废留痕）；其余 32 个快照文件 sha 未变。
- **勘误内容（按场景，勿再用旧的"6 个 Canvas"说法）**：普通满岛 CanvasTexture=0 / `renderer.info.memory.textures`=2；阶梯每张 CanvasTexture=5（T0..T4 芯片）/ renderer textures=7；**城市模块贴图恒 0**；"6"是阶梯类别数，不是每场景纹理数。
- **本报告性能相关结论复核**：本报告**未引用**旧 (e-2) 贴图表，性能侧只引用了 (a) 构建快照 `blocks=85 / units=69 / placeholders=0` 与 §7 预算/三画风同几何口径——这两处在勘误版中**未改动，按新表复核仍成立**；"85 块 vs 69 代理"的数量口径结论不受影响。三画风逐位一致仍由 `Lead/预算实测.txt` 表 3 的 position SHA256 相同（A/B/C=`245468f0cd16`）支撑，也不受本次勘误影响。
