# S-15 · 0.2.3 定稿总报告（合并 → 定稿 → 全量回归 → 重出四包）

- 执行：主对话（lead）亲自做核心步骤；机械步骤派子智能体 A（全量回归）、B（产物校验与打包）
- 时间：2026-10-19 01:05 → 01:55 PDT
- 工作副本：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm023/`（版本 **0.2.3**）
- 任务产出目录：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm/tasks-out/S-15/`

> **开工即发现的前置缺口（已按 docs/35 §7 规则 9 由主对话补齐）**：S-15.4 任务书下达时，
> `hm023` 仍是**未合并**状态（无 `src/core/bigx.ts`、版本仍 `0.2.3-pre`、`tasks-out/S-15/` 不存在）。
> 而 S-15.4–S-15.6 全部以「合并 + 定稿」已完成为前提。主对话据此先补做 S-15.1–S-15.3，
> 再执行 S-15.4–S-15.6。以下清单即该补齐过程的完整留痕。

---

## 一、合并与清理清单（S-15.1 / S-15.2）

### 1.1 合并前备份（回滚锚点）

| 项 | 值 |
|---|---|
| 备份文件 | `tasks-out/S-15/hm023-合并前备份.tgz` |
| sha256 | `c7e4567dc5ba18b8181abfe2a76e22be69cdbb50cdea4d31e1fed37883b2b6f4` |
| 字节数 | 376,378 B |
| 条目数 | 175（`node_modules/`、`dist/`、`evidence/` 未纳入：前二者为可重建产物，`evidence/` 为历史证据） |
| 抽验 | 备份内 `src/core/config.ts` 仍为 BigInt 版、`package.json` 仍为 `0.2.3-pre`、**无** `src/core/bigx.ts`；与当前树 sha256 不同 ⇒ 确为合并前快照 |

### 1.2 合并：hm023diag → hm023（13 个文件）

从 `frontend-rebuild-hm023diag/` 逐字节复制（该 13 个文件是总监在 S-14 已核验过的版本）：

| # | 文件 | 类别 | 合并后 sha256 |
|---|---|---|---|
| 1 | `src/core/bigx.ts` | 新增（base-2^16 limb 任意精度整数） | `cc0c1e27ec89fdc387f4a6f714c4b076a7cb07c536632a26190cf0733ed24149` |
| 2 | `src/core/ints.ts` | 去原生 BigInt（`MAX_SAFE_BIG` 改 number、新增 `mulDivFloor` 商余分解） | `d9d4bd698a656a77e424301c83af70f34cda2bcf7b78013a68d48361ecd156ab` |
| 3 | `src/core/config.ts` | `priceCoins` 去 BigInt | `7aea70dd1df6b5bfa971741a2c0770dc93b93418af6079782b08d0d71162e654` |
| 4 | `src/core/debug.ts` | 调试加币去 BigInt | `d9d7897e580dda775114b64363a719cd58bc54518230e7b853bb425758e02e67` |
| 5 | `src/core/uistate.ts` | `affordable` 去 BigInt | `f6c34ea46d73727aad1d798a9a455ce332e83e139d9adab2a17ce102b5d467ed` |
| 6 | `src/core/rates.ts` | 费用/结算改精确商余分解 | `f7346ade36764e9022eb7a8d04aeb1067e5231bb3e0a1e9b608045aec80cf75d` |
| 7 | `src/core/queue.ts` | 队列去 BigInt | `95251c597bd687aed95f031df83945b1cb48576c1660742f7f92c86ce806028b` |
| 8 | `src/core/actions.ts` | 事务去 BigInt | `20f87da70358b6408b3bd50a0a2f4cd7e11f19fe38b8fe1556e853cd97f41bcf` |
| 9 | `src/game/session.ts` | 存档/结算去 BigInt | `45fb17121e1842446092a94e877dc6f2b07acc059369d46cb4419918e4387e4e` |
| 10 | `src/wechat/wx.d.ts` | 补 `onError`/`onUnhandledRejection`/`getFileSystemManager`/`env` 声明 | `5c0ea568c6c832e3a627da48d9e0d69d397ecd8b7a363873ce83be769dae70ce` |
| 11 | `src/wechat/main.ts` | 诊断插桩（`__INTERNAL__` 守卫）+ 启动 try/catch | `222451e310968a317d7174410d56f29ce711691e25af8eb34004833360f401f1` |
| 12 | `tools/build-wechat.mjs` | 零 BigInt 硬断言 + `supported.bigint=false` + 内部包诊断 banner | `69556826562a841f57513a84a764d964d6ba3c8d6c44b2065abd6642d47f7df1` |
| 13 | `tools/contract/static2.mjs` | 3 处驱动适配（Node 侧原生 BigInt 独立复算，断言强度不变） | `3ecae8eb4a9ea1f43f7838c8726c9414cc280ddbb65ef7a44df280a756e3bb3b` |

