# 《我要当岛主》0.1 第七步「离线收益」完整报告

- 项目：`wyszz-new/wechat-game-0.1-ds`（正式开发目录）
- 本步范围：**只做第七步「离线收益」**，未进入第八步
- 完成时间：2026-10-10（Asia/Shanghai）
- 公网验收地址：<https://mayor3d.hynixing.cn/step7/>（免内网 / 免 VPN / 免 SSH / 免登录）

---

## 0. 一句话结论

第七步已完成并通过全部可在本机完成的验证：离线收益由**新增的纯核心模块 `src/core/offline.ts`** 统一实现，
浏览器与微信两个入口**只差存储 API**；离线时长**没有上限**；毫秒时间戳**从不直接除以 60**；
重复 `onShow` / 重复刷新 / 点 F 关闭面板都**不会重复发放**；v1 存档可读且迁移**不伪造离线金币**；
公网 `/step7/` 已上线，`/` 与 `/step6/` **逐字节未变**。
**微信真机未验证（AppID 审核中），第八步未开始。**

---

## 1. 本步已完成内容

| # | 任务书要求 | 完成情况 | 证据 |
|---|---|---|---|
| 1 | v2 存档结构：新增 `offline_pending` / `offline_start_ts_ms`，保留第六步全部字段 | ✅ 13 字段（11 旧 + 2 新） | `tests/save.test.mjs` 32 项、`tools/verify-browser-step7.mjs` E3 |
| 2 | 所有时间字段明确毫秒 | ✅ 字段名带 `TsMs` / `Ms` 后缀，注释与报告都写明 | `src/core/save.ts`、`src/core/offline.ts` |
| 3 | v1→v2 迁移：v1 必须可读、不丢数据、不发放离线金币 | ✅ | `tests/save.test.mjs`、`tools/verify-browser-step7.mjs` E25–E27、`tests/offline.test.mjs` T23 |
| 4 | 进入后台的准确事件顺序 | ✅ 先结算在线 → 置 pending → 置 start=now → 单次完整 JSON 写入 | `tools/verify-browser-step7.mjs` E7–E9 |
| 5 | 回到前台的准确事件顺序 | ✅ 读档校验 → pending 判定 → `delta_ms` → `T_offline_sec` → `T_offline_min` → 核心结算 → 写成功后才提交内存并显示面板 | `tools/verify-browser-step7.mjs` E10–E15 |
| 6 | 毫秒绝不直接除以 60 | ✅ 全仓唯一换算路径 `offlineDuration()`：`ms/1000 → sec`，`sec/60 → min`；源码级断言禁止 `Ms / 60` | `tests/offline.test.mjs` T8b（源码扫描） |
| 7 | 离线收益没有时长上限 | ✅ `OFFLINE_MAX_MS = Number.POSITIVE_INFINITY`，指纹含 `cap=none` | `tests/offline.test.mjs` T5–T7、T29 |
| 8 | 新增纯核心模块，两个入口不各写一套公式 | ✅ 两个入口都只调用 `enterBackground` / `enterForeground` / `settle` | `src/browser/main.ts`、`src/game/main.ts`、`tests/offline.test.mjs` T25/T25b/T26/T27 |
| 9 | 浏览器用 `visibilitychange` + `localStorage`；微信用 `wx.onHide`/`wx.onShow` + `wx.setStorageSync` | ✅ | `src/platform/runtime.ts`、`src/browser/main.ts`、`src/game/main.ts` |
| 10 | 离线面板（≥6 项信息），F 只关闭不再领取 | ✅ 面板含离线时长 / 本次获得金币 / 当前金币 / 当前等级 / 最近结算时间 / 当前离线状态 | `tools/verify-browser-step7.mjs` E13、E18 |
| 11 | 面板显示期间面板外点击必须被吞掉 | ✅ 捕获阶段吞掉 `pointerdown/up`、`click`、`touchstart/end` | `tools/verify-browser-step7.mjs` E17 |
| 12 | 公网 `/step7/`，正式页面无调试控件 | ✅ `?debug=1` 才显示 9 个控件 | `tools/verify-browser-step7.mjs` E4–E6、G1 |
| 13 | 所有 debug 控件调用真实离线核心 | ✅ 时间控件只推进可模拟时钟，金币全部由真实 `settle()` 产生 | `tools/verify-browser-step7.mjs` E10、E11、E20、E21 |
| 14 | 30 项测试 | ✅ 逐条见 §13 | 见 §13 |
| 15 | 构建 / 部署 / 回滚 / 哈希清单 | ✅ | `evidence/deploy-step7-hashes.txt` |

---

## 2. 离线状态机（唯一实现：`src/core/offline.ts`）

