# 《我要当岛主》0.1 第五步 · 手动升级市政厅 — 实现与验证报告

- 日期：2026-10-09
- 项目目录：`/vol1/ai/projects/wyszz-new/wechat-game-0.1-ds/`
- 本步范围：**只做第五步「手动升级市政厅」，完成后停止，未进入第六步**
- 运行时：微信小游戏运行时（`wx.createCanvas()`，无 DOM/CSS/WebView）+ 浏览器版本，两者共用同一套核心
- 引擎：three.js r186（`three@0.186.1`），未降级

---

## 1. 结论速览

| 验证项 | 结果 |
| --- | --- |
| TypeScript 类型检查 `tsc --noEmit` | **通过（0 错误）** |
| 核心自动测试 `npm test` | **43/43 通过**（第三步 9 + 第四步 12 + 第五步 22） |
| 浏览器生产构建 | **通过**（`dist/browser/app.js` 566004 B） |
| 浏览器端到端测试（无头 Chromium） | **63/63 通过** |
| 微信开发者工具游客模拟器 | **通过**（真实点击 23 次，升级 3 成功 2 失败） |
| 沙箱日志逐条回放（第五步） | **21/21 通过** |
| 第四步回放器回归（第四步日志） | **12/12 通过** |
| 第三步/第四步核心文件是否被改动 | **逐字节相同**（见 §9） |
| 游戏代码运行时错误 | **0** |
| 公网预览 `https://mayor3d.hynixing.cn/` | **HTTP 200** |
| 真机验证 | **未验证 —— AppID 审核中** |
| 第六步 | **未进入** |

---

## 2. 修改文件清单

### 2.1 新增

| 文件 | 行数 | 说明 |
| --- | --- | --- |
| `src/core/upgrade.ts` | 248 | 第五步升级费用与等级的唯一实现（纯函数，两个入口共用） |
| `tests/upgrade.test.mjs` | 618 | 第五步自动测试 22 项（含任务书必测 12 项 + HUD 遮挡护栏） |
| `tools/analyze-vm-log-step5.mjs` | 390 | 沙箱日志逐条回放器（第五步版，21 项） |

### 2.2 修改

| 文件 | 行数 | 改了什么 |
| --- | --- | --- |
| `src/game/main.ts` | 675 | 小游戏入口：升级按钮 + 热区、市政厅射线分支、`doUpgrade()`、HUD 10 行 |
| `src/browser/main.ts` | 525 | 浏览器入口：升级按钮/面板读数、市政厅射线分支、`doUpgrade()`、`__wyszz` 快照扩字段 |
| `public/index.html` | 112 | 新增「升级」按钮与等级/费用/次数/反馈读数 |
| `build.mjs` | 177 | `buildCore()` 增加 `upgrade.ts` 入口；项目名 `wyszz-0.1-step5` |
| `package.json` | 25 | `test` 脚本纳入 `tests/upgrade.test.mjs`；描述更新 |
| `README.md` | 132 | 进度更新到第五步；新增第五步实现说明与规则 12–20 |
| `tools/verify-browser.mjs` | 572 | 新增 C1–C8 共 30 项第五步检查；B1 速率文案正则同步 |
| `win/deploy_into_open.ps1` | 30 | 部署完成标记改为 `deploy-01step5-into-open` |

### 2.3 明确未改动（第五步没有碰）

`src/core/economy.ts`（273 行）、`src/core/visit.ts`（194 行）、`src/core/input.ts`、
`src/scene/world.ts`、`src/scene/camera.ts`、`src/scene/pick.ts`、`src/shared/hud.ts`、
`tests/economy.test.mjs`、`tests/visit.test.mjs` —— 全部与第四步源码包**逐字节相同**（§9 有 md5 比对）。

**第三步时间收益核心未被重写，第四步寻访逻辑未被破坏。**

---

## 3. 新增 / 修改状态字段及单位

`EconomyState` 字段**没有新增**（等级 `level` 在第三步就已存在）。第五步只新增了**派生显示与统计**：

