# S-25F 视觉验收 · 整岛一体化（G3）

> 验收对象：`frontend-rebuild-hm035-island`（内部包 0.3.3）满岛 Lv33 / 85 块时，浮空岛是否「一整块连续岩体」，
> 即修掉 S-25 被机主否掉的「一片片漂浮的暗色小六边形（太恶心、密恐）」。
> 本文件所有数字都来自**交付构建**（见 §1 指纹）+ 满岛存档的实测截图。
> **结论只代表 headless Chromium（SwiftShader 软渲染，lowFx=true）的截图；真机未验，真机结论只能来自机主。**

## 0. 结论（五条逐条）

| # | 验收条 | 结论 | 关键读数（S-25 被否 → after） |
|---|---|---|---|
| ① | 岛体是一整块连续岩体，不是一片片分开的小六边形 | **PASS** | under：下缘最大跳变 36→**12**px、>16px 大跳变 5→**0** 个、列内部透出背景 30.66%→**4.22%**；near-bottom：下缘最大跳变 66→**0**px、平滑列占比 89.5%→**100%** |
| ② | 无「重复暗色小块/暗盘」 | **PASS** | under 76→**3** 个、near-bottom 47→**1** 个（L<60 且 20–400px 的暗色连通块） |
| ③ | 顶面相邻地块之间无内部暗缝 | **PASS** | 相邻地块屏幕中点比两侧都暗 >18 的采样 32/124（25.8%）→**7/124（5.6%）**，中点亮度差中位数 4.3→**−3.7**；rejected 的 32 个暗缝点拿到 after 同点复量：差中位数 **59.2 → −1.2** |
| ④ | 岛底只有一个、连续、中调色的 cap | **PASS** | near-bottom：cap 区域近黑(L<42) **2.63% → 0%**、最大近黑连通块 **191 → 0**px、下缘平滑列 89.5%→**100%**、最大跳变 66→**0**px；cap 平均亮度 84.3→**77.0**（中调，非黑盘） |
| ⑤ | 与「机主同机位」对比明显改善 | **PASS** | 6 个机位镜头读数逐项一致；岛体区域像素变化 default 4.43%、low 3.54%、top 5.25%、under 11.82%、near-edge 33.50%、near-bottom 42.42% |

配套几何结构读数（Lead/G2 的 Node 自检工具，同一构建）：满岛外轮廓 66 顶点、顶面 510 tri、侧壁 660 tri、
**cap 64 tri（n−2）且连通分量 = 1**、cap y 恒 −1.75、**每块地自己的底面 tri = 0**、内部边不建墙、
**水晶 3 处（≤4）且水平位置都在初始 7 块内、不成排**；9 组启动指纹（fp/fp02/s10/s12/s12int/s19/s20/s21/s22）全 ok。
本文件的像素证据独立复核了这些结构读数在画面上的结果。

## 1. 复现方式与构建指纹（交付构建）

| 项 | 值 |
|---|---|
| 工作树 | `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm035-island` |
| 构建 | `node tools/build-web.mjs --internal` → `dist/web-internal` |
| **交付构建指纹（全部截图来自它）** | `assets/main-3de59944c8.js`，**856,083 B**，sha256 `3de59944c845c832023c80b48098dfc7b85ba085c0434c5bd29efc6b2333fb33` |
| 反面对照（S-25 被否版）指纹 | `assets/main-a0bb4be158.js`，855,392 B，sha256 `a0bb4be15890301936fb4f83a6a00e25f0fa687cdbf748997afe7f54401d9988` |
| 存档 | 满岛 Lv33 / 85 块（`land` 78 行 + `level=33` + 4 建筑），`满岛存档-Lv33-85块.json`，sha256 `1448c83fc681…` |
| 采集工具 | `tools/test-island-shots.mjs`（本次新建；每页 `setRaw+reload → debugOpen(false) → resetFocus → stepFrames(360) → freezeWorld(true)` 后逐机位 `setCamera` 截图） |
| 自检工具 | `tools/test-island-shots-check.mjs`（本次新建，纯读 PNG/读数） |
| 渲染 | headless Chromium `/usr/bin/chromium` + SwiftShader（软件光栅），`lowFx=true`；390×844，DPR 1 |
| 页面报错 | `pageerror = 0`（两版均 0） |
| 渲染预算（390×844 zoom1，满岛） | calls 47 / triangles **127,876** / programs 11 / world.materials 19（S-25 被否版：calls 47 / tri 131,098；4 水晶中间版：tri 127,892，本轮 −16 tri = 减少 2 颗水晶） |
| 近景（zoom3） | near-edge：calls 44 / tri 115,351；near-bottom：calls 43 / tri 112,964 |
| 初始 7 块 | fit 距离 63.258；calls 43–46 / tri 40,135–49,206 / owned 7 |