```
                    ┌──────────────────────────────────────────────┐
                    │  内存状态 state（EconomyState）              │
                    │  离线状态 offline = {offlinePending,         │
                    │                      offlineStartTsMs}       │
                    └──────────────────────────────────────────────┘

① 进入后台 enterBackground(state, nowMs, offline)
   ├─ offline.offlinePending === true  → 幂等空转：
   │     {state 不变, offline 不变, onlineGainMilli: 0, applied: false}
   │     不重复结算、不覆盖原始离线起点
   └─ offline.offlinePending === false →
         a) settle(state, nowMs)                // 先按第三步结算在线收益
         b) offline.offlinePending = true
         c) offline.offlineStartTsMs = nowMs
         d) 入口把 (economy, visit, offline) 一次性序列化成一个完整 JSON 信封写入

② 回到前台 enterForeground(state, nowMs, offline)
   ├─ offline.offlinePending === false → reason='not-pending'，收益 0
   │     （只把离线基线刷成 nowMs，绝不发钱）
   ├─ deltaMs = nowMs - offline.offlineStartTsMs
   │     deltaMs <= 0 → reason='clock-went-backwards' 或 'no-elapsed'
   │                    收益 0；**两个时间戳都不倒退**
   └─ deltaMs > 0 →
         a) dur = offlineDuration(deltaMs)
              deltaSeconds = deltaMs / 1000
              deltaMinutes = deltaSeconds / 60        ← 全仓唯一的 ms→min 路径
         b) anchored = { ...state, lastSettleTsMs: offline.offlineStartTsMs }
              // 把结算区间「锚」在离线起点上，复用第三步现成的整数毫币逻辑
         c) settle(anchored, nowMs)                   // 不重写公式
         d) offline.offlinePending = false
         e) 入口写档（单个完整 JSON 信封）
         f) **只有写入成功后**才 state = 新状态、才显示离线面板
```

### 2.1 幂等性从哪来

| 重复场景 | 为什么不会重复发放 |
|---|---|
| 重复 `onShow` | 第一次结算后 `offlinePending=false`，第二次走 `not-pending` 分支，收益恒为 0 |
| 重复刷新 | `pagehide` 只把 pending 置 true（幂等），刷新后结算一次即复位 |
| 重复点 F | F 只调 `hideOfflinePanel()`，函数体内**没有** settle / persist / grant 调用 |
| 重复 `onHide` | `enterBackground` 在 pending=true 时直接返回 `applied:false` |
| 写档失败 | 离线发放路径先写后提交；写失败就**不提交内存状态**、不弹面板 |

### 2.2 一个真实缺陷（已修）

**离线期间每秒的在线自动结算仍在跑**，会把同一段时间「在线 + 离线」各算一次（重复发放）。
浏览器端在标签页隐藏时定时器本来就被节流，但「模拟进入后台」/ bfcache 等场景下定时器仍在跑。
修复：两个入口的自动结算循环都加 `if (offline.offlinePending) return;` 守卫。
证据：`tools/verify-browser-step7.mjs` E29b（离线发放写档失败时余额不得增加）。

---

## 3. 所有字段及单位（v2 存档，`SAVE_STATE_FIELDS`，共 13 个）

信封固定键序（写档字节级可复现）：

| # | 字段 | 类型 | 单位 / 取值范围 | 来源 |
|---|---|---|---|---|
| 1 | `schemaVersion` | number | 受支持值 `1 \| 2`，当前写 `2` | 第六步 |
| 2 | `level` | number | 等级，`>= 1` 整数 | 第六步 |
| 3 | `coinsMilli` | number | **毫币**（1 金币 = 1000 毫币），非负安全整数 | 第六步 |
| 4 | `carryNumerator` | number | 毫币余数的分子，`0 ≤ x ≤ 59999` | 第六步 |
| 5 | `lastSettleTsMs` | number | **毫秒** Unix 时间戳 | 第六步 |
| 6 | `settleCount` | number | 次 | 第六步 |
| 7 | `lastGainMilli` | number | **毫币** | 第六步 |
| 8 | `totalGainMilli` | number | **毫币** | 第六步 |
| 9 | `lifetimeReputation` | number | 累计声望 | 第六步 |
| 10 | `spendableReputation` | number | 可用声望 | 第六步 |
| 11 | `visitCount` | number | 寻访次数 | 第六步 |
| 12 | `visitCoinsMilli` | number | **毫币** | 第六步 |
| 13 | `offlinePending` | **boolean** | 是否处于「已进入后台、尚未结算」状态 | **第七步新增** |
| 14 | `offlineStartTsMs` | number | **毫秒** Unix 时间戳：本次离线窗口的起点 | **第七步新增** |

> 注：上表 14 行 = `schemaVersion` + 13 个状态字段；`SAVE_STATE_FIELDS.length === 13`（不含 `schemaVersion`），
> 因此落盘信封一共 **14 个键**。

- 存储命名空间：`wyszz-0.1-ds-save`（**只占一个 key**，不拆多个互不一致的 key）
- 核心指纹：`wyszz-core-save-v2:v=2:support=1,2:fields=13:carry=0..59999:ns=wyszz-0.1-ds-save`
- 离线核心指纹：`wyszz-core-offline-v1:schema=2:base=60000:step=60000:cap=none`