**合并完整性**：合并后 `hm023` 与 `hm023diag` 全树 `diff -rq`（排除 `node_modules/dist/evidence/package-lock.json`）**差异为 0**；
随后主对话施加的 S-15 定稿改动（下表）是两者唯一的差异来源。

### 1.3 清理（3 项）

| # | 项 | 位置 | 改动 | 依据 |
|---|---|---|---|---|
| C1 | 正式包残留键名 `reportEnv`/`copyText` | `src/web/main.ts`、`src/wechat/main.ts` | 由 `reportEnv: __INTERNAL__ ? f : undefined` 改为**对象展开** `...(__INTERNAL__ ? { reportEnv: f, copyText: g } : {})`，正式包编译期折叠为空、**键名不再进入产物**（web 与 wechat 一致） | S-12b 裁决 4「0.2.3 清理」 |
| C2 | 内部包常驻「DIAG OK」角标 | `src/wechat/main.ts` | 首帧回调**只写 err.log 取证**，删除 `app.hud.toast('DIAG OK …')` 可见 toast | S-15.5 校验项 ③ |
| C3 | 内部包 banner 的可见 toast | `tools/build-wechat.mjs` | 删除 DIAG_BANNER 内 `wx.showToast({title:"引擎bigint:…"})`；保留 onError/onUnhandledRejection **提前注册**与 storage/err.log 探针 | S-15.5 校验项 ③ |

清理效果（主对话实测）：正式包 `reportEnv`/`copyText` 命中数由 **1 / 2 → 0 / 0**；内部包仍保留（内部包本就需要这两个接口）。

---

## 二、版本更新逐处对照（0.2.3-pre → 0.2.3）

共 **39 处**替换，覆盖 **17 个文件**；替换后全树（排除 `dist/`、`evidence/`、`node_modules/`）`0.2.3-pre` 残留 **0 处**。

| 文件 | 处数 | 说明 |
|---|---|---|
| `package.json` | 1 | `"version": "0.2.3-pre"` → `"0.2.3"` |
| `tools/build-web.mjs` | 1 | `const VERSION` |
| `tools/build-wechat.mjs` | 3 | `const VERSION` + 2 处注释（含 `0.2.3-pre2` 表述归一） |
| `tools/regress.mjs` | 2 | 步骤注释 |
| `src/app/app.ts` | 1 | 注释 |
| `src/ui/debug-panel.ts` | 1 | 内部包面板可见文案「内部测试包 0.2.3」 |
| `src/game/fingerprints-s12.ts` / `-int.ts` | 1 / 1 | 头注释 |
| `src/wechat/main.ts` | 2 | 头注释 + 首帧角标文案（角标本身已在 C2 移除） |
| `tests/s12-layout.test.ts` | 2 | 钉版本的测试输入 |
| `tests/s12b-layout.test.ts` | 3 | 同上 |
| `tests/s12-node.test.ts` | 2 | 同上（输入 + 期望串） |
| `tests/s12b-node.test.ts` | 2 | 同上 |
| `test/t-land.mjs` | 3 | 正式包/内部包标记断言 |
| `test/t-s12.mjs` | 1 | 报告字段断言 |
| `test/wechat-s12.mjs` | 1 | 报告字段断言 |
| `test/t-wechat-project-config.mjs` | 12 | `V02_NAME='wyszz-island-0.2.3'`、W13/W18/W19 断言与注释 |

