# 《我要当岛主》0.1 第八步：完整流程收口 —— 完成报告

- 报告日期：2026-10-10
- 项目：`/vol1/ai/projects/wyszz-new/wechat-game-0.1-ds/`
- 公网地址：**https://mayor3d.hynixing.cn/step8/**（免内网 / 免 VPN / 免 SSH / 免登录，可直接打开）
- 本步范围：把第三～第七步整合成**一个可连续游玩的 0.1 版本**，并验证**完整流程**
- 本步结束状态：**已完成并停止，不进入 0.2**

---

## 0. 一句话结论

第八步把「新游戏 → 在线结算 → 寻访 → 升级 → 写档 → 刷新恢复 → 进后台 → 回前台 → 再写档」
这条流程收敛成**唯一一份实现** `src/core/flow.ts`，浏览器入口与微信小游戏入口都调用它；
两端的核心指纹逐字一致，离线收益用同一条整数公式在两端各自复算通过；
公网 `/step8/` 已部署并通过 14/14 步远程验收，`/`、`/step6/`、`/step7/` 三个旧页面逐字节未变。

---

## 1. 完整流程状态图（本步的「唯一实现」）

流程核心：`src/core/flow.ts`（纯函数，无 `Date.now()`、无 storage、无 DOM / wx）

```
FLOW_CORE_ID        = wyszz-core-flow-v1
FLOW_CORE_FINGERPRINT = wyszz-core-flow-v1:order=settle>visit,settle>upgrade,settle>bg,
                        fg-once:bg=idempotent:save=single-envelope:v=2:fields=13
FLOW_STEPS          = boot > foreground > settle > visit > upgrade > background > save
```

```
                 ┌─────────────────────────────────────────────────────────┐
                 │ boot：读档（v1→v2 迁移 / 损坏回退 / 新游戏）             │
                 └───────────────────────────┬─────────────────────────────┘
                                             ▼
        ┌────────────────────────────────────────────────────────────────────┐
        │ foreground（唯一发放点）                                            │
        │   if offline_pending == false → 不发放（not-pending）               │
        │   if offline_pending == true  → settle(now - offline_start_ts_ms)   │
        │        · 用**存档里那一刻的等级速率**结算整个离线区间               │
        │        · 复位 offline_pending=false，写**一个完整 v2 信封**          │
        │        · 写档成功才提交内存；写档失败不提交、不崩溃                  │
        │   ⇒ 同一区间绝不重复发放（刷新 / 重复 onShow / 重复读档都一样）      │
        └───────────────────────────┬────────────────────────────────────────┘
                                    ▼
        ┌────────────────────────────────────────────────────────────────────┐
        │ settle（在线，每 1 秒一次 + 手动「结算」按钮）                      │
        │   gainMilli = wholeMinutes × rateMilli                              │
        │             + floor((carryNumerator + remMs × rateMilli) / 60000)   │
        │   carryNumerator' = (carryNumerator + remMs × rateMilli) % 60000    │
        │   结算后才更新 last_settle_ts_ms                                    │
        └──────────┬──────────────────────────────────┬──────────────────────┘
                   ▼                                  ▼
   ┌───────────────────────────────┐   ┌──────────────────────────────────────┐
   │ visit（点真实射线命中的居民）  │   │ upgrade（点市政厅 / 升级按钮）        │
   │   **先 settle**                │   │   **先 settle（按旧等级速率）**        │
   │   再 +3000 毫币 / +1 lifetime  │   │   再检查金币：不足 ⇒ 一分不扣、等级不变│
   │   / +1 spendable / visitCount+1│   │   足够 ⇒ 扣 C(L) 毫币、level+1        │
   │   不移动 last_settle_ts_ms     │   │   新速率 = 旧速率 × 1.2，下次结算生效  │
   └───────────────────────────────┘   └──────────────────────────────────────┘
                   │                                  │
                   └──────────────┬───────────────────┘
                                  ▼
        ┌────────────────────────────────────────────────────────────────────┐
        │ background（唯一建立离线基线的地方，幂等）                          │
        │   ① 先 settle 在线收益                                              │
        │   ② offline_start_ts_ms = last_settle_ts_ms                         │
        │   ③ offline_pending = true，立刻写一个完整 v2 信封                   │
        │   重复进入后台：起点不被推后、余额不变、不重复结算（applied=false）  │
        └───────────────────────────┬────────────────────────────────────────┘
                                    ▼
        ┌────────────────────────────────────────────────────────────────────┐
        │ save：单个完整 v2 JSON 信封（14 键，schemaVersion 在首位，13 字段）  │
        │   写入时机 = 状态改变后 / 进入后台 / 回前台提交成功后（15 秒节流）   │
        │   绝不持久化：相机角度、飘字、临时 UI、调试状态                      │
        └────────────────────────────────────────────────────────────────────┘
```