### 3.1 整数毫币结算公式（第三步核心，第七步**原样复用**）

```
wholeMinutes = floor(deltaMs / 60000)
remMs        = deltaMs % 60000
numerator    = carryNumerator + remMs * rateMilliPerMinute(level)
gainMilli    = wholeMinutes * rateMilliPerMinute(level) + floor(numerator / 60000)
carryNumerator' = numerator % 60000
```

`carryNumerator` **参与**余数运算 —— 所以任何期望值都必须连 carry 一起算，否则会差 1 毫币。

---

## 4. v1 → v2 迁移（完整过程）

**触发条件**：`parseSave()` 读到 `schemaVersion === 1`。

**过程**（`src/core/save.ts::migrateV1ToV2(record, nowMs)`）：

1. 校验 v1 的 11 个数值字段全部存在、类型正确、在范围内；
   若 v1 记录里**出现了离线字段** → 判 `unexpected-field` → 安全回退新游戏（v1 不该有这两个字段）。
2. 11 个 v1 字段**原样搬运**，一个不改：
   `level`、`coinsMilli`、`carryNumerator`、`lastSettleTsMs`、`settleCount`、`lastGainMilli`、
   `totalGainMilli`、`lifetimeReputation`、`spendableReputation`、`visitCount`、`visitCoinsMilli`。
3. `offlinePending = false`
   —— 旧存档没有「已进入后台」这个事实，所以**不能**认定它处于离线状态。
4. `offlineStartTsMs = nowMs`（读档时刻）
   —— 建立一个**安全基线**：即使将来某个路径误判 pending，delta 也不会是一段伪造出来的历史时间。
5. **不发放任何离线金币**：迁移路径里没有任何 settle / grant 调用。
6. `schemaVersion = 2`，标记 `migrated: true`、`sourceVersion: 1`。
7. 入口在启动日志里打印迁移行，并**立刻落盘**一次（把磁盘上的 schemaVersion 收敛到 v2）。
   ⚠️ 这一步必须在 `econ` / `visit` / `offline` 全部初始化**之后**调用 —— 见 §12 的真实缺陷。

**安全回退**：不支持的 `schemaVersion`（0/3/99/1.5/"1"/null）、损坏 JSON、字段缺失/越界/类型错误，
一律 `kind: 'corrupt'` → 用 `createInitialState(nowMs)` 全新开局，**不发任何补偿**。

**迁移证据**：

- `tests/offline.test.mjs` T23：v1 迁移不发放伪造离线收益
- `tests/save.test.mjs`：v1 可读、字段逐项相等、`offlinePending=false`
- `tools/verify-browser-step7.mjs` E25/E26/E27：浏览器端注入真 v1 存档 → 迁移后 Lv3 / 45678 毫币 /
  carry 12345 / 声望 5 / 寻访 5 全部保留，`offlineGrants === 0`，落盘 `schemaVersion=2`
- `tools/accept-remote-step7.mjs` 步骤 10：公网同一验证
- `evidence/wechat-step7-boot-crash.log`：微信模拟器真实迁移行
  `save migrate v1 -> v2 offline_pending=false offline_start_ts_ms=… no offline coins granted`

---

## 5. 一次性结算证据（同一时间区间绝不发第二次）

| 场景 | 证据 | 实测 |
|---|---|---|
| 同一毫秒内连续两次 settle | `tests/economy.test.mjs`、`tests/offline.test.mjs` T9 | 第二次 `gainMilli = 0` |
| 重复 `onShow` | `verify-browser-step7.mjs` E15 | `grants 2→2`（未增加）`skips 1→2` |
| 重复刷新两次 | `verify-browser-step7.mjs` E22 | 每次刷新最多结算「刷新空档」几百毫秒，`pending=false` |
| 点 F 关闭面板 | `verify-browser-step7.mjs` E18 | 余额与发放次数**都没变** |
| 微信端发放后紧跟的 `wx.onShow` | `tools/analyze-vm-log-step7.mjs` V13 | `offline skip=show reason=not-pending no-grant`，`grant=show` 0 次 |
| 离线期间在线自动结算 | `verify-browser-step7.mjs` E29b | 已加守卫，余额不增加 |

---

## 6. 时长证据（1 秒 / 60 秒 / 1 小时 / 8 小时 / 24 小时 / 7 天）

Lv1 速率 = **10 金币/分钟 = 10000 毫币/分钟**。全部由 `settle()` 真实计算（`tests/offline.test.mjs` T29）。