机位（`读数.json` 实录）：yaw 35°；default pitch 34°、top 88°、low 16°、under −20°，zoom 1，fit 距离 125.803；
near-edge pitch 18°、near-bottom pitch −25°，zoom 3，fit 距离 41.934。近景用 `panBy` 把同一块岛缘/岛底摆到画面同一位置，
两版 pan 差：near-edge (0.454, 0.086) world ≈ **1.6/0.3 px**、near-bottom (0.041, 0.035) world ≈ **0.15/0.13 px**。

## 2. 五条验收的判据、读数与证据图

### ① 一整块连续岩体（不是一片片分开的小六边形）

**判据（像素口径）**
- 岛体掩码 = 与「逐行背景色」差 >24（背景色逐行估计，天空是竖直渐变；岛体撑满全屏的行沿用上一行背景色），
  取最大连通块为岛体，并只用该块的**严格成员**做后续统计（挂在 cap 下的水晶、飘进 bbox 的云不参与）。
- 下缘轮廓：逐列取岛体最下方像素，**左右各去掉 2% 边缘列**（避免「最外侧一列只切到尖端薄片」的边缘伪跳变），
  量相邻列高差（`maxJump` 最大、`jumps16` 为 >16px 的个数、`rough` 均值）。
- 列内部透出背景：主块 bbox 内，每列从最上方岛体像素到最下方岛体像素之间的背景像素占比——旧版块与块之间的
  缝隙会大量透出天空，整岛后应≈0。

**读数**

| 指标 | under（−20°）rejected → after | near-bottom（−25°/zoom3）rejected → after |
|---|---|---|
| 下缘相邻列最大跳变 | 36 → **12** px | 66 → **0** px |
| >16px 大跳变个数 | 5 → **0** | 6 → **0** |
| 下缘逐列高差均值 | 1.42 → **0.52** px | 1.29 → **0** px |
| 列内部透出背景占比 | 30.66% → **4.22%** | —（此机位岛体撑满画面，不做此口径） |
| 有内部透出的列占比 | 94.21% → **30.85%** | — |
| 下缘平滑列占比（相邻列高差≤1px） | 83.3% → **92.5%** | 89.5% → **100%** |

**判定理由**：rejected 的下缘是逐块锯齿（36/66px 大跳变、5~6 处 >16px 断口、块间缝隙透出 30.66% 背景），
after 是一条连续轮廓（under 大跳变 0 个、near-bottom 0 跳变且 100% 平滑）；after 残留的 4.22% 内部透出经逐像素
定位（`细节-列内部透空位置-after-under.png` 红点）全部在岛体**左右两个尖端的外轮廓凹口**上（远缘轮廓内凹、
透视下露出天空），不是岛体内部的洞。

**证据图**：`after-390x844-under.png`；`对比-after-vs-rejected-390x844-under.png`（左 after / 右 rejected）；
`after-near-edge-390x844.png`；`对比-after-vs-rejected-near-edge-390x844.png`；`细节-岛底-上after下rejected.png`。

### ② 无「重复暗色小块 / 暗盘」

**判据（像素口径）**：岛体主连通块严格成员内，亮度 **L<60** 且**面积 20–400 px** 的暗色连通块计数。
S-25 被否版每块地自带一块独立暗色盘/暗缝碎片 ⇒ 该口径下会数出几十个近似等大的块。
（判据取 under / near-bottom：机主否的是「从下方/侧面看到一片片暗色小六边形」，顶视图里这些盘被顶面挡掉；
顶面问题由 ③ 覆盖。）

**读数**

| 视图 | rejected | after |
|---|---|---|
| under（−20°） | **76** 个（典型尺寸 383/320/294/283/264/261/242/231 px） | **3** 个（160/66/57 px，均在岛缘左右尖端侧壁下缘阴影处，非重复暗盘） |
| near-bottom（−25°/zoom3） | **47** 个 | **1** 个（20–29 px） |
| default（34°，参考） | 21 个 | 11 个（建筑投影/暗色路面碎片，非逐块暗盘；顶面判据见 ③） |