| 字段 | 单位 | 归属 | 说明 |
| --- | --- | --- | --- |
| `level` | 整数等级（≥1） | `EconomyState`（第三步已有） | 初始 `1`；升级成功才 `+1` |
| `coinsMilli` | **整数毫币**（1 金币 = 1000 毫币） | `EconomyState`（第三步已有） | 升级扣费 = `C(L) × 1000` 毫币 |
| `upgradeCount` | 次 | 两个入口的本地统计 | 升级成功次数（只用于显示/日志） |
| `upgradeFailCount` | 次 | 两个入口的本地统计 | 升级失败次数（只用于显示/日志） |
| `lastUpgradeText` / `lastUpgradeMsg` | 文案 | 两个入口的本地显示 | 最近一次升级反馈 |
| `lastUpgrade`（`UpgradeResult`） | 结构 | 两个入口的本地快照 | 含升级前后全部字段，供验证读取 |
| `upgradeCostCoins(L)` | 金币（整数） | `core/upgrade.ts` 纯函数 | `ceil(20 × 1.22^(L-1))` |
| `upgradeCostMilli(L)` | 毫币（整数） | `core/upgrade.ts` 纯函数 | `upgradeCostCoins(L) × 1000` |

`UpgradeResult`（诊断/证据结构，不参与记账）关键字段：
`ok`、`reason`（`ok`/`insufficient-coins`/`invalid-state`/`max-level`）、
`levelBefore/After`、`costCoins/costMilli`、`shortfallCoins/Milli`、
`coinsBefore/After`、`coinsMilliBefore/After`、
`ratePerMinuteBefore/After`、`rateMilliPerMinuteBefore/After`、
`lastSettleTsMsBefore/After`、`lifetimeReputationBefore/After`、`spendableReputationBefore/After`。

**升级只写两个字段**：`level` 与 `coinsMilli`（成功时用 `{...economy, level, coinsMilli}` 生成新对象）。
失败时**原样返回同一个 economy 对象引用**（`applyUpgrade(e,v).economy === e`，测试有断言）。

---

## 4. R(L) 与 C(L) 公式

### 4.1 产出速率（第三步，未改）

```
R(L) = 10 × (1 + 0.20 × (L - 1))   金币/分钟
R(1) = 10   R(2) = 12   R(3) = 14   R(4) = 16
内部使用毫币/分钟：rateMilliPerMinute(L) = R(L) × 1000
```

### 4.2 升级费用（第五步新增）

```
C(L) = ceil(20 × 1.22^(L - 1))   金币
C(1) = 20 金币 = 20000 毫币
C(2) = 25 金币 = 25000 毫币
C(3) = 30 金币 = 30000 毫币
C(4) = 37 金币 = 37000 毫币
C(5) = 45 金币 = 45000 毫币
```

实现细节：`ceil` 前减 `1e-9` 消除浮点误差（L≥2 时理论值不是整数，epsilon 不会改变结果）。
非法等级（`NaN`/负数/`Infinity`/`0`/`undefined`/`null`）一律回落到 `C(1) = 20`，绝不产生 `NaN`/`0`/负数。

### 4.3 核心指纹（两端必须一致）

```
UPGRADE_CORE_ID         = wyszz-core-upgrade-v1
UPGRADE_CORE_FINGERPRINT = wyszz-core-upgrade-v1:c1=20000:c2=25000:r1=10000:r2=12000:growth=1.22
```

模拟器启动日志实测（`evidence/vm-runlog-step5.txt` 第 25–26 行）：

```
upgrade core wyszz-core-upgrade-v1 fingerprint=wyszz-core-upgrade-v1:c1=20000:c2=25000:r1=10000:r2=12000:growth=1.22 (expect wyszz-core-upgrade-v1:c1=20000:c2=25000:r1=10000:r2=12000:growth=1.22) cityhallTag=市政厅
upgrade cost C(1)=20 coins(=20000 milli) C(2)=25 coins(=25000 milli)
```

---

