# 20 · H1 独立验收评审报告（0.1）

- 评审人：Lead（独立验收员，非实现者）
- 评审日期：**2026-10-13**
- 评审对象：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-H1/`（由 L3 副本复制而来）
- 任务书：`docs/11-0.1收尾任务书-分级.md` §7
- 依据：契约包 `frontend-rebuild-contract-v1/`、迭代计划 v2 §5

> **本报告刻意不写出 5 个禁目录名的字面量**，统一用「禁名 #n（见 `tools/check-isolation-project.mjs` 的 `BANNED_NAMES`）」指代 ——
> 否则本文件自己会被项目的隔离检查判为违规（源码文件不享受白名单，`docs/*.md` 也需人工评审加白名单）。

---

## 0. 结论

# 有条件通过

**0.1 的核心层与契约高度一致，可复现证据充分**：`src/contract/*.d.ts` 与契约逐字节同源、29 个契约函数全部实现、黑盒夹具 **32/32 通过**、我自写的 **107 项独立探针 104 通过**。

**之所以不是「通过」，有三条硬理由：**

1. **迭代计划 §5 第 6、7 条（真机可操作 / Three.js WebGL2 在目标手机实际运行）我无法验证** —— 不在我的可验证范围内，只能标「未验证」。**这两条是 0.1 进入下一版的明文条件。**
2. **「重复点击」这条要求在整个项目里没有任何自动化回归** —— 契约的事件语言没有手势身份，夹具覆盖不到；`test/`、`tests/` 也零引用 `GestureGate`。我补了用例（全部通过），但**项目自身的测试仍然没有它**。
3. **2 处与契约明文不符**（`schemaVersion` 非有限时的 reason 码；`settle` 缺状态护栏会产生 NaN）。

**P0 = 0，P1 = 0，P2 = 5。**

> 说明：第 3 条的两处偏差影响面很小（都只在损坏存档/异常状态路径上，且不改变「回退新游戏」的结果），所以我定 P2 而不是 P1。

---

## 1. 问题表

| # | 严重度 | 位置 | 问题 | 复现步骤 | 建议 |
| --- | --- | --- | --- | --- | --- |
| **H1-1** | **P2** | `src/core/save.ts:55` | 契约 §2.5 第 7 条要求 `schemaVersion` **非有限**时报 `not-integer`；实现报 **`bad-type`**。夹具 `F11` 的 13 个变体**没有这一条**，所以 32/32 全绿也没发现 | `S.parseSave('{"schemaVersion":1e999,…其余合法字段…}', 0).reason` → 实际 `bad-type`，契约要求 `not-integer` | 把第 55 行的 `bad-type` 改成 `not-integer`；并在 `F11` 加一个 `not-finite-version` 变体。**改契约夹具需用户批准**，见待决问题 |
| **H1-2** | **P2** | `src/core/economy.ts:65-117` | `settle()` **没有状态护栏**（`applyUpgrade` 有）。传入 `lastSettleTsMs` 非有限的状态时：`deltaMs` 变 `NaN`，`=== 0` 与 `< 0` 都为假，直接落到计算分支 → **返回 `reason='ok'` 且 `coinsMilli=NaN`、`carryNumerator=NaN`** | `E.settle({…, lastSettleTsMs: NaN}, 1700000000000)` → `state.coinsMilli === NaN`，`result.reason === 'ok'` | 在 `settle` 开头加与 §3.3 同款护栏（`lastSettleTsMs` 非有限 ⇒ `invalid-timestamp`）。**我实测确认当前不可达**（见 §4.5），故定 P2 |
| **H1-3** | **P2** | `test/t-gameplay.mjs:45`（T04d） | 「金币不足」这条 e2e 断言只查了**等级不变 + 有抖动 + 有"金币不足"提示**，**没查 `coinsMilli` 一分未扣** —— 而契约 §3.3 ③ 明文要求「一分不扣」 | 读 `t-gameplay.mjs:45`：条件里没有 `coinsMilli` 比较 | 在 T04d 的条件里补 `v.coinsMilli === coinsBefore`。账务层已有 `F05` 覆盖，故 P2 |
| **H1-4** | **P2** | `test/`、`tests/` 全目录 | **「重复点击 / 同一次手势重复投递只发一次奖」（契约 §3.2 手势门）零自动化覆盖**。`GestureGate` 已实现且被 `input.ts` 使用，但 `test/`、`tests/` 里 **grep 不到任何引用**；契约夹具的事件语言也没有手势身份，覆盖不到 | `grep -rn "GestureGate\|gesture" test/ tests/` → 无输出 | 在 `t-gameplay.mjs` 或 `t-ui.mjs` 加一条：同一次 pointerdown/up 重复派发 ⇒ `visitCount` 只 +1。**这是 0.1 明文条件第 3 条的唯一自动化缺口** |
| **H1-5** | **P2** | `tools/check-isolation-project.mjs:89,102-108` | 隔离检查器**有两处可绕过**（我实测击穿，见 §4.8）：① `release/` 在 `IGNORE_DIRS` 里 ⇒ **该目录下的文本文件永不扫描**；② 规则 A/C 只匹配字面量 ⇒ **字符串拼接可绕过** | 见 §4.8 的实测命令与输出 | ①把 `release/` 从 `IGNORE_DIRS` 移除或改为只排除二进制；②增加「拼接还原」启发式（如检测 `'x-' + 'y'` 形式的相邻字面量）并在报告里标注为已知限制 |

### 我尝试过但**没有**发现问题的攻击面（如实列出）

| 攻击面 | 结果 |
| --- | --- |
| 契约 §2.5 全部 18 条校验顺序（我逐条实测 24 个输入） | ✅ 全对（除 H1-1 的 `schemaVersion` 非有限） |
| 毫币整数性 / 进位余量 / 不丢不重（含 3600×1 秒 vs 1×3600 秒） | ✅ 逐毫币相同 |
| 在线 vs 离线等价（8 组时长 × 跨升级 × 跨前后台 × 跨重开） | ✅ 全部相同 |
| 离线一次性结算（重复回前台 / RELOAD / 重开） | ✅ 全部 `not-pending`、收益 0 |
| 离线期间跳过在线结算（F17 守卫） | ✅ 5 次 TICK 全跳过，未重复发放 |
| `previewOffline` 纯函数性与一致性 | ✅ 不改入参，gain/carry 与真实发放逐值相等 |
| 数值饱和（`level=1e15`、`coinsMilli=MAX_SAFE`、7 天离线） | ✅ 夹到安全整数，无 NaN、无负数 |
| 存储读抛错 / 写抛错 | ✅ 读抛错→`corrupt`+新游戏不崩；写抛错→`ok:false` 不抛，且 T08d 证明 UI 会回滚 |
| 高频点击 2000 次 | ✅ 2000 次全发奖，同步耗时 **2ms** |
| 同一手势重复投递 4 次 × 500 轮 | ✅ 仍然只有 500 次发奖 |
| 源码引用禁区（import/require/fs） | ✅ 零命中 |

---

## 2. 逐项回答任务书 §7 的 8 个问题

### Q1. 对照契约的类型与接口，实现是否有偏离？

**基本没有偏离，只有 1 处 reason 码偏差（H1-1）。**

| 检查 | 方法 | 结果 |
| --- | --- | --- |
| 类型声明是否同源 | `diff -u 契约/types/game-state.d.ts src/contract/game-state.d.ts` | **逐字节一致** ✅ |
| API 声明是否同源 | `diff -u 契约/api/contract.d.ts src/contract/contract.d.ts` | **只差 1 行 import 路径**（`'../types/game-state'` → `'./game-state'`），是必要的本地路径适配，非语义偏离 ✅ |
| 契约函数是否全部实现 | 对比 `export declare function` 与 `export function` | **29/29 全部实现，无缺失** ✅ |
| 是否有契约外的额外导出 | 同上 | 3 个附加导出：`checkFingerprints`、`createVisitStateForSession`、`durationParts`（纯新增，不冲突） |
| `UpgradeReason` 是否含实现的 `max-level` | 读 `game-state.d.ts:275-279` | ✅ 含 `'max-level'`，实现与类型自洽 |
| `reason` 码是否逐条符合 §2.5 | 我实测 24 个输入 | 23/24 符合，**`schemaVersion` 非有限不符（H1-1）** |

**另有一处设计层面的说明（不算偏离，但值得记录）**：
`applyUpgrade(economy, visit)` 的签名**没有 `nowMs`**，因此契约 §3.3 ① 的「先 `settle(economy, nowMs)` 是强制的」**无法在核心层边界上强制执行**，只能靠调用方自觉。`tools/driver.mjs:143-146` 与 `src/game/session.ts` 都正确地先 settle 了，`F04`/`F19` 也钉住了行为 —— 但**如果将来有调用方忘记 settle，就会静默少赚收益且没有任何护栏**。建议 0.2 把 `nowMs` 纳入签名或返回显式告警。

### Q2. 契约样例 32/32 是否真的覆盖了那 8 点？

夹具规模我先独立复算过，与 `docs/07` 完全一致：**20 场景 / 32 变体 / 106 步**。

| 必查点 | 对应样例名 | 是否真覆盖 |
| --- | --- | --- |
| 升级前先结算旧产速 | **`F04-lv1-to-lv2`**（`BOOT TICK UPGRADE TICK`）、**`F19-upgrade-preserves-settled-income`**、`F15` | ✅ 覆盖（`F04` 的 UPGRADE 用旧速率结算后扣费，`saveEnvelope` 逐字节钉住） |
| 金币不足不扣费 | **`F05-upgrade-insufficient-coins`**（`BOOT TICK UPGRADE`） | ✅ 覆盖（`saveEnvelope` 逐字节证明余额未动） |
| 毫币整数与进位余量 | **`F14-carry-remainder`**（7 次 `TICK` 累积余数）、**`F15-offline-carry-and-level-rate`** | ✅ 覆盖 |
| 离线结算无上限 | **`F08-offline-long-durations`**（1h→8h→24h→7d 四段，无截断） | ✅ 覆盖 |
| 时钟回拨保护 | **`F13-clock-backwards`**（3 次 TICK 含回拨 + 进出后台） | ✅ 覆盖 |
| v1→v2 存档迁移 | **`F12-v1-migration`**、**`F20-migration-then-play`** | ✅ 覆盖 |
| 重复结算 | **`F09-repeated-foreground`**（重复回前台 + 2×`RELOAD`）、**`F06`**（重复进后台幂等）、**`F17`**（离线期间跳过在线结算）、**`F18`**（零时长） | ✅ 覆盖（四条从不同角度） |
| **重复点击** | **无** | ❌ **未覆盖** |

**「重复点击」为什么覆盖不到（根因）**：
契约的寻访 API 是 `applyResidentVisit(economy, visit, tag)` —— **只有 `tag`，没有 `pointerId`/手势标识**；`docs/05` 的 `TAP` 事件也只有 `{type, nowMs, hit}`。而 `docs/03` §3.2 要求的手势门是 `begin(pointerId)/claim(pointerId)/cancel(pointerId)`。**事件语言里没有表达「同一次手势」的字段，夹具在原理上就无法覆盖这条规则。** 我实测确认：`grep -l "pointerId\|gesture" contract-fixtures/*.json` → 无。

**我设计的补充用例（写在 `review-H1/lead-h1-probes.mjs`，不改项目）与实测结果：**

| 用例 | 预期 | 实际 |
| --- | --- | --- |
| Q2a-1 同一次手势第一次 `claim` | `true` | ✅ `true` |
| Q2a-2 同一 id 重复 `claim` | `false` | ✅ `false` |
| Q2a-3 新 `begin` 作废旧手势 | 旧 id `claim=false` | ✅ `false` |
| Q2a-4 新手势自身可 `claim` | `true` | ✅ `true` |
| Q2a-5 `cancel` 后 `claim` | `false` | ✅ `false` |
| Q2a-6 连续 10 次独立手势 | 10 次全发奖 | ✅ 10 |
| Q2a-7..9 10 次寻访的账务 | 30000 毫币 / visitCount 10 / visitCoinsMilli 30000 | ✅ 全对 |
| Q2a-10 无手势门时重复投递 2 次的后果 | visitCount=2（量化风险） | ✅ 2 |
| Q6a-4 500 次手势各重复投递 4 次 | 仍然只有 500 次发奖 | ✅ 500 |

**⇒ 实现是对的，但没有任何自动化测试守着它。** 这是我给 0.1 定「有条件通过」的理由之一。

### Q3. 测试里有没有「只检查显示字符串而没有检查账务」的断言？

四个测试文件用的是自研 `R.add(id, 描述, 条件, 详情)` 断言器，共 **62 条**（t-fixtures 3 / t-gameplay 25 / t-ui 23 / t-visual 11）。

- **纯字符串断言只有 1 条**：`T02b`「`?debug=1` 面板标注 DEBUG ONLY」—— 它断言的是调试面板文案，**不涉及任何账务主张**，属正当用法。
- **其余所有含字符串的断言都与数值检查并列**（我逐条看过）：`T07f` 同时查 `coinsMilli` 相等 + 无面板 + `offlinePending`；`T08d` 同时查 `visitCount`/`coinsMilli` 不变 + `saveOk=false`；`T04d` 同时查等级不变 + 抖动。
- **唯一实质缺口是 H1-3**：`T04d` 查了「等级不变」但**漏了「一分不扣」**，而契约 §3.3 ③ 明文要求后者。

**⇒ 结论：没有「拿显示字符串糊弄账务」的断言；但 T04d 缺一个账务维度。**

### Q4. 在线与离线同样时长是否得到相同收益？

**是。我写了跨升级、跨前后台、跨多次退出的组合场景，全部逐毫币相同。**

| 场景 | 结果 |
| --- | --- |
| Q4a-1..8：Lv1/Lv2/Lv3 × 8 种时长（含 59999ms 不足一分钟、3600001ms 余数、7 天） | ✅ 8/8 在线 == 离线（`coinsMilli`、`carryNumerator`、`gainMilli` 三者全等） |
| Q4b-1：6×10 分钟 vs 1×60 分钟 | ✅ 相同 |
| Q4b-2：**3600×1 秒 vs 1×3600 秒** | ✅ 相同（整数毫币 + carry 的关键证据） |
| Q4c-1..5：Lv1 挂 30 分 → 升级 → Lv2 挂 30 分 | ✅ 300 + 360 = 640 金币，与手算一致 |
| Q4c-6：升级后离线 30 分 == 在线 30 分 | ✅ 相同 |
| Q4d-1..2：3 次「进后台→回前台」各 10 分钟 | ✅ 合计 300 金币 |
| Q4d-3：**3 次重开（BOOT/RELOAD）**累计 30 分钟 | ✅ 300 金币 |
| Q4e-1..6：重复回前台 / 刷新 / 重开 | ✅ 全部 `not-pending`、收益 0、余额不变 |
| Q4f-1..3：离线期间 5 次 TICK | ✅ 全跳过，只按离线发放一次 |
| Q4g-1..3：`previewOffline` | ✅ 不改入参，gain/carry 与真实发放逐值相等 |

### Q5. 存档损坏 / 写失败 / 数值超大 / 时间戳异常，会不会丢档或产生负数、NaN？

| 情形 | 结果 |
| --- | --- |
| 损坏存档（我实测 24 个输入，覆盖 §2.5 全部 18 条） | ✅ 一律 `corrupt` → 回退新游戏，**不补偿**（level=1 / coins=0 / 声望=0 / totalGainMilli=0） |
| 存储**读**抛错 | ✅ `kind='corrupt'`、`reason='read-failed'`，不崩溃，回退新游戏 |
| 存储**写**抛错 | ✅ `persistSave` 返回 `ok:false`（不抛出）；`T08d` 证明 UI 会**回滚点击**并提示「存档失败」 |
| 数值超大（`level=1e15`、`coinsMilli=MAX_SAFE`、7 天离线） | ✅ `clampAdd` 夹到 `MAX_SAFE`，**无 NaN、无负数**；饱和后 `visitCoinsMilli` 仍 `= visitCount×3000` |
| `nowMs = NaN / Infinity` | ✅ `invalid-timestamp`，收益 0，`lastSettleTsMs` 不变 |
| `nowMs` 早于 `lastSettleTsMs` | ✅ `clock-went-backwards`，**时间戳不倒退** |
| `nowMs` 等于 `lastSettleTsMs` | ✅ `duplicate-timestamp` |
| **非有限的 `lastSettleTsMs` 状态** | ❌ **产生 `NaN`**（H1-2）。但见下 |
| 非有限时间戳进后台 | ✅ `enterBackground` 回退为有限的 `state.lastSettleTsMs`，写出的存档**不含 `null`、能被自己读回** |

**H1-2 的可达性我专门查过（这决定了它是 P2 还是 P1）**：
- `src/platform/clock.ts` 的 `GameClock.now() = source() + offset`，`source` 是 `Date.now`；
- `createInitialState` 与 `loadSave` 都把 `nowMs` 规整为 `Number.isFinite(nowMs) ? Math.floor(nowMs) : 0`；
- `settle` 只在 `deltaMs > 0` 时才写 `lastSettleTsMs`，而那时 `Math.floor(nowMs)` 必然有限。

**⇒ 在已交付的代码路径上，非有限的 `lastSettleTsMs` 无法到达**（唯一入口是 `debugShift(NaN)`，那是 `?debug=1` 的调试助手）。所以定 **P2**：这是「契约 §3.3 给 `applyUpgrade` 加了护栏、§3.1 却没给 `settle` 加」的**不对称**，属纵深防御缺口，不是现行 bug。

### Q6. 连续高频点击与反馈动画：是否可能丢点击或阻塞？

**账务层不会丢、不会阻塞（我实测）。动画层的阻塞我只有间接证据。**

| 检查 | 结果 |
| --- | --- |
| 2000 次独立手势 → 发奖次数 | ✅ **2000 次全部发奖**（无上限、无冷却、无递减，符合 §3.2） |
| 2000 次奖励金额 | ✅ `coinsMilli = 6000000`（= 2000×3000） |
| 2000 次「手势 + 寻访」同步耗时 | ✅ **2ms**（远低于一帧 16.7ms，不会阻塞） |
| 500 次手势各重复投递 4 次 | ✅ 仍然只有 500 次发奖（手势门有效） |
| 反馈动画是否阻塞后续点击 | **间接证据**：`T08d`（写档失败回滚）、`T04d`（抖动 + toast 后仍能继续点击并攒够金币升级）都证明 UI 在反馈后仍可点击。**但我没有测帧率或主线程长任务，也没有真机证据** → 标「部分未验证」 |

**⇒ 结论：账务层「不丢点击」已被我实测证明；「不被反馈弹窗打断」有 e2e 间接证据但无帧级/真机证据。**

### Q7. 0.1 对 0.2 的扩展点是否留得合理？哪些设计会让 0.2 返工？

**留得合理的部分：**
- **存档有版本机制**：`schemaVersion` + `SAVE_SUPPORTED_SCHEMA_VERSIONS=[1,2]` + 命名迁移函数 `migrateV1ToV2`，已有 v1→v2 的成功先例 ✅
- **事件序列可扩展**：`docs/05` 的类型表是开放的，0.2 加 `BUY_PLOT` / `OPEN_BUILDING` 等事件不需要改现有语义 ✅
- **幂等与一次性语义已有范式**：进后台幂等（`F06`）、离线一次性（`F09`/`F17`/`F18`）、手势门 —— 0.2 的「重开不重抽、失败不吃队列、重复操作不扣两次」可直接复用 ✅
- **「扩建前结算旧产速」与 0.1 的「升级前先结算旧产速」同构**，已有 `F04`/`F19` 作模板 ✅
- **纯函数 + 平台无关核心**的边界清晰，0.2 加玩法不用动渲染层 ✅

**会让 0.2 返工的设计（我按严重度排）：**

| # | 设计 | 为什么会返工 | 严重度 |
| --- | --- | --- | --- |
| R1 | **声望被冻结为「安全整数」**：`docs/02` I9 要求 `Number.isSafeInteger`，`docs/02` §2.5 第 13 条对小数直接判 `not-integer` 损坏 | 0.2 明文要求「**小数声望保留**」（单次寻访声望 `= 1 × (1 + 0.20 × A)` 是小数）。**要加小数声望必须升 v3 并把声望单位改成「毫点」**，否则只能四舍五入（违反 0.2 条件） | **高** |
| R2 | **`level` 是单个标量**，`upgrade.ts` 只服务市政厅一栋 | 0.2 需要「每栋建筑的 L」+ 城区 D + 配套 F + 宣传 A（4 条独立升级线）。**`EconomyState.level` 装不下**，`applyUpgrade` 要重写，`upgradeCostCoins` 要按建筑参数化 | **高** |
| R3 | **`parseSave` 把 `ver === 1` 硬编码**，没有通用迁移链 | 加 v3 必须再改 `parseSave` 的分支与 `SAVE_V1_NUMERIC_FIELDS` 的用法；版本越多分支越乱。建议改成 `migrations[v]` 表驱动 | 中 |
| R4 | **`I11: visitCoinsMilli === visitCount × 3000`** 把寻访金币硬绑在固定 3000 | 0.2 若让宣传等级也影响寻访金币，这条不变量直接破。应改成 `visitCoinsMilli` 独立累计 + 不变量改为「= 累计发放额」 | 中 |
| R5 | **没有 `seed` / `genVersion` / `plots[]` / `purchaseOrder[]` 字段** | 0.2 的「重开不重抽、种子加版本加购买历史可复现」需要这些；它们必须进 v3 存档 | 中 |
| R6 | **32/32 夹具把 0.1 语义冻死了** | 0.2 改市政厅公式（R2）会让 `F04`/`F05`/`F15`/`F19` 全红。需要**按版本分夹具集**（如 `fixtures/v1/`、`fixtures/v2/`），而不是原地改 | 中 |
| R7 | `visitCoinsMilli` 与 `totalGainMilli` 在饱和时靠 `clampAdd` 静默截断 | 0.2 数值更大时，`I8`（`totalGainMilli = 时间累计 + 寻访累计`）在饱和后会不成立。需要显式溢出策略 | 低 |

### Q8. 隔离：用你自己的方式核查项目是否引用了禁区目录

**项目自带检查器结果**（我实跑）：
```
=== 项目专用隔离检查：PASS（0 处违规 / 93 处白名单 / 扫描 200 个文本文件）===
exit=0
```

**我自己的独立扫描**（不复用它，直接在 shell 里拼接禁名以免自毒）：

| 范围 | 结果 |
| --- | --- |
| `src/`、`test/`、`tools/`、`tests/`、`contract-fixtures/` | ✅ **零命中** |
| 全仓（含 `docs/`、`ISOLATION.md`） | 命中 8 个文件，**全部是「声明禁区的文档」**（`ISOLATION.md`、`docs/09`、`docs/10`、`docs/11`、`docs/12`、`docs/13`、`docs/16`、`docs/17`）—— 属正当引用，不是代码依赖 |
| 代码里的 `import`/`require`/`fs.readFileSync` 指向禁区 | ✅ **零命中** |

**⇒ 隔离是真的干净的：源码零引用，只有文档在「声明禁区」。**

**自带检查器有无可绕过之处？我实测击穿了 2 处：**

我造了一个 `/tmp/iso-test/` 沙盒，用 `--root` 跑自带检查器：

| 沙盒文件 | 内容 | 检查器结果 |
| --- | --- | --- |
| `src/a.ts` | 含禁名 #4 的字面量 | ✅ FAIL（正确命中） |
| `src/d.json` | 同上，`.json` 里 | ✅ FAIL（说明 `.json` 有被扫） |
| `NOTES`（无扩展名） | 同上 | ✅ FAIL（说明 `''` 扩展名有被扫） |
| **`src/b.ts`** | **`'little-' + 'town'` 拼接** | ❌ **PASS（漏检！）** |
| **`release/c.txt`** | 含禁名 #4 | ❌ **PASS（漏检！）** |
| 把 `release/` 改名成 `rel2/` 后重跑 | 同一个文件 | ✅ FAIL → **证明是 `IGNORE_DIRS` 里的 `release` 导致漏检** |

**⇒ 两处绕过（已记为 H1-5）：**
1. **`release/` 目录永不扫描**（`IGNORE_DIRS = {node_modules, .git, release}`）。本副本的 `release/` 现在只有压缩包，风险低；但**只要有人把文本放进 `release/`，检查器就看不见**。
2. **字符串拼接可绕过规则 A 与规则 C**。讽刺的是检查器自己就用这招（`P('little-','town')`）来避免自命中 —— 它知道这个手法，但没有检测它。

**顺带确认检查器的两处「设计得好」的地方**：
- 白名单**只在 `.md`/`.txt` 生效，源码文件永不享受白名单**（`check-isolation-project.mjs:40`）—— 这挡住了「往源码里塞禁名再把自己加白」的路子 ✅
- 输出掩码（`MASK_OUTPUT`）防止检查日志自己中毒 ✅

---

## 3. 我实际运行的命令与原始输出

全部原始日志在 `review-H1/logs/`。

### 3.1 输入包完整性（评审前置门槛）

```
$ grep -v '^==>' review-H1/baseline-sha256-start.txt > /tmp/base-H1.txt
$ sha256sum -c /tmp/base-H1.txt | grep -c ": OK$"
72        # 清单 72 条 = contract-fixtures 21 + src 30 + test 8 + tests 1 + tools 12
          # 失败或缺失 0
```
`src/`、`test/`、`tests/` 与 L3 副本 `diff -rq` → **各 0 处差异**。

### 3.2 基线：typecheck / 构建 / 黑盒夹具

```
$ npm run typecheck        → exit=0
$ npm run build:core       → core built: constants, economy, visit, upgrade, save, offline   exit=0
$ npm run test:fixtures
=== 黑盒夹具校验：32/32 通过 ===
exit=0
```

### 3.3 我的独立探针（107 项）

```
$ npx esbuild src/game/gesture.ts --bundle --format=esm --platform=node --outfile=review-H1/build/gesture.js
$ node review-H1/lead-h1-probes.mjs
...
===== Q2-a 手势门（重复点击）—— 契约夹具无法覆盖，改用前端实现直测 =====
===== Q2-b 契约 §2.5 第 7 条：schemaVersion 非有限 应报 not-integer =====
  ❌ Q2b-2 schemaVersion=Infinity 的 reason（契约 §2.5 第 7 条要求 not-integer）  期望 not-integer，实际 bad-type
===== Q5-d 数值超大：是否产生 NaN / 负数 / 越界 =====
  ❌ Q5d-1 settle(非有限 lastSettleTsMs) 不产生 NaN coinsMilli  coinsMilli=NaN reason=ok
  ❌ Q5d-2 settle(非有限 lastSettleTsMs) 不产生 NaN carryNumerator  carry=NaN
...
     → 2000 次手势 + 寻访耗时 2ms
============================================
总计：104 通过 / 3 失败
============================================
```

### 3.4 隔离检查

```
$ npm run check:isolation
=== 项目专用隔离检查：PASS（0 处违规 / 93 处白名单 / 扫描 200 个文本文件）===
exit=0
```
绕过实测见 §2 Q8 与 §4.8 的沙盒输出。

---

## 4. 我没能验证的（**未验证清单**）

| # | 未验证项 | 原因 |
| --- | --- | --- |
| U1 | **真机画面可操作、旋转/缩放不触发寻访、UI 不把触摸传给场景**（迭代计划 §5 第 6 条） | 无真机、无微信官方模拟器；不在我的可验证范围内 |
| U2 | **Three.js WebGL2 在目标手机实际运行**（§5 第 7 条） | 同上 |
| U3 | **「玩家无需讲解即可完成第一次寻访和第一次升级」**（§5 第 1 条） | 这是可用性判断，需要真人测试；自动化只能证明「技术上做得到」 |
| U4 | **帧率 / 主线程长任务 / 反馈动画是否真的不阻塞** | 我只测了核心层吞吐（2ms/2000 次），没测渲染帧；无真机 |
| U5 | **微信端（`src/wechat/`）的行为** | 属 H2 范围，本报告不覆盖 |
| U6 | **`release/` 里历史压缩包的内容是否含禁名** | 检查器不扫 `release/`；我也没解包逐个查（见 H1-5） |
| U7 | **0.1 之外版本（0.2+）的任何行为** | 超出 0.1 验收范围；Q7 的返工判断是**基于文档与代码结构的推断**，不是实测 |
| U8 | **本副本 `docs/07` 校验和清单是否自洽** | 该副本 `src/`、`test/` 已被 L3 改动而 `docs/07` 未重算（属 L3 遗留，见待决问题） |

---

## 5. 我读过的目录清单

| 目录 | 读法 |
| --- | --- |
| `frontend-rebuild-hm-work-H1/` | 全量（`src/` 全部 30 个文件、`test/` 8 个、`tests/` 1 个、`tools/` 12 个、`contract-fixtures/` 21 个、`docs/11`、`ISOLATION.md`） |
| `frontend-rebuild-contract-v1/` | `docs/01`–`docs/11`、`api/contract.d.ts`、`types/game-state.d.ts`、`fixtures/`（清单与规模） |
| `/vol1/ai/projects/wyszz-new/docs/` | 只读**迭代计划 v2**（§5、§6）—— 任务书允许 |
| `review-H1/` | 前一位 Agent 的半成品（**只当线索，未采信其结论**） |

**明确没有读**：任务书 §2 与用户指令列出的禁区（5 个禁名目录、`app/`、旧截图、旧公开页面、旧模型素材、`docs/` 旧截图与旧「第二步」报告）、其它 `frontend-rebuild-hm-work-*` 副本、`frontend-rebuild-hm-lead-验收/`。**没有读取、打印或外传任何凭据。**

---

## 6. 我写入的文件及 SHA256

只写在允许范围内（`review-H1/` 与 `docs/20-*.md`），**未修改 `src/`、`test/`、`tests/`、`tools/`、`contract-fixtures/` 里任何已有文件**。

| 文件 | 说明 |
| --- | --- |
| `review-H1/lead-h1-probes.mjs` | 我自写的 107 项独立探针（新增） |
| `review-H1/build/gesture.js` | 用 esbuild 把 `src/game/gesture.ts` 编译出来供探针导入（新增） |
| `review-H1/logs/lead-h1-baseline.txt` | typecheck / build / fixtures 原始输出（新增） |
| `review-H1/logs/lead-h1-probes.txt` | 探针原始输出（新增） |
| `docs/20-H1-独立验收评审报告.md` | 本报告（新增） |

SHA256 见随报告附的清单（见 §8）。

**收尾复核**：写完本报告后，我再次用 `sha256sum -c review-H1/baseline-sha256-start.txt` 校验 `src/`、`test/`、`tests/`、`tools/`、`contract-fixtures/` —— 结果见 §8。

---

## 7. 待决问题（我不猜）

| # | 问题 | 为什么需要你决定 |
| --- | --- | --- |
| D1 | **H1-1 该不该改？** 改 `save.ts:55` 会动核心代码；改完还要给 `F11` 加变体 —— 而 `contract-fixtures/` 是**冻结的契约样例**，加变体会让 32/32 变成 33/33，**这算不算动契约？** | 契约是冻结物，改它需要你批准。**我没有改，只报告。** |
| D2 | **H1-4（手势门无回归测试）要不要补？** 补测试要改 `test/`（任务书禁止我改已有文件，但可以新增？任务书说「只评审，不改 src/、test/、tests/、tools/、contract-fixtures/ 里任何已有文件」——新增测试文件是否算违规，我理解为「新增可以、改已有不行」，但**不确定**，故不擅自做） | 需要你明确「新增测试文件」是否在允许范围内 |
| D3 | **H1-5 的两处绕过要不要修？** 修 `tools/check-isolation-project.mjs` 属于改 `tools/` 已有文件，任务书明确禁止 | 需要你决定由谁修 |
| D4 | **本副本 `docs/07` 校验和清单已过期**（L3 改了 `src/`、`test/` 但没重算）。这是 L3 的遗留，不影响 H1 评审，但**合并回主目录前必须重算** | 与 L3 的合并决定绑定 |
| D5 | **迭代计划 §5 第 6、7 条（真机）由谁验证、何时验证？** 我无法验证，但它们 0.1 进下一版的明文条件 | 需要你安排真机/官方模拟器验收 |

---

## 8. 收尾复核结果

**写入文件 SHA256 与 `src/`/`test/`/`tests/` 未变的复核输出**，见 `review-H1/logs/lead-h1-final-check.txt`（与本报告同批生成）。

复核结论：`baseline-sha256-start.txt` 的 **72 条全部 OK，0 失败 0 缺失** ⇒ 我在整个评审过程中**没有改动任何被审文件**。

---

*本报告由 Lead 独立产出。所有数字均为我实际运行所得；未验证项见 §4；我尝试过但未发现问题的攻击面见 §1 末表；我不确定的地方见 §7。*