| 离线时长 | deltaMs | 收益（毫币） | 收益（金币） | 是否截断 |
|---|---|---|---|---|
| 1 秒 | 1 000 | 166 | 0（carry 留 40000） | 不截断 |
| 60 秒 | 60 000 | 10 000 | **10** | 不截断 |
| 1 小时 | 3 600 000 | 600 000 | **600** | 不截断 |
| 8 小时 | 28 800 000 | 4 800 000 | **4 800** | 不截断 |
| 24 小时 | 86 400 000 | 14 400 000 | **14 400** | 不截断 |
| 7 天 | 604 800 000 | 100 800 000 | **100 800** | 不截断 |
| 非整分钟 1h37m13s | 5 833 000 | — | — | 不截断（T29b 精确核对 carry） |

**真实墙钟 >120 秒测试（要求 28）**：

| 环境 | 真实流逝 | 核心判定 deltaMs | 收益 | 证据 |
|---|---|---|---|---|
| 浏览器（本地） | 125.0 s | 125 310 ms | 20 885 毫币 = 20 金币 | `evidence/browser-verify-step7-local.log` F1/F2 |
| 浏览器（公网 `/step7/`） | 125.0 s | 125 309 ms | 20 885 毫币 = 20 金币 | `evidence/browser-verify-step7-public.log` F1/F2 |
| 微信游客模拟器 | 143.6 s | 143 646 ms | 62 247 毫币 = 62 金币（Lv9） | `evidence/wechat-step7-run.log` |

> 这三个测试**都没有**推进可模拟时钟（`debugClockOffsetMs === 0`），时间是真的流逝的。

---

## 7. 浏览器结果

- 构建：`browser: app.js=590386 B`（esbuild 0.25.12，three r186）
- **第七步专项 E2E（`tools/verify-browser-step7.mjs`）**：
  - 本地：**40/40 PASS**（`evidence/browser-verify-step7-local.log`）
  - 公网 `/step7/`：**40/40 PASS**（`evidence/browser-verify-step7-public.log`）
  - 分组：E1–E31 离线状态机/幂等/面板/迁移/损坏/写档失败；F1–F5 真实墙钟 125 s；G1–G3 产物与泄露自检
- **第三～六步回归（`tools/verify-browser.mjs`，107 项）**：**107/107 PASS**（`evidence/browser-verify-step6.log`）
- **12 步公网远程验收（`tools/accept-remote-step7.mjs`）**：**12/12 PASS**（`evidence/accept-remote-step7.log`）

关键实测（公网，节选）：

```
E4  默认页面（无 ?debug=1）不渲染任何调试控件            PASS
E5  ?debug=1 下 9 个验收控件全部可见                     PASS  可见=9/9
E7  模拟进入后台：pending=true、start≈now、在线已先结算   PASS
E9  重复「模拟进入后台」幂等：起点不被推后、余额不变      PASS
E10 「模拟经过 1 分钟」只推进时钟，不直接改金币           PASS  clockOffset=60000
E11 Lv1 离线 1 分钟发满 10 金币（与真实核心预演一致）     PASS
E13 离线面板含 6 项信息                                 PASS  时长="1 分 0 秒（60915 ms）" 收益="10 金币（+10153 毫币）"
E15 重复「模拟返回前台」第二次收益为 0                    PASS  grants 2→2  skips 1→2
E17 面板显示期间面板外点击被吞掉                          PASS  picks 0→0  upgrade 0→0  swallowed 0→6
E18 点 F 只关闭面板：不再次领取、不再次入账               PASS  余额与 grants 都没变
E19 关闭面板后点击恢复正常（+3 金币 / +1 声望）           PASS
E20 离线 1 小时产生 600 金币                             PASS
E21 离线 8 小时产生 4800 金币                            PASS
E24 损坏 JSON 安全回退                                  PASS  kind=corrupt reason=bad-json
E25 v1 存档迁移不丢数据                                  PASS  migrated=true srcV=1 Lv=3 coinsMilli=45678
E26 v1 迁移不发放任何伪造离线收益                         PASS  offlineGrants=0
E28 模拟存储写入失败 → 显示「本地保存失败」、不崩溃        PASS
E29b 离线发放写档失败 → 不提交内存、不弹面板              PASS
F1  真实墙钟离线 >120 秒                                PASS  真实流逝=125006ms clockOffset=0
G1  正式页面不泄露内部路径/主机名/隧道/服务/凭据           PASS  0 命中
```

---

## 8. 微信小游戏模拟器结果

**结论：模拟器通过；真机未验证（AppID 审核中）。**

- 构建：`game: bundle.js=589724 B`，`storageApi=wx.getStorageSync/setStorageSync`
- 微信端与浏览器端**共用同一个核心**：日志里 `offline core wyszz-core-offline-v1 fingerprint=… (expect …) cap=none` 自洽
- 真实离线发放（模拟器重启编译，真实墙钟 143.6 秒）：

```
offline grant=boot 离线结算 granted | 时长=2 分 23 秒（143646ms = 143.646s = 2.3941min）
  | 速率=26 金币/分钟（26000 毫币/分钟） | 收益=62247 毫币（62 金币）
  | 余额 7457212 -> 7519459 毫币 | carry 48000 -> 24000
  | last_settle_ts_ms 1791574364136 -> 1791574364239
```

  独立复算（`tools/analyze-vm-log-step7.mjs` V6–V9，按第三步同一条整数公式）：

