# 27 · M2 报告（H1-1…H1-5 修复 + H2 层可修 P1）

日期：2026-10-14 · 执行 Agent：M2 · 工作副本：`frontend-rebuild-hm-work-M2/`（由 `frontend-rebuild-hm/` 复制，只在副本内工作）

输入（只读）：`docs/20`（H1 独立验收评审，在 `frontend-rebuild-hm-work-H1/docs/`）、`docs/21`（H2 微信适配层真机风险评审，在 `frontend-rebuild-hm-work-H2/docs/`）、`docs/24`（H2 修复报告，在 `frontend-rebuild-hm-work-FIX2/docs/`）。

## 0. 结论摘要

| 项 | 内容 | 结果 |
|---|---|---|
| A | H1-1 `save.ts`：非有限 `schemaVersion` 报 `not-integer` | ✅ 已修，T14a–T14g（7 条新用例） |
| B | H1-2 `economy.ts` `settle` 状态护栏 | ✅ 已修，T15a–T15f（6 条新用例） |
| C | H1-3 玩法「金币不足」补 `coinsMilli` 未扣断言 | ✅ 已补，T04d 加强 + T18（精确版） |
| D | H1-4 新增「同一次手势重复投递只发一次奖」自动化 | ✅ 已加，T16a–T16f（单元）+ T17a–T17c（e2e） |
| E | H1-5 隔离检查：`release/` 整目录排除 → 只排除二进制 + 负例 | ✅ 已修，E1–E6（6 条负例，已接入回归） |
| F | H2 层 P1：只修小而稳、不改变规则的三条 | ✅ H2-05 / H2-06 / H2-13 已修；H2-07 / H2-14 进待决 |

**全量回归：7 次全绿**（1 次基线 + A–E 各 1 次 + F 1 次，另有 1 次接线失败的局部试跑）。最终一次（F）：**12/12 步 PASS，197.3s，exit 0**；样例数只增不减（玩法 24→29、UI 23→30、视觉 16→18、浏览器全量 66→80、微信替身 37→38、新增核心护栏 19、新增隔离负例 6），**没有任何旧用例因本次改动而失败或改断言迁就代码**。

`src/core` 只动了 A、B 两处，逐行 diff 见 §4。

## 1. 任务与硬约束（照做）

1. 先把原目录复制为 `frontend-rebuild-hm-work-M2`，**只在副本里工作**（已 `rsync -a --exclude node_modules` + 软链 `node_modules`；复制后 `diff -rq` 逐文件校验一致）。
2. 每项**改前先 `npm run regress` 记基线，改后全量回归**；样例数只增不减。
3. 任何旧用例失败 ⇒ 该项回退；**绝不改测试去迁就代码**。
4. `src/core` 只允许 A、B 两处改动，且要在报告里贴逐行 diff。
5. 判断不了的事写进「待决问题」；不进入 0.2；不改 0.1 已冻结的规则与数值。
6. 隔离约束：不读取/不引用 5 个被禁目录；隔离检查会扫描包括 `docs/**` 在内的全部文本文件（因此本报告也不写出禁名字面量）。

## 2. 环境

| 项 | 值 |
|---|---|
| 副本 | `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm-work-M2/` |
| Node | v24.15.0（`/mnt/ssd/apps/nodejs_v24/bin`，每次命令前 `export PATH`） |
| 技术栈 | Three.js 0.186.1 / TypeScript 7.0.2 / esbuild 0.28.2 / puppeteer-core 25.13.0 |
| 回归 | `npm run regress` = `node tools/regress.mjs`，基线 10 步 → 本次 12 步（新增 `core-guards`、`isolation-neg`） |
| 证据 | `evidence/regress-<UTC时间戳>/`（每步日志 + `summary.json`） |

## 3. 逐项执行记录

### A · H1-1：`schemaVersion` 非有限 → `not-integer`

- **依据**：契约 `docs/02 §2.5` 第 6 条只把「不是 number」判为 `bad-type`；第 7 条「非有限**或**非整数」判 `not-integer`。原实现把非有限判成了 `bad-type`。
- **改动**（`src/core/save.ts`，1 行改 + 2 行注释）：见 §4。
- **测试**：新增 `test/t-core-guards.mjs`（**项目自有**测试，**未触碰 `contract-fixtures`**），T14a–T14g：
  - T14a/T14b `1e999 → Infinity` / `-1e999 → -Infinity` ⇒ `not-integer`（修复点）
  - T14c 小数 `1.5` ⇒ `not-integer`（原有行为未变）
  - T14d 字符串 `"2"` ⇒ `bad-type`（第 6 条未被误伤）
  - T14e `schemaVersion=3` ⇒ `unsupported-version`；T14g 缺字段 ⇒ `missing-field`
  - T14f 合法 v2 存档仍解析成功（`ok=true / migrated=false / sourceVersion=2`）
