# S-14.4 最小修复 + 全量复验 + 重新出包 → report-4.md

> 时间：2026-10-18（PDT）。工作副本：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm023diag/`（`hm023` 的逐字节副本）。
> **四个前端目录 `frontend-rebuild-hm/`、`hm02/`、`hm022/`、`hm023/` 一个字节都没动**（见 report-5 的 0 差异核对）。

## 一、修复原则

契约 docs/05 §5.5 与 §5.4 O7 要求「中间乘积一律用任意精度整数」，并有样例钉死精确值：
- `S07-O01`：`landMilli` 精确 **393965049262765**，双精度算成 …**766**（差 1）；
- `S07-C-hallL139/140`：`costMilli` 精确 **16545756505731000** / **20185822936992000**（> 2^53−1）。

⇒ 修复**不能**退化成双精度。做法是：**保留「任意精度」语义，去掉对运行环境原生 BigInt 的依赖**。

## 二、改动清单（全部只在 `hm023diag/`）

| # | 文件 | 改动 | 性质 |
|---|---|---|---|
| 1 | `src/core/bigx.ts` | **新增**：base 2^16 limb 数组实现的最小任意精度非负整数（+ − × ÷ mod 幂 比较 转 number 转字符串），纯 JS，不引用 `BigInt` | 新增模块 |
| 2 | `src/core/ints.ts` | `MAX_SAFE_BIG` 由 `9007199254740991n` 改为 number；`ceilDiv`/`minBig`/`toNum` 改 number 版；**新增** `mulDivFloor`（商余分解，超域自动回退 bigx） | 等价重写 |
| 3 | `src/core/rates.ts` | 费用类 `powCost`/`costBlockUpgrade` 改走 bigx 精确计算（先浮点估算，明显超界直接饱和为 `MAX_SAFE_BIG`）；`coreMilli`/`landFraction` 改 number 精确式；`landMilli`/`totalMilli` 改 `mulDivFloor`；`settle` 改「rate 拆 60000·qr+sr」的精确商余分解 | 等价重写 |
| 4 | `src/core/actions.ts` | 15 处 `BigInt(...)` 运算改 number（`shortfall`/`lastChecks`/`quoteTile`/`buyTile`/`upgradeLine`/`upgradeDistrict`/`openBuilding`/`upgradeBlock`/`applyTap`） | 等价重写 |
| 5 | `src/core/config.ts` | `priceCoins` 改纯整数式 `(x − x%5)/5` | 等价重写 |
| 6 | `src/core/debug.ts` | `DEBUG_ADD_COINS` 改 number + 精确封顶式 | 等价重写 |
| 7 | `src/core/queue.ts` | `(u×len)>>32n` 改 `Math.floor(u×len/2^32)`（u 为 uint32，乘积 < 2^36，除法精确） | 等价重写 |
| 8 | `src/core/uistate.ts` | `affordable` 改 number 比较 | 等价重写 |
| 9 | `src/game/session.ts` | `cost*1000n > MAX_SAFE` 改 number 比较 | 等价重写 |
| 10 | `tools/build-wechat.mjs` | **新增构建期硬断言**：`game.js` 中若出现 `BigInt` 标识符则构建失败；诊断 banner 加「引擎 bigint 能力探针」toast（用 `G["Big"+"Int"]` 拼接，不引入标识符）；`VERSION` **保持 `0.2.3-pre` 不变** | 构建护栏 |
| 11 | `tools/contract/static2.mjs` | 3 行适配：核心已返回 number，测试驱动在 Node 侧用原生 BigInt 独立复算（**断言强度不降**，仍证明双精度差 1） | 驱动适配 |

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

## 三、为什么 `settle` 可以不用大数

`numerator = carry + 余毫秒 × rate` 的中间乘积会到 6e19（> 2^53）。做法：把 `rate` 拆成 `rate = 60000·qr + sr`，则

```
numerator = carry + 余毫秒·sr + 60000·(余毫秒·qr) = A + 60000·B     (A、B 均 < 2^53)
⇒ numerator div 60000 = B + (A − A mod 60000)/60000,  carry' = A mod 60000   —— 全部精确
```

是否封顶用「整分钟 > floor((room − numDiv) / rate)」精确判定，避免 `整分钟 × rate` 溢出。

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

| 项 | 基线（S-14.0） | 修复后 | 判定 |
|---|---|---|---|
| 契约样例全量 | 32 组 / 9751 case / 差异 0 | **32 组 / 9751 case / 差异 0** | 一致 ✓ |
| 属性测试 | 3000 序列 / 193500 步 / 违反 0 / 确定性差异 0 | **3000 / 193500 / 0 / 0** | 一致 ✓ |
| 全量回归 | 35/35 PASS / 496.4s | 见 `report-5.md` | — |

### 契约里两处「钉死精确值」的实测

| 样例 | 期望 | 修复后实测 |
|---|---|---|
| `S07-O01` `landMilli` | 393965049262765 | **393965049262765** ✓（双精度对照 = 393965049262766） |
| `S07-C-hallL139` `costMilli` | 16545756505731000 | **16545756505731 × 1000 精确** ✓ |
| `S07-C-hallL140` `costMilli` | 20185822936992000 | **20185822936992 × 1000 精确** ✓ |

## 五、产物层面的决定性证据（esbuild 独立复扫）

```
esbuild <pkg>/game.js --target=es2017 --outfile=/dev/null
```

| 包 | 「Big integer literals … may crash at run-time」警告数 | `BigInt` 标识符出现次数 |
|---|---|---|
| 0.1（B1 包 `010b1`，机主真机玩过） | 0 | 0 |
| 0.2.0 / 0.2.1 / 0.2.2 / 0.2.3-pre | 6 / 6 / 6 / 6 | 32~34 |
| **修复版（本次产物）** | **0** | **0** |

⇒ 修复版在语法层与「真机能跑的 0.1」完全同级。

## 六、出包

`npm run build`（typecheck + build:core + fixtures + replay + 内部包 + 正式包）产出四包：

| 包 | 目录 | 说明 |
|---|---|---|
| 网页正式包 | `dist/web` | |
| 网页内部包 | `dist/web-internal` | |
| 微信正式包 | `dist/wechat` | 游客模式 appid，零诊断字样 |
| 微信内部包 | `dist/wechat-internal` | 含诊断 banner（真机错误可见 + bigint 能力探针） |

sha256 清单见 `dist-交付件sha256.txt`。

## 七、真机验证状态

**未验证。** 修复包已部署到 VM 并出预览码，但**机主尚未在真机上扫码验证**。
在机主回传「能进游戏」之前，本报告不声称问题已解决。真机结论一律以机主实测为准。