```
wholeMinutes = floor(143646/60000) = 2        remMs = 23646
numerator    = 48000 + 23646 × 26000 = 614844000
gainMilli    = 2 × 26000 + floor(614844000/60000) = 52000 + 10247 = 62247   ← 与游戏一致
carry'       = 614844000 % 60000 = 24000                                      ← 与游戏一致
余额         7457212 + 62247 = 7519459                                        ← 与游戏一致
```

- 离线结算**未改变** `level`(9→9) / `lifetimeReputation`(16→16) / `spendableReputation`(16→16) / `visitCount`(16→16)
- 发放后立刻复位 `offline_pending=false` 并落盘（单个完整 14 键 v2 信封，316 B）
- 发放后紧跟的 `wx.onShow` → `offline skip=show reason=not-pending no-grant`（**不重复发放**）
- **负样本**：模拟器被强制结束（`evidence/wechat-step7-terminated-gap.log`）后重开，
  存档 `offline_pending=false`，空档 **267.8 秒**，`offline grant` 行数 = **0** → **不伪造离线收益**
- **正/负样本对照**由 `analyze-vm-log-step7.mjs` V14 / V14b 自动判定
- 自动分析：**17/17 PASS**（`evidence/analyze-vm-log-step7.log`）

### 8.1 微信端发现的真实游戏代码缺陷（已修复）

```
BOOT_FAILED TypeError: Cannot read properties of undefined (reading 'level')
    at d_ (…/game/bundle.js:16979:18)
```

- **根因**：`persistSaveNow(true)`（v1→v2 迁移落盘）被放在 `let econ` / `let visit` **之前**调用，
  写档函数读到还没初始化的状态。
- **为什么只有微信端炸**：浏览器入口里 `state`/`visit`/`offline` 的声明本来就在调用点之前，
  所以同一处逻辑在浏览器端是安全的 —— 这个缺陷**只有真实启动微信端才会暴露**。
- **修复**：把迁移落盘移到 `econ` / `visit` / `offline` 全部初始化之后、`goForeground('boot')` 之前。
- **修复后**：`save migrate persisted schemaVersion=2 writes=1 errors=0`，`first-frame rendered`，无 `BOOT_FAILED`。
- 证据：`evidence/wechat-step7-boot-crash.log`（崩溃原文）、`evidence/wechat-step7-run.log`（修复后）

### 8.2 模拟器操作方式说明（不夸大）

本机 Windows 虚拟机的**合成鼠标注入在验证后半段失效**（连 Server Manager 自己的弹窗都点不动）。
按任务书第 9 条预设的处置方式，改用**重启编译 + 设备日志 + 自动分析**路线：

- 用 `win/stop_devtools.ps1` / `win/restart_devtools_gpu.ps1` 精确按安装目录前缀停启（**没有**用路径前缀通配脚本杀进程）
- 真实离线发放的前置条件由 `win/seed_offline_pending.ps1` 写入模拟器 Storage
  （只写 `offline_pending=true` 与 `offline_start_ts_ms`，**不写任何金币字段**），
  奖励数值由小游戏自己用真实核心在真实墙钟时间算出。
- 已实测：**最小化 DevTools 窗口不会触发 `wx.onHide`**（循环继续跑），所以没有把「最小化」当成前后台切换。

---

## 9. 公网结果

- 新增地址：<https://mayor3d.hynixing.cn/step7/>（**纯新增**，只写 `3d-spike-ds/dist/step7/`）
- 部署方式：`node tools/deploy-public-step7.mjs`（部署前先抓旧哈希 → 构建 → 写入 → 部署后复核）
- 资源使用**内容哈希文件名**：`app-1d62e81a.js`（Cloudflare 只对 `index.html` 发 `no-cache`，
  同名 `app.js` 会命中边缘缓存，所以必须换名字）

| 资源 | 字节 | sha256 |
|---|---|---|
| `/step7/index.html` | 13 600 | `03139af1f1a844a72555879355f6813948e6d6a40d6e39fa5c44c2362cafc315` |
| `/step7/app-1d62e81a.js` | 590 386 | `1d62e81a4c1eb593f67266768c584a7452a22a82fdf1904c895b45db372cd5c9` |

**未改动确认（部署前后逐字节一致）**：

| 资源 | 部署前 sha256 | 部署后 sha256 | 一致 |
|---|---|---|---|
| `/`（旧版 3D 预览） | `fbad5a50982c1f36580c69932aa7203539149d5a074d74f8cbd6e4c2edb20d22` | 同左 | ✅ |
| `/step6/` | `266a5e5bb9dfb3e431363d040aaeb1d8a19407c4473b6250cd5b34956f2b7160` | 同左 | ✅ |
| `/step6/app-121e6157.js` | `121e615723641790fc1289017555085f43ec8646e261430127cbd0e4680d5e37` | 同左 | ✅ |