- **踩坑记录**：`JSON.stringify(Infinity)` 会变成 `null`，所以「非有限」样例**必须**用文本注入原始字面量（`JSON.parse('1e999')` → `Infinity`）。第一次探针误报 `bad-type` 就是这个原因，改用 `encRaw()` 文本替换后才测到真实行为。
- **改前基线**：`regress-20261014-023602` 10/10 PASS、184.3s。
- **改后回归**：`regress-20261014-024347` 11/11 PASS、183.4s；新步骤 `core-guards` 7/7；其余样例数全部与基线一致（32/32、32/32、24、23、16、66、37、隔离 0 违规）。
- **风险**：唯一的对外行为变化是「原始 JSON 文本里出现 `1e999` 这类非有限字面量」时 reason 从 `bad-type` 变 `not-integer`。`JSON.stringify` 无法产生这种文本，正常存档与全部 32 条契约夹具都不受影响（夹具 32/32 未变）。

### B · H1-2：`settle` 状态护栏（`lastSettleTsMs` 非有限）

- **依据**：与契约 `docs/03 §3.3`「状态护栏」同款思路。旧实现里 `deltaMs = now - NaN = NaN`，而 `NaN === 0`、`NaN < 0` 都为假 ⇒ 直接落到计算分支，返回 `reason='ok'`，并把 `coinsMilli`/`carryNumerator` 写成 `NaN`（**静默污染存档**）。
- **改动**（`src/core/economy.ts`，1 行加 + 8 行注释，放在既有 `nowMs` 检查**之前**）：见 §4。
- **测试**：`test/t-core-guards.mjs` T15a–T15f：
  - T15a `NaN` ⇒ `invalid-timestamp`、`gainMilli=0`、**返回同一 state 对象引用**（未写回）
  - T15b 状态未被污染：6 个数值字段逐一不变、无一变 NaN
  - T15c `Infinity` ⇒ 同样不写回、不产生 NaN
  - T15d 对照：`nowMs=NaN`（状态有限）⇒ `invalid-timestamp`（原有行为未变）
  - T15e 对照：正常 60 秒仍按整数毫币结算（Lv1 → 10000 毫币、`lastSettleTsMs` 正确推进）——护栏没有误伤正常路径
  - T15f 无副作用：同一 NaN 状态连续调用两次，都报 `invalid-timestamp` 且状态始终未变
- **改前基线**：`regress-20261014-024347`（A 之后的绿灯）11/11。
- **改后回归**：`regress-20261014-024744` 11/11 PASS、179.7s；`core-guards` 7/7 → 13/13。
- **风险**：若 `lastSettleTsMs` 与 `nowMs` **同时**非有限，两条护栏的 reason 相同（`invalid-timestamp`）、返回值相同（`state` 原样、`gainMilli=0`），差别只是哪一条先短路。未改任何规则与数值。

### C · H1-3：「金币不足」补 `coinsMilli` 未扣断言

- **问题**：原 `T04d` 只断言「等级不变 + 有抖动 + 有『金币不足』提示」，**没有断言金币没被扣**——「一分不扣」是契约 `docs/03 §3.3` ③ 的明文条件。
- **改动**（`test/t-gameplay.mjs`，只加强、不删除任何原条件）：
  1. `T04d` 原 3 个条件保留，新增 `0 ≤ coinsMilli 增量 < 费用` 两个条件。
  2. 新增 **T18**：在**冻结时钟**页上做「严格相等」的精确断言。
- **为什么不能直接断言严格相等**：契约 §3.3 ① 规定升级前**强制先 settle**，真实时钟下这一步会把「上次结算到本次点击」的在线时间结进 `coinsMilli`。实测 `delta=73` 毫币（`costMilli=20000`），所以「严格相等」在真实时钟下必然抖动。T18 把时钟冻结（`__fakeNow` + `setAutoTick(false)`），settle 走 `duplicate-timestamp`（delta=0、收益 0），于是：
  - `T18`：先点 6 个居民得 18000 毫币（`canUpgrade=false`），再真实射线点击市政厅 ⇒ **18000 → 18000（差 0）**、等级不变、命中 `市政厅`、有抖动、提示「金币不足，还差 2 金币」。