**存档字段表（v2，13 个字段，顺序固定）**

`schemaVersion=2`（信封第 0 键）+ 按序：
`level, coinsMilli, carryNumerator, lastSettleTsMs, settleCount, lastGainMilli, totalGainMilli,
lifetimeReputation, spendableReputation, visitCount, visitCoinsMilli, offlinePending, offlineStartTsMs`

---

## 2. 各步骤的实际执行顺序（实测轨迹，不是设计稿）

两端都会把每一步记成**统一格式的一行** `flow step=<步骤> changed=<bool> …`
（`src/core/flow.ts` 的 `flowTraceLine()`），因此顺序是**实测**出来的。

### 2.1 浏览器端实测轨迹（节选自 `evidence/browser-verify-step8.log`）

```
flow step=foreground changed=true  offline_reason=granted delta_ms=137383 rate=26 gain_milli=59533 carry_after=22000 write=ok committed=true
flow step=settle     changed=true  settle_ok=true delta_ms=1000 rate=10 gain_milli=167 carry_after=10000
flow step=visit      changed=true  visit_ok=true tag=居民 coin_gain_milli=3000 visit_count=1 last_settle_unchanged=true
flow step=upgrade    changed=true  upgrade_ok=true level=1->2 cost_milli=20000 rate=10->12
flow step=background changed=true  applied=true online_gain_milli=39 offline_pending=false->true offline_start_ts_ms=…
flow step=foreground changed=true  offline_reason=granted delta_ms=3600000 rate=12 gain_milli=720192 write=ok committed=true
flow step=foreground changed=false offline_reason=not-pending gain_milli=0 was_pending=false
```

### 2.2 微信小游戏端实测轨迹（节选自 `evidence/wechat-step8-run.log`）

```
flow core wyszz-core-flow-v1 fingerprint=… steps=boot>foreground>settle>visit>upgrade>background>save
flow step=foreground changed=true offline_reason=granted delta_ms=137383 rate=26 gain_milli=59533 carry_after=22000 write=ok committed=true
offline grant=boot 离线结算 granted | 时长=2 分 17 秒（137383ms） | 速率=26 金币/分钟 | 收益=59533 毫币（59 金币）
save write 存档已写入 wyszz-0.1-ds-save bytes=318 schemaVersion=2 | … | offline_pending=false …
flow invariants OK 0-problems
wx.onShow
flow step=foreground changed=false offline_reason=not-pending gain_milli=0 was_pending=false
offline skip=show reason=not-pending no-grant
flow step=settle changed=true settle_ok=true delta_ms=860 rate=26 gain_milli=373 carry_after=2000
```

### 2.3 顺序不变量（自动核对，两端一致）

| 不变量 | 判据 | 结果 |
| --- | --- | --- |
| 升级前必先结算 | `stepUpgrade` 内部先调 `stepSettle`；轨迹里 upgrade 行必带结算信息 | PASS |
| 寻访前必先结算 | `stepVisit` 内部先调 `stepSettle`；轨迹 `last_settle_unchanged=true` | PASS |
| 进后台前必先结算 | `stepEnterBackground` 内部先调 `stepSettle`；轨迹带 `online_gain_milli` | PASS |
| 回前台只结算一次 | 每次 granted 都 `committed=true`；两次 granted 之间必有一次 `applied=true` 的 background | PASS |
| 重复进后台幂等 | 相邻两次 background 不会都 `applied=true` | PASS |
| 存档是单个信封 | 每次写档都是 `bytes=N schemaVersion=2` | PASS |
| 流程不变量自检 | 两端启动都打印 `0 项异常` | PASS |