## 5. 升级成功完整证据（微信模拟器实测日志）

**触发方式 1：点「升级」按钮**（热区 `(39,629)-(351,709)`，点击落在 `(195,667)`）

```
tap#4 at=(195,667) -> 升级按钮
结算 +0 金币 | delta=934ms=0.015567min | rate=10/min | 余额=32 金币+399/1000 | last_settle_ts_ms=1791550261470 | upgrade-pre
升级#1 source=button tag=市政厅 Lv1->Lv2 花费=20 金币(=20000 毫币) | 余额=12 金币+399/1000 | rate=10->12/min | lifetime=3->3 spendable=3->3 (must be equal) | last_settle_ts_ms=1791550261470->1791550261470 (must be equal)
```

**触发方式 2：点市政厅对象的真实三维射线命中**

```
pick#13 tap=(184,290) ndc=(-0.059,0.312) HIT 市政厅 dist=50.56 point=(-2.08,2.88,-2.17)
升级#2 source=cityhall tag=市政厅 Lv2->Lv3 花费=25 金币(=25000 毫币) | 余额=29 金币+510/1000 | rate=12->14/min | lifetime=11->11 spendable=11->11 (must be equal) | last_settle_ts_ms=1791550352024->1791550352024 (must be equal)
```

（同一会话中第三次成功：`升级#3 source=cityhall Lv3->Lv4 花费=30 金币 rate=14->16/min`）

**逐项对照**

| 要求 | 实测 | 结论 |
| --- | --- | --- |
| 成功后 `level + 1` | `Lv1->Lv2`、`Lv2->Lv3`、`Lv3->Lv4` | ✅ |
| 扣费 = `C(L)` | `-20`、`-25`、`-30` 金币（`=20000/25000/30000` 毫币） | ✅ |
| 后续时间收益用新等级速率 | 升级后自动结算行 `rate=12/min`、`rate=14/min` | ✅ |
| 已结算的旧速率收益不回滚 | 升级前的 `结算 ... rate=10/min 余额=32 金币+399/1000` 原样保留，扣费只减 `C(L)` | ✅ |
| 升级不改声望 | `lifetime=3->3 spendable=3->3`、`lifetime=11->11 spendable=11->11` | ✅ |
| 升级不改 `last_settle_ts_ms` | `1791550261470->1791550261470`（相同） | ✅ |

---

## 6. 金币不足完整证据

```
tap#5 at=(195,667) -> 升级按钮
结算 +0 金币 | delta=854ms=0.014233min | rate=12/min | 余额=17 金币+897/1000 | last_settle_ts_ms=1791550288963 | upgrade-pre
升级失败（insufficient-coins）source=button Lv2 保持 | 需要=25 金币(=25000 毫币) 还差=8 金币 | 余额=17 金币+897/1000 | rate=12->12/min | lifetime=3->3 spendable=3->3 (must be equal) | last_settle_ts_ms=1791550288963->1791550288963 (must be equal)
结算 +0 金币 | delta=172ms=0.002867min | rate=12/min | 余额=17 金币+932/1000 | last_settle_ts_ms=1791550289135 | auto
```

**逐项对照**

| 要求 | 实测 | 结论 |
| --- | --- | --- |
| 等级不变 | `Lv2 保持` | ✅ |
| 不扣费用 | 结算后 `余额=17 金币+897/1000`，升级后仍 `17 金币+897/1000`（一分未扣） | ✅ |
| 刚刚结算的时间收益必须保留 | 紧随其后的自动结算从 `17 金币+897/1000` 继续累加到 `17 金币+932/1000` | ✅ |
| `lifetimeReputation` 不变 | `lifetime=3->3` | ✅ |
| `spendableReputation` 不变 | `spendable=3->3` | ✅ |
| `last_settle_ts_ms` 不变 | `1791550288963->1791550288963` | ✅ |
| 反馈文案 | HUD/飘字：`金币不足，升级费用 25 金币` + `还差 8 金币` | ✅ |

