# 31a · H2 评审报告勘误（C1）

> **勘误对象**：报告 21《H2 微信适配层真机风险评审报告》（2026-10-13 版；原判 P0=3 / P1=6 / P2=6）。
> **本文件是新增文件，不覆盖、不改写原报告。** 本文件与原报告冲突处，以本文件为准。
> **依据**：`docs/31-评审侧进度汇报.md` 第 3 节「评审结论修正清单」，及 `docs/31-evidence/` 下三份取证文件：
> ① `2026-10-14-真机探针实测-H2-01证实.md`；② `2026-10-14-真机跑通-冻结数值复验.md`；③ `24-微信端启动问题阶段汇报-致指导模型.md`。
> **日期**：2026-10-14。
> **真机环境**：HUAWEI-ALN-AL10，HarmonyOS / Android 31，微信 8.0.78，基础库 3.17.4 [1656]，4G；工具：微信开发者工具 Stable 2.02.2608080「真机调试」，用户自行扫码。
> **性质**：纯文档勘误。本文件不修改任何源码（`src/`、`test/`、`tools/` 零改动）。

---

## 1. 逐项修正清单（对应 `docs/31` §3）

| 项 | 原判（报告 21） | 修正后 | 依据 |
|---|---|---|---|
| **H2-01** `canvas` 无 `addEventListener` | **P0**（文档推断，真机未验证） | **P0 维持，并已被真机实测证实**。真机探针原文：`typeof canvas.addEventListener = undefined`、`typeof canvas.removeEventListener = undefined`；同一探针在工具模拟器里为 `function`。three r186 在 `new THREE.WebGLRenderer({canvas})` 构造期**无条件**调用 `canvas.addEventListener(...)`（`three.module.js:16440-16442`）⇒ 真机抛 `TypeError` ⇒ 渲染器建不出来 ⇒ 黑屏卡加载 | `31-evidence/2026-10-14-真机探针实测-H2-01证实.md` §真机 Console 原文、§逐项对照表、§结论 1–3 |
| **H2-03** `sys()` 得到 NaN | **P0** | **降级**（真机侧不成立）：真机 `wx.getSystemInfoSync()` 返回 **36 键**、`windowWidth = 388`，是**非空对象**；原 P0 的前提（接口降级返回 `{}`）未在真机出现 | 同上 §逐项对照表、§结论 5 |
| **H2-07** `compileType` 与官方不符 | **P1（疑似）**，要求改 `minigame` | **评审错误，撤销**。工具自带的空白小游戏模板 `project.config.json` 里写的就是 `"compileType": "game"`（模板实测）；反向验证：运行中改成 `minigame` → 工具报 `something wrong in electron appservice`（appservice 崩溃）。⇒ **该字段保持 `game`，不改** | `31-evidence/24-微信端启动问题阶段汇报-致指导模型.md` §3.2 |
| `requestAnimationFrame is not a function` | 曾疑为**真机级 P0** | **真机不成立**。真机探针：`typeof requestAnimationFrame = function`、`GameGlobal.requestAnimationFrame = function`、`rAF 回调已触发 ts=1791961250643 typeof=number`。该报错只出现在**开发者工具的「游客模式」/我们的旧配置**下 | `31-evidence/2026-10-14-真机探针实测-H2-01证实.md` §逐项对照表、§结论 4；`31-evidence/24-…md` §3.6 |
| **「需要单独的小游戏 appid」** | 报告 24 的结论（并多次被评审侧断言） | **错误，作废**。官方《小游戏开发指南》原文：「微信小游戏是小程序其中的一个类目」；用户已有的 `wx1c0ae0869ea1424f` 即可用，**不需要**另申请「小游戏 appid」 | `docs/31` §3 第 6 行；`31-evidence/24-…md` §5.4（该节结论即本行作废对象） |
| **「H2-01 工具侧证伪，所以降级」** | 评审侧结论（`31-evidence/24-…md` §6.1） | **错误外推，作废**。模拟器的画布**由工具模拟**、自带 `addEventListener`；真机 `wx.createCanvas()` 返回的对象没有该方法。**「工具侧不成立」不能推出「真机侧不成立」**——这正是本次降级被更正的根因 | `31-evidence/2026-10-14-真机探针实测-H2-01证实.md` §逐项对照表、§结论 2–3 |
| **H2-02 / H2-04 / H2-05 / H2-06 / H2-13 / H2-14 / H2-15** | 保留（原判 P0/P1/P2） | **保留，真机未验证**（逐项标注见 §2） | `docs/31` §3 第 5 行 |
| **「5.7 还差 40 的显示 Bug」** | 疑点 | **关闭，评审侧误读**：真机截图里 `金币 7.7` 与 `声望 51` 是并排的两个独立数字；当时那个 `53` 是**声望**而非金币（`55 − 15 = 40` 才对得上，`55 − 53 = 2` 从未成立） | `31-evidence/2026-10-14-真机跑通-冻结数值复验.md` §附带定案 |

