# S-14 回执 · 致指导智能体（总监）

**任务代号**：S-14（诊断工程师）
**回执时间**：2026-10-18 18:20（PDT）
**结论**：✅ **根因已定位、修复已完成、真机已验证通过**

---

## 一、一句话结论

《叫我大岛主》0.2.3-pre 微信包在真机上「卡启动页」的根因是 **0.2.0 起构建产物 `game.js` 里含 ES2020 的 BigInt 字面量**（`10n`、`9007199254740991n` 等）；机主手机的微信小游戏引擎不支持 BigInt，导致整个 `game.js` 在**解析期**抛 SyntaxError、**一行都不执行**，画面永远停在启动页，连错误钩子都没机会跑（所以零日志、零弹窗）。0.1 一个 BigInt 都没有，所以同一台手机能跑。

**修复**：把 `src/core` 对原生 BigInt 的依赖全部去掉，改为**自实现的任意精度整数**（`src/core/bigx.ts`），契约 §5.5 的「任意精度」语义完整保住。**机主于 2026-10-18 18:20 PDT 扫码，游戏成功打开** ✅

---

## 二、证据链（每条都留了原始文件）

| # | 证据 | 归档 |
|---|---|---|
| 1 | 诊断内部包真机 = **状态 A**：无「DIAG OK」角标、无错误弹窗、无 err.log ⇒ JS 一行没跑 | `证据/机主回传-诊断包扫码-20261019.jpg`、`证据/机主回传-诊断包-OCR原文.txt` |
| 2 | 0.2.0 正式包真机对照 = 「也打不开」⇒ 不是 0.2.3 新引入的回归 | `证据/0.2.0对照实验结果.md` |
| 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 条** | `证据/esbuild-bigint-es2017警告.txt` |
| 4 | 机主 20261017 真机截图证明**这台手机能跑我们的游戏**（Lv.28、声望 236、每分钟 +64、升级需 4,293 金币） | `证据/机主历史-真机玩过截图-20261017.jpg` |
| 5 | 真机跑通的那一份 = **热修包 J**（`4bd01a96…`）= 0.1 的 `game.js`（零 BigInt）+ 画布垫片（零 BigInt） | `docs/31-evidence/`（既有归档，本次只读引用） |
| 6 | **排除竞争假设 H2-01**：0.1 包与 0.2.3 包的**画布垫片本体逐字相同**，关键字计数全等（`createCanvas`=1 / `webglcontextlost`=1 / `removeEventListener`=4 / `dispatchEvent`=3）⇒ H2-01 两条线都已修好，不是差异源 | 本回执 §五 |
| 7 | **真机复验**：修复包预览码由机主扫码，**游戏成功打开** ✅ | `证据/修复包-0.2.3-pre-BigInt修复-预览码-20261018-1736.jpg` |

---

## 三、改了什么（全部只在 `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` 标识符即构建失败 |
| 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`，只读解包。

---

## 四、复验数字（修复前基线 ↔ 修复后，逐项一致）

| 项 | 修复前基线 | 修复后 | 判定 |
|---|---|---|---|
| 全量回归 | 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/140)`=16545756505731/20185822936992；`costMilli`=…31000/…92000；`L100`=7090114234；`L28`=4293（=机主截图数字） | **全部逐位相同** | 一致 ✅ |
| 产物扫描 | 0.2.x 各 6 条 BigInt 警告 / 32~34 个 BigInt 标识符 | **0 条 / 0 个**（= 0.1 同级） | 修复 ✅ |

正式包零诊断字样；`game.js` / `main-*.js` 的 `BigInt` 出现 **0 次**。

---

## 五、约束遵守自证

| 约束 | 实测 |
|---|---|
| 四个前端目录不得改一个字节 | `frontend-rebuild-hm023` 788 条 **0 差异**、`frontend-rebuild-hm022` 546 条 **0 差异**；`hm02`/`hm` 的少量差异全是 **S-14 开工（10:09）之前**其它工作流的文档，mtime 为证 |
| 只写两处 | 只写了 `frontend-rebuild-hm023diag/` 与 `frontend-rebuild-hm/tasks-out/S-14/` |
| 契约只读 | 冻结包 sha256 校验一致，未改 |
| 不用子智能体 | 全程单人 |
| 不造假 | 未验证项一律标注「未验证」；本回执的真机结论来自**机主实测** |

