# L3（hall.glow 着色 + 居民点击区）· Lead 独立验收报告

- 验收人：Team Lead（非实现者）
- 验收日期：2026-10-12
- 任务书：`docs/11-0.1收尾任务书-分级.md` §5（L3：两个小项修复，低等级，严格约束）
- 被验收产物：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-L3/`
- 原目录 `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/` **本次未被改动**（见 §6）

---

## 0. 验收结论

**L3 通过。** 两个任务都完成，红线全部清白，三次全量回归全绿且样例数只增不减，预算全部达标。

**任务二只做到 3/4，我判定这是正确的、不该追求 4/4** —— 剩下的那 1 个是**被真正画出来的地形遮挡**，属设计上正确的行为（`docs/03` §已知局限原本就写明「这是遮挡的真实表现，不是拾取错误」）。L3 把它刻意保留为负例，是对的。

**L3 推翻了我（Lead）在派发前给它的侦察笔记里的一处错误前提，它是对的**（见 §5）。我照实登记。

---

## 1. 任务书 §5 七条硬要求逐条核对

| # | 要求 | 我的核对 | 结果 |
| --- | --- | --- | --- |
| 1 | 每项改动前先跑全量回归记录基线 | R0 `evidence/regress-20261012-033523/` = 10/10 PASS / 189.4s；R1（任务一后）`…034436/` = 10/10 PASS / 178.7s 充当任务二基线 | ✅ |
| 2 | 改动后重跑，原有断言必须仍通过、样例数不得减少 | R2 `…035553/` = **10/10 PASS / 224.2s**；样例数 **216 → 216 → 230** | ✅ |
| 3 | 新增针对该修复的测试（只增不删） | `test/t-visual.mjs` 断言 7→11（+4，T12a–d）、`test/t-gameplay.mjs` 22→25（+3，T13a–c）；两文件 `diff -u` **删除行数 = 0** | ✅ |
| 4 | 任一原有测试失败就立刻回退该项、不改测试迁就 | **无任何失败，无回退** | ✅ |
| 5 | 预算不得超过 60 / 40000 / 16 / 7，报告贴前后对比 | 见 §3，全部达标 | ✅ |
| 6 | 需要改 `src/core` 就停下写待决 | `diff -rq src/core` **完全一致**，未碰 | ✅ |
| 7 | 截图只能来自本次实跑并写明环境 | 3 张截图我逐张看过；环境为 chromium + ANGLE/SwiftShader **软件渲染，非真机**，390×844 | ✅ |

---

## 2. 我独立复现的关键事实（不是读它的报告）

### 2.1 我自己写探针，对全屏网格逐点比对「旧语义 vs 新语义」

我在 `/tmp/lead-l3-verify/probe.mjs` 写了独立探针（**不属于 L3 交付物**），对 390×844、步长 26 的 **480 个扫描点**逐点比对：

- **旧语义** = `pickAll` 第一项（最近者胜）
- **新语义** = `pickAt`（L3 改后的真实拾取）

并断言两者差异**只允许**出现在一种情形：第一项是不可见（`drawn=false`）且非居民的辅助命中体，且其后确实还有居民。

**结果**：

```
# 扫描点 480 个（390x844，步长 26）
# 语义发生变化的点：2
#   其中【符合允许条件】的：2（隐形辅助体抢走点击被改判给居民）
#   其中【隐形盒→市政厅】被改判给居民的：2
# ⚠ 违规（不允许的语义变化）：0
# 隐形体命中且其后无居民的点（应保持原样）：22
```

**⇒ 480 点里只有 2 点语义变化，全部符合允许条件，0 违规；22 个「隐形体命中但后面没有居民」的点全部保持原样。** 这证明修复是**外科手术式**的，没有让玩家"隔着可见建筑点到居民"。

### 2.2 我用**同一个探针**跑原目录（未修复版），复现「基线 2/4」

这是 L3 的核心声称，必须独立验证。同一探针、同一冻结世界：

| 居民 | 原目录（未修复） | L3 副本（已修复） |
| --- | --- | --- |
| #0 | 自命中 YES（最近命中=居民 d=35.53） | 自命中 YES（d=35.52） |
| #1 | 自命中 YES（最近命中=居民 d=37.75） | 自命中 YES（d=37.75） |
| **#2** | **NO → 市政厅 d=36.69** | **YES → 居民 d=38.29** |
| #3 | NO → 浮空岛 d=34.08 | NO → 浮空岛 d=34.07 |
| **合计** | **2/4** | **3/4** |

**⇒ L3 的「2/4 → 3/4」声称完全复现。** 且证实：
- 居民 #2 的元凶确实是**不可见的市政厅命中盒**（`drawn=false`, `verts=24`，而可见外形只有 1.7×1.25）；
- 居民 #3 的遮挡者是 **`drawn=true`、`verts=4704` 的真实地形**，修复**刻意不碰**它。

### 2.3 光晕真的可见（我逐张看图）

| 截图 | 我看到的 |
| --- | --- |
| `14-glow-0.png`（220×220 对照） | 市政厅屋顶**无**光环，其余画面与下图形同 |
| `14-glow-1.png`（220×220，glow=1） | 市政厅屋顶一圈**金色光环**，清晰可见，与设计稿暖金色调一致 |
| `14-升级光晕-glow1.png`（390×844 全屏） | 真实升级路径：HUD **Lv 2 / 每分钟 +12.0**、toast「市政厅升至 Lv.2 · 每分钟 +12.0」、金色光环在场景中可见、下一级「升级市政厅 → Lv.3 / **需要 25 金币** · 还差 21」、右下「已保存 自动存档」 |

**⇒ 光环真实可见；且「需要 25 金币」与冻结契约 `C(2)=ceil(20×1.22)=25` 一致，说明没有改动任何数值。**

### 2.4 glow=0 时不常驻（我自己的探针也测到）

| | 原目录 | L3 副本 |
| --- | --- | --- |
| `renderer.info.render.calls` | 41 | **41** |
| `renderer.info.render.triangles` | 29174 | **29174** |
| `world.materials` | 7 | **7** |

**⇒ glow=0 时光环完全不进渲染列表，draw call 与三角形与原目录逐字相同。**

---

## 3. 预算对照（任务书要求贴前后对比）

| 指标 | R0 改前 | R2 改后（glow=0） | R2 光晕点亮 | 上限 | 结论 |
| --- | --- | --- | --- | --- | --- |
| draw calls | 40 | 40 | 41 | ≤60 | ✅ |
| 三角形 | 29172 | 29172 | 29412（+240=环面） | ≤40000 | ✅ |
| programs | 10 | 10 | 10 | ≤16 | ✅ |
| **世界材质对象数** | 7 | **7** | **7** | **≤7** | ✅ **未新增材质** |
| 纹理 | 15 | 15 | 15 | — | 不变 |

**关于「不新增材质」这一条**：我在派发前就警告过 L3 —— 世界材质恰好是 7、预算是 ≤7，所以 glow 修复**不能新增材质对象**。L3 的做法是把**已有的** `matDiamond`（原本只给居民提示菱形用）上移定义、让光环**复用同一个材质对象**，因此 `materials.length` 仍为 7。我在 R2 的 T11a 输出里核对过 `worldStats.materials: 7`，并在自己的探针里再次确认 `world.materials: 7`。✅

---

## 4. 三次回归结果表（我的核对）

| 步骤 | R0 | R1 | R2 |
| --- | --- | --- | --- |
| 类型检查 | PASS | PASS | PASS |
| 构建(core+web+wechat) | PASS 614.0KiB | PASS 615.4KiB | PASS 615.9KiB |
| 契约样例 fixtures | 32/32 | 32/32 | 32/32 |
| 会话回放 replay | 32/32 | 32/32 | 32/32 |
| 玩法 gameplay | 21/21 | 21/21 | **24/24**（+3） |
| UI ui | 23/23 | 23/23 | 23/23 |
| 视觉 visual | 12/12 | 12/12 | **16/16**（+4） |
| 浏览器全量 | 59/59 | 59/59 | **66/66**（+7） |
| 微信替身 | 37/37 | 37/37 | 37/37 |
| 隔离检查 | PASS 0 违规 / 93 白名单 | PASS | PASS |
| 总耗时 / 结论 | 189.4s PASS | 178.7s PASS | 224.2s PASS |

**样例数 216 / 216 / 230 —— 只增不减。** 新增的 7 条（+4 visual、+3 gameplay）全部是 L3 新写的 T12/T13。

---

## 5. L3 推翻了我的侦察前提（它是对的，我登记）

我在派发前告诉 L3：「居民**本体网格不在 `pickables` 里**，只有那个隐形胶囊可拾取。」

L3 在报告里明确推翻，并给出证据：居民本体 `verts≈3204~3468, drawn=true` **也在** `pickables` 里，胶囊只是最近的命中体。

**我复核后确认 L3 正确，我的笔记错了。** 证据在 `src/render/world.ts:182`：

```ts
const meshOf = (g, m, tag, cast, recv, pickable = true) => {
  ...
  if (pickable) { pickables.push(me); }   // ← pickable 默认 true
  return me;
};
```

而居民本体是 `meshOf(residentGeometry(pal), matFlat, RESIDENT_TAG, true, false)` —— 只传了 5 个参数，**`pickable` 走默认值 `true`**，所以本体确实进了 `pickables`。

**⇒ 我给的错误前提没有影响结果（L3 没有盲从），但这说明我的侦察笔记不该被当作事实。** 照实登记。

---

## 6. 红线核查（我逐条实测）

| 红线 | 我的实测 | 结果 |
| --- | --- | --- |
| 不改原目录 | 原目录文件数仍为 **170**；`docs/07` `--check` 退出码 0（说明 `src/`、`test/` 未被动过） | ✅ |
| 不改 `src/core` | `diff -rq src/core` 完全一致 | ✅ |
| 不删改已有断言 | 8 个 `test/*.mjs` 逐一 `diff -u`，**删除行数全部为 0** | ✅ |
| 不新增世界材质 | `world.materials` = 7（源码 `materials.push` 仍只有 2 处；实测 7） | ✅ |
| 不改寻访规则/金币/声望 | 数值相关测试 T04a（寻访+1、声望+1/+1、金币+3 毫币差≥3000）、T04d（金币不足）全部原样通过；截图里 C(2)=25 与契约一致 | ✅ |
| 预算不超 | 见 §3 | ✅ |
| 只改渲染层 + 点击命中层 | `src/` 只动了 `render/world.ts` 与 `app/app.ts`，未碰 `core/`、`game/`、`host/` | ✅ |

**L3 副本 vs 原目录的全部差异**（排除 `dist/`、`evidence/`、`release/`）：

```
Only in ...-work-L3/docs: 19-L3-报告.md
src/app/app.ts          differ
src/render/world.ts     differ
test/t-gameplay.mjs     differ
test/t-visual.mjs       differ
```

**就这 5 项，没有任何多余改动。**

---

## 7. 我认可的新增测试质量

L3 没有用"断言一个显示字符串"糊弄，而是做了可测量的证明：

- **T12a**：在市政厅区域取 220×220 像素，比对 `glow=0` 与 `glow=1` 两帧截图 → **729 像素差异**；同时设**对照组** `glow=0 ↔ glow=0` → **0 像素**。这排除了"差异来自居民走动/云飘"的可能。
- **T12b**：同帧原子测量 draw calls **40→41→40**、三角形 **29172→29412→29172**（+240 恰为环面）、材质仍 **7**。
- **T12c**：走**真实升级路径**（点居民攒钱→升级）交叉验证，不依赖调试接口。
- **T13a**：居民中心自命中最好一帧 3/4（基线 2/4），并逐个列出"最近命中是隐形辅助命中体"的 6/6 例。
- **T13b（负例）**：居民中心 ±30px 窗口内「最近命中是**可见**非居民、其后仍有居民」的 **435 个点 0 泄漏**；被可见几何遮挡的居民中心 6/6 仍判给可见物体。

T12a 的对照组设计尤其关键 —— L3 在诚实记录里说明，它最初用 `world.update(0, app.time)` 导致两次 `glow=0` 截图差 **6641 像素**，定位后改为只同步光晕。**这说明它真的在验证而不是在凑断言。**

---

## 8. 我不认可 / 需要留意的

1. **`world.stats()` 把隐藏光环也计入**（`+1` 网格、`+240` 三角形），与 `renderer.info` 口径不一致。我在探针里也看到了：原目录 `world.triangles: 22652 / meshes: 31`，L3 `22892 / 32`，而 `renderer.info.render.triangles` 两边都是 29174。**这不是 bug（`stats()` 本就不看 `mesh.visible`），但它让 D9 的"材质/网格"口径多了一层歧义**。L3 没改（改了会动 T11a 与 `docs/01` 的 D9 口径），我同意留作待决。
2. **`docs/07` 在 L3 副本里已经过期**（`src/`、`test/` 都改了，清单没重算）。这在**副本**里无所谓，但**如果要合并回主目录，必须先合并、再重跑回归、最后用 `tools/gen-sha256-list.mjs` 重算 `docs/07`**，否则 `docs/07` 会与文件不符。**这一步我不会在未获授权时替用户做**（任务书 §9.2 明确写「L3 通过后，由我决定是否把副本的改动合并回主目录」）。
3. L3 新增了 2 个 **debug-only** 接口（`world.syncGlow()`、`setHallGlow()`）并在升级分支加了一行 `syncGlow()`。严格讲超出"最小改动"字面，但它给了理由（必须在不推进世界的前提下切换 glow，否则像素比对被污染），且 `setHallGlow` 走生产同款 `syncGlow` 路径、另有 T12c 用真实升级路径交叉验证。**我接受。**

---

## 9. 未验证项

- **真机 / 真 GPU / 微信官方模拟器**：全部未验证。所有截图、帧率、像素数字都来自 **chromium + ANGLE/SwiftShader 软件渲染**，≈26fps **不能当性能结论**。
- **`npm run test:public`**：未跑（公网预览仍 404，按设计不在全量回归内）。
- **L3 副本里 `docs/07` 的校验和**：已过期，见 §8.2。
- **两个 L3 压缩包**：无（L3 未打包，属正常——任务书未要求）。
- **微信端是否也有同样的隐形盒抢点击问题**：未验证（微信替身测试 37/37 通过，但那是替身环境）。

---

## 10. 交付物

| 项 | 路径 / 值 |
| --- | --- |
| L3 报告（主交付） | `…-work-L3/docs/19-L3-报告.md`，451 行，sha256 `07146a1d77cb1c246df3773791ec4824f7d08ea928d97bcac7646b2f6240a368` |
| L3 报告下载 | https://files.hynixing.cn/dl/l3--hall-glow-01fee |
| 截图 | `…-work-L3/evidence/screens/14-glow-0.png`、`14-glow-1.png`、`14-升级光晕-glow1.png`、`13-视口-*.png`、`12-射线命中标注.png` |
| 探针与原始日志 | `…-work-L3/evidence/l3/`（6 个文件） |
| 三次回归日志 | `…-work-L3/evidence/regress-20261012-033523|034436|035553/` |
| **Lead 独立探针**（不属于交付物） | `/tmp/lead-l3-verify/probe.mjs`（L3 副本）、`probe-orig.mjs`（原目录基线） |

---

*本报告由 Team Lead 独立验收产出。所有数字均为我实际运行所得；未验证项见 §9；我不认可的部分见 §8。*