---

## 3. 验收环境与结果总览

| 环境 | 工具 | 结果 |
| --- | --- | --- |
| TypeScript 类型检查 | `npx tsc --noEmit` | **0 错误** |
| 核心单元/集成测试 | `npm test`（`node --test`） | **171/171** |
| 浏览器生产构建 | `node build.mjs` | 通过 |
| 浏览器完整流程 E2E（本地） | `tools/verify-browser-step8.mjs` | **45/45** |
| 浏览器完整流程 E2E（公网 `/step8/`） | 同上 + `WYSZZ_BASE_URL` | **45/45** |
| 公网远程验收（14 步） | `tools/accept-remote-step8.mjs` | **14/14** |
| 微信小游戏游客模拟器 | `tools/analyze-vm-log-step8.mjs` | **22/22** |
| 第三步回归 | `tests/economy.test.mjs` | **9/9** |
| 第四步回归 | `tests/visit.test.mjs` | **12/12** |
| 第五步回归 | `tests/upgrade.test.mjs` | **22/22** |
| 第六步回归 | `tests/save.test.mjs` + `tools/verify-browser.mjs` | **32/32** + **107/107** |
| 第七步回归 | `tests/offline.test.mjs` + `tools/verify-browser-step7.mjs` | **48/48** + **40/40** |
| 第八步新测试 | `tests/flow.test.mjs` | **38/38** |
| 真实三维射线拾取 | `tests/scene-pick.test.mjs` | **10/10** |

**合计：171 个核心测试 + 45 项浏览器 E2E（本地）+ 45 项浏览器 E2E（公网）+ 14 步公网远程验收
+ 22 项微信模拟器判据 + 第三～七步回归（9+12+22+32+48+38+10 单元/集成 + 107 + 40 浏览器 E2E），全部通过。**

### 3.1 构建产物

| 产物 | 字节 | SHA-256（前 16 位） |
| --- | --- | --- |
| `dist/browser/app.js` | 596553 | `6d7e723018128ede…` |
| `dist/game/bundle.js` | 595330 | （见 `evidence/packages-sha256.txt`） |
| `dist/game/adapter.js` | 9182 | — |
| `dist/core/flow.js` | 9160 | — |

---

## 4. 任务书 18 项要求的逐条落点

