# 2026-10-14 · 包 G 二分结果：游客模式是启动崩溃的开关；H2-01 工具侧证伪

## 包 G 单变量二分实测结果（用户执行）

测试床：已跑通的 F 项目（`game.js` = 我们的原始构建，未改动）；每步只换 `project.config.json`。

| 编号 | 变体（相对空白模板只改一处） | 结果 |
|---|---|---|
| 01 | 模板原版 | **好** |
| 02 | 模板 + `"miniprogramRoot": ""` | **好** ⇒ **排除 `miniprogramRoot`** |
| 03 | 模板 + `"appid": "touristappid"`（`isGameTourist` 仍为 `false`） | **好** ⇒ **排除 appid 本身** |
| 04 | 模板 + `"appid": "touristappid"` + `"isGameTourist": true` | **崩** ⇒ **触发条件 = 游客模式** |

04 的 Console 原文：

```
[fingerprint] economy ok … / visit ok / upgrade ok / save ok / offline ok
[fingerprint] all ok
[renderer] ANGLE (Intel, Intel(R) Arc(TM) Graphics (0x00007D55) Direct3D11 vs_5_0 ps_5_0, D3D11) lowFx=false platform=wechat
TypeError: MiniProgramError
requestAnimationFrame is not a function
    at Object.raf (game.js?[sm]:4220)
    at $a.start (game.js?[sm]:4220)
    at Module.d (WAGameSubContext.js:1)
(env: Windows,mp,2.02.2608080; lib: 3.17.3)
```
工具底部另打印：`… 游客模式`，并警告「请注意游客模式下，调用 wx.operateWXData 是受限的，API 的返回是工具的模拟返回」。

## 推论：我们原版配置崩溃的原因

我们的原版 `project.config.json` 有 `"appid": "touristappid"`，但**没有 `isGameTourist` 字段**。
结合 03（显式 `isGameTourist:false` → 好）与 04（`isGameTourist:true` → 崩）：

⇒ **工具很可能在 `appid === "touristappid"` 且 `isGameTourist` 缺省时，默认按「游客模式」运行**，
   而游客模式是工具的**受限模拟环境**，不提供 `requestAnimationFrame` ⇒ 启动即崩。

⇒ 待验证（包 H）：我们的原版配置**只加 `"isGameTourist": false`** 是否即可跑通。

## ★ H2-01 降级：工具侧证伪

`src/app/app.ts` 结构：

```
:59   new THREE.WebGLRenderer({ canvas: host.canvas })     ← 构造函数内
:86   start(): void {
:88-90   [fingerprint] 行、[renderer] 行                    ← start() 内
:94      this.host.raf(ts => this.frame(ts));
```

- `WebGLRenderer` 的构造**先于全部日志**；而 three r186 在构造期**无条件**调用
  `canvas.addEventListener('webglcontextlost', …)`（`three.module.js:16440-16442`）。
- 04 的 Console 里 `[fingerprint] all ok` 与 `[renderer] ANGLE …` **都打出来了**
  ⇒ 构造函数未抛错 ⇒ **工具环境里 `canvas` 确实有 `addEventListener`**。
- ⇒ **H2-01 在开发者工具环境下不成立。**

**但**：`[renderer]` 显示 `ANGLE … Direct3D11`，即模拟器使用 PC 显卡、由工具模拟画布，
**不等于真机上微信的 `Canvas` 对象**。
⇒ **H2-01 的正确状态：工具侧不成立；真机侧仍未验证。不应再表述为「已证实的启动级 P0」。**

## 顺带确认的正面结果

- **`[fingerprint] all ok`**：契约指纹 5 项（economy / visit / upgrade / save / offline）在真实工具环境**全部通过**。
- 包 F 现场读数与冻结数值一致：`R(1)=10`、`C(1)=20`、Lv 1 初始等级。
- 存档正常（已保存 / 自动存档）。

## 修复方向（**不修改 `tools/`，仅报告**）

任务书 §2 禁止评审方改动 `src/`、`test/`、`tests/`、`tools/`、`contract-fixtures/`。
故本节只报告应当由代码所有者执行的改动：

`tools/build-wechat.mjs:24-29` 生成的 `project.config.json` 需处理两点：
1. `appid: 'touristappid'` 时必须显式写 `isGameTourist: false`（或改用真实小游戏 appid）；
2. 建议同时移除小程序专有字段 `miniprogramRoot: ''`（虽经 02 证明它不是本次崩溃的原因）。