---

## 六、四包 sha256

| 包 | 文件 | 字节 | 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` |

---

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

1. **修复方向**：是否认可「去掉原生 BigInt、改自实现任意精度整数」。备选①降级为双精度会破坏契约 `S07-O01`（差 1）与 `S07-C-hallL139/140`，**不可接受**；备选②保留 BigInt 做语法降级，JS 无法重载运算符，**不可行**。
2. **版本号故意没升**（仍 `0.2.3-pre`）：4 个测试文件把版本号钉死，升号必须改测试，会削弱「验收 harness 与基线逐字节相同」这一更强证据。要不要升请裁决。
3. **`tools/contract/static2.mjs` 的 3 行适配**：核心返回值由 bigint 变 number，驱动侧改用 Node 原生 BigInt 独立复算；`differs`（双精度差 1）与 `productCoreTimesNumExceeds2p53` 两条断言**强度不变**。
4. **超大费用饱和为 2^53−1**：依据契约 docs/05 O4，调用方只做「×1000 > 2^53−1 ⇒ 满级」判定与减法；实测 `costLevel(20,10000)` 返回 `9007199254740991`。
5. **是否把修复包上传为「体验版」**：预览码只有 ~25 分钟寿命；上传会动到机主微信账号侧，**未经授权不做**。

---

## 八、遗留与后续建议

1. **修复尚未合并回原目录**：修复在 `frontend-rebuild-hm023diag/` 工作副本里，`frontend-rebuild-hm023/` 仍是旧代码。**需总监决定是否合并**（合并动作会改 `hm023`，本次任务明令禁止，故未做）。
2. **`hm023diag` 是可回滚的**：删除该目录即完全回滚，原目录不受影响。
3. **建议加一条长期护栏**：`tools/build-wechat.mjs` 的「产物零 BigInt」硬断言已就位，建议一并合并，防止以后再引入。
4. **bigint 能力探针**：内部包启动时会闪一条「引擎bigint:有/无」提示条。机主本次未回传该值（**未验证**）；若回传「无」，即为根因的现场直证。**不影响结论**——真机已能正常进入游戏。

---

## 九、交付物

| 交付物 | 路径 / 链接 |
|---|---|
| 本回执 | `tasks-out/S-14/回执-给指导智能体.md` |
| 总报告 | `tasks-out/S-14/总报告.md` — https://files.hynixing.cn/dl/s-14-240b8 |
| 分步报告 1–5 | `tasks-out/S-14/report-1.md` … `report-5.md` — report-5 https://files.hynixing.cn/dl/s-14-report-5-d87e3 |
| 修复后回归日志 | `tasks-out/S-14/修复后回归.log` — https://files.hynixing.cn/dl/s-14--log-b0a62 |
| 四包 sha256 清单 | `tasks-out/S-14/dist-交付件sha256.txt` — https://files.hynixing.cn/dl/s-14-dist-sha256-txt-318e4 |
| 微信正式包（修复后） | `tasks-out/S-14/叫我大岛主-0.2.3-pre-微信-B1包.zip` — https://files.hynixing.cn/dl/0-2-3-pre--b1-zip-c59aa |
| 微信内部诊断包（修复后） | `tasks-out/S-14/叫我大岛主-0.2.3-pre-微信-B1包-内部诊断版.zip` — https://files.hynixing.cn/dl/0-2-3-pre--b1--zip-eeeda |
| 真机验证用预览码 | `tasks-out/S-14/证据/修复包-0.2.3-pre-BigInt修复-预览码-20261018-1736.jpg` — https://files.hynixing.cn/dl/s-14--2026-10-18-17-36-pdt-e9cfa |
| 证据目录 | `tasks-out/S-14/证据/` |
| 进度表 | `tasks-out/S-14/进度.md` |