- **改前基线**：`regress-20261014-024744`（B 之后）11/11。
- **改后回归**：`regress-20261014-025159` 11/11 PASS、187.6s；玩法 24/24 → **26/26**，浏览器全量 66 → 68。
- **风险**：无源码改动；新增断言是「只加强」，不会让原本通过的路径变红（已用全量回归验证）。

### D · H1-4：新增「同一次手势重复投递只发一次奖」自动化

- **问题**：`GestureGate`（`src/game/gesture.ts`）已实现并被 `src/app/input.ts` 使用，但 `test/`、`tests/` 里**零引用**（grep 不到 `gesture`）——契约 `docs/03 §3.2` 的这条明文条件此前**没有自动化覆盖**。
- **改动**：
  1. `test/t-core-guards.mjs` 新增 T16a–T16f（**单元层**，直接 `import { GestureGate } from '../src/game/gesture.ts'`；Node ≥22.18 的 TS 类型擦除在本机 v24.15.0 实测可用 ⇒ 测的就是 `input.ts` 实际使用的那份实现，不是另写一份等价类）：
     - T16a `claim` 同一 id 三次 = `true/false/false`
     - T16b `begin` 覆盖未关闭的旧手势：旧 id 不可认领、新 id 可以（防「旧手势延迟抬起」重复发奖）
     - T16c 未 `begin` 时 `claim(0)` 一律 false
     - T16d `cancel` 后同 id 不可认领（拖拽/捏合/被面板吞掉的手势不得发奖）
     - T16e 对照：连续 10 次独立手势 ⇒ 10 次都发奖
     - T16f `claimed` 集合上限（>64 清空）不影响判定：200 次独立手势仍全部发奖
  2. `test/t-gameplay.mjs` 新增 T17a–T17c（**e2e**，真实鼠标射线点击 + 重复派发同一手势的抬起）：
     - T17a 真实点击 +1 寻访后，再派发同 `pointerId` 的 `pointerup` ×4 与 `pointercancel` ⇒ 寻访**不再增加**、`inputStats.taps` 不增加（实测 `{v0:0,v1:1,v2:1,taps1:1,taps2:1}`）
     - T17b 对照：连续 10 次独立手势（真实点击）⇒ 10 次都发奖（实测 10/10）
     - T17c 无 pageerror
- **改前基线**：`regress-20261014-025159`（C 之后）11/11。
- **改后回归**：`regress-20261014-025649` 11/11 PASS、190.4s；`core-guards` 13 → **19**、玩法 26 → **29**、浏览器全量 68 → 71。
- **风险**：纯新增用例，无源码改动。T17a 的判定不依赖「同一次手势被投递几次」的时序细节，只看「奖励与 taps 不增加」，因此在真实时钟下也稳定。

### E · H1-5：隔离检查 `release/` 整目录排除 → 只排除二进制

- **问题**（H1 报告 §4.8 实测）：`IGNORE_DIRS` 含 `release/` ⇒ 该目录下**文本文件永不扫描**，是可被塞入禁名的盲区。
- **改动**（`tools/check-isolation-project.mjs`）：
  1. `IGNORE_DIRS` 3 → 2：只剩 `node_modules/`、`.git/`；**`release/` 不再整目录排除**。
  2. 新增 `BINARY_EXTS`（压缩包/图片/字体/媒体/PDF/`.wasm`），在 `collect()` 里**按扩展名**排除二进制文件（任何目录下都排除），并打印「排除的二进制文件 N 个」。`release/` 下的 `.txt`（打包原始输出、校验和清单）**不在**此列 ⇒ 必须被扫描。
  3. 头部注释同步改写（说明为什么不能整目录排除）。
- **直接证据（同一夹具、新旧检查器对照）**：夹具 `release/SHA256SUMS-demo.txt` 第 2 行含禁名
  - **旧检查器**（原目录版本）：`排除目录…node_modules/ .git/ release/` → `候选文件数：0；扫描文本文件数：0` → `PASS（0 处违规 / 0 处白名单 / 扫描 0 个文本文件）`，**exit 0（盲区成立）**
  - **新检查器**（M2）：`排除目录…node_modules/ .git/` → `扫描文本文件数：1` → `FAIL | A | release/SHA256SUMS-demo.txt:2 | 出现禁目录名（#1）`，**exit 1（盲区关闭）**