**与总监裁决的一致性**：docs/37「裁决 2」要求「定稿时升 0.2.3 并**同步改测试文件**重跑全量回归」——
本报告即按此执行：版本号、构建脚本、可见文案、4 个测试文件（`tests/*.test.ts` 与 `test/*.mjs`）同步更新后，**才**跑全量回归。

**未受影响的证据链**（主对话核查）：
- 启动指纹是**行为指纹**（固定输入算结果串），非源码哈希；`fingerprints-s12-int.ts` 用 `version:'0.0.0-fp'` 固定输入，故版本号变更**不会**动摇指纹。回归第 22/26/31 步指纹自检 12/12、11/11、21/21 全 PASS 印证。
- `project.config.json` 的 `projectname`/`description` 由 `VERSION` 派生 ⇒ 正式包 `wyszz-island-0.2.3`、内部包 `wyszz-island-0.2.3-internal`。

---

## 三、全量回归数字（S-15.4）

| 项 | 值 |
|---|---|
| 命令 | `export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH; npm run regress`（`B1_PACK_DIR=/vol1/ai/projects/wyszz-new/template-quickstart-pack`） |
| 总步数 / 通过 / 失败 / 跳过 | **35 / 35 / 0 / 0** |
| 结论 / 退出码 | **PASS** / **0** |
| 总耗时 | **494.5 s（8 分 14.5 秒）**；01:38:11 → 01:46:26 PDT |
| 契约样例 | **32 组 / 9751 case / 差异 0** |
| 属性测试 | **3000 序列 / 193500 步 / 违反 0 / 确定性差异 0** |
| 微信替身 | 第 10 步 **38/38**；B1 工程配置 19/19；微信包 S-08 13/13；替身 S-12 15/15；替身 S-12b 8/8 |
| 指纹各步 | fp02 **12/12**、fpS10 **11/11**、fpS12 **21/21**；运行期 `[fingerprint] all OK`、`[fingerprintS10] all OK`、`[fingerprintS12] all OK` |
| 窄屏矩阵 | S-08.1 3240 用例 / 违反 0；S-10.5 165888 用例 / 违反 0；S-12.3 27072 用例 / 违反 0；S-12b 648 用例 / 违反 0 |
| 正式包扫描 | 正式包 web 3 文件 / wechat 4 文件 **0 命中 PASS**；负例 dirty-demo 2 命中、内部包各 6 命中，均如期 FAIL |
| 步骤级 FAIL | **0**（日志全文仅 3 行 "FAIL" 字样，均为前缀 `OK` 的预期负例） |

- 完整日志：`tasks-out/S-15/agents/A/回归.log`（1176 行，stdout+stderr 原样）
- 报告：`tasks-out/S-15/agents/A/报告.md`
- 逐步日志 + summary.json：`hm023/evidence/regress-20261019-083811/`
- 对照：S-14 修复后回归同为 35/35、496.8 s（本次 494.5 s，**逐项一致**）

---

## 四、四包产物 sha256 与直链（S-15.5）

### 4.1 主产物 sha256

| 包 | 产物 | 字节 | sha256 |
|---|---|---|---|
| 微信正式 | `dist/wechat/game.js` | 712,138 | `8cb13934bac72d3818fefcee4f7bd6d29e46f1fdfd00f08decbe5f54bf39e999` |
| 微信内部 | `dist/wechat-internal/game.js` | 745,377 | `e8c19cf66b49d6f41f69fd5adfd301bc4a4b3bee0bb77d5c4e1f8952fe234d70` |
| 网页正式 | `dist/web/assets/main-450fc126a9.js` | 708,014 | `450fc126a9377696fa81f6a0c5545a877446db576e2187112440611535df7680` |
| 网页内部 | `dist/web-internal/assets/main-2603aa34bb.js` | 739,133 | `2603aa34bbfc41c0fcdf540b7bdbef72b835c6afb319e85997db47ceda2dcdb6` |

