# 《我要当岛主》0.1 第三步：时间收益逻辑 · 开发与验证报告

> **本目录是 DSH 正式开发目录。MIMO、旧项目和实验目录不得读取、修改或删除本目录；本目录也不得读取、修改或删除 MIMO 与实验目录。**

| 项 | 值 |
| --- | --- |
| 正式开发目录 | `/vol1/ai/projects/wyszz-new/wechat-game-0.1-ds/` |
| 本步范围 | **只做 0.1 第三步：时间收益逻辑**（未进入第四步） |
| 基线来源 | 已验证的微信小游戏迁移**阶段 C**（`wechat-spike-ds/wechat-3d`，只读复制） |
| 运行环境 | 微信开发者工具 Stable 2.02.2608080（游客模式），基础库 3.17.2，iPhone 12/13 (Pro) 390×844 dpr3 |
| 公网预览 | `https://mayor3d.hynixing.cn/` → **HTTP 200**（未改动 DNS / Cloudflare / 现有预览服务） |
| 结论 | 第三步**已实现并通过自动验证**；真机与正式发布**未验证**（游客模式限制） |

---

## 1. 目录隔离

- 本报告与 `README.md` 开头均已写明强隔离声明。
- 本次开发**只写入** `/vol1/ai/projects/wyszz-new/wechat-game-0.1-ds/`（以及微信虚拟机内的项目槽，见 §7）。
- **只读参考**：`wechat-spike-ds/`（基线来源）、`3d-spike-ds/`。
- **未读取、未修改、未删除**：MIMO 对照目录、`3d-spike/`、`app/`、`/vol1/ai/projects/little-town/`。
- 未改动 DNS、Cloudflare、systemd、NAS 权限、共享、路由、防火墙与公网预览服务。

## 2. 本步实现内容

### 2.1 唯一核心：`src/core/economy.ts`

纯模块（无 DOM / 无 `wx` / 无定时器 / 自身不读时钟，`now` 由调用方传入），**浏览器版本与微信小游戏版本都从这里 import**。

- 初始等级 `L = 1`，初始金币 `G = 0`，`R(L) = 10 × (1 + 0.20 × (L-1))` 金币/分钟。
- `now_ms`、`last_settle_ts_ms`、`delta_seconds = (now_ms - last_settle_ts_ms) / 1000`、`delta_minutes = delta_seconds / 60`（**毫秒不直接除以 60**）。
- **先算收益，再把 `last_settle_ts_ms` 更新为 `now_ms`**。
- `delta_ms <= 0`（同一时间戳或时钟倒退）：收益 0、余额不变、`last_settle_ts_ms` 不倒退、不为负。

### 2.2 小数收益的处理方式（明确说明）

余额用**整数毫币**记账（1 金币 = 1000 毫币），全程整数运算，无浮点累加：

```
wholeMinutes = floor(delta_ms / 60000)
remMs        = delta_ms - wholeMinutes * 60000          // 0..59999
numerator    = carryNumerator + remMs * rateMilliPerMinute
gainMilli    = wholeMinutes * rateMilliPerMinute + floor(numerator / 60000)
carryNumerator = numerator % 60000                       // 0..59999
coinsMilli  += gainMilli
显示金币数    = floor(coinsMilli / 1000)
```

- 不足 1 毫币的收益留在 `carryNumerator`，**不丢弃**；不足 1 枚金币的小数部分留在余额里，**不四舍五入、不提前进位**。
- 例：`1000ms` → `floor(1000×10000/60000) = 166` 毫币（= 0.1667 金币，显示 0 金币）；`59999ms` → 9999 毫币（不是 10000）。

### 2.3 两个入口

| 入口 | 文件 | 说明 |
| --- | --- | --- |
| 浏览器版本 | `src/browser/main.ts` + `public/index.html` | DOM 页面，显示当前金币 / 产出速率 / 最近结算时间，可点「结算」；每秒按真实时间差自动结算一次 |
| 微信小游戏版本 | `src/game/main.ts` | 无 DOM。保留阶段 C 的浮空岛 + 拖拽旋转 + 真实 Raycaster 拾取，HUD 增加金币 / 速率 / 最近结算 / 上次收益，画布底部增加可点的「结算」按钮（热区 `(123,721)-(267,819)`，逻辑屏 390×844） |