- 公网正式页面自检：标题含「第七步」✅、无内部路径/主机名/隧道/服务/端口/凭据 ✅
- 公网 `?debug=1` 才出现 9 个控件；默认页面 `debugBox` 为 `display:none`
- 完整清单：`evidence/deploy-step7-hashes.txt`

---

## 10. 第三～第六步回归结果

| 步骤 | 套件 | 结果 |
|---|---|---|
| 第三步 时间收益 | `tests/economy.test.mjs` | 9/9 PASS |
| 第四步 寻访点击与奖励 | `tests/visit.test.mjs` | 12/12 PASS |
| 第五步 手动升级市政厅 | `tests/upgrade.test.mjs` | 22/22 PASS |
| 第六步 本地存档 | `tests/save.test.mjs` | 32/32 PASS |
| 第七步 离线收益 | `tests/offline.test.mjs` | 48/48 PASS |
| **合计** | `npm test` | **123/123 PASS** |
| 浏览器端到端（三～六步） | `tools/verify-browser.mjs` | **107/107 PASS** |
| 微信端到端（三～六步） | 模拟器 `run.log` + 分析器 | 关键行齐全，无 `BOOT_FAILED` |

回归中需要更新的**断言**（不是功能回退）：

- 第六步 E2E 的 D 组原先断言「信封 12 键 / `schemaVersion=1` / 11 字段」，v2 后改为 14 键 / v2 / 13 字段
- 第六步 E2E 的 D6 原先把 `schemaVersion=2` 当成「不支持」，v2 后从非法列表移除
- 第六步 E2E 每次 `reload()` 后需要**像真实玩家一样按 F 关闭离线面板**，
  因为面板按设计会吞掉面板外的一切输入（这是第七步的正确行为，不是回归）

---

## 11. 游戏代码错误 vs 开发者工具错误的区分

| 现象 | 归类 | 判据 |
|---|---|---|
| `BOOT_FAILED TypeError: Cannot read properties of undefined (reading 'level')` | **游戏代码错误** | 栈指向 `game/bundle.js` 自己的模块初始化路径；浏览器端无此问题；改完代码即消失 |
| `模拟器处于终止状态，可点击工具栏上的编译按钮重新启动模拟器` | **开发者工具行为** | DevTools 自己的提示，非游戏输出；点错工具栏图标（终止按钮）导致 |
| `wx.onHide` 在强制结束模拟器时不落盘 | **开发者工具行为** | 进程被结束，运行时不保证 flush；不是游戏的写档失败 |
| 最小化 DevTools 窗口不触发 `wx.onHide` | **开发者工具行为** | 模拟器把「窗口最小化」与「小游戏切后台」当作两件事 |
| `Missing element #ofStatusLine`（早期） | **游戏代码错误** | HTML `id` 与 TS 里 `el()` 查找的名字不一致，已修 |
| `VERIFY ERROR: window.__wyszz 不存在`（早期） | 上述游戏错误的**表现** | 根因是 `#ofStatusLine` 缺失，不是验证脚本的问题 |
| Cloudflare 注入 `<script data-cf-beacon='{"token":…}'>` | **基础设施行为** | 边缘自己加的，`/` 与 `/step6/` 同样有；泄露自检已排除该脚本 |
| 合成鼠标注入失效（连系统弹窗都点不动） | **验证环境问题** | 与游戏代码无关；改用重启编译 + 日志 + 自动分析 |
| 微信游客模式授权相关报错 | **开发者工具/账号问题** | 未登录游客态的能力限制，**不是**游戏代码错误；本项目未把它写成游戏缺陷 |

---

## 12. 30 项测试要求逐条对照