- **负例测试（新增，已接入回归）**：`tools/test-isolation-negatives.mjs`（`npm run test:isolation-neg`，regress 第 12 步）在系统临时目录建夹具、跑真实检查器，断言 6 条：
  - E1 `release/` 下**文本**文件里的禁名 ⇒ 报 `FAIL`（H1-5 ① 的修复证据）
  - E2 `release/` 下**二进制**（真 gzip 的 `.tar.gz`，内容含禁名）⇒ 按扩展名排除、不报命中
  - E3 `docs/` 下「禁止…禁名」同行声明 ⇒ 记 `WHITE`、不计违规（白名单未被误伤）
  - E4 **源码**文件里即使写了禁止性措辞 ⇒ 仍报 `FAIL`（源码永远不享受白名单）
  - E5 夹具树有违规时退出码必须为 1（不得静默通过）
  - E6 真实项目根在改动后仍 `PASS`（新规则没有引入误报）
  - 安全设计：夹具在 `/tmp`（不在项目内）、跑完即删；禁名由片段拼接（该文件自身也会被扫描）；检查器输出保持**掩码**开，因此落进 `evidence/regress-<时间戳>/` 的日志不会污染后续扫描。
- **真实项目实测**：`release/` 下 **3 个 `.txt` 现在纳入扫描**、7 个 `.tar.gz` 按扩展名排除；全项目排除的二进制文件 **44 个**（evidence 截图 + release 压缩包）。隔离检查仍 `PASS（0 处违规 / 103 处白名单）`。
- **改前基线**：`regress-20261014-025649`（D 之后）11/11。
- **改后回归**：`regress-20261014-030315` 12/12 PASS、194.0s（新步骤 `isolation-neg` 6/6）。
  - 注：中间有一次接线失误——新步骤的编辑吃掉了上一步的闭括号，`regress.mjs` 解析失败（未产生任何测试结果），修正后先做了一次**局部试跑**（`evidence/regress-20261014-030310`，只跑第 11/12 步）确认接线正确，再跑全量。该局部目录保留在证据里，未删除。
- **已知限制（未修，进待决）**：规则 A/C 仍只匹配**字面量**，用字符串拼接（例如把禁名拆成两段再 `+`）仍可绕过——H1-5 的 ② 属于「需要 AST/构建图分析」的更大改动，本次按任务要求只修 ①，并把 ② 写进待决问题（D-M2-1）。

### F · H2 层 P1：只修小而稳、不改变规则的三条

**先说清单**（`docs/21` 的 P1 共 6 条；P0 三条 H2-01/02/03 与 P1 H2-04 已在 FIX2 修完，且**已包含在本次 M2 的基线副本里**——我核对了 `src/app/input.ts`、`src/wechat/main.ts`、`src/wechat/wx.d.ts`、`src/app/app.ts` 四个文件与 FIX2 副本**逐字节相同**，`input.reset()` + `onHide/onShow` 清残留触点都在）：

| 编号 | 结论 | 处理 |
|---|---|---|
| H2-04 | 已在 FIX2 修（继承） | 未重复修；另手动实跑 FIX2 的 `test/wechat-strict.mjs` = **6/6 PASS** |
| **H2-05** 离屏画布累积 | **本次已修** | 见 F1 |
| **H2-06** 安全区 | **本次已修** | 见 F2 |
| **H2-13** 胶囊按钮 | **本次已修** | 见 F3 |
| H2-07 `compileType` | **待决** | 需微信开发者工具模板才能验证，本机不可验证（D-M2-2） |
| H2-14 存档可能被系统清理 / 无云备份 | **待决** | 产品决策（D-M2-4） |
| H2-08…H2-12（P2） | 未动 | 不在 M2 范围 |
| H2-15（P2，已核验安全） | 未动 | 仅记录 |

#### F1 · H2-05 离屏画布/纹理累积 —— 已修

- **修法**（`src/ui/fx.ts`）：给文案纹理加**缓存**（`Map<key, CanvasTexture>`，key = 文案|颜色|描边|尺寸），`floatText()` 与 `setLabel()` 改为从缓存取；**LRU 上限 24，且绝不驱逐仍在用的纹理**（`texInUse()` 检查 label 与全部飘字精灵）；`floatText/setLabel` **不再 `dispose()` 旧 map**（纹理由缓存持有，dispose 会把缓存里的纹理销毁掉）；`dispose()` 改为「先摘引用、再统一销毁缓存」。
- **验证**：
  - `test/t-visual.mjs` **T19**（页内计数 `document.createElement('canvas')`）：第 1 轮 10 次真实点击新建 **2** 张（= 不同文案数，首次建纹理），第 2 轮 10 次再新建 **0** 张（修复前每轮飘字都新建，≈ +20/轮）；两轮各 10/10 次发奖、飘字仍在场 `fx=9`。
  - `test/wechat-sim.mjs` **W13**（真实 `wx.createCanvas` 计数，替身已有的 `__canvasN`）：10 次真实 wx 触摸后 `9→11`（首次建 2 张纹理），再 10 次 `11→11`（**稳态 0 增长**）。