两个入口都**没有**任何结算公式；所有收益都来自共用核心（测试 7 断言两个构建产物内嵌同一个核心标识）。

## 3. 规则符合性对照

| 规则 | 实现位置 | 验证 |
| --- | --- | --- |
| 当前时间读取、`now_ms`、`last_settle_ts_ms` | `economy.ts` `readNowMs` / `EconomyState` | 测试 1–4、6 |
| `delta_seconds = (now-last)/1000`；`delta_minutes = delta_seconds/60` | `settle()` 内 `deltaMs/1000/60` | 测试 9（结构）+ 测试 1（数值） |
| 毫秒时间戳不得直接除以 60 | `MS_PER_MINUTE = 60000`，无 `/60` 毫秒换算 | 测试 9 |
| 结算后再更新 `last_settle_ts_ms` | `settle()` 中 `next.lastSettleTsMs = now` 位于收益计算之后 | 测试 2（`lastSettleTsMs === 60000`） |
| 同一时间区间不得重复结算 | `delta_ms <= 0` → 0 收益、状态原样返回 | 测试 3、测试 8 |
| 重复刷新/重复点击不制造额外金币 | 刷新=以当前时刻新建初始状态；重复点击=同一时间戳 0 收益 | 测试 6、浏览器 B3/B4、模拟器重启 |
| 时间戳倒退不产生负金币 | `deltaMsRaw <= 0` 分支，时间戳不倒退 | 测试 4 |
| 整数余额 + 小数收益处理明确 | `coinsMilli` / `carryNumerator` 整数运算 | 测试 5（含精确不变式） |
| 不得写成固定帧数累加 | 自动结算用 `Date.now()` 差值触发（`nextSettleMs`），与帧率无关 | 模拟器 C2/C7（103s 与 271s 两段均精确等于 10 金币/分钟） |
| 不得实现自动升级/批量升级/MAX 升级 | 未实现；`level` 固定 1 | 源码无升级代码 |
| 不得提前实现第 4～8 步 | 未实现寻访/扣费/离线收益/存档/广告/后端/排行榜 | 源码无 `localStorage`/`wx.setStorage`/网络调用 |

## 4. 验证结果

### 4.1 TypeScript 类型检查

```
npx tsc --noEmit   →  exit 0，无输出（strict 模式）
```

### 4.2 生产构建

```
node build.mjs core browser game
core:    economy.js=4106
browser: app.js=3180
game:    bundle.js=564071  adapter.js=9182  total=573253
```

### 4.3 核心逻辑自动测试：**9/9 通过**

```
node --test tests/economy.test.mjs
✔ 1) 1000 毫秒只产生 1/60 分钟的收益
✔ 2) 60 秒按 Lv1 产生 10 金币
✔ 3) 连续两次结算同一时间戳，第二次收益为 0
✔ 4) 时间戳倒退时不能产生负金币
✔ 5) 计算过程使用整数余额，小数收益不丢弃、不提前进位
✔ 6) 页面刷新后不伪造新的收益
✔ 7) 浏览器版本与微信小游戏版本使用同一套核心结算逻辑
✔ 8) 同一时间区间不得重复结算：分步与一次结算结果完全一致
✔ 9) 源码结构：毫秒时间戳不得直接除以 60
tests 9 | pass 9 | fail 0
```

**任务书 7 项必测全部覆盖**（1–7），另加 2 项加强项（8：分步 600 次与一次结算毫币完全一致；9：源码结构）。

### 4.4 浏览器版本验证：**11/11 通过**

无头 Chromium（CDP）驱动真实页面，`node tools/verify-browser.mjs 62`：

```
PASS | B1 启动金币为 0                              | coins=0
PASS | B1 产出速率为 10 金币/分钟（Lv1）              | rate=10 金币/分钟（Lv1）
PASS | B1 最近结算时间为合法时刻                      | lastSettle=17:53:03
PASS | B2 62 秒内金币按 10/分钟增长                   | delta=10 expected≈10.33 (elapsed=1.0335min)
PASS | B2 增长量合理（不是 0 也不是暴增）              | delta=10
PASS | B3 同毫秒双点只计 1 次结算                      | count 63 -> 64
PASS | B3 第二次结算收益为 0                           | lastGain=0 金币（+0 毫币）
PASS | B3 日志记录了被拒结算                           | log 含 duplicate-timestamp
PASS | B4 刷新后金币回到 0（不伪造刷新前收益）          | before=10 afterReload=0
PASS | B5 页面日志含共用核心标识                       | CORE_ID 出现
PASS | B5 核心指纹自洽                                 | 指纹行
=== browser verification: 11/11 passed ===
```