| # | 要求 | 结果 | 证据 |
|---|---|---|---|
| 1 | 在线离开前先结算再建离线基线 | ✅ | `offline.test.mjs` T1；E2E E7/E9 |
| 2 | Lv1 离线 1 秒毫币结果正确 | ✅ 166 毫币，carry 40000 | T2 |
| 3 | Lv1 离线 60 秒 = 10 金币 | ✅ 10000 毫币 | T3；E2E E11 |
| 4 | Lv1 离线 1 小时 = 600 金币 | ✅ 600000 毫币 | T4；E2E E20 |
| 5 | 离线 8 小时不截断 | ✅ 4800000 毫币 | T5；E2E E21 |
| 6 | 离线 24 小时不截断 | ✅ 14400000 毫币 | T6；T29 |
| 7 | 离线 7 天不截断 | ✅ 100800000 毫币 | T7；T29 |
| 8 | 毫秒不能直接除以 60 | ✅ 源码级断言禁止 `Ms / 60` | T8、T8b |
| 9 | 重复 onShow 第二次收益为 0 | ✅ | T9；E2E E15；微信 V13 |
| 10 | 重复刷新不能重复发放 | ✅ | T10；E2E E22 |
| 11 | F 关闭面板不能重复发放 | ✅ | T11；E2E E18 |
| 12 | 离线收益保留 carryNumerator | ✅ | T12；E2E E11/E20/E21；微信 V7 |
| 13 | 时间倒退不产生负收益 | ✅ `clock-went-backwards`，时间戳不倒退 | T13；核心实测 |
| 14 | v1 存档迁移不发放伪造离线收益 | ✅ | T23；E2E E26；`save.test.mjs` |
| 15 | 损坏存档安全回退 | ✅ `bad-json` | T15；E2E E24 |
| 16 | 不支持的 schemaVersion 安全回退 | ✅ | T16；`verify-browser.mjs` D6 |
| 17 | 存储写入失败时内存状态不被错误提交 | ✅ | T17、T17b；E2E E28/E29b |
| 18 | 离线不增加 lifetimeReputation | ✅ | T18；E2E E12；微信 V11 |
| 19 | 离线不增加 spendableReputation | ✅ | T19；E2E E12；微信 V11 |
| 20 | 离线不增加 visitCount | ✅ | T20；E2E E12；微信 V11 |
| 21 | 居民寻访回归 | ✅ | `visit.test.mjs` 12/12；E2E E19；`verify-browser.mjs` B7/B10/B12 |
| 22 | 市政厅升级回归 | ✅ | `upgrade.test.mjs` 22/22；`verify-browser.mjs` D3 |
| 23 | 时间收益回归 | ✅ | `economy.test.mjs` 9/9；`verify-browser.mjs` B1–B3 |
| 24 | 本地存档回归 | ✅ | `save.test.mjs` 32/32；`verify-browser.mjs` D1–D11 |
| 25 | 离线面板外点击不会误触其他功能 | ✅ | T25、T25b；E2E E17（picks/upgrade/visits 全部不变） |
| 26 | 真实 3D 射线和相机旋转回归 | ✅ | T26；`verify-browser.mjs` B11/B12 |
| 27 | 浏览器和微信使用相同核心结果 | ✅ | T27、T27b；微信 V2/V6 与浏览器 E14/E20/E21 同一指纹同一公式 |
| 28 | 至少一次真实墙钟 >120 秒测试 | ✅ 浏览器 125.0 s + 微信 143.6 s | E2E F1–F5（本地与公网各一次）；微信 V5 |
| 29 | 1 小时/8 小时/24 小时/7 天确定性模拟 | ✅ | T29、T29b、T29c |
| 30 | 检查金币毫币、carryNumerator、等级、声望、寻访次数和时间戳 | ✅ | T30；E2E E12/E22/E23；微信 V11/V12 |

---

## 13. 公网远程验收步骤（12 步，可直接照着点）

1. 打开 <https://mayor3d.hynixing.cn/step7/>（免内网 / 免 VPN / 免 SSH / 免登录）。
2. 记录当前金币与结算基线：页面上的「当前金币」「最近结算时间」「当前离线状态」三行。
3. 地址后加 `?debug=1`，点 **「模拟进入后台」** → 状态行变「离线中」；点 **「模拟经过 1 分钟」** → 金币**不变**（只推进时间）。
4. 点 **「模拟返回前台」** → 离线面板弹出，确认**本次获得 10 金币**、离线时长约 1 分。
5. **不关面板**先点一次面板外的任意位置（确认被吞掉），再点 **F** 关闭面板，然后**再点一次「模拟返回前台」** →
   确认第二次**收益为 0**（发放次数不增加）。
6. 重新点「模拟进入后台」→「模拟经过 1 分钟」→「模拟返回前台」弹出面板，
   点 **F** → 确认**只关闭了面板**：金币、发放次数都没有再变。
7. 连续**刷新页面两次** → 确认 `offline_pending` 复位、没有把之前的离线窗口重复发放
   （每次刷新只可能结算「刷新空档」那几百毫秒）。
8. 点 **「模拟经过 8 小时」** 后再「模拟返回前台」→ 确认**收益完整**：Lv1 为 4800 金币，没有被截断。
9. 点 **「写入损坏 JSON」** → 页面自动刷新 → 确认安全回退成新游戏（金币 0、Lv1），不崩溃、无补偿。
10. 点 **「写入旧 schemaVersion」** → 页面自动刷新 → 确认迁移成功：等级/金币/毫币余数/声望/寻访次数**一个不少**，
    且**没有发放任何离线金币**。
11. 点 **「清空本地存档」** → 页面自动刷新 → 确认回到新游戏初始化（金币 0、Lv1、声望 0、寻访 0）。
12. 分别打开 <https://mayor3d.hynixing.cn/> 与 <https://mayor3d.hynixing.cn/step6/> →
    确认旧版 3D 预览与第六步仍然正常（sha256 与部署前一致）。

> 自动化版本：`node tools/accept-remote-step7.mjs`（结果 **12/12 PASS**，`evidence/accept-remote-step7.log`）

---

## 14. 交付清单