- **风险**：纹理在多个精灵间共享。若在仍被使用时被驱逐/销毁会出现贴图错乱——已用「不驱逐在用纹理」+ 上限 24（实际不同文案 ≤ ~7）规避；`dispose()` 的语义从「每个精灵销毁自己的纹理」变成「缓存统一销毁」，已相应改写并保留 `ringTex/dotTex` 的销毁。

#### F2 · H2-06 安全区 —— 已修

- **修法**：`src/wechat/main.ts` 新增 `safeInsets()`（`getSystemInfoSync`/`getWindowInfo` 的 `safeArea`；官方明确「部分机型…不会返回 safeArea」⇒ 缺失/异常/非有限一律 **0**）；`AppHost` 增加可选 `safeInsets?()`；`GameApp.applySize` 把它传给 `hud.resize(w,h,dpr,env)`；`Hud` 里 `topH += safeTop`、底栏 `safeBottom += safeBottom`（世界视口随之收缩），并在 `layoutInfo` 暴露 `safeTop/safeBottom/bottomInset`。
- **默认零值原则**：`safeTop/safeBottom` 缺省为 0 ⇒ **布局与改动前逐像素一致**（这是既有 30 条 UI/视觉用例不被打破的关键）。
- **验证**（`test/t-ui.mjs`）：T20a 基线公式不变（`topH=84`、`bottomH=73`、insets=0）；T20b 注入 `top=47/bottom=34` ⇒ `topH 84→131`、`bottomH 73→107`；T20c 安全区内的点判给顶栏（吞掉、不穿透成世界点击），安全区下方仍是世界区；T20d 无 pageerror；T21c 复位后恢复基线。
- **风险**：有安全区的机型上顶栏变高、可见场景区变小——**不改任何游戏规则与数值**，但画面观感变化需要真机截图确认；若某机型返回异常 `safeArea`，最坏情况是顶栏偏高/偏低（已用严格 sanitize + 缺失即 0 兜底）。

#### F3 · H2-13 右上角胶囊按钮 —— 已修

- **修法**：`src/wechat/main.ts` 新增 `capsuleRect()`（`wx.getMenuButtonBoundingClientRect()`，基础库 2.1.0 起；四字段必须全为有限数，否则 `null`）；`Hud` 用 `topContentW = capsule ? clamp(capsule.left - ox - 4, 200, cw) : cw`，`drawTop()` 改用 `topContentW`；**图层矩形与画布尺寸不变**（避免为让位而重建画布，与 F1 的方向一致）。
- **验证**（`test/t-ui.mjs`）：T21a 注入 `{left:296,…}`（390 宽屏）⇒ 顶栏内容宽度 `390 → 292`（= 胶囊左边界 − 4），不再被胶囊盖住；T21b 胶囊区域内的触摸判给顶栏（不穿透成世界点击）；T21c 复位恢复 `390`。
- **风险/残留**：①内容区被压到最小 200px，极窄机型上顶栏更挤（有下限保护）；②落在胶囊上的触摸**被微信原生吞掉**，这是平台行为、应用层无法拦截——修完的效果是「不再有内容被盖住 + 不再把胶囊区当成可点区域」，真机仍需肉眼确认（D-M2-7）。

- **F 的改前基线**：`regress-20261014-030315`（E 之后）12/12。
- **F 的改后回归**：`regress-20261014-031619` **12/12 PASS、197.3s、exit 0**：类型检查 PASS、构建 PASS、契约样例 32/32、回放 32/32、核心护栏 19/19、玩法 29/29、UI **30/30**、视觉 **18/18**、浏览器全量 **80/80**、微信替身 **38/38**、隔离 0 违规、隔离负例 6/6。

## 4. `src/core` 逐行 diff（只有 A、B 两处）

与**基线副本** `frontend-rebuild-hm/` 对比；`diff -rq` 确认 `src/core` 下只有这两个文件不同。