**点市政厅且金币不足**（同样不发寻访奖励）：

```
pick#4 tap=(184,290) ndc=(-0.059,0.312) HIT 市政厅 dist=50.56 point=(-2.08,2.88,-2.17)
升级失败（insufficient-coins）source=cityhall Lv2 保持 | 需要=25 金币(=25000 毫币) 还差=4 金币 | 余额=21 金币+910/1000 | rate=12->12/min | lifetime=3->3 spendable=3->3 (must be equal) | last_settle_ts_ms=1791550309024->1791550309024 (must be equal)
```

此处**没有出现任何 `visit#` 行** —— 点市政厅不触发寻访奖励。

---

## 7. 「先结算 → 再检查 → 再扣费」证据

代码顺序（`src/game/main.ts` / `src/browser/main.ts`）：

```ts
if (inUpgradeButton(endX, endY)) {
  logLine('tap#' + taps + ' ... -> 升级按钮');
  settleNow('upgrade-pre');     // ① 先按第三步规则结算截至当前时间的时间收益
  doUpgrade('button');          // ② 再检查金币 ③ 足够才扣费并 level+1
  return;
}
// 射线分支
} else if (isCityhallTag(hit.tag)) {
  settleNow('upgrade-pre');     // ①
  doUpgrade('cityhall');        // ②③
}
```

`doUpgrade()` 内部只调用 `applyUpgrade(econ, visit)`，**不读时钟、不结算、不碰声望**。

日志时间线（`升级#1`）：

| 序 | 日志 | 含义 |
| --- | --- | --- |
| 1 | `tap#4 ... -> 升级按钮` | 命中升级按钮热区 |
| 2 | `结算 +0 金币 ... rate=10/min ... 余额=32 金币+399/1000 ... upgrade-pre` | **① 结算**（用的还是**旧等级**速率 10/min） |
| 3 | `升级#1 ... 花费=20 金币 ... 余额=12 金币+399/1000 ... rate=10->12/min` | **② 检查**（余额 32 ≥ 20 足够）**③ 扣费**（32−20=12，毫币部分 `+399/1000` 原样保留） |
| 4 | `结算 ... rate=12/min ... 余额=12 金币+416/1000 ... auto` | 之后的时间收益按**新等级**速率 12/min |

**毫币余数 `+399/1000` 在扣费前后完全一致**，证明扣费只动整数毫币余额、没有重算或清空余数。

自动化断言（`tests/upgrade.test.mjs` 第 3 项）另有一条更强的确定性证据：
先结算 119 秒（19 金币，不够）→ 升级失败且不扣费；再结算到 126 秒（21 金币）→ 升级成功，
并断言 `result.coinsMilliBefore === 21_000 === 结算后的余额`，即升级「看到」的正是刚结算完的余额。

---

## 8. 升级后速率变化证据

| 证据 | 内容 |
| --- | --- |
| 模拟器日志 | 升级后自动结算行：`结算 +0 金币 \| delta=85ms=0.001417min \| rate=12/min \| 余额=12 金币+416/1000` |
| 模拟器 HUD | `金币 75 · 16 金币/分钟（Lv4）`（截图 `evidence/screenshots/step5-final_1.png`） |
| 浏览器端到端 C4 | `C4 升级后的结算日志使用 rate=12/min（新等级速率）` → PASS |
| 浏览器端到端 C4 | `C4 升级后余额继续增长（6 秒 @12/min ≈ 1200 毫币）` → `coinsMilli +1283` → PASS |
| 自动测试第 4 项 | 120 秒 @Lv1 = 20 金币 → 升级 Lv2 → 再 60 秒必须 = **12 金币**（`rate=12/min`） |
| 自动测试第 4 项 | 总收益 `20（Lv1）+ 12（Lv2）= 32` 金币，**旧速率收益未被回滚** |

---

## 9. 居民寻访回归证据（第四步未被破坏）

**实测日志**：11 次居民点击 → 11 次 `visit#`，每次 `+3 coins(=3000 milli) +1 lifetime +1 spendable`：