**证据图**：`细节-岛底-上after下rejected.png`（上 after：一整片中调底面；下 rejected：85 块暗色六边形盘、
盘间透出天空——就是机主说的「一片片漂浮的暗色小六边形」）；`对比-after-vs-rejected-near-bottom-390x844.png`。

### ③ 顶面相邻地块之间无内部暗缝

**判据（像素口径）**：default（34°）机位下，取全部相邻已拥有地块 **222 对**，每对取屏幕中点 + 中点向两侧地块中心
各 30% 处的两个参考点；三点都要求**最近且已绘制的命中是地面（浮空岛/道路）**（否则被街区/居民/树挡住，作废）。
量中点亮度 − min(两侧亮度)：>18 判为暗缝。采样点坐标只由 `tileScreen`（世界坐标→屏幕）决定，与岛体几何无关。

**读数**

| 指标 | rejected | after |
|---|---|---|
| 有效地面采样点 | 124（98 对被建筑/树遮挡，已剔除） | 124（同一批点） |
| 暗缝点数（差 >18） | **32**（25.81%） | **7**（5.65%） |
| 中点亮度差中位数 | +4.3 | **−3.7**（中点反而略亮） |
| 最大亮度差 | **103.1** | 56.6 |
| 交叉复量：rejected 的 32 个暗缝点 → after 同点 | 差中位数 **59.2**、最大 103.1 | 差中位数 **−1.2**、最大 56.6、>18 仅 7 点 |

**判定理由**：rejected 的暗缝是「沿地块边界的细暗线」，深度 18–103 灰阶；after 在**同一批 32 个点**上复量差中位数
**−1.2**，说明这些缝本身已消失。after 残留 7 个 >18 的点经看图（`细节-顶面接缝点-上after下rejected.png`）是
**街区/树投在顶面上的阴影成片暗区**（不是沿地块边成线的缝），7 点最大 56.6、其余 6 点在 18–33。

**证据图**：`细节-顶面接缝点-上after下rejected.png`（上 after / 下 rejected，红点=地块中点）；`对比-after-vs-rejected-390x844-default.png`。

### ④ 岛底只有一个、连续、中调色的 cap

**判据（像素口径）**：cap 区域 = 岛体主块 bbox 下 62% 高度内的岛体成员（避开草沿与会把侧壁算进来的上部）；
量近黑像素（L<42）占比、最大近黑连通块、cap 平均亮度；另用 near-bottom 下缘平滑占比验证「单一平面 cap」——
平面 cap 从 −25° 看下去下缘应是一条连续线，而旧版逐块盘的下缘是逐块缺口。

**读数**

| 指标 | under rejected → after | near-bottom rejected → after |
|---|---|---|
| cap 区域平均亮度 | 79.4 → 77.9 | 84.3 → **77.0**（中调，非黑） |
| 近黑(L<42)占比 | 4.79% → **2.60%** | 2.63% → **0%** |
| 最大近黑连通块 | 184 → 204 px | 191 → **0** px |
| 下缘平滑列占比 | 83.3% → 92.5% | 89.5% → **100%** |
| 下缘最大跳变 | 36 → 12 px | 66 → **0** px |

**判定理由**：near-bottom 是量岛底最干净的机位（cap 占满画面）：after 近黑 **0 像素**、最大近黑块 **0**、
下缘 **0 跳变/100% 平滑** ⇒ 一整片连续、中调（L≈77）的底面，没有纯黑盘；rejected 同机位 2.63% 近黑、191px 黑块、
逐块缺口下缘。under 视图还包含左右尖端侧壁下缘，after 残留近黑像素集中在**左右两个尖端**（成片阴影带、非重复盘），
故 under 只作参考；判据以 near-bottom 为主 + under 的近黑占比同时达标（2.60%≤3%）。

**证据图**：`细节-岛底-上after下rejected.png`；`对比-after-vs-rejected-near-bottom-390x844.png`；`after-near-bottom-390x844.png`。

### ⑤ 与「机主同机位」对比明显改善

**判据**：机位读数逐项一致（yaw/pitch/zoom）+ 同机位像素差显示岛体区域显著变化 + ①②③④ 均不劣于反面对照。

**读数（同机位 diff，390×844）**