```diff
--- frontend-rebuild-hm/src/core/save.ts	（基线）
+++ frontend-rebuild-hm-work-M2/src/core/save.ts	（M2）
@@ -52,7 +52,9 @@
   const ver = o['schemaVersion'];
   if (ver === undefined) { return fail('missing-field', 'missing schemaVersion'); }
   if (typeof ver !== 'number') { return fail('bad-type', 'schemaVersion is not a number'); }
-  if (!Number.isFinite(ver)) { return fail('bad-type', 'schemaVersion is not finite'); }
+  // 契约 docs/02 §2.5 第 7 条：schemaVersion「非有限**或**非整数」都报 not-integer
+  // （第 6 条只把「不是 number」判为 bad-type）。H1-1：原实现把非有限报成 bad-type，本次修。
+  if (!Number.isFinite(ver)) { return fail('not-integer', 'schemaVersion is not finite'); }
   if (!Number.isInteger(ver)) { return fail('not-integer', 'schemaVersion is not an integer'); }
   if (!(SAVE_SUPPORTED_SCHEMA_VERSIONS as readonly number[]).includes(ver)) {
     return fail('unsupported-version', 'schemaVersion ' + ver);
```

```diff
--- frontend-rebuild-hm/src/core/economy.ts	（基线）
+++ frontend-rebuild-hm-work-M2/src/core/economy.ts	（M2）
@@ -81,6 +81,14 @@
     return { state, result };
   };
 
+  /**
+   * 状态护栏（H1-2；与契约 docs/03 §3.3「状态护栏」同款思路）：
+   * `lastSettleTsMs` 非有限时，`deltaMs` 会变成 NaN，而 `NaN === 0` 与 `NaN < 0` 都为假，
+   * 旧实现会直接落到计算分支，返回 reason='ok' 且 coinsMilli/carryNumerator 全变 NaN。
+   * 现在改为：不结算、不写回、state 原样返回（同一对象），reason='invalid-timestamp'。
+   * 放在 `nowMs` 检查之前：状态非法时优先报状态问题（两者的 reason 相同，但不会读到 NaN 状态）。
+   */
+  if (!Number.isFinite(before)) { return fail('invalid-timestamp', before, 0); }
   if (!Number.isFinite(nowMs)) { return fail('invalid-timestamp', before, 0); }
   const now = Math.floor(nowMs);
   const deltaMs = now - before;
```

> 两处都是「判定分支的 reason/提前返回」级别的最小改动，**没有触碰任何数值、公式、常量与存档结构**。

## 5. 样例数只增不减 + 7 次回归记录

| # | 证据目录 | 步骤 | 耗时 | 契约样例 | 回放 | 核心护栏 | 玩法 | UI | 视觉 | 浏览器全量 | 微信替身 | 隔离 | 隔离负例 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | `regress-20261014-023602`（**基线**） | 10/10 | 184.3s | 32/32 | 32/32 | — | 24/24 | 23/23 | 16/16 | 66/66 | 37/37 | 0 违规 | — |
| A | `regress-20261014-024347` | 11/11 | 183.4s | 32/32 | 32/32 | **7/7** | 24/24 | 23/23 | 16/16 | 66/66 | 37/37 | 0 违规 | — |
| B | `regress-20261014-024744` | 11/11 | 179.7s | 32/32 | 32/32 | **13/13** | 24/24 | 23/23 | 16/16 | 66/66 | 37/37 | 0 违规 | — |
| C | `regress-20261014-025159` | 11/11 | 187.6s | 32/32 | 32/32 | 13/13 | **26/26** | 23/23 | 16/16 | **68/68** | 37/37 | 0 违规 | — |
| D | `regress-20261014-025649` | 11/11 | 190.4s | 32/32 | 32/32 | **19/19** | **29/29** | 23/23 | 16/16 | **71/71** | 37/37 | 0 违规 | — |
| E | `regress-20261014-030315` | **12/12** | 194.0s | 32/32 | 32/32 | 19/19 | 29/29 | 23/23 | 16/16 | 71/71 | 37/37 | 0 违规 | **6/6** |
| F | `regress-20261014-031619` | **12/12** | 197.3s | 32/32 | 32/32 | 19/19 | 29/29 | **30/30** | **18/18** | **80/80** | **38/38** | 0 违规 | 6/6 |

- 另有 `regress-20261014-030310`：E 的**局部试跑**（`--skip` 其余 10 步，只验证第 11/12 步接线），非全量，保留作证据。
- 隔离检查扫描的文本文件数从基线 150 涨到 241：主要是每轮回归新增约 13 个 `evidence/regress-*/` 日志文件（**日志里的禁名已掩码**），其次才是本次的 `release/` 3 个 `.txt` 与 3 个新文件。计数增长本身不是违规（`0 处违规` 始终成立）。
- 「改前基线」的取法：树是线性的，因此 B–F 各自改前的基线 = **上一项改后的全量绿灯**（A 的改前基线是第 0 行那次独立基线）。