---

## 2. 其余 H2 项：一律标注「真机未验证」

除 **H2-01**（已证实）、**H2-03**（真机侧不成立 ⇒ 降级）、**H2-07**（评审错误 ⇒ 撤销）外，**其余所有 H2 项**——即 **H2-02、H2-04、H2-05、H2-06、H2-08、H2-09、H2-10、H2-11、H2-12、H2-13、H2-14、H2-15**——本次真机实测**均未覆盖其判定条件**，因此**一律标注「真机未验证」**，既不能算「已成立」，也不能算「已排除」。

- `docs/31` §3 显式列出的是 **H2-02 / H2-04 / H2-05 / H2-06 / H2-13 / H2-14 / H2-15**；**H2-08…H2-12** 未在该行枚举，但按同一条原则（未经实测的一律标「未验证」）同样标注**真机未验证**，本文件据此补齐，不改变任何一项的原有严重度。
- **唯一例外说明（H2-13）**：真机截图显示微信胶囊按钮压在 HUD 右上角「可用 51 · 访问 51」之上，属**真机现场证据**；但「是否真的点不到」**仍待确认**，且 M2 已加胶囊避让、**是否生效待真机确认** ⇒ 仍标注**真机未验证**。
- **H2-15 另有一处待复核**：包体积三个口径不一致（我方 `MANIFEST.json` 615.9 KiB / 工具「二维码预览」代码包 1652 KB / 工具「真机调试」流量 118 KB、压缩节省 342 KB），三者口径不同（未压缩 / 含基础库 / 压缩后传输量），**H2-15 的「15.04% of 4 MiB」结论需复核，未定论**（`31-evidence/2026-10-14-真机探针实测-H2-01证实.md` §附）。

---

## 3. 严重度计数修订

| 级别 | 原判（报告 21） | 修订后 | 说明 |
|---|---|---|---|
| P0 | 3（H2-01、H2-02、H2-03） | **已证实 P0 = 1（H2-01）**；H2-02 仍按 P0 级别保留但**真机未验证**；H2-03 降级 | 「已证实的启动级 P0」由 3 条修订为 1 条；H2-02 不得再与 H2-01 并列为「已证实」 |
| P1 | 6 | **5**（H2-07 撤销） | 其余 P1（H2-04、H2-05、H2-06、H2-13、H2-14）全部**真机未验证** |
| P2 | 6 | **6**（数量不变） | H2-15 的包体积结论需复核（见 §2） |

---

## 4. 真机实测证据

真机环境的探针原始输出与真机读数，完整记录见 `docs/14-真机与官方模拟器验收手册.md` §0.2「真机实测证据」与 `docs/31-evidence/` 三份原始文件。要点：

