# S-14 总报告 ·《叫我大岛主》0.2.3-pre 微信正式包「真机卡启动页」根因定位与修复

> 任务代号 S-14；角色：诊断工程师。
> 工作副本：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm023diag/`（`hm023` 逐字节副本）。
> 结论时间：2026-10-18（PDT）。

---

## 一、根因（一句话）

**0.2.0 起构建产物 `game.js` 里含 ES2020 的 BigInt 字面量（`10n`、`9007199254740991n` 等），机主手机的微信小游戏 JS 引擎不支持 BigInt，于是整个 `game.js` 在「解析期」就抛 SyntaxError、一行都不执行 —— 画面永远停在启动页，而且连我们自己埋的错误钩子都没机会跑，所以零日志、零弹窗。0.1 一个 BigInt 都没有，所以同一台手机能跑。**

---

## 二、证据链（每轮一行）

| 轮次 | 证据 | 结论 |
|---|---|---|
| 0 | 机主确认「真机玩过，还有截图，那是**没有修复文字卡片错误**的版本」+ 20261017 真机截图（Lv.28 市政厅、声望 236、每分钟 +64、升级需 4,293 金币） | 这台手机**能跑我们的游戏**；真机跑通的是 0.1 线 |
| 1 | 诊断内部包（0.2.3-pre-diag，埋了 `wx.onError`/`onUnhandledRejection` + try/catch 弹窗 + 首帧「DIAG OK」角标）真机 = **状态 A：三类痕迹一个都没有** | `game.js` 里的 JS **一行都没执行** ⇒ 解析期就挂了 |
| 2 | 0.2.0 正式包真机对照 = 「也打不开」 | 不是 0.2.3 新引入的回归，而是 0.2.0 起就有的共因 |
| 3 | esbuild 对**已发布产物**逐个复扫 `--target=es2017`：**0.1 = 0 条**「Big integer literals … may crash at run-time」警告；**0.2.0 / 0.2.1 / 0.2.2 / 0.2.3-pre = 各 6 条** | BigInt 是「能跑的 0.1」与「全挂的 0.2.x」之间**唯一**的 ES2017+ 语法差异 |
| 4 | 契约 docs/05 §5.5 要求任意精度整数，样例 `S07-O01` 钉死 `landMilli` 精确值 393965049262765（双精度会算成 …766）；`S07-C-hallL139/140` 钉死 `costMilli` = 16545756505731000 / 20185822936992000（> 2^53−1） | 修复**不能**退化成双精度，必须保住「任意精度」语义 |
| 5 | **排除竞争假设 H2-01（画布垫片）**：`docs/31-evidence/2026-10-14-真机探针实测-H2-01证实.md` 证实真机 canvas 无 `addEventListener`；而**逐字比对 0.1 包与 0.2.3 包的垫片本体完全一致**（`for(i of ["addEventListener","removeEventListener"]){…console.log("[wechat] cannot patch canvas."+i…)}`），且两包 `createCanvas`=1 / `webglcontextlost`=1 / `removeEventListener`=4 / `dispatchEvent`=3 计数全等 | H2-01 在 **0.1 与 0.2.x 两条线上都已修好** ⇒ 它不是「0.1 能跑 / 0.2.x 全挂」的差异源，**排除**；唯一剩下的差异就是 BigInt |
| 6 | 真机环境（`docs/31-evidence` 探针原文）：**HUAWEI-ALN-AL10 / HarmonyOS-Android 31 / 微信 8.0.78 / 基础库 3.17.4 [1656]**；真机 `typeof window`/`self` = `undefined`，`GameGlobal` 存在 | 该机型/基础库组合下 `game.js` 加载失败，与「解析期语法错误」一致 |

---

### 附：真机上「跑通过的那一份」到底是哪一份

记忆库/`docs/31-evidence` 记载：2026-10-14 真机跑通的是**热修包 J**（sha256 `4bd01a96f0cf35b23cdfd004f54f2850f7b3d15db285c59c39ea35c198b2d166`），
它是 **0.1 正式构建产物（`d9fa3861…`）前面加了一段「画布垫片 IIFE」**。热修包 J 的正文 = 0.1 的 `game.js`（**零 BigInt**）+ 一段纯 ES5 垫片（**零 BigInt**）。

⇒ **机主真机玩过的那一份产物，BigInt 出现次数 = 0**；而 0.2.0 起的每一份产物都是 6 条 BigInt 字面量警告。这与根因完全自洽。

---

## 三、是否改了代码：**改了（在我方工作副本里）**

**只改了 `/vol1/ai/projects/wyszz-new/frontend-rebuild-hm023diag/`，四个前端目录一个字节都没动。**

| # | 文件 | 改动 |
|---|---|---|
| 1 | `src/core/bigx.ts` | **新增**：base 2^16 limb 数组自实现的任意精度非负整数（+ − × ÷ mod 幂 比较 转换），纯 JS，全文不含 `BigInt` 标识符 |
| 2 | `src/core/ints.ts` | `MAX_SAFE_BIG` 改 number；新增 `mulDivFloor`（商余分解，超域自动回退 bigx） |
| 3 | `src/core/rates.ts` | 费用走 bigx 精确计算（明显超界直接饱和）；`landMilli`/`totalMilli` 走 `mulDivFloor`；`settle` 改「rate 拆 60000·qr+sr」的精确商余分解 |
| 4 | `src/core/actions.ts` `config.ts` `debug.ts` `queue.ts` `uistate.ts` `src/game/session.ts` | 共 22 处 `BigInt(...)` 运算等价改写为 number |
| 5 | `tools/build-wechat.mjs` | **新增构建期硬断言**：产物出现 `BigInt` 标识符即构建失败；诊断 banner 加引擎 BigInt 能力探针 |
| 6 | `tools/contract/static2.mjs` | 3 行驱动适配（核心已返回 number，测试侧用 Node 原生 BigInt 独立复算，**断言强度不降**） |

**0.1 冻结数字一个没改**：整数毫币、升级费 `ceil(20×1.22^(L−1)−1e-9)`、速率 `10×(1+0.2(L−1))/分`、寻访 +3 金币 +1 声望、离线一次性不封顶、存档命名空间 `wyszz-0.1-ds-save` schema v2。

**契约未动**：`contract-0.2-R3-FROZEN-v1.0.tar.gz` sha256 `535e4beac061d361…feb277`，只读解包到 `/tmp/s14/contract`。

---

## 四、复验结果（全部在冻结后的代码上重跑）

| 项 | 修复前基线 | 修复后 | 判定 |
|---|---|---|---|
| 全量回归 | 35/35 PASS / 0 失败 / 496.4 s | **35/35 PASS / 0 失败 / 496.8 s** | 逐项一致 ✓ |
| 契约样例 | 32 组 / **9751 case / 差异 0** | **32 组 / 9751 case / 差异 0** | 一致 ✓ |
| 属性测试 | 3000 序列 / **193500 步 / 违反 0 / 确定性差异 0** | **同左** | 一致 ✓ |
| 微信替身 | 38/38 | 38/38 | 一致 ✓ |
| 精确值复算 | `costLevel(20,139)`=16545756505731；`(20,140)`=20185822936992；`costMilli`=…31000/…92000；`L100`=7090114234；`L28`=4293（=机主截图上的数字） | **全部逐位相同** | 一致 ✓ |

### 产物扫描

| 包 | esbuild「BigInt 字面量」警告 | `BigInt` 标识符 |
|---|---|---|
| 0.1（机主真机玩过） | 0 | 0 |
| 0.2.0 / 0.2.1 / 0.2.2 / 0.2.3-pre | 6 / 6 / 6 / 6 | 32~34 |
| **修复版（本次）** | **0** | **0** |

正式包零诊断字样（DIAG OK / `__s14_errbuf` / 启动失败 / bigintSupport / 引擎bigint 全 0 命中）；内部包 banner 在位。

---

## 五、四包 sha256（`dist-交付件sha256.txt`）

| 包 | 文件 | 字节 | sha256 |
|---|---|---|---|
| 微信正式包 | `dist/wechat/game.js` | 712,171 | `aaad8adb0ebc8037ab9cd8deed0ba43c3acf73893f6fbee93d7d353440b119d6` |
| 微信内部包 | `dist/wechat-internal/game.js` | 745,558 | `2bfb5fd9f7578ce5dca3b92cf143c54927be21a4dd35c9c67212f5ad3c313ea7` |
| 网页正式包 | `dist/web/assets/main-1e334d5c22.js` | 708,047 | `1e334d5c227fa3ac9ecf42752b2e70c1f8b2288611a9313e1432b27f04cedb91` |
| 网页内部包 | `dist/web-internal/assets/main-8e7df3f667.js` | 739,141 | `8e7df3f667c6a919d7c1f8075bec77a8aed0d09f7cd8fcda56efde716c5fa564` |
| （共同） | `game.json` | 64 | `82526622d158db584fe0783eb469d01eaaa33a85360c28d83bf2b01cb031b8ec` |

> 版本号**故意保持 `0.2.3-pre` 不变**：`test/t-wechat-project-config.mjs`、`t-land.mjs`、`t-s12.mjs`、`wechat-s12.mjs` 共 4 个测试把版本号钉死，升版号就必须改测试文件；为了保住「验收 harness 与基线逐字节相同」这一更强证据，选择不动。若总监要求可见的版本区分，属后续显式改 harness 的动作。

---

## 六、原目录是否被改：**没有被改**

逐字节 sha256 全树比对：

| 目录 | 基线 | 差异 |
|---|---|---|
| `frontend-rebuild-hm023/` | `S-14/hm023开工sha256.txt`（788 条） | **0** |
| `frontend-rebuild-hm022/` | `S-12/hm022开工sha256.txt`（546 条） | **0** |
| `frontend-rebuild-hm02/` | `S-12/hm02开工sha256.txt`（401 条） | 5 条（全是**新增 .md/txt 文档**，mtime 00:47–09:45，均早于 S-14 开工 10:09） |
| `frontend-rebuild-hm/` | `S-06/hm基线sha256.txt`（280 条） | 3 条（`docs/` 下 2 改 1 增，mtime 09:56 / 10-17，均早于 S-14） |

**S-14 只写了两个地方**：`frontend-rebuild-hm023diag/`（工作副本）与 `frontend-rebuild-hm/tasks-out/S-14/`（报告与证据）。

---

## 七、真机验证状态：**未验证**

- 修复包已部署到 VM 工程 `C:\wyszz\wechat023fix`（appid 已换真实 `wx1c0ae0869ea1424f`，MANIFEST 同步），开发者工具 `preview` **编译通过**、已出预览码。
- 预览码存档：`tasks-out/S-14/证据/修复包-0.2.3-pre-BigInt修复-预览码.png`（48,483 B，sha256 `4c9fbc5dc0ff3f0b…`）。
- **预览码有效期约 25 分钟**，机主起床后需重出（重出命令已备好，见 §九）。
- **在机主回传「能进游戏」之前，本报告不声称问题已解决。真机结论一律以机主实测为准。**

---

## 八、待总监裁决（5 条）

1. **是否接受「去掉原生 BigInt、改为自实现任意精度整数」这一修复方向。** 备选方案（未采用）：① 降级为双精度 —— 会让契约 `S07-O01` 差 1、`S07-C-hallL139/140` 失效，**不可接受**；② 保留 BigInt 但在产物里做语法降级 —— JS 无法重载运算符，**不可行**。
2. **版本号是否要从 `0.2.3-pre` 升到 `0.2.3-pre2`。** 本次**故意没升**，以保住 4 个测试文件不被改、验收 harness 与基线逐字节相同。若要求可见版本区分，需显式授权改 harness。
3. **`tools/contract/static2.mjs` 的 3 行适配是否认可。** 核心返回值由 bigint 变 number，驱动侧改用 Node 原生 BigInt 独立复算精确值；`differs`（双精度差 1）与 `productCoreTimesNumExceeds2p53` 两条断言的**强度不变**。
4. **`costLevel` 对超过 2^53−1 的费用饱和为 `MAX_SAFE_BIG` 是否认可。** 依据契约 docs/05 O4：调用方只做「×1000 > 2^53−1 ⇒ max-level」判定与减法，饱和不改变判定；实测 `costLevel(20,10000)` 返回 `9007199254740991`。若契约要求超大费用必须返回精确值，需新增契约样例后再改。
5. **是否需要把修复包上传为「体验版」。** 预览码只有 ~25 分钟寿命，机主起床后需重出；若希望长期可扫，需要把包 `cli upload` 成体验版并在 MP 后台「选为体验版」，这会动到机主微信账号侧，**未经授权不做**。

---

## 九、交付物与操作指引

| 交付物 | 路径 |
|---|---|
| 本总报告 | `tasks-out/S-14/总报告.md` |
| 分步报告 | `tasks-out/S-14/report-1.md` … `report-5.md` |
| 修复后全量回归日志 | `tasks-out/S-14/修复后回归.log`（35/35 PASS / 496.8 s） |
| 修复前基线回归日志 | `tasks-out/S-14/基线回归.log`（35/35 PASS / 496.4 s） |
| 四包 sha256 清单 | `tasks-out/S-14/dist-交付件sha256.txt` |
| 证据目录 | `tasks-out/S-14/证据/`（含各轮二维码、机主截图、OCR 原文、esbuild 扫描原文） |
| 修复包（微信内部包，可直接扫） | `hm023diag/dist/wechat-internal/`（4 文件） |
| 修复包（微信正式包） | `hm023diag/dist/wechat/`（4 文件） |
| 进度表 | `tasks-out/S-14/进度.md` |

**机主起床后的重出码流程**（约 3 分钟）：

```bash
# 1) 若 dist 已被改动，先重建内部包
cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm023diag && npm run build:internal
# 2) 重新打包并放到 NAS 服务目录（8096 常驻）
cd dist/wechat-internal && zip -q /tmp/s14/serve/wyszz-fix.zip game.js game.json project.config.json MANIFEST.json
# 3) VM 侧下载 → 换 appid → 重启 IDE → open → preview（脚本已备好）
/vol1/ai/windows-mcp/.venv/bin/python /vol1/ai/_scripts/vmctl.py PowerShell '@/tmp/s14/deploy_fix.ps1' --timeout 285
# 4) 回传二维码并出下载链接
/vol1/ai/windows-mcp/.venv/bin/python /vol1/ai/_scripts/vmctl.py PowerShell '@/tmp/s14/upfix.ps1' --timeout 55
cp /tmp/vm-upload/qr-fix.png <存档路径>
```
