# 任务书 B2 · 把画布垫片落到源码（《我要当岛主》0.1）

> 提出方：评审侧（H1/H2 独立评审 + 真机实测取证）
> 依据：2026-10-14 真机探针实测
> 性质：**建议稿**，供指导模型裁决后转派执行模型

---

## 通用头（同前）

你是《我要当岛主》0.1 的执行 Agent，任务 **B2**。
通用头同前：禁区、不造假、不进 0.2、不改 0.1 冻结规则。
先把 `frontend-rebuild-hm` 复制为 `frontend-rebuild-hm-work-B2`，**只在副本工作**。

**与 B1 的改动面不重叠**：B1 只改 `tools/build-wechat.mjs`；**B2 只改 `src/wechat/main.ts`**（以及 `test/` 新增只读检查）。两者可并行。

---

## 背景（真机实测，逐字证据）

**环境**：微信开发者工具 Stable 2.02.2608080「真机调试」；真机 **HUAWEI-ALN-AL10**，微信 **8.0.78**，基础库 **3.17.4 [1656]**，Android 31，4G。

探针包（`probe-wyszz-env-v1`）在真机 Console 输出：

```
[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] typeof canvas.requestAnimationFrame = undefined
[PROBE] typeof requestAnimationFrame = function           ← 真机正常
[PROBE] GameGlobal.requestAnimationFrame = function       ← 真机正常
[PROBE] rAF 回调已触发 ts=1791961250643 typeof=number     ← 真机正常
[PROBE] typeof window = undefined
[PROBE] typeof self = undefined
[PROBE] wx.getSystemInfoSync() 键数 = 36
[PROBE] wx.getSystemInfoSync().windowWidth = 388
```

**同一探针在工具模拟器上**：`canvas.addEventListener = function`、`typeof window/self = object`、`getSystemInfoSync 键数 = 39`。

### 根因

three r186 在 `new THREE.WebGLRenderer({ canvas })` 构造期**无条件**调用
`canvas.addEventListener('webglcontextlost' / 'webglcontextrestored', …)`
（`three.module.js:16440-16442`；同处 `:16437` 反而守卫了 `setAttribute`）。

真机 `canvas` 没有这两个方法 ⇒ 抛 `TypeError` ⇒ **渲染器建不出来 ⇒ 黑屏卡加载**。

**这解释了「工具模拟器能跑、真机不能」**：模拟器画布由工具模拟，有该方法；真机没有。

### 已验证的修复（包 J，用户真机实测通过）

在 `game.js` 最前面前置一段**只含画布垫片**的 IIFE，用户真机上**已能完整游玩**：
`Lv 6` / `每分钟 +20.0` / `升级需要 55 金币 · 还差 48` / `已保存·自动存档` —— 与冻结契约逐项一致
（`R(6)=20.0`、`C(6)=ceil(20×1.22⁵)=55`、`ceil(55−7.7)=48`）。

**但那只是热修包。正式构建产物 `dist/wechat/game.js`（sha256 `089feda0833b5380a3442cd863889edf66e5e87ef2153b6b33ad0ab8d955b0b4`）在真机上仍然黑屏。**
⇒ 必须把修复落到源码。

---

## 任务

1. **在 `src/wechat/main.ts` 里，于「创建渲染器之前」给画布补上 `addEventListener` / `removeEventListener` 空实现。**
   - **缺失才补**，绝不覆盖已有实现。
   - **必须包裹 `wx.createCanvas` 并给「每次返回的画布」补**；
     **不要预先调用 `wx.createCanvas()`** —— 小游戏里**首次调用返回的是上屏画布**，
     预先调用会把那一次机会吃掉，导致主画布变成离屏画布。
   - 全程 `try/catch`：补丁自身失败**不得**中断启动。
   - 不改变 `src/` 下其它文件的既有行为。
2. **不得引入任何新的运行时依赖。**
3. **在 `test/` 新增只读检查**（项目自有测试）：画布对象缺少 `addEventListener` 时会被补上；
   已有实现不被覆盖；补丁抛错时不中断。
4. **`npm run regress` 全量回归**，样例数只增不减。
5. **报告写入 `docs/31-B2报告.md`**：改动 diff、回归**原始输出**、新旧 `game.js` 的 SHA256、读过的目录。
   **真机能否启动属于「未验证」——由用户复测后填写，不得写成已通过。**

---

## 明确不做

- **不加 `requestAnimationFrame` 垫片。** 真机 rAF 实测正常（`function`，回调时间戳为数值）。
  加顶层 `var requestAnimationFrame` 反而有**遮蔽全局**的风险（`var` 提升到文件作用域，
  而 `else` 分支不执行时赋值永不发生）。
- **不改 `compileType`**，保持 `"game"`（工具模板即写 `game`；改成 `minigame` 会让 appservice 崩溃）。
- **不写入任何真实 appid。**

---

## 验收（评审侧 + 用户复测）

| # | 判据 | 谁验 |
|---|---|---|
| a | `npm run build:wechat` 产出的 `dist/wechat/game.js` 在开发者工具里可玩 | 用户 |
| b | 用该产物做**真机调试**，真机上能出画面 | 用户 |
| c | 首屏读数与冻结契约一致：`Lv 1` / `每分钟 +10.0` / 升级需要 `20` 金币 | 用户 |
| d | Console 出现 `[fingerprint] all ok` | 用户 |
| e | `npm run regress` 全绿且样例数只增不减 | 执行模型 |

**在 b/c 由用户确认之前，本任务的真机部分一律记「未验证」。**

---

## 附：真机冒烟清单（建议固化为 0.1 验收门槛）

```
□ 开发者工具里导入新包 → Ctrl+B → 模拟器出画面
□ Console: [fingerprint] all ok
□ 首屏读数：Lv 1 / 每分钟 +10.0 / 升级需要 20 金币 · 还差 20
□ 已保存 / 自动存档
□ 点「真机调试」→ 手机扫码 → 真机上出画面
□ 真机上核对：等级、每分钟速率、升级费用、还差金额 与契约一致
□ 真机上点一次升级、切后台再回前台、杀进程重进（存档保留）
```

---

## 附：真机侧观察到的新问题（建议同时处理或另开一条）

**H2-13（胶囊遮挡）在真机上得到现场证据**：用户真机截图显示，微信胶囊按钮压在 HUD 右上角的
「可用 51 · 访问 51」文本之上。**「访问」按钮可能被胶囊挡住点不到** —— 影响可点击性。
建议纳入本任务或单独开一条（需真机确认是否真的点不到）。