其余交付文件：`wechat/game.json` = `wechat-internal/game.json` = `82526622d158db584fe0783eb469d01eaaa33a85360c28d83bf2b01cb031b8ec`（64 B）；
`wechat/project.config.json` = `26dddb1722b6a3b4f4e5f7bd459598b21026a7b73e5e2fb6941ed0fab7b4622e`；
`wechat-internal/project.config.json` = `d6ea0b8e7c75ff3345780805e40defd57d5f70933674b0f57e13f8a895907f80`。
全量清单（dist 全部 22 文件 + 4 个 zip = **26 条**）：`tasks-out/S-15/dist-交付件sha256.txt`。

### 4.2 交付 zip

| 交付件 | 条目 | 字节 | sha256 | 直链 |
|---|---|---|---|---|
| 叫我大岛主-0.2.3-微信-正式包.zip | game.js / game.json / project.config.json / MANIFEST.json | 195,482 | `47cbd4c9f6bfb7b90f838cfeaa6bca720a7139d116335cb76426414dbf9ec94b` | 见 §4.3 |
| 叫我大岛主-0.2.3-微信-内部包.zip | 同上 | 207,544 | `d01f7c72c8d9c55268de9d41531acc70e5825dd0bfb881ffe3ea258ed6522982` | 见 §4.3 |
| 叫我大岛主-0.2.3-网页-正式包.zip | index.html / assets/main-450fc126a9.js / MANIFEST.json | 193,649 | `f3c229b612f63a08fca71e77e077feae2f2a312adbce4c4bf36329df41b48223` | 见 §4.3 |
| 叫我大岛主-0.2.3-网页-内部包.zip | index.html / assets/main-2603aa34bb.js / MANIFEST.json | 204,806 | `c4cb51c4f10dc6f0d1dc83545340543c98849ba069050cd154bc6225cba8668c` | 见 §4.3 |

zip 结构：各自 dist 子目录内打包，条目位于**根层**（web 包内含 `assets/` 目录，与 S-14 一致）。

### 4.3 下载直链（deliver-link）

见 `tasks-out/S-15/交付直链.md`。

---

## 五、产物校验结论（S-15.5b，子智能体 B）

B 对 `hm023/dist/` 六项校验 **6/6 PASS、0 FAIL**：

| # | 校验项 | 结果 |
|---|---|---|
| ① | 四个产物 `BigInt` 出现 0 次 | PASS（四包 14 文件合计 0；`typeof x=="bigint"` 类型判断与内部包 `G["Big"+"Int"]` 拼接探测均非 BigInt 字面量，已留痕） |
| ② | 微信正式包零诊断字样 | PASS（`DIAG OK`/`引擎bigint`/`err.log`/`__s14_errbuf`/`bigintSupport`/`wx.showToast` 全 0） |
| ③ | 微信内部包有 onError 提前注册、无可见 toast | PASS（banner 字节偏移 558/745377，早于主 bundle；`wx.showToast`=0、`DIAG OK`=0） |
| ④ | projectname | PASS（`wyszz-island-0.2.3` / `wyszz-island-0.2.3-internal`） |
| ⑤ | game.json | PASS（两包均 `{"deviceOrientation":"portrait","showStatusBar":false}`，64 B） |
| ⑥ | dist 各 MANIFEST version=0.2.3 | PASS（4/4；channel=release/internal 正确；10/10 条文件记录与实际吻合） |

B 报告：`tasks-out/S-15/agents/B/报告.md`。

---

## 六、终检结果（S-15.4，主对话亲自做，只读）

