# S-11 总报告 · 《叫我大岛主》0.2.2 独立验收

- 被验收对象：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm022/`（实现者代号 **S-10**，版本 **0.2.2**）
- 验收人：**S-11**（独立验收者：不写、不改被验收实现；全部脚本在 `tasks-out/S-11/scripts/`；被验代码一律 `cp -a` 到 `/tmp/s11/hm022` 后再运行）
- 时间：2026-10-17
- 冻结契约：`contract-0.2-R3-FROZEN-v1.0.tar.gz`，sha256 `535e4beac061d36124a3c2dbc80b6c8ede5bb60ff02cf1a3d7cf3a2860feb277`（**三方一致**，解压到 `/tmp/s11/contract/contract-0.2-R3`）
- 运行环境：Node v24.15.0；无头 Chromium + SwiftShader **软件渲染**（**不代表手机性能**）

---

## 一、总体结论

### **验收通过（有条件）。**

**阻断 0 项 / 重要 0 项 / 建议 9 项。**

0.1 冻结规则（整数毫厘金币、升级价 `ceil(20×1.22^(L−1)−1e−9)`、产速 `10×(1+0.2(L−1))/分`、寻访 +3 金币 +1 声望、离线一次性不封顶、存档命名空间 `wyszz-0.1-ds-save` schema v2）**逐条未发现违反**，不构成阻断。

「有条件」指的是两件事，**都必须由你在手机上做完才算数**：

1. **外观档位好不好看**——S-11 只能证明「1/4/7/10 级几何确实不同、同档位完全一致」，**美观是主观的**，需用户真机确认（B-D1）。
2. **真机性能与手感**——本轮所有帧率数字来自**软件渲染**，**不能代表手机**；真机帧率、发热、跟手度**未验证**（见第五节）。

> ## ⚠️ 本验收通过 ≠ 真机通过。
> S-11 验的是「代码逻辑、契约一致性、包内容、界面排版矩阵」。
> **真机上的流畅度、发热、触摸手感、刘海/挖孔适配、微信环境，一条都还没验。**
> 请按 `report-D.md`（给非技术同学的真机验收清单）在手机上逐条做完。

### 分步结论

| 步 | 内容 | 结论 | 阻断 | 重要 | 建议 | 报告 |
| --- | --- | --- | --- | --- | --- | --- |
| S-11.0 | 取样与门槛（契约哈希、基线复算、副本） | **通过** | 0 | 0 | 0 | `report-0.md` |
| S-11.A | 核心与防作弊（diff / 硬编码 / 契约 445 样例 / 差分模糊） | **通过** | 0 | 0 | 3 | `report-A.md` |
| S-11.B | 界面布局 / 街区升级 / 居民 / 外观 / 性能 / 0.2.1 回归 | **有条件通过** | 0 | 0 | 4 | `report-B.md` |
| S-11.C | 回归 / 正式包 / MANIFEST / 指纹破坏 / 0.1 夹具 / 依赖 | **通过** | 0 | 0 | 2 | `report-C.md` |
| S-11.D | 真机验收清单（给非技术同学） | **已交付清单**（清单本身无通过/不通过） | — | — | — | `report-D.md` |
| **合计** | | **通过（有条件）** | **0** | **0** | **9** | |

---

## 二、关键数字一览

| 项目 | 数字 | 出处 |
| --- | --- | --- |
| 冻结契约哈希 | `535e4bea…` 三方一致 | S-11.0 |
| 0.1 基线 `frontend-rebuild-hm` 复算 | 280 文件，唯一差异 `docs/37-0.2实施路线.md`（允许） | S-11.0 |
| `frontend-rebuild-hm02`（0.2.1）复算 | 401 文件，**0 差异** | S-11.0 |
| 副本 `/tmp/s11/hm022` | 5878 文件逐字节一致 | S-11.0 |
| **原实现目录结束时未被改动** | 5878 文件，结束哈希 vs 起始哈希 **0 差异** | S-11.Z |
| `src/core` 相对 0.2.1 | **26 文件零改动**（逐字节） | S-11.A1 |
| 契约样例重跑（自写驱动） | 事件序列 137 case / 374 step、UI 状态机 29 / 69、加载流程 41、静态 238 / 341 条 | S-11.A4 |
| 契约样例差异 | **1 条**，且是**契约内部自相矛盾**（S06-N02，见第四节） | S-11.A4 |
| 差分模糊测试（vs 契约参考实现） | **7003 序列 / 280,772 事件 / 不一致 0** | S-11.A5 |
| 界面布局纯函数矩阵 | **239,648 用例 / 0 违规** | S-11.B1 |
| 运行期布局检查 | 3 种视口 + 注入安全区/胶囊，**20 检查 / 0 违规** | S-11.B1 |
| 用户真机数字复现 | 等级 28 / 金币 1,022.8 / 声望 236 → **一致** | S-11.B1 |
| 街区升级端到端 | **4/4** 满足 | S-11.B2 |
| 居民与角色卡 | **8/8** 满足（3 个居民、奖励 +3 金币 +1 声望） | S-11.B3 |
| 外观档位 | 几何随档位变化、同档位一致 → 判定 true | S-11.B4 |
| 满岛满级绘制调用 | **43 次**（限值 200）/ 三角形 122,938 | S-11.B5 |
| 60 次连续操作对象增长 | 几何/程序/对象数**不增长**（贴图一次性 +4 后持平） | S-11.B5 |
| 软件渲染帧率 | ≈35.8 fps —— **软件渲染，不得当作手机性能** | S-11.B5 |
| 两步点击时间窗 | 实测 **249 ms 被拦 / 250 ms 放行**（窗口 1 ms） | S-11.B6 |
| 0.2.1 关键 5 项回归 | **5/5** 通过 | S-11.B6 |
| `npm run regress` | **26/26 全 OK**，退出码 0 | S-11.C1 |
| 正式包契约扫描 | `web` **PASS 0 命中**、`wechat` **PASS 0 命中** | S-11.C2 |
| MANIFEST 自校验 | 4 个包**字节 + sha256 全一致**，无清单外/缺失文件 | S-11.C3 |
| 指纹破坏（改 1 字节） | 正式包 **HALTED** 且存档**读 0 写 0**；内部包继续 + 红字 | S-11.C4 |
| 0.1 夹具 F01–F20 | 0.1 契约自带校验器 **32/32 通过**（F11+F12 单独 14/14） | S-11.C5 |
| 0.1 夹具完整性 | 实现的 `contract-fixtures/` 与 0.1 契约原件**逐字节相同** | S-11.C5 |
| 依赖变化 vs 0.2.1 | 新增 0 / 删除 0 / 版本变化 0 | S-11.C6 |
| 产物引用契约目录 | **0 命中**（无绝对路径、无契约目录引用） | S-11.C6 |

---

## 三、建议汇总（9 条，均不影响通过）

### 来自 S-11.A（3 条）

| 编号 | 建议 |
| --- | --- |
| A-1 | 契约下一版应统一 `S06-N02` 的期望值与 `lib_econ.upgradeBlock`（否则每轮验收都会重复踩这一条） |
| A-2 | `src/game/session.ts:87 BLOCK_NAMES = ['住宅','商业','绿化']` 把契约类型名复制到了 UI 层；建议由核心导出或加断言绑死 |
| A-3 | 契约样例 `S10f-N04/N06` 未把「哪个键写失败」落进 JSON，样例不自包含；建议补齐 `failWriteKey` |

### 来自 S-11.B（4 条）

| 编号 | 建议 |
| --- | --- |
| B-1 | 街区升级**失败**时只有按钮抖动 + 顶部提示条，没有世界浮字（成功有浮字 `app.ts:488`，失败 `app.ts:492-493` 无）。反馈强度不一致，建议补一个失败浮字 |
| B-2 | 内部调试快捷键 `buyTileNow` 不刷新 HUD（`hud.setBlocks` 唯一调用点在 `refreshView()` 内），**只影响内部调试包**，真实玩法不受影响；建议补一次 `refreshView()` |
| B-3 | 「报价卡 + 展开的街区面板」在真机上**不会同时出现**（`app.ts:269` 注释即设计），建议在验收清单里写明「点候选地会自动收起面板」，免得测试者按字面找不到 |
| B-4 | 实现者自报性能数字未注明测量条件（自报 58 calls / 123,144 三角形；本轮实测 43 / 122,938，三角形差 0.17%）；建议自报数字附「机位 + 是否含 HUD + 采样帧」 |

### 来自 S-11.C（2 条）

| 编号 | 建议 |
| --- | --- |
| C-1 | `dist/contract-core` 整体被契约扫描器判 FAIL(5)，但 5 处命中**全部在 `core-internal.mjs`**（内部通道构建，本就该有），同目录 `core-release.mjs` **0 命中**。它不是发布包，**不算违规**；建议把两个通道的构建分目录存放，并在打包时显式排除 `dist/contract-core` |
| C-2 | 正式包里有 **21 处裸 `debug` 子串**（编译成 `return null` 的桩方法名 + 契约白名单 `debugTaint` + WebGL 扩展名 `WEBGL_debug_renderer_info`），`__wyszzDebug` 在正式包 **0 次**。任务书「人工 grep `debug` 均为 0」**字面不成立**；建议把验收措辞改为「契约禁止词 0 命中」（现状已满足），或对桩做死代码消除。**不要删 `debugTaint`**——契约明确要求保留 |

---

## 四、待决清单（需用户/总监裁决）

| 编号 | 事项 | 说明 |
| --- | --- | --- |
| D-1 | **外观档位是否「更好看」** | 只能证明档位几何确实变化且同档位一致；美观需用户在真机上看 `screens/b4-档位-等级{0,1,4,7,10}.png` 后确认 |
| D-2 | 街区升级失败是否要加世界浮字 | 建议 B-1；体验取舍，契约不规定 |
| D-3 | 内部调试买地是否要刷新 HUD | 建议 B-2；只影响内部包 |
| D-4 | 面板展开时会遮住岛上部（S-10 已知偏差） | 本轮只验了「不与其它 UI 元素重叠」，未量化遮挡观感 |
| D-5 | 契约 `S06-N02` 的期望值自相矛盾，是否改契约 | 样例期望 `{ok:false, reason:'insufficient-coins', priceCoins:2000}`；参考实现 `lib_econ.upgradeBlock` 返回 `shortfallCoins:1999` 且**无 `priceCoins`**；生成器 `tools/gen_samples_b.mjs:78` 自己加了 `priceCoins`；事件样例 `S06c-N02` 又是有 `shortfallCoins` 无 `priceCoins`。**实现跟随参考实现，判定为正确**；建议契约下一版统一 |
| D-6 | 契约 `S10f-N04/N06` 是否补 `failWriteKey` 字段 | 建议 A-3；不补则每轮验收者都要自行推断 |
| D-7 | `BLOCK_NAMES` 是否由核心导出 | 建议 A-2 |
| D-8 | `dist/contract-core` 与 `dist/core` 没有 `MANIFEST.json` | 它们是中间产物，不算发布包；是否纳入清单由用户定 |
| D-9 | 验收清单里「正式包 `debug` 字样为 0」的措辞 | 建议 C-2；现按契约禁止词判定为通过 |

---

## 五、未验证清单（一律不得当作通过）

### 真机相关（最重要）

1. **真机性能**：所有帧率数字来自无头 Chromium + SwiftShader **软件渲染**，**不代表手机**。满岛 85 格 + 全街区 Lv10 + 3 居民的真机帧率、发热、内存**未验证**。
2. **真机触摸与安全区**：胶囊矩形与安全区是**注入的模拟值**（`setCapsuleRect` / `setSafeInsets`），未在真机微信里验证真实胶囊位置、圆角屏、横屏。
3. **手感类项目**：点击跟手度、拖动灵敏度、动画流畅度、音效——**完全未验证**。
4. **真机微信运行**：微信小游戏端实际启动、包体积上限、上传与审核用包**未验证**；微信端只跑了替身测试（38/38）与模拟器工程配置检查（19/19）。
5. **真机存档行为**：杀进程/微信后台的真实行为未验证（本轮只验了核心的存档读写与迁移逻辑）。

### 视觉/主观

6. **外观美观度**：见 D-1。
7. **角色卡与居民的视觉一致性**：实现者已知偏差「外观用固定配色，不使用 `card.color`」；本轮只验了卡片**数据**与核心一致，未验「卡片配色与岛上居民外观是否对应」。
8. **街区升级浮字的视觉位置**：只验了 `fxActive > 0` 与截图，未逐帧核对浮字是否出现在正确的街区位置。
9. **面板展开时对岛屿的遮挡程度**：未量化。

### 方法与覆盖边界（如实登记）

10. **0.1 契约里引用外部文件的自证项未独立复核**：`S01` 的 `sameSetAsR4Csv`/`ringIdxMatchesR4Csv`/`fromR4MaxVertexDist`、`S02` 的 `equalsR4RoadParentExample`、`S04-P01` 的 `matchesA1cJson` —— 它们引用的 `R4 tiles_85.csv` / `A1c land_config.json` 不在冻结契约包内，也不在允许读取的清单里；已按「说明项」处理，**未计入通过也未计入差异**。
11. **`S07` 中需要重建 land 的样例**（P05–P10、O01–O03）：本驱动用**核心自身**的 `candidates/typeAt/priceCoins` 按契约生成器写明的规则重建输入，再对契约期望值（76 项全中）。严格说这是「以核心重建输入」，如实登记该方法学。
12. **A5 中两类契约空白**：`PREVIEW_OFFLINE` 非法起点、被拒 `BOOT/RELOAD` 的 `persistFailed` 键 —— 只登记了两边取值不同的次数，**未验证哪一边才对**（契约未规定）。
13. **`core-release.mjs` 在 release 通道下对 `DEBUG_*` 的实际拒绝行为**：本轮只查了字符串命中；拒绝行为由 A4（release 通道样例 0 差异）间接覆盖，未单独构造 release 通道调试事件用例。
14. **`public-check.mjs`（P07 路径穿越等）**：随 C1 第 17 步「正式包烟雾测试 11/11」通过，但**未独立复核其网络层断言**。
15. **MANIFEST 无签名**：MANIFEST 是明文哈希清单，本身不防篡改（改了产物也能改清单）；本轮只验了「清单与实际一致」。
16. **长时间运行**：只跑了 60 次操作 / 约 1.5 秒烟雾衰减，未做数小时挂机内存与存档增长验证。
17. **B4「同档位完全一致」只在同一次会话、同一块地上成立**；跨会话/跨地块未验证。
18. **C1 第 13 步的运行方式与任务书设想不同**：我在跑之前先确认了副本缺 `../template-quickstart-pack`，所以**这一次 `npm run regress` 是带 `B1_PACK_DIR` 跑的**；并单独补跑了「不带变量 → 17/19、退出码 1」作为反证。照实记录。

---

## 六、产物清单

### 报告

| 文件 | 内容 |
| --- | --- |
| `report-0.md` | S-11.0 取样与门槛 |
| `report-A.md` | S-11.A 核心与防作弊 |
| `report-B.md` | S-11.B 界面/街区/居民/外观/性能/0.2.1 回归 |
| `report-C.md` | S-11.C 回归/正式包/MANIFEST/指纹/0.1 夹具/依赖 |
| `report-D.md` | S-11.D 真机验收清单（给非技术同学） |
| `总报告.md` | 本文件 |
| `进度.md` | 逐步进度表 |

### 脚本（全部自写，未使用实现者的 `tools/*` 作为验证手段）

`s11-build-core.mjs`、`s11-a4-steps.mjs`、`s11-a4-log.mjs`、`s11-a4-loadflow.mjs`、`s11-a4-static.mjs`、`s11-a5-fuzz.mjs`、`s11-build-ui.mjs`、`s11-page.mjs`、`s11-b1-layout.mjs`、`s11-b1-shots.mjs`、`s11-b2-upgrade.mjs`、`s11-b3-residents.mjs`、`s11-b4-tiers.mjs`、`s11-b5-perf.mjs`、`s11-b6-regress021.mjs`、`s11-c2-packages.mjs`、`s11-c2b-internal.mjs`、`s11-c4-fingerprint.mjs`、`hm022-起始sha256.txt`、`hm022-结束sha256.txt`、`hm022-结束diff.txt`、`A1-core-*.txt`

### 截图

`screens/` 共 42 张：`b1-*` 20 张、`b2-*` 5 张、`b3-*` 2 张、`b4-档位-等级{0,1,4,7,10}.png` 5 张、`b5-*` 3 张、`b6-*` 3 张、`c2b-*` 2 张、`c4-*` 2 张。

---

## 七、一句话交付

**代码这一层，0.2.2 验收通过：0 阻断、0 重要、9 建议；契约 445 样例只差 1 条（且是契约自己写矛盾了）、7003 条差分 0 不一致、26/26 回归全过、正式包干净且指纹破坏后确实拒绝启动、0.1 老存档 32/32 兼容。**
**但「本验收通过 ≠ 真机通过」——真机流畅度、发热、手感、刘海适配一条都没验，请照 `report-D.md` 在手机上做完。**