| # | 要求 | 覆盖位置 | 结果 |
| --- | --- | --- | --- |
| 1 | 完整流程：新游戏→寻访→升级→存档→刷新恢复 | E2E H1–H9；远程验收步骤 2/4/7/8 | PASS |
| 2 | Lv1 时间收益与寻访奖励同时正确 | E2E H5+H6；远程验收步骤 4/5；`flow.test.mjs` F3/F4 | PASS |
| 3 | 升级先按旧速率结算，之后用新速率 | E2E H8/H8b；远程验收步骤 7；`flow.test.mjs` F10 | PASS |
| 4 | 金币不足时升级：已结算收益保留、等级不变 | E2E H7；远程验收步骤 6；`flow.test.mjs` F11 | PASS |
| 5 | 刷新恢复后等级/金币/毫币余数/声望/寻访逐项一致 | E2E H9；远程验收步骤 8（含信封原样注入再读回） | PASS |
| 6 | 进后台前先结算在线收益 | E2E H12/H13；远程验收步骤 9；`flow.test.mjs` F14 | PASS |
| 7 | 回前台离线收益恰好发放一次 | E2E H15/H16；远程验收步骤 10；`flow.test.mjs` F15/F16 | PASS |
| 8 | 第二次 onShow / 刷新 / 重开不重复发放 | E2E H17；远程验收步骤 11；`flow.test.mjs` F18/F19 | PASS |
| 9 | F 关面板不再次结算 | E2E H18；远程验收步骤 12；`flow.test.mjs` F20 | PASS |
| 10 | 点面板外不触发寻访/升级/结算 | E2E H19；远程验收步骤 12（`swallowedInputs` 0→2） | PASS |
| 11 | 损坏存档与旧 schema 安全处理 | E2E H20/H21/H21b；远程验收步骤 13；`flow.test.mjs` F22 | PASS |
| 12 | 时钟回拨/负数/NaN/Infinity 不污染状态 | E2E H22；`flow.test.mjs` F23 | PASS |
| 13 | 居民/道路/市政厅/空白 负样本射线拾取正确 | E2E J6（30 点网格扫描）；`scene-pick.test.mjs` S1–S9 | PASS |
| 14 | 旋转视角后居民与市政厅仍可命中 | `scene-pick.test.mjs` S4b/S5（10 个姿态环形搜索） | PASS |
| 15 | 真实墙钟 >120 秒测试 | E2E I1–I6（`REAL_WAIT_MS=125000` 字面量，真实等待 125 秒） | PASS |
| 16 | 模拟 1 小时 / 8 小时 / 24 小时 / 7 天 | `flow.test.mjs` F6–F9（逐毫币复算） | PASS |
| 17 | 浏览器与微信小游戏同核、结果相同 | 两端 `flow core` 指纹逐字一致；微信日志独立复算通过（W9–W12） | PASS |
| 18 | 第三～第七步既有测试全部回归通过 | 见 §3 总览表 | PASS |

### 4.1 真实墙钟测试（要求 15）细节

`tools/verify-browser-step8.mjs` 的 I 组使用字面量 `REAL_WAIT_MS = 125000`，**真实 sleep**，
不推进任何可模拟时钟：

```
PASS | I1 真实墙钟离线测试（等待 125 秒，时间真实流逝）
PASS | I2 真实墙钟离线收益与整数毫币公式逐毫币一致（carryNumerator 参与余数） | gainMilli=29237 期望=29237 carryAfter=58345 期望=58345
PASS | I3 真实墙钟离线结算不改动等级 / 声望 / 寻访次数
PASS | I4 真实墙钟发放已落盘：pending 复位、余额只增不减、仍是单个 14 键 v2 信封
PASS | I5 真实墙钟离线面板显示了正确的时长与收益 | 时长="2 分 5 秒（125305 ms）"
PASS | I6 真实墙钟发放之后刷新，不再重复发放
```

---

## 5. 公网部署

### 5.1 部署清单（纯新增）

| 项 | 值 |
| --- | --- |
| 地址 | https://mayor3d.hynixing.cn/step8/ |
| `index.html` | 14797 B，sha256 `8142457b9b558a3792a442ccf8928ac210276b010b369830aab41f85b99e9c11` |
| 资源（内容哈希命名） | `app-6d7e7230.js`，596553 B，sha256 `6d7e723018128edee773fdef2b80d90460d8abf2f82581129276d61c9ee8dfe5` |
| 部署方式 | 纯新增写入 `/vol1/ai/projects/wyszz-new/3d-spike-ds/dist/step8/`（唯一改动点） |
| 部署脚本 | `tools/deploy-public-step8.mjs` |
| 部署日志 | `evidence/deploy-step8-hashes.txt` |

**为什么资源用内容哈希文件名**：文档根的静态服务只对 `index.html` 发
`no-cache, must-revalidate`，其它扩展名没有 `Cache-Control`，Cloudflare 边缘会把 `app.js`
缓存住（实测 `cf-cache-status: HIT`）。既然不许改 Cloudflare 配置，就用内容哈希文件名做
缓存失效——`index.html` 每次回源校验，它引用的哈希名一变，边缘与浏览器必然取到新资源。
实测新资源首次请求 `cf-cache-status: MISS`，之后 `HIT`，且字节与本地逐字节一致。