| 机位 | 变化像素 | 占比 | 机位一致 |
|---|---|---|---|
| default 34° | 14,570 | 4.43% | ✅ yaw35/pitch34/zoom1/dist125.803 完全一致 |
| top 88° | 17,294 | 5.25% | ✅ 同上 |
| low 16° | 11,643 | 3.54% | ✅ 同上 |
| under −20° | 38,899 | 11.82% | ✅ 同上 |
| near-edge（pitch18/zoom3） | 60,104 | 33.50%（统计区 y150–610） | ✅ 机位一致，pan 差 ≈1.6px |
| near-bottom（pitch−25/zoom3） | 139,646 | 42.42% | ✅ 机位一致，pan 差 ≈0.15 world ≈0.15px |

**证据图**：6 张 `对比-after-vs-rejected-*.png`（左=after / 右=rejected，同一机位并排）。
注：两版截图都是实时 RAF 渲染后冻结的单帧，树/云/水晶的动画相位在两次采集间不同，同机位 diff 本身含
这部分动画噪声（细碎、与岛体结构无关）；判定几何/颜色差异请看并排图与 ①②③④ 的结构读数。

### 补充：320×568（小屏）

`after-320x568-{default,top,low,under}.png` 已出，机位/读数同口径（calls 47 / tri 127,876 / owned 85），
画面结论一致；未逐条重算 320 像素读数（结论以 390×844 为准）。

### 补充：初始 7 块（水晶不悬空）

`after7tiles-7tiles-390x844-{default,top,low,under}.png`（重置到初始 7 块态、机位同 `test/t-island.mjs`，owned 7）：
**3 颗水晶都在 7 块 footprint 之内的 cap 下方**，没有一颗悬在岛外空气里；页面上原来的
「程序完整性自检未通过」红色横幅**已消失**（见 §3-3）。

## 3. 本轮（交付构建）相对 S-25 被否版 / 中间版的变化

1. **构建**：`main-a0bb4be158`（S-25 被否）→ `main-349c6bae2c`（4 水晶中间版）→ **`main-3de59944c8`**（856,083 B，
   交付构建）；tri 131,098 → 127,892 → **127,876**（−16 = 减少 2 颗水晶）。
2. **水晶挂点修正**：4 处 → **3 处**（`(0,0)`、`(1,0)`、`(-1,1)`，都在初始 7 块内）。截图复核：under / near-bottom
   视图水晶由 4 颗变 3 颗，原先悬在右侧外圈（(2,-1) 一带）的 2 颗不再出现在岛外空气里；初始 7 块态下 3 颗均在
   岛体 footprint 之内。
3. **「程序完整性自检未通过」横幅：已定位并修复。** 中间版把 cap 颜色写成 `palette.ts` 的 `C.rockCap`，
   使 palette 指纹覆盖数变成 54（期望 53）⇒ `fingerprintS22` MISMATCH ⇒ 内部包弹横幅，**正式包会直接 HALT 拒绝启动**。
   交付构建已把 palette 回退到基线、cap 颜色改为 `hexworld.ts` 里的字面量 `0xe8e0ff`（同一色值 + 同一 shade 公式）；
   Lead 的 9 组启动指纹复测全 ok，重拍后初始 7 块 4 张图**红色横幅像素 = 0**
   （检测口径：底部 HUD 区 R>170/G<90/B<90 的像素计数）。
4. **自检口径的一处修正（如实记录）**：水晶挂点修正后，under 下缘轮廓「最外侧一列只切到尖端薄片」会产生伪跳变、
   且挂 cap 下的水晶会把下缘拉出尖刺；本轮下缘统计改为「去掉左右 2% 边缘列 + 只用主连通块严格成员」，并新增
   「>16px 大跳变个数」指标。rejected 与 after 用**同一套最终口径**重算（rejected under 36 / near-bottom 66），
   对比仍成立。
5. cap 颜色与顶面 shade 相对中间版未变（near-bottom cap 平均亮度 77.0 = 中间版 77.0），本次只搬常量、不动渲染结果。

## 4. 「机主同机位」的说明（必须如实标注）

- **机主原始截图未交接**：没有拿到机主那张「太恶心了，有密恐」的原图，因此**不能**声称任何图是「机主同机位」。
  本文件里的「同机位」指：与 S-25 被机主否掉的那版**同一套相机参数**（§1），用 `test/t-island.mjs` 的机位序列
  （default 34°/top 88°/low 16°/under −20°，zoom 1）加两张近景复现。