```
pick#10 tap=(197,387) ndc=(0.008,0.083) HIT 居民 dist=48.48 point=(0.44,0.96,0.51)
visit#9 tag=居民 +3 coins(=3000 milli) +1 lifetime +1 spendable | lifetime=9 spendable=9 | coins=47 coins+268/1000 | last_settle_ts_ms=1791550345814->1791550345814 (must be equal)
...
visit#11 tag=居民 +3 coins(=3000 milli) +1 lifetime +1 spendable | lifetime=11 spendable=11 | coins=53 coins+963/1000 | last_settle_ts_ms=1791550349291->1791550349291 (must be equal)
```

- 累计 `寻访毫币=33000`、`lifetime=11`、`spendable=11`（回放器 V9 断言 `33000 === 11 × 3000`）
- 每次寻访的 `last_settle_ts_ms` 前后相同（V4：不一致 0/11）
- 三次成功升级穿插其中，**声望始终未被改动**（V17：声望不一致 0、时间戳不一致 0）
- 升级**没有**触发任何寻访奖励（V16：市政厅来源升级尝试 3 次，未产生任何 `visit#`）

**负样本**（第五步里市政厅改走升级分支，不再是负样本）：

```
pick#14 tap=(90,334)  HIT 道路    -> visit-skip tag=道路 -> 不发奖（非居民）+ upgrade-skip
pick#18 ...           HIT 浮空岛  -> visit-skip tag=浮空岛 -> 不发奖（非居民）+ upgrade-skip
pick#19 tap=(325,420) HIT 树木    -> visit-skip tag=树木 -> 不发奖（非居民）+ upgrade-skip
pick#20 tap=(313,462) HIT 道路    -> visit-skip tag=道路 -> 不发奖（非居民）+ upgrade-skip
pick#16 tap=(70,334)  MISS candidates=0 pickables=7   （树木边缘）
pick#17 tap=(20,118)  MISS candidates=0 pickables=7   （天空）
```

回放器 V6：`道路×2 浮空岛×1 树木×1`；V7：`MISS=2 其中错误发奖=0`。

**按钮不穿透**

```
settle button rect=(39,721)-(351,819) logical=390x844
upgrade button rect=(39,629)-(351,709) logical=390x844
buttons overlap=false settleY=[721,819] upgradeY=[629,709] (must be false)
tap#16 at=(195,769) -> 结算按钮     （结算按钮热区，无 pick# 行）
```

回放器 V8：结算按钮点击 1 次、无 `pick#`；V15：升级按钮点击 2 次、伴随 `pick` 的 0 次。

---

## 10. 浏览器与微信模拟器结果

### 10.1 浏览器（无头 Chromium，软件光栅化）

- 生产构建：`dist/browser/app.js` 566004 B（md5 `36120cbc50270ff6dd996183ecfb41a9`）
- 端到端：**63/63 通过**（B1–B13 第四步回归 33 项 + C1–C8 第五步 30 项）
- 关键 C 系列结果：

| 检查 | 实测 |
| --- | --- |
| C1 初始等级/速率 | `level=1 rate=10` |
| C1 升级费用 | `C(1)=20 金币 = 20000 毫币` |
| C1 HUD 同步 | `upgradeCost=Lv1→Lv2：20 金币（20000 毫币）` |
| C2 金币不足 | `level=1 成功=0 失败=1`；`coinsMilli 500 -> 571`（只增不减） |
| C2 反馈文案 | `lastUpgrade=金币不足，升级费用 20 金币` |
| C3 居民寻访回归 | 7 次点击 `milli=+21000 life=+7 spend=+7` |
| C3 升级成功 | `level 1 -> 2 成功次数=1` |
| C3 毫币精确扣费 | `花费=20 金币(20000 毫币) 21764 -> 1764` |
| C3 速率变化 | `rate 10 -> 12（页面 12）` |
| C3 声望不变 | `lifetime 7->7 spendable 7->7` |
| C3 成功飘字 | `市政厅升级成功 Lv1 → Lv2-20 金币` |
| C4 新速率结算 | 日志含 `rate=12/min`；6 秒 `coinsMilli +1283` |
| C5 下一级费用 | `C(2)=25 金币 = 25000 毫币`；`Lv2→Lv3：25 金币（25000 毫币）` |
| C6 点市政厅 | `lastPick=市政厅`、`visitCount 7->7`、`reason=insufficient-coins` |
| C7 按钮不穿透 | 结算只结算不升级不拾取；升级不拾取；两个 DOM 矩形不相交 |
| C8 失败飘字 | `金币不足，升级费用 25 金币还差 22 金币` |