### 5.2 部署前后旧页面哈希（证明未改动）

| 地址 | 部署前 | 部署后 | 结论 |
| --- | --- | --- | --- |
| `/` | HTTP 200 · 1337 B · `fbad5a50982c1f36580c69932aa7203539149d5a074d74f8cbd6e4c2edb20d22` | 同左 | **逐字节未变** |
| `/step6/` | HTTP 200 · 9048 B · `266a5e5bb9dfb3e431363d040aaeb1d8a19407c4473b6250cd5b34956f2b7160` | 同左 | **逐字节未变** |
| `/step6/app-121e6157.js` | `121e615723641790fc1289017555085f43ec8646e261430127cbd0e4680d5e37` | 同左 | **逐字节未变** |
| `/step7/` | HTTP 200 · 13600 B · `03139af1f1a844a72555879355f6813948e6d6a40d6e39fa5c44c2362cafc315` | 同左 | **逐字节未变** |
| `/step7/app-1d62e81a.js` | `1d62e81a4c1eb593f67266768c584a7452a22a82fdf1904c895b45db372cd5c9` | 同左 | **逐字节未变** |
| `/step8/` | HTTP 404（不存在） | HTTP 200 · 14797 B · `8142457b…` | 新增成功 |

### 5.3 正式页安全自检

- 默认页（**不带** `?debug=1`）**不渲染任何**测试辅助控件：`#debugBox` 的 `display: none`，
  `body.debug` 为 `false`，`document.readyState === 'complete'`，可直接远程打开。
- 正式页面**不含**：内部路径（`/vol1/`、`/mnt/`）、主机名、隧道名、systemd 服务名、
  凭据字样（`token` / `secret` / `password` / `API_KEY` / `appid` / `AppID` / `SSH`）、
  端口（`127.0.0.1` / `localhost` / `:5190` / `:8898` / `:8899`）。命中 **0**。
- 页面自己只加载**一个**模块脚本，且文件名带内容哈希。
  （Cloudflare 会额外注入它自己的 `beacon.min.js`，验收时已按域名单独排除。）
- 运行期未捕获异常 **0**。

### 5.4 回滚（一条命令）

```bash
rm -rf /vol1/ai/projects/wyszz-new/3d-spike-ds/dist/step8
```

回滚效果：`/step8/` 立即回到 HTTP 404。`/`、`/step6/`、`/step7/` 全程**未被触碰**，
无需回滚。本步未改动 DNS、Cloudflare、隧道、反向代理、防火墙、systemd 或 nginx 的任何配置。

### 5.5 公网 `/step8/` 的完整流程 E2E

```bash
WYSZZ_BASE_URL=https://mayor3d.hynixing.cn/step8/ \
WYSZZ_OUT=browser-verify-step8-public.log \
  node tools/verify-browser-step8.mjs
```

结果：**45/45 通过**（`evidence/browser-verify-step8-public.log`）。
同一套 45 项判据（H 组完整流程 / I 组 125 秒真实墙钟 / J 组按钮与射线互不穿透 / K 组正式页自检）
原样跑在公网地址上，其中 K2 在公网模式下验证的正是内容哈希资源名
（`https://mayor3d.hynixing.cn/step8/app-6d7e7230.js`）。

---

## 6. 微信小游戏（游客模拟器）

### 6.1 运行环境

- 微信开发者工具 2.02.2608080，游客模式（无 AppID），`libVersion 3.17.2`
- 模拟器：iPhone 12/13 (Pro) 逻辑分辨率 390×844，dpr 3，WebGL2 / ANGLE(D3D11)
- 小游戏工程槽：`C:\projects\wyszz-wx-spike\minigame-env-check`（由
  `win/deploy_into_open.ps1` 从本地文件通道拉取 `game.js / bundle.js / adapter.js / game.json`）
- 日志来源：小游戏自己写进沙箱的 `wx.env.USER_DATA_PATH/run.log`（经 `win/read_gamelog.ps1` 取出）