## 6. 隔离检查：改动、负例、已知限制

- **改动**：`IGNORE_DIRS` 去掉 `release/`；新增按扩展名排除的 `BINARY_EXTS`（任何目录下都排除二进制）；打印「排除的二进制文件 N 个」。真实项目：排除 44 个二进制（evidence 截图 37 + release 压缩包 7），`release/` 的 3 个 `.txt` 纳入扫描。
- **负例**：见 §3-E（E1–E6，已作为回归第 12 步）。
- **已知限制（未修）**：规则 A/C 只匹配字面量 ⇒ 字符串拼接可绕过（H1-5 ②）。本次只修了「整目录排除」这个结构性盲区；拼接绕过需要把文本扫描升级为「字面量拼接折叠 + 模块引用图分析」，属更大的改动，按任务要求进待决问题。
- 顺带确认：`tools/check-isolation-project.mjs` 的**声明措辞正则**问题（`docs/21 §13.3` 备注的 `未读取` 不生效）本次**未动**——它属于「白名单措辞」范畴，改动会牵动 103 条白名单的判定，超出 M2 授权范围（列入待决 D-M2-6）。

## 7. 待决问题（判断不了 / 超出授权的，都不动手）

| 编号 | 问题 | 建议 |
|---|---|---|
| **D-M2-1** | 隔离检查规则 A/C 只匹配字面量，字符串拼接可绕过（H1-5 ②） | 升级为「字面量拼接折叠 + import/require 图分析」；代价是误报率上升，需先定误报容忍度 |
| **D-M2-2** | H2-07 `compileType: 'game'` 是否被开发者工具接受 | 必须用官方开发者工具模板验证（D3 裁决维持「不替它下结论」），本机不可验证 |
| **D-M2-3** | FIX2 新增的 `test/wechat-strict.mjs`（6 用例，覆盖 H2-01/03/04）**没有**被 `package.json` 或 `tools/regress.mjs` 引用 ⇒ 每次 `npm run regress` 都不跑它 | 本次按范围未接线；建议下一轮加一步 `wechat-strict`（我手动实跑过：**6/6 PASS**） |
| **D-M2-4** | H2-14：微信 storage「可能因存储空间原因被系统清理」，0.1 无云备份 ⇒ 玩家进度可能无声归零 | 产品决策：是否需要 `wx.getStorageInfo` 配额检查 / 云存档 / 更醒目的存档提示 |
| **D-M2-5** | 微信开发者工具、官方模拟器、**真机**、公网预览**全部仍未验证**（M2 的所有结论都是本机 Chromium + Worker 替身） | 按 `docs/14` 真机验收手册执行；M2 的三条修复都给了真机最小验证方法（见 §8） |
| **D-M2-6** | 隔离检查的**声明措辞正则**不含 `未读取/未引用/未使用` 等近义写法（`docs/21 §13.3` 已记录），一换词就失效 | 扩充措辞表；需同步复核 103 条白名单，授权后再动 |
| **D-M2-7** | H2-06/H2-13 的「**平台确实返回 safeArea / 胶囊**」这条分支，只在浏览器/替身里用调试钩子注入覆盖；替身宿主不提供这两个字段 ⇒ 真机分支未验证 | 真机打印 `wx.getWindowInfo().safeArea` 与 `wx.getMenuButtonBoundingClientRect()`，再截图量间距 |

## 8. 未验证事项（照实标注，不含糊）

1. **微信开发者工具、官方模拟器、真机、公网预览：全部未验证。** 本次所有微信侧结论均来自「Worker 无 DOM + 模拟 wx」替身与浏览器 Chromium（软件渲染）。
2. F1 的替身证据是 `wx.createCanvas` **调用计数**，不等于真机离屏画布/显存占用曲线；真机最小验证方法：连续点居民 200 次，看 Memory 面板是否仍单调上升（修复后应只在首次出现新文案时增长）。
3. F2/F3 的真机最小验证方法：在 iPhone 14 Pro（灵动岛）/挖孔 Android 上截图，量顶部 HUD 与刘海、底部按钮与 Home Indicator 的间距；并打印 `safeArea` 与胶囊矩形，确认顶栏内容不再与胶囊重叠。
4. 真机 `requestAnimationFrame` 回调是否带时间戳、进后台是否必发 `touchcancel`（H2-09/H2-04 的残留不确定性）本次未涉及，仍以 `docs/21` 的「未找到官方依据」为准。
5. `dist/` 的 web 产物哈希随本次改动变化（`main-7a8a4941d7.js`，618.0KiB；wechat `game.js` 619.5KiB / sha256 `d9fa3861b23db18e…`）；**没有**做真机加载验证。