- 基线树 `frontend-rebuild-hm033` 的同机位图**只用于机位校准**（初始 7 块状态的 `before-island-390x844-*` vs 本树
  `rejected-7tiles-390x844-*`：HUD 顶栏、左侧天空条差 0 px；其余差异集中在岛体与云）。**基线是初始 7 块，不是满岛，
  不能当 before 主对照**；before 主对照一律用满岛 85 块的 `rejected-*`（同一构建、同一存档、同一机位）。
- 校准读数见 `机位校准.json`。

## 5. 局限

1. **真机未验**：全部截图是 headless Chromium + SwiftShader 软件渲染、`lowFx=true`；真机 GPU 的色调映射/抗锯齿/阴影
   可能与截图不同，性能数字（calls/tri）也不是真机实测。**真机结论只能来自机主。**
2. 内部包 HUD（「调试▼」「内部测试包 0.3.3」徽标）属于 internal channel 自带的调试层，两版一致，不影响岛体判定。
3. 像素自检阈值按「反面对照 vs 本次 after」读数定（见 `像素自检.json` 的 `thresholds`），判据定义已写在 §2；
   ③ 的残留 7 点、④ under 视图的尖端近黑块已逐点看图归因（建筑/树投影阴影、尖端侧壁下缘），不是几何缝/黑盘。
4. 近景两张是 `panBy` 平差后的机位，两版 pan 差 near-edge ≈1.6px、near-bottom ≈0.15px；near-edge 的 33.5% 变化里
   包含这部分位移与动画相位差，判断岛缘连续性以 near-bottom（≈0.15px）与 under（pan=0）为准。
5. 同机位 diff 含实时动画相位噪声（树/云/水晶），数值在不同采集轮次间会有小幅波动，不影响结构判定。

## 6. 文件清单（均在 `tasks-out/S-25F/截图/`，关键图另拷 `tasks-out/S-25F/evidence/`）

**after 主证据（满岛 85 块，390×844，交付构建）**
- `after-390x844-default.png` / `-top.png` / `-low.png` / `-under.png`
- `after-near-edge-390x844.png`（岛缘侧壁近景）、`after-near-bottom-390x844.png`（岛底近景）
- `after-320x568-{default,top,low,under}.png`

**初始 7 块补充验证（水晶不悬空、横幅消失）**
- `after7tiles-7tiles-390x844-{default,top,low,under}.png`

**同机位对比（左 after / 右 rejected）**
- `对比-after-vs-rejected-390x844-{default,top,low,under}.png`
- `对比-after-vs-rejected-{near-edge,near-bottom}-390x844.png`

**细节放大**
- `细节-岛底-上after下rejected.png`（上 after / 下 rejected）
- `细节-顶面接缝点-上after下rejected.png`（上 after / 下 rejected，红点=相邻地块中点）
- `细节-列内部透空位置-after-under.png`（红=列内部透出背景的像素，集中在左右尖端轮廓凹口）

**读数**
- `像素自检.json`（五条判据、阈值、两版全部原始读数、交叉复量）
- `读数.json`（采集的全部机位/渲染预算/接缝采样点；`runs.rejected` / `runs.after` / `runs.after7`）
- `机位校准.json`、`满岛存档-Lv33-85块.json`、`Phase1-采集说明.md`

**工具（只新增，未改产品代码）**
- `tools/test-island-shots.mjs`（截图 + 接缝采样点采集）
- `tools/test-island-shots-check.mjs`（像素自检；`--accept` 出五条判定，`--calibrate` 出机位校准）

## 7. 需要 Lead / 机主确认的点

1. **真机需要机主看一眼**（尤其 under 与岛底近景）：截图证据只能证明软渲染下已是一整块连续岩体。
2. after 的 under 视图（−20°）里，岛体**左右两个尖端**的远缘轮廓有内凹缺口，透视下会露出一点天空（不是洞）；
   若机主对「尖端轮廓」还有意见，可再收一层外轮廓的凹口（属几何细节，不影响本轮五条）。
3. after 顶面仍有 7/124 个采样点（5.6%）中点比两侧暗 >18，看图是建筑/树投影阴影；若机主对「顶面有暗块」敏感，
   可再确认阴影贴图/亮度是否要收敛（不是地块缝）。
4. 水晶已从 4 处改为 3 处且都在初始 7 块内，初始 7 块态已验证不悬空（§2 补充）。