### 6.2 判据（`tools/analyze-vm-log-step8.mjs`，22/22）

| # | 判据 | 结果 |
| --- | --- | --- |
| W1 | 启动成功，无 `BOOT_FAILED` / `BUNDLE_FAIL` / `ADAPTER_FAIL` | PASS |
| W2 | 加载第八步流程核心，指纹自洽，步骤顺序与浏览器端一致 | PASS |
| W3 | 启动时流程不变量自检 **0 项异常** | PASS |
| W4 | 全部 33 行流程轨迹格式统一 | PASS |
| W5 | 实际执行到 foreground / settle 两类步骤 | PASS |
| W6 | 发放那次的 foreground 轨迹 `write=ok committed=true` | PASS |
| W7 | 发放之后所有 foreground 都是 `not-pending`，绝无第二次 granted | PASS |
| W8 | 真的发生了一次离线结算，**时长 137383 ms > 120 秒（真实墙钟）** | PASS |
| W9 | 收益与第三步核心公式**独立复算逐毫币一致**：`2×26000 + floor((44000+17383×26000)/60000) = 59533` | PASS |
| W10 | `carryNumerator` 参与余数运算且落回 `[0,59999]`（44000 → 22000，复算一致） | PASS |
| W11 | 余额变化 = 本次发放额（19745313 → 19804846，差 59533，毫币级精确相等） | PASS |
| W12 | 毫币/金币两种口径一致（59533 毫币 = 59 金币） | PASS |
| W13 | 离线结算不改动等级 / lifetime / spendable / visitCount（9/16/16/16 全不变） | PASS |
| W14 | 发放后**一次完整 JSON 写入**把 `offline_pending` 复位为 false（318 字节，schemaVersion=2） | PASS |
| W15 | 存档核心为 v2（13 字段、支持 1/2、走 `wx.getStorageSync/setStorageSync`） | PASS |
| W16 | 读档日志带出 `offline_pending` / `offline_start_ts_ms` | PASS |
| W17 | 发放后紧跟的 `wx.onShow` 不重复发放（`skip=show reason=not-pending no-grant`） | PASS |
| W18 | 负样本：存档 `offline_pending=false`，空档 267.8 秒也**一分钱都不发** | PASS |
| W19 | 所有写档都是单个完整 v2 信封 | PASS |
| W20 | 五个核心（economy/visit/upgrade/save/offline）指纹全部自洽 | PASS |
| W21 | 「结算」与「升级」按钮热区不重叠（`settleY=[721,819]` / `upgradeY=[629,709]`） | PASS |
| W22 | 渲染循环真的在跑（fps 采样，末行 `fps=56`） | PASS |

### 6.3 微信端未覆盖到的部分（如实说明，不粉饰）

- **微信端的「点居民寻访」与「点市政厅升级」没有被真实触摸覆盖到。**
  原因：这台 Windows 虚拟机的合成鼠标注入已经失效（第七步就出现过，本步再次确认：
  任务栏点击、`Click` 注入都到不了模拟器；Server Manager 的通知浮层还会盖住工具栏）。
  按任务书允许的降级路径，本步改用「重启编译 + 设备日志 + 自动化回放」取证。
- 这两条路径在微信端**并非没有依据**：微信入口与浏览器入口调用的是**同一份**
  `src/core/flow.ts` 的 `stepVisit` / `stepUpgrade`，两端 `flow core` 指纹逐字一致（W2/W20），
  且 `tests/flow.test.mjs` 在源码层断言了微信入口确实走 `stepVisit` / `stepUpgrade`
  而不是自己重写一遍；浏览器端 45 项 E2E 与公网 14 步验收覆盖了这两条路径的行为。
- **真机（真设备）未验证。** AppID 仍在审核中，无法生成真机预览二维码或提交体验版。
  本报告中的「微信」结果**全部来自开发者工具游客模拟器**，
  **不得**被当作真机结果。本步**没有**伪造 AppID、二维码、真机通过结论或发布结果。

---

## 7. 第三～第七步回归