### 10.2 微信开发者工具游客模拟器

- 设备：iPhone 12/13 (Pro) 390×844 dpr3，基础库 3.17.2，DevTools Stable 2.02.2608080，**游客模式**
- 图形：`GL api=WebGL2`，`rendererCaps.isWebGL2=true`（SwiftShader 软件光栅化）
- 部署产物 md5（部署前后一致）：`bundle.js=3DD3FEE766BAC0D15BF104045078664C`、`adapter.js=E3DE2BD1A8C0C747104FF0329015908C`、`game.js=A6CB31C48010C0BD5525751BF8583420`、`game.json=F9ADC3C1E1F057BEF2A7161AC25FEE33`
- 真实点击 23 次（`tap=23 drag=0`）：11 次居民 + 2 次升级按钮 + 3 次市政厅（其中 1 次是我算错的点）+ 1 次结算按钮 + 4 次负样本 + 2 次 MISS

**最终 HUD（截图 `evidence/screenshots/step5-final_1.png`）**

```
0.1 第五步 · 手动升级市政厅 · three r186
金币 75 · 16 金币/分钟（Lv4）
市政厅 Lv4 · 升级到 Lv5 需 37 金币
已升级 3 次（失败 2）· 市政厅升级成功 Lv3 → Lv4，-30 金币
声望 lifetime 11 · spendable 11
最近结算 20:57:44 · 上次 +0 金币 · 待进位 345/1000
自动结算 534 次 · 寻访 11 次 · 最近 居民 +3 金币 +1 声望
PICK 道路 · 点居民寻访 · 点市政厅或「升级」按钮升级
API WebGL2 · WebGL2=true · canvas 390x844 · pickables=7
yaw=0.62 pitch=0.95 tap=23 drag=0 tri=6 fps=57
```

屏幕底部两个按钮：`升级 Lv5 · 37 金币`（绿色 = 余额 75 ≥ 37 可负担）与 `结算`（黄色）。
`C(4)=37` 与公式一致。市政厅与居民均未被 HUD 面板遮挡。

**沙箱日志回放（21/21）**

```
V1  启动日志含时间收益核心标识 / 寻访核心标识与指纹 / 启动时间戳可解析        PASS
V11 启动日志含升级核心标识与指纹 / C(1)/C(2) 与公式一致                     PASS
V14 结算按钮与升级按钮热区不重叠                                          PASS
V2  每一次「结算」余额都能被核心重放一致（结算行=526 不一致=0）              PASS
V3  每一次 visit# 余额/声望都能被核心重放一致（寻访=11 不一致=0）            PASS
V4  每次 visit# 的 last_settle_ts_ms 前后相同（0/11）                      PASS
V5  射线命中标签与是否发奖严格对应（命中 20 次，负样本拒绝 4 次）             PASS
V6  负样本齐全（道路×2 浮空岛×1 树木×1）                                  PASS
V7  空白/天空点击为 MISS 且不发奖（MISS=2 错误发奖=0）                      PASS
V8  「结算」按钮点击不触发射线拾取（1 次，无 pick# 行）                      PASS
V9  连续居民点击累计 33000 毫币 / +11 / +11                                PASS
V10 游戏代码运行时错误 0                                                  PASS
V12 每一次「升级#」的等级/速率/余额/花费都能被核心重放一致（成功=3 不一致=0）  PASS
V13 每一次「升级失败」等级不变、一分不扣、reason=insufficient-coins（失败=2） PASS
V15 「升级」按钮点击不触发射线拾取（2 次，伴随 pick 的 0 次）                 PASS
V16 点市政厅走升级分支且不发寻访奖励（3 次尝试，未产生任何 visit#）            PASS
V17 升级全程不改动 lifetime/spendable 声望（声望不一致=0 时间戳不一致=0）     PASS
V18 全程不出现负余额/负等级/NaN（终态 余额=68+558/1000 Lv4 lifetime=11）     PASS
```