## 9. 交付物与校验和

改动文件（与基线副本 `diff -rq` 的全部差异；另有本报告 `docs/27-M2报告.md`）：

```
aa7f1152b9436828917029e484d97cc62e0f3b2c48bbe31cbce398ccf25c2c06  src/core/save.ts
18f2443346bc5f5848bfc877de0160c01b11e540c2ed7d3a63355484d7024125  src/core/economy.ts
137c9725822e360457ca57111d826e3fe5d3ac773723e1f6e47cb1ab424cbb96  src/ui/fx.ts
adc3b63b52a51600066fd6563c76b311ca5001aeff91c3b6bffc4cb5fc7643a2  src/ui/hud.ts
57b467cb04e2c528a3a7a4dae0a30d78c859ad1c7c2993a1639b45dc37acea2f  src/app/app.ts
80f68a56cec8d1c98a071994ef22050abb624badb5a04e4774143a3ff4b28f34  src/wechat/main.ts
f50506c76be64906036cd8944bd3dbb711799e1f90503542677567a4f6f5de2e  src/wechat/wx.d.ts
a50e478b827e733db86708638cb7f8e3a08b20fb5219037b3e814e06011bd6c8  test/t-core-guards.mjs        （新增）
23cdcef8b8e76644be2a366a49f1d49bfa334bdcd816e45dc785716ac5ec2b28  test/t-gameplay.mjs
4698c9541424e12bb193bfcb34a387d17e40e2bb15818ddb5cc55344911b2540  test/t-ui.mjs
c0ad1b454973a7b9f88898b9810dbf156bafa62be5bf05c3500df04d9be1352f  test/t-visual.mjs
45ae2524b881e21ac95575b529575d066c09aaed869861ff8b36c911adc036c2  test/wechat-sim.mjs
9f294fdac0b0611a8717b34382d3878c7448c6b5d12b0bd311429c2405ebec89  tools/check-isolation-project.mjs
87d0ab5ccae23d1643c042b36a794205ac56b66e484e3f923ece3054cb8cf193  tools/test-isolation-negatives.mjs  （新增）
be7a17894ba75807503f9e3a70b8f82242dbed4cef1fd60c45b71990faad8921  tools/regress.mjs
a577fa4148b809ca134d86af31e8c56ad6d68d8599e8a798cbcc0007a6cbd963  package.json
d9fa3861b23db18ee721ac88dd2d440eb7c078a8891df87bad0bff2ef0c8471a  dist/wechat/game.js
7a8a4941d73067df6f731070ba1db8af67d86c11d4b7d23bd16009b24e4d3762  dist/web/assets/main-7a8a4941d7.js
```

- 回归证据：`evidence/regress-20261014-023602`（基线）、`-024347`（A）、`-024744`（B）、`-025159`（C）、`-025649`（D）、`-030310`（E 局部试跑）、`-030315`（E）、`-031619`（F）。
- 新增测试入口：`npm run test:core-guards`、`npm run test:isolation-neg`。
- 未改：`src/contract/`、`contract-fixtures/`、`tests/`（契约夹具）、0.1 的规则与数值、`docs/` 下既有报告。

## 10. 最终冻结版本验收（本报告入库后的最后一次全量回归）

- 证据目录：**`evidence/regress-20261014-032424`** —— **12/12 步 PASS，194.7s，exit 0**：类型检查 PASS、构建 PASS、契约样例 32/32、回放 32/32、核心护栏 19/19、玩法 29/29、UI 30/30、视觉 18/18、浏览器全量 80/80、微信替身 38/38、隔离检查 `0 处违规 / 103 处白名单`、隔离负例 6/6。
- 与 F 那次回归（`regress-20261014-031619`）相比，**树差异只有「新增本报告文件」**；源码/测试/工具/`package.json`/`dist/` 产物哈希完全一致（`dist/web/assets/main-7a8a4941d7.js`、`dist/wechat/game.js` sha256 `d9fa3861b23db18e…`）。
- 本节是在上述回归**之后**追加的（纯文档追加，不触碰任何代码、测试与产物）；追加后**单独复跑了隔离检查第 11/12 步**：`0 处违规 / 103 处白名单` + 负例 `6/6`，确认文档追加没有引入违规。