| 检查项 | 任务书要求 | 实测 | 判定 |
|---|---|---|---|
| `hm022` vs `S-12/hm022开工sha256.txt` | 0 差异 | **0 差异**（546/546，改 0 缺 0 增 0） | ✅ |
| `hm02` vs `S-12/hm02开工sha256.txt`（排除 4 份用户文档） | 0 差异 | **基线条目 0 差异**（401/401，改 0 缺 0）；新增 5 份根目录用户侧文档 | ✅（附说明） |
| `frontend-rebuild-hm` vs `S-06/hm基线sha256.txt` | 仅 `docs/35`、`37`、`38` 差异 | **仅 `docs/35`、`37`、`38` 差异**（2 改 1 增，均为总监文档） | ✅ |

- **说明（1 点）**：任务书列明排除 4 份用户文档，但 `hm02` 根目录实有 **5** 份用户侧文档；
  第 5 份 `交接说明-真机卡启动页-20261019.md`（mtime 2026-10-18 09:45:26）与其余 4 份同批同性质、早于 S-15 开工，**未列入排除名单**。
  实质结论不变：`hm02` 的 401 条基线条目被改 0、缺失 0。
- `tasks-out/` 下 725 个新文件不计入差异：该目录**从未被 S-06 基线覆盖**（基线生成时即排除），属任务产出正常增长。
- 方法与原始 JSON 证据：`tasks-out/S-15/终检-基线.md`、`tasks-out/S-15/scripts/verify-baseline.mjs`、`scripts/终检-{hm022,hm02,hm}.json`。

---

## 七、子智能体分工与抽查记录

| 子智能体 | 分工 | 权限边界 | 产出 | 主对话抽查（亲自复核） |
|---|---|---|---|---|
| **A** 回归执行员 | 跑 `npm run regress` | 只写 `hm023/evidence/**` 与 `tasks-out/S-15/agents/A/` | `agents/A/回归.log`、`agents/A/报告.md` | ✅ 亲自 `grep` 原始日志逐项确认：`合计：执行 35 步，通过 35 步，失败 0 步`（第 1171 行）、`合计: 32 组, case=9751, 差异=0`（464 行）、`3000 序列 / 193500 步 / 违反 0`（490 行）、`微信替身测试 PASS 38/38`（1144 行）；并对 `FAIL` 字样全量定位，确认仅 3 行且均为前缀 `OK` 的预期负例 |
| **B** 产物校验与打包 | 六项校验 + 打 4 个 zip + 生成 sha256 清单 | 只写 `tasks-out/S-15/agents/B/` 与 `tasks-out/S-15/` 下 zip/清单 | `agents/B/报告.md`、4 个 zip、`dist-交付件sha256.txt` | ✅ 亲自重算 **4 个主 JS + 4 个 zip** 共 8 个 sha256，与 B 清单**逐一吻合**；并亲自 `unzip -l` 确认 4 个 zip 条目位于根层、文件数与字节数正确 |

- 两个子智能体均**未嵌套再派**子智能体；均未改动 `src/`、`tools/`、`test/`、`tests/`、`package.json`。
- 主对话亲自完成的步骤：备份、合并、清理、版本定稿、终检、四包构建、抽查复核、总报告、交付。

---

## 八、未验证清单（必须随交付一并上报）

1. **真机未验证**：本报告所有产物级结论均为**静态/模拟器级**（构建产物 grep、微信替身、无头浏览器、窄屏矩阵）。**0.2.3 四包均未在真机上启动过**——S-14 的真机结论只覆盖 `0.2.3-pre` 修复包（hm023diag），不覆盖本次合并后的 0.2.3。
2. **微信正式包从未真机运行过**（自 0.2.1 起）。S-14 真机通过的是内部诊断包 + 正式包 B1 各一枚预览码，其中正式包真机复测仍未做。
3. **30 秒真机烟测未做**：任务书 S-15 尾项「真机 30 秒烟测」需出预览码 + 机主扫码，本轮未执行（预览码寿命约 25 分钟，须由能操作 VM 的智能体在机主在场时出码）。
4. **真机报告数据未回传**：机主未回传内部包 30 秒采样的 FPS / draw calls，0.2.3 性能优化继续待数据。
5. **外网下载未验证**：deliver-link 直链只保证生成成功，未做外网实际下载校验（沿用 S-14 的口径）。