B3 中「同毫秒双点」第二次结算被核心以 `duplicate-timestamp` 拒绝、且**不计入结算次数**，正是「同一时间区间不得重复结算」的端到端证据。

### 4.5 微信开发者工具模拟器验证：**11/11 通过**

部署路径：`dist/game/*` → NAS 暂存 `wyszz01/` → 虚拟机项目槽 `C:\projects\wyszz-wx-spike\minigame-env-check`；随后重启开发者工具（带软件 WebGL 参数），工具在打开项目时重新编译，**全程不需要交互注入**。

启动证据（`stage-err.log`，UTF-8）：

```
boot 2026-10-09T10:02:19.492Z
ADAPTER_OK
BUNDLE_OK
```

游戏侧日志（`run.log`）关键行：

```
core wyszz-core-economy-v1 fingerprint=wyszz-core-economy-v1:r1=10000:m1=10000
econ boot last_settle_ts_ms=1791540139799 coins=0 rate=10/min autoSettleMs=1000
settle button rect=(123,721)-(267,819) logical=390x844
结算 +0 金币 | delta=1001ms=0.016683min | rate=10/min | 余额=0 金币+166/1000 | last_settle_ts_ms=1791540140800 | auto
tap#1 at=(202,343) travel=0 held=46ms -> raycast
pick#1 tap=(202,343) ndc=(0.034,0.188) HIT 市政厅 dist=50.79 point=(-1.05,1.08,-1.90)
tap#2 at=(202,772) -> 结算按钮
结算 +0 金币 | delta=177ms=0.002950min | rate=10/min | 余额=43 金币+955/1000 | last_settle_ts_ms=1791540403531 | tap
```

`node tools/analyze-vm-log.mjs`（把设备日志逐条喂回**共用核心**重放比对）：

```
PASS | C1  结算次数 > 0                              | 268 条（auto=267 tap=1）
PASS | C2  自动结算无需任何输入即可推进                | 267 次自动结算，delta 区间 [848,1095]ms
PASS | C2b 点击「结算」按钮的手动结算生效且不重复计时  | 1 次手动结算，delta=177ms（< 1000ms）
PASS | C3  每次 delta 都 > 0（无重复结算）            | min delta=177ms
PASS | C4  last_settle_ts_ms 严格递增（不倒退）        | first=1791540140800 last=1791540411518
PASS | C5  速率始终为 Lv1 的 10 金币/分钟              | rates=10
PASS | C6  设备余额与共用核心重放完全一致              | 268 条全部一致
PASS | C7  整段收益 = 10 金币/分钟                     | 271.719s=4.528650min 期望=45286.50 实际=45286 毫币 误差=0.5 毫币
PASS | C8  delta_minutes 由 ms→s→min 换算              | 1001ms -> 0.016683min
PASS | C9  适配器与 bundle 均加载成功                  | ADAPTER_OK + BUNDLE_OK
PASS | C10 无游戏代码错误                              | 无 BOOT_FAILED/ADAPTER_FAIL/BUNDLE_FAIL/WX_ONERROR/UNHANDLED
=== VM log analysis: 11/11 passed ===
```

要点：

- **C6 是最强证据**：设备打印的每一次整数余额，都与共用核心用同一批时间戳重放出来的结果**逐条完全一致**（268/268）。这说明小游戏端没有自己的第二套算法。
- **C7**：4 分半钟的真实运行，收益误差仅 0.5 毫币（纯属 6 位小数打印与整数取整），速率精确等于 10 金币/分钟。
- **手动结算**：点击「结算」按钮触发的结算只结算了距上次结算的 177ms 真实增量，**没有**重复结算或额外发币；该次点击**没有**触发射线拾取。
- **阶段 C 基线保持**：`tap#1` 仍走真实 3D 射线拾取并命中 `市政厅`。
- **重启不伪造收益**：经济状态在 `2026-10-09T10:02:19.799Z` 以 `coins=0` 启动，首次结算只按之后的 1001ms 增量发币，未把启动前的时间算成收益。