| 步 | 测试 | 结果 | 说明 |
| --- | --- | --- | --- |
| 三 时间收益 | `tests/economy.test.mjs` | 9/9 | 核心文件 `src/core/economy.ts` 逐字节未改 |
| 四 寻访奖励 | `tests/visit.test.mjs` | 12/12 | — |
| 五 手动升级 | `tests/upgrade.test.mjs` | 22/22 | 第 10 项按新委派结构改写并**加强**：断言 `升级按钮 → doUpgrade → stepUpgrade → 先 settle() 再 applyUpgrade()`，且升级按钮**不再**单独调 `settleNow()` |
| 六 本地存档 | `tests/save.test.mjs` + `tools/verify-browser.mjs` | 32/32 + 107/107 | 浏览器 E2E 107 项全通过 |
| 七 离线收益 | `tests/offline.test.mjs` + `tools/verify-browser-step7.mjs` | 48/48 + 40/40 | 其中 `T17b`/`T27b` 按新委派结构改写：`T17b` 接受 `adopt({ economy: candidate … })` 形式并仍要求「写档失败后不提交」；`T27b` 接受 `stepEnterBackground(` / `stepEnterForeground(` 并要求入口 import `../core/flow` |

**改写原则**：第七步的这两项断言原本锁的是**字面代码字符串**，在第八步把流程收敛到
`flow.ts` 之后必然失配。改写后它们锁的是**委派链与不变量**（谁调用谁、失败后是否提交），
既保持行为等价，又比原来更难被绕过。所有原有行为断言一条都没有放宽。

---

## 8. 本步明确「没有做」的事

- **未进入 0.2。** 本步完成后即停止。
- **未新增**：岛屿扩张、种子生成、随机地形 / 随机场景、助手、广告、后端、排行榜、
  月度赛季、新的升级轨道、真机发布、正式提交审核。
- **未使用任何高级模型**（未调用任何大模型 / AI 生成服务参与本步的实现或验收）。
- **未改动**：旧项目目录、实验目录、MIMO 对照目录、`little-town/`、`app/`、
  `wechat-spike-ds/`、`3d-spike-ds/` 的**源码**，以及任何已上线的旧公网版本。
- **未改动**：DNS、Cloudflare 配置、隧道、防火墙、反向代理、systemd、nginx。
- 本步唯一的目录写入是：
  1. `/vol1/ai/projects/wyszz-new/wechat-game-0.1-ds/`（正式开发目录）
  2. `/vol1/ai/projects/wyszz-new/3d-spike-ds/dist/step8/`（公网新增子路径，纯新增）
  3. 记忆库 `/vol1/ai/vault/AI记忆库/`（按全局规则回写）

---

## 9. 本轮定位到的缺陷与处置（游戏代码 / 工具分开记）

### 9.1 游戏代码缺陷

| 缺陷 | 现象 | 处置 |
| --- | --- | --- |
| 第七步遗留：`offlinePending === true` 期间自动结算仍在跑 | 进后台后在线定时器继续结算，会与离线区间重复计费 | 第八步收敛时在 `flow.ts` 的 `stepSettle` 前置判断 `offlinePending`，两个入口都走同一判断 |
| 微信端启动崩溃 `TypeError: Cannot read properties of undefined (reading 'level')`（第七步修） | 迁移写档早于前台结算 | 迁移后的 `persistSaveNow(true)` 移到 `goForeground('boot')` 之前 |

本步**没有**发现新的游戏代码缺陷：45 项浏览器 E2E、14 步公网验收、22 项微信模拟器判据
全部一次或经上述处置后通过。

### 9.2 工具/验收脚本缺陷（**不是**游戏 bug，如实记录）