---

## 九、回滚办法

```bash
# 回到「S-15 合并前」的 hm023（0.2.3-pre、无 bigx.ts）
cd /vol1/ai/projects/wyszz-new
tar xzf frontend-rebuild-hm/tasks-out/S-15/hm023-合并前备份.tgz -C /vol1/ai/projects/wyszz-new
# 覆盖后按需重建产物（备份不含 dist/，dist 是可重建产物）
cd frontend-rebuild-hm023 && export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH && npm run build
```

- 备份 sha256：`c7e4567dc5ba18b8181abfe2a76e22be69cdbb50cdea4d31e1fed37883b2b6f4`（**覆盖前请先核对**）。
- 备份覆盖 `src/`、`tools/`、`test/`、`tests/`、`package.json`、`contract-fixtures/`、`deploy/`、`tsconfig.json`、`ISOLATION.md`（共 175 条）；
  **不含** `node_modules/`、`dist/`、`evidence/`——`dist/` 由 `npm run build` 重建，`evidence/` 为历史证据不动。
- 另一条退路：`hm023diag/` 工作副本（总监已核验的修复态）完整保留，未被本轮改动。

---

## 十、遗留与待总监裁决

### 10.1 已登记的后续版本候选

- **F-1 放大受限**：镜头 `zoomMax=1.45`（`src/render/camera.ts`），拉不到近景看细节/小人。属 0.2 整岛观察的设计边界；加深需处理近裁剪面、雾、岛底/岛缘穿帮、低模近距离观感、真机填充率 ⇒ **已登记 0.3 镜头工作**。
- **F-2 小人偏少**：0.2 契约固定 3 居民（`SPAWN_RESIDENT`）。企划书 0.3 加助手与基础居民反馈，并明确「居民动画同时最多展示少量（如 8 名），不做居民 AI」⇒ **已登记 0.3**。

### 10.2 待总监裁决

1. **S-15.1–S-15.3 由主对话补做的追认**：任务书下达时 `hm023` 未合并、版本未定稿，主对话按 docs/35 §7 规则 9 先补做合并/清理/定稿再执行 S-15.4–S-15.6。请追认此处置与「清理项 C1/C2/C3」的取舍（尤其 C2/C3 删除可见 toast 属实现层判断）。
2. **合并后的 0.2.3 四包是否需要在真机上终验一次**（当前真机结论只覆盖 0.2.3-pre 修复包）。
3. **是否把 0.2.3 微信正式包上传为「体验版」**（会动到机主微信账号侧，未经授权不做）。
4. **`docs/37` 与 `docs/35` 的 S-15 记录是否由总监回填**（本轮未改任何总监文档）。

---

## 十一、交付物索引

| 交付物 | 路径 |
|---|---|
| 本总报告 | `tasks-out/S-15/总报告.md` |
| 只读终检报告 | `tasks-out/S-15/终检-基线.md` |
| 全量回归日志（A） | `tasks-out/S-15/agents/A/回归.log` |
| 全量回归报告（A） | `tasks-out/S-15/agents/A/报告.md` |
| 产物校验报告（B） | `tasks-out/S-15/agents/B/报告.md` |
| dist 交付件 sha256 清单（26 条） | `tasks-out/S-15/dist-交付件sha256.txt` |
| 四个交付 zip | `tasks-out/S-15/叫我大岛主-0.2.3-{微信,网页}-{正式,内部}包.zip` |
| 合并前备份（回滚用） | `tasks-out/S-15/hm023-合并前备份.tgz` |
| 交付直链 | `tasks-out/S-15/交付直链.md` |
| 终检脚本与原始 JSON | `tasks-out/S-15/scripts/` |