1. **探针原始输出（真机 Console，逐字节选）**：

   ```
   [PROBE] typeof requestAnimationFrame = function
   [PROBE] typeof window = undefined
   [PROBE] typeof self = undefined
   [PROBE] typeof wx.createCanvas = function
   [PROBE] wx.createCanvas() 调用 = 返回对象 ok
   [PROBE] typeof canvas.addEventListener = undefined
   [PROBE] typeof canvas.removeEventListener = undefined
   [PROBE] typeof canvas.getContext = function
   [PROBE] wx.getSystemInfoSync() 键数 = 36
   [PROBE] wx.getSystemInfoSync().windowWidth = 388
   [PROBE] rAF 回调已触发 ts=1791961250643 typeof=number
   ```

   同一探针在**工具模拟器**的对照：`typeof window = object`、`typeof self = object`、`typeof canvas.addEventListener = function`、`wx.getSystemInfoSync() 键数 = 39`。

2. **真机读数与契约一致**：

   | 屏幕读数 | 契约 | 判定 |
   |---|---|---|
   | `Lv 6` | — | ✅ |
   | `每分钟 +20.0` | `R(6) = 10 × (1 + 0.20 × (6−1)) = 20.0` | ✅ **真机复验一致** |
   | `升级市政厅 → Lv.7 · 需要 55 金币` | `C(6) = ceil(20 × 1.22^5) = ceil(54.0542) = 55` | ✅ **一致** |
   | `还差 48`（当时金币 7.7） | `ceil(55000 − 7700) / 1000 = ceil(47.3) = 48` | ✅ **一致** |

   ⇒ `R(6) = 20.0` 与 `C(6) = 55` 两条冻结公式在真机上得到独立复验。

3. **重要限定（必须与上面两条同时引用，不得单独引用「真机已跑通」）**：
   - 真机跑通的是**热修包 J**（`dist/wechat/game.js` 前置画布垫片 IIFE，sha256 `4bd01a96f0cf35b23cdfd004f54f2850f7b3d15db285c59c39ea35c198b2d166`），**不是正式构建产物**。
   - **M3 之后的正式构建尚未在真机上测过**：M3 合并后 `dist/wechat/game.js` 哈希为 `d9fa3861…`（已含画布补丁），**真机未测**。
   - 用户此前在真机上测的「正式构建产物」哈希 `089feda0…` 是**旧构建**，在真机上**仍然是黑屏的**。
   - ⇒ 画布垫片必须落到源码（任务书 B2）、重新构建后**再真机复测一次**，0.1 才算真机达标。

---

## 5. 本次勘误**未**改变的事项

1. **新增待评估项（真机未验证）**：真机**没有 `window` / `self` 全局**（模拟器有）。我方 `src/wechat/main.ts:18-19` 会自行设置 `g.self` / `g.window`，但 three r186 内部亦有 `self` / `window` 分支，**需评估真机上是否走不同路径。未验证。**
2. **H2-13 现场证据保留**（见 §2 例外说明）。
3. **H2-15 包体积口径分歧未定论**（见 §2）。
4. 报告 21 的**「通过的部分」不受影响**：核心经济 / 存档 / 离线逻辑的幂等性、32/32 夹具交叉验证、存档失败回滚、损坏存档回退、包体远低于主包 4M 限制，仍然成立。
5. **`test/wechat-sim.mjs` 的 37/37 仍然不是真机可用性证据**（报告 21 结论 3 维持）。替身通过只能证明适配层逻辑，不能证明能启动；「替身 37/37 全过、真实开发者工具里启动即崩」已有一次实证（同一份 `game.js`，`31-evidence/24-…md` §6.2）。

---

## 6. 生效方式

- 本文件**不覆盖原报告**：报告 21 原文继续作为 2026-10-13 的评审记录保留，但**其 H2-01 降级、H2-03 定级、H2-07 判定、「需要单独小游戏 appid」四处结论以本文件为准**。
- 后续修订 `docs/00`、`docs/04` 中与微信相关的措辞时，一并引用本文件与 `docs/31`。