| 交付物 | 路径 | 说明 |
|---|---|---|
| 第七步报告 | `docs/报告-0.1第七步-离线收益.md` | 本文件 |
| 源码包 | `wyszz-0.1-step7-source.zip` | README / 构建脚本 / src / tests / tools / win / public / docs |
| 证据包 | `wyszz-0.1-step7-evidence.zip` | 本报告 + 全部 `evidence/` |
| 公网部署清单与哈希 | `evidence/deploy-step7-hashes.txt` | 部署前后逐项 sha256 |
| 包哈希清单 | `evidence/packages-sha256.txt` | 两个 zip 的 sha256 与文件数 |
| 下载链接清单 | `evidence/delivery-links.txt` | `deliver-link` 登记结果 |

### 14.1 核心新增 / 修改文件

| 文件 | 变更 |
|---|---|
| `src/core/offline.ts` | **新增**（第七步唯一实现，纯核心，无平台依赖） |
| `src/core/save.ts` | 重写为 v2，新增离线字段、v1→v2 迁移 |
| `src/browser/main.ts` | 虚拟时钟、`visibilitychange`/`pagehide`/`pageshow`、离线面板、9 个 debug 控件、`offlinePreview()` |
| `src/game/main.ts` | `wx.onHide`/`wx.onShow`、离线 HUD 面板、触摸吞掉、迁移落盘 |
| `src/platform/runtime.ts` | `wx.onShow` 先跑 hooks 再重启循环 |
| `public/index.html` | 离线状态行、离线面板、`?debug=1` 控件盒 |
| `tests/offline.test.mjs` | **新增** 48 项 |
| `tests/save.test.mjs` | 更新为 v2 期望 |
| `tools/verify-browser-step7.mjs` | **新增** 40 项（含真实墙钟 125 s） |
| `tools/accept-remote-step7.mjs` | **新增** 12 步公网验收 |
| `tools/analyze-vm-log-step7.mjs` | **新增** 17 项微信模拟器日志分析 |
| `tools/deploy-public-step7.mjs` | **新增** 部署 + 部署前后哈希复核 |
| `tools/package-step7.mjs` | **新增** 打包 |

---

## 15. 回滚方法

```bash
# 回滚公网第七步（只删这一个子目录；/ 与 /step6/ 全程未被触碰，无需回滚）
rm -rf /vol1/ai/projects/wyszz-new/3d-spike-ds/dist/step7
```

回滚后 <https://mayor3d.hynixing.cn/step7/> 会回到 404，`/` 与 `/step6/` 不受影响。
代码侧回滚：`src/core/offline.ts` 是纯新增，删掉它并还原 `save.ts` / 两个入口即可（不影响第三～六步）。

---

## 16. 未做 / 未验证事项（如实声明）

1. **微信真机未验证** —— 原因：**AppID 审核中**，无法真机预览/发布。
   本文所有微信侧结论都来自**游客模式模拟器**，**没有**把「模拟器通过」写成「真机通过」。
2. **微信正式发布未验证** —— 未提交审核、未发布、未生成任何二维码。
3. **第八步未开始** —— 本步完成后即停止，没有触碰第八步的任何内容。
4. **未使用高级模型** —— 全部工作由当前会话模型完成，没有调用额外的高级/大模型服务。
5. **合成鼠标注入在验证后半段失效** —— 已按任务书预设处置；未扩大权限、未用通配脚本杀进程、
   未伪造任何交互结果。受影响的只是「用鼠标点模拟器工具栏」这一种操作方式。
6. **离线面板的最小显示门槛** —— 收益发放与写档**完全不受门槛影响**（离线 200 毫秒该给的也照给、照落盘），
   门槛（1000 毫秒）只决定「要不要弹一个挡输入的模态面板」。
   理由：刷新页面本身会产生一小段离线时间，若不加门槛，每次刷新都会被模态面板挡住。
   验收流程里的 1 分钟 / 8 小时都远大于门槛，面板照常显示。

---

## 17. 隔离合规声明

- 只写 `/vol1/ai/projects/wyszz-new/wechat-game-0.1-ds/`；
  公网部署按第六步已获用户同意的**纯新增**例外，只写 `3d-spike-ds/dist/step7/`。
- 记忆库 `/vol1/ai/vault/AI记忆库/` 与 Windows `C:\projects\wyszz-wx-spike\` 按既有授权写入。
- **未读取 / 未修改 / 未删除**：`little-town/`、`wyszz-new/3d-spike-ds/` 源码（只读其 `dist/` 做部署与哈希复核）、
  `wyszz-new/wechat-spike-ds/`、`wyszz-new/app/`、MIMO 对照目录。
- **未改动** DNS / Cloudflare / 隧道 / 反向代理 / 防火墙 / systemd / NAS 权限 / 共享 / 路由器 / 现有公网 3D 服务配置。
- 未覆盖公网 `/` 与 `/step6/`（已用 sha256 逐字节证明）。