升级序列（回放器汇总）：`OK#1(button)Lv1->Lv2 -20 rate10->12` → `FAIL#1(button)Lv2->Lv2 -25 rate12->12`
→ `FAIL#2(cityhall)Lv2->Lv2 -25 rate12->12` → `OK#2(cityhall)Lv2->Lv3 -25 rate12->14`
→ `OK#3(cityhall)Lv3->Lv4 -30 rate14->16`

### 10.3 第三步/第四步回归

- `node tools/analyze-vm-log-step4.mjs`（跑第四步日志）：**12/12 通过**
- `tests/economy.test.mjs`（9 项）+ `tests/visit.test.mjs`（12 项）：**全绿**
- 与 `wyszz-0.1-step4-source.zip` 逐文件 md5 比对，以下文件**逐字节相同**：

```
src/core/economy.ts  src/core/visit.ts  src/core/input.ts
src/scene/world.ts   src/scene/camera.ts  src/scene/pick.ts  src/shared/hud.ts
tests/economy.test.mjs  tests/visit.test.mjs
```

---

## 11. 游戏代码错误与工具自身错误（严格区分）

### 11.1 游戏代码运行时错误：**0**

- `evidence/vm-boot-step5.txt`（沙箱 `stage-err.log`）全文只有 3 行：

```
boot 2026-10-09T12:45:26.921Z
ADAPTER_OK
BUNDLE_OK
```

- 回放器 V10：`WX_ONERROR|UNHANDLED|BOOT_FAILED|_FAIL` 匹配行 = **0**
- 无 `BOOT_FAILED`，无未捕获异常，无 GL 初始化失败

### 11.2 工具自身错误（不是游戏代码错误）

| # | 工具错误 | 现象 | 处理 |
| --- | --- | --- | --- |
| T1 | `sed` 改日志输出路径没匹配 | `verify-browser.mjs` 的路径被拆成 `'evidence', 'browser-verify-step4.log'` 两段字符串，`sed` 按整段路径替换必然失败 | 改用 `edit` 精确替换；已核对产物路径为 `evidence/browser-verify-step5.log` |
| T2 | 负样本命中点计算不稳 | 我用中心点算出的「浮空岛」屏幕点 `(230,316)` 实际打到了**市政厅**（显示标定四舍五入），「树木」点 `(70,336)` 落在边缘判为 MISS | 改为扫描 3×3 邻域全部命中同一标签的**稳定点**再点击。**两次游戏行为本身都是正确的**（打中市政厅→走升级分支且不发奖；MISS→不发奖），是测量方法的问题 |
| T3 | HUD 高度会导致遮挡市政厅 | 我原计划把 HUD 从 `512×400` 加到 `512×460` 以容纳 11 行；按 `createHudOverlay` 面板公式算得面板底边会落到逻辑 y=313.5，而市政厅中心在 y=291.2，会被盖住 | 部署前发现，改回 `Hud(512,400)` 并把 HUD 压到 **10 行**；新增自动测试「HUD 面板不得遮挡市政厅」永久看护 |
| T4 | `read_gamelog.ps1` 输出需按 `R\| ` 切分 | 每个文件被 `Get-Content -Raw` 打成一行，`grep "^R| "` 只能匹配首行 | 用 `re.split(r'^FILE ', raw, flags=re.M)` 切文件块、再剥掉 `R| ` / `Response: ` 前缀 |