| 缺陷 | 根因 | 处置 |
| --- | --- | --- |
| E2E 全程拿不到 `#dbgHide` | 初始导航没带 `?debug=1`，H 组的流程推进控件根本不存在 | 初始导航改为 `?debug=1`，并加一条前置断言 `H12pre` 直接检查控件存在 |
| 点居民总是点空 | `__wyszz.screenOf()` 返回的**已经是视口坐标**，脚本又加了一次 canvas rect 偏移 | 去掉二次偏移，并在注释里写明原因 |
| 读不到「最近一次收益」 | `snapshot()` 里没有 `lastGainMilli` 键（只有同名 DOM 节点） | 在浏览器入口快照里补上只读的 `lastGainCoins` / `lastGainMilli`（不入档） |
| 「金币不足」用例恒不成立 | 攒钱循环每次只等 120 ms，1 秒的自动结算吃不到推进的时间 | 每次推进后等 1400 ms，让真实核心把时间结算掉 |
| 注入损坏/旧版存档后刷新，fixture 被覆盖 | `pagehide` 会触发 `goBackground()` 立刻写档，把 fixture 冲掉 | 新增 `reloadWithFixture()`：先注入 → `suppressWrites()` 堵住写档 → 再刷新；并且 `suppressWrites` 必须先把**真正的** `getItem` 抓下来，否则读档也一起失效（会把「损坏存档」测成「没有存档」） |
| 流程轨迹断言在刷新后失配 | 内存轨迹每次 reload 都重置，且「两次 granted」可能属于**两个不同离线窗口** | 轨迹分前后两段合并看；「同一窗口只发一次」改成「两次 granted 之间必有一次 `applied=true` 的 background」——这才是真正的不变量 |
| 公网部署校验误判 `/step6/`、`/step7/` 变了 | `ORIGIN + '/' + 'step6'` 少了结尾斜杠，拿到的是 404 页 | 子路径拼上结尾斜杠；并修正 `html.length`（字符数）被当成字节数的问题 |
| 公网页面脚本数永远不是 1 | Cloudflare 会注入自己的 `beacon.min.js` | 统计「本页面自己的模块脚本」时按域名排除 CF beacon |
| 公网验收里点面板外没被吞掉 | 用 CDP `Input.dispatchMouseEvent` 到不了面板的吞输入处理器 | 改为派发 DOM `PointerEvent`（走页面真实的 pointer 处理器链），`swallowedInputs` 0→2 |
| 几处断言把「真实在线自动结算的零头」当成 bug | 两次快照之间隔了几百毫秒到 1 秒真实时间，在线定时器会加几十~几百毫币 | 账目闭合统一给 ≤2 秒零头容差，并把容差本身写进实测输出，不做无解释的放宽 |

---

## 10. 证据与交付物清单

| 文件 | 内容 |
| --- | --- |
| `docs/报告-0.1第八步-完整流程收口.md` | 本报告 |
| `evidence/browser-verify-step8.log` | 本地浏览器完整流程 E2E（45/45） |
| `evidence/browser-verify-step8-public.log` | 公网 `/step8/` 完整流程 E2E |
| `evidence/accept-remote-step8.log` | 公网 14 步远程验收（14/14） |
| `evidence/deploy-step8-hashes.txt` | 公网部署清单 + 部署前后旧页面哈希 |
| `evidence/wechat-step8-run.log` | 微信模拟器 `run.log` 原文 |
| `evidence/wechat-step8-simulator.raw.log` | `read_gamelog.ps1` 原始输出 |
| `evidence/analyze-vm-log-step8.log` | 微信模拟器 22 项判据（22/22） |
| `evidence/regression-step8.log` | `tsc` + `npm test` + 第六/七步浏览器 E2E |
| `evidence/browser-verify-step6.log` / `browser-verify-step7.log` | 第六步 107/107、第七步 40/40 |
| `evidence/screenshots/` | 本轮模拟器截图 |
| `evidence/packages-sha256.txt` | 两个交付包的 SHA-256 |
| `evidence/delivery-links.txt` | 全部交付物的下载链接 |

---

## 11. 后续（0.2 未开始）

0.2 的任何工作**本步都没有启动**。若要进入 0.2，需要另行下达任务书。
在此之前，唯一待办是**真机验证**——它被 AppID 审核阻塞，本步无法完成，也不做任何替代性声明。