### 4.6 错误分类（游戏代码 / 工具自身 / 游客模式）

控制台徽标：**❌2 ⚠️1**（截图 `evidence/screenshots/03-step3-final_1.png`、`07-console-errors_1.png`），与阶段 A 已验证基线**完全一致**。

| 类别 | 条数 | 依据 |
| --- | --- | --- |
| **游戏代码运行时错误** | **0** | ① `game.js` 已挂 `wx.onError` + `wx.onUnhandledRejection`，`stage-err.log` 只有 `boot / ADAPTER_OK / BUNDLE_OK`，无任何失败标记；② 开发者工具「问题」页显示**「目前尚未在工作区检测到问题。」**；③ 徽标数未增加 |
| 微信开发者工具自身错误 | 1 | HarmonyOS 相关堆栈，栈底 `getDeviceOrientation`（`WAGame.js`），属工具/基础库侧（阶段 A 已三分类确认） |
| 游客模式授权错误 | 1 | `SystemError (appServiceSDKScriptError) {-80002 webapi_getwxaasyncsecinfo:fail}`，游客模式下的授权/密钥接口失败 |
| 基础库能力提示（警告级） | 1 | 基础库能力提示，非错误 |

**游客模式错误不记为游戏代码错误**；同时也不宣称「控制台无错误」——错误 2 条 + 警告 1 条如实记录。
说明：本次运行中控制台缓冲区在读取时已滚过启动时刻的条目，因此**本次未逐字重读这 2 条错误的文本**；结论由「徽标数一致 + 自建错误钩子干净 + 问题页干净」三条互证得出。

### 4.7 公网预览

```
curl https://mayor3d.hynixing.cn/  →  HTTP 200
```

未改动 DNS、Cloudflare、预览服务与实验目录。

## 5. 修改文件清单

### 5.1 新建（本步产出）

| 文件 | 说明 |
| --- | --- |
| `src/core/economy.ts` | **唯一**时间收益结算核心（纯模块） |
| `src/browser/main.ts` | 浏览器版本入口（DOM，import 核心） |
| `public/index.html` | 浏览器页面外壳（金币/速率/最近结算/结算按钮） |
| `tests/economy.test.mjs` | 自动测试 9 项（覆盖任务书 7 项必测） |
| `build.mjs` | 三个构建目标 core / browser / game |
| `package.json` | 脚本与依赖（无新增依赖） |
| `README.md` | 目录说明 + 强隔离声明 |
| `tools/serve.mjs` | 本地静态服务（仅验证用，127.0.0.1） |
| `tools/verify-browser.mjs` | 无头 Chromium 自动验证（11 项） |
| `tools/analyze-vm-log.mjs` | 设备日志回放比对（11 项） |
| `tools/wx.py` | Windows-MCP 助手（从验证目录复制） |
| `win/deploy_into_open.ps1` | 部署构建产物到模拟器项目槽 |
| `win/read_gamelog.ps1` | 读取小游戏沙箱日志（UTF-8） |
| `win/launch_devtools_gpu.ps1` / `win/restart_devtools_gpu.ps1` | 带软件 WebGL 参数启动/重启开发者工具（按安装目录精确匹配进程） |
| `docs/报告-0.1第三步-时间收益.md` | 本报告 |
| `evidence/**` | 验证证据（日志、分析结果、10 张截图） |

### 5.2 修改（在复制来的阶段 C 基线上）

| 文件 | 改动 |
| --- | --- |
| `src/game/main.ts` | ① 修正 import 路径 `./world` → `../scene/world`；② 引入共用核心；③ 经济状态 + `settleNow()`；④ 渲染循环内按真实时间差自动结算；⑤ HUD 增加金币/速率/最近结算/上次收益（离屏画布 512×256 → 512×320）；⑥ 画布底部「结算」按钮 + 点击热区；⑦ 点按钮不触发射线拾取 |
| `src/shared/hud.ts` | **未修改**（仅构造参数由调用方调整） |
| `src/platform/*`、`src/scene/world.ts` | **未修改**（阶段 C 基线原样） |
| `templates/project.config.json` | **未修改**（模板占位符由 build.mjs 替换） |