### 11.3 游客模式授权错误：**1（不是游戏代码错误）**

- `-80002 webapi_getwxaasyncsecinfo:fail` —— 游客模式限制
- 控制台徽标 **❌2 ⚠️1 = 第三步基线**，本步**没有新增任何错误**（终态截图可见 `2 ▲1`）

---

## 12. 真机未验证

**真机（iOS / Android 微信客户端）未验证，原因是 AppID 审核中。**

- 无合法小游戏 AppID，游客模式取不到有效预览二维码
- 本步**未伪造 AppID、未伪造二维码、未伪造真机通过结论**
- 未做正式上传、未做体验版、未做正式发布
- 已完成的最高强度验证是「微信开发者工具游客模式模拟器 + 真实点击 + 沙箱日志逐条回放」

---

## 13. 未进入第六步

本步严格止于「手动升级市政厅」。以下**均未实现**：

- 自动升级 / x10 升级 / MAX 升级 / 批量升级（`core/upgrade.ts` 内无定时器、无相关导出，测试有断言）
- 岛屿扩张、建筑摆放、多建筑升级
- 离线收益、本地/云存档、助手、广告、后端、排行榜
- 第六步的任何内容

---

## 14. 回滚方法

本项目**不是 git 仓库**，回滚靠源码包 + 重新构建：

1. **回到第四步**：解压 `wyszz-0.1-step4-source.zip` 覆盖项目目录，然后
   `npm install && npm run typecheck && npm test && node build.mjs`，
   并把 `dist/game/*` 重新部署到模拟器项目槽位。
2. **回到第三步**：解压 `wyszz-0.1-step3-source.zip`（同样流程）。
3. **只回退第五步**：删除新增文件 `src/core/upgrade.ts`、`tests/upgrade.test.mjs`、
   `tools/analyze-vm-log-step5.mjs`，并把 `build.mjs` 的 `buildCore()` 恢复为
   `[economy.ts, visit.ts, input.ts]`（`names` 同步）、`package.json` 的 `test` 脚本去掉
   `tests/upgrade.test.mjs`，再按第 1 步重建。
   `src/core/economy.ts` 第五步**完全没碰**，无需回滚。

---

## 15. 隔离声明：旧项目与其他实验目录未修改

本步**只写入** `/vol1/ai/projects/wyszz-new/wechat-game-0.1-ds/`，以及：

- 记忆库回写：`/vol1/ai/vault/AI记忆库/`（用户级工作规则要求）
- Windows 模拟器项目槽位：`C:\projects\wyszz-wx-spike\minigame-env-check\`（部署目标）
- 中转目录：`/mnt/ssd/winvm-mcp/serve/wyszz01/`（局域网下载中转）
- 成果登记：`/vol1/ai/_scripts/deliver-link`（用户级工作规则要求）

**未读取、未修改、未删除**：

- `/vol1/ai/projects/little-town/`（本会话 cwd，与任务无关）
- `/vol1/ai/projects/wyszz-new/3d-spike-ds/`
- `/vol1/ai/projects/wyszz-new/wechat-spike-ds/`
- `/vol1/ai/projects/wyszz-new/app/`
- MIMO 对照目录
- 公网预览基础设施：Cloudflare / DNS / 反向代理 / 现有服务配置 / systemd / NAS 权限 / 共享 / 路由 / 防火墙

`https://mayor3d.hynixing.cn/` 在本步改动后**实测 HTTP 200**（未做任何配置改动）。

重启脚本只按 DevTools **安装目录精确前缀**匹配进程，**未使用任何路径前缀通配脚本杀进程**，且先打印目标再执行。

---

## 16. 本步遗留与下一步

- 真机验证需要等 AppID 审核通过，属**外部阻塞**，不是代码问题
- 市政厅中心在逻辑 y=291.2，HUD 面板底边在 y=274.8，余量仅 16.4 px：**后续若再加 HUD 行数必须先改面板尺寸策略**（已有自动测试看护）
- 下一步（第六步）**未开始**，等待指令