`src/game/main.ts` 的 MD5：`b87c54dcaae0b2211a52464b53a73f1e`（构建后复核未变，无并发覆盖）。

## 6. 未验证项（如实列出）

1. **真机（iOS / Android 微信）未验证** —— 原因是**游客模式限制**（无合法 AppID），本报告不主张任何真机通过。
2. **微信正式发布 / 上传 / 提审未验证**，未生成任何二维码。
3. **本步明确不实现的功能未验证**：寻访、升级扣费、离线收益、存档、广告、后端、排行榜、自动/批量/MAX 升级。
4. **模拟器上的「同一毫秒重复点击」未直接复现**：注入两次点击无法保证落在同一毫秒。该性质已由核心测试 3 与浏览器 B3 端到端覆盖；模拟器侧验证的是「手动结算只结算真实增量（177ms）」。
5. **模拟器上的「系统时钟倒退」未注入验证**：无篡改系统时间的合规手段。该性质由核心测试 4 覆盖。
6. **控制台 2 条错误的文本本次未逐字重读**（缓冲区已滚过），结论由徽标一致 + 自建错误钩子干净 + 问题页干净三条互证。
7. 浏览器验证使用无头 Chromium（SwiftShader 软件渲染路径未启用，DOM 页面不需要 WebGL）；小游戏侧使用软件 WebGL（`--enable-unsafe-swiftshader`），**非真实 GPU 环境**。

## 7. 回滚方法

| 回滚目标 | 操作 |
| --- | --- |
| **整步回滚（推荐，最干净）** | 删除整个 `/vol1/ai/projects/wyszz-new/wechat-game-0.1-ds/`。本目录为新建目录，不被其它工程引用；公网预览与实验目录完全未受影响，无需额外操作。 |
| 只回滚模拟器项目槽 | 部署脚本在覆盖前已把槽内原文件备份到 `C:\projects\wyszz-wx-spike\slot-displaced-stageA\wyszz01.{game.js,bundle.js,adapter.js,game.json}`；把这 4 个文件复制回 `C:\projects\wyszz-wx-spike\minigame-env-check\` 并重启开发者工具即可。 |
| 只回滚开发者工具启动参数 | 不带 `--enable-unsafe-swiftshader --ignore-gpu-blocklist --enable-gpu-rasterization --disable-gpu-sandbox` 重新启动 `微信开发者工具.exe`（软件 WebGL 会退回不可用，模拟器无法渲染 3D）。 |
| 只回滚小游戏端改动 | 用阶段 C 基线覆盖 `src/game/main.ts`（只读来源：`wechat-spike-ds/wechat-3d/src/island/main.ts`），然后 `node build.mjs game` 重新部署。 |
| 只回滚浏览器端改动 | 删除 `src/browser/`、`public/` 与 `build.mjs` 中的 `browser` 目标；小游戏端不受影响。 |

本目录不是 git 仓库，因此无 `git revert` 路径；回滚以上表为准。

## 8. 证据文件

| 证据 | 路径 |
| --- | --- |
| 浏览器自动验证输出 | `evidence/browser-verify.log` |
| 模拟器沙箱日志（原始读回） | `evidence/vm-runlog.txt` |
| 模拟器沙箱日志（UTF-8 正确解码） | `evidence/vm-runlog-utf8.txt` |
| 模拟器日志回放分析 | `evidence/vm-log-analysis.txt` |
| 模拟器截图（运行中 / HUD / 结算按钮） | `evidence/screenshots/01..03_*.png` |
| 开发者工具「问题」页（无问题） | `evidence/screenshots/04..06_*.png` |
| 控制台（Errors: 2, Warnings: 1 + 结算日志） | `evidence/screenshots/07..10_*.png` |
| 核心自动测试 | `tests/economy.test.mjs`（`npm test`） |

---

### 一句话结论

0.1 第三步「时间收益逻辑」已在**同一套共用核心**上完成实现：浏览器版本 11/11、微信小游戏模拟器 11/11、核心自动测试 9/9 全部通过，设备端 268 次结算的每一次整数余额都与核心重放**逐条一致**，误差 0.5 毫币；游戏代码错误 0 条，游客模式与工具自身错误如实分类记录；真机与正式发布因游客模式限制**未验证**。本步到此为止，未进入第四步。
