# S-17 总报告:契约 v1.0 → v1.1 修订(新增 land_config_version=3 街区新价)

- **任务**:S-17 契约维护工程师(v1.0 → v1.1 增加 `land_config_version=3` 街区新价;含独立复审与快照)
- **日期**:2026-10-19(PDT)
- **批准依据**:机主 2026-10-19 拍板(原话见 `frontend-rebuild-hm/docs/37`;候选登记 `docs/38 #11`);提案 `frontend-rebuild-hm/tasks-out/S-16/提案.md`(§5.1 候选乙、§7.1 上限 20 备选、§9 受影响样例清单)
- **批准数值**:`land_config_version=3`、`block_upgrade={price:[1200,1], g:[3,2], gain:[1,25], max_level:20}`,公式 `ceil(1200×1.5^U×n)`;`base_price` 78 档、开业门槛、设施/宣传价、0.1 冻结数字均不变
- **v1.0 冻结包**:`contract-0.2-R3-FROZEN-v1.0.tar.gz`,sha256 `535e4beac061d36124a3c2dbc80b6c8ede5bb60ff02cf1a3d7cf3a2860feb277`,373,330 B(已复制留档于本目录)
- **v1.1 快照**:`contract-0.2-R3-v1.1.tar.gz`,sha256 `cb155cdd08e08261f828bf14abf9fe1839ccd327ec9353eaa37c6ca889593012`,394,966 B,132 条 tar 条目(123 文件 + 9 目录;v1.0 为 126 条目/117 文件)

## 1. 结论

**v1.1 修订完成**:按机主批准数值新增 v3 价格表(只改 `block_upgrade` 的 price/g/max_level 三个数字 + 版本号),文档/样例/证据/README/SHA256SUMS 全部同步;`bash tools/run_all.sh` 结尾 `ALL_DONE fail=0`,样例 463 例(正 195/反 155/边界 113)。独立复审(1 个低阶子智能体,自写脚本、未复用 S-16 脚本)结论:6 项中 5 项 PASS、1 项 FAIL(文档里"价格表份数 6/5→6"计数错误);该错误已修正并由 Lead 复核通过(见 `复审报告.md` 第 7 节)。**v1.1 尚未冻结,待用户确认**。

## 2. 修订摘要(文件级 diff)

**新增文件(6)**
| 文件 | 内容 |
| --- | --- |
| `samples/config/land_config_v3.json` | v1.1 现行价格表(sha256 `2b0a1c1fe468b522075dcf33f8868b81794742ab4848750468ebef7bc3daf54e`);以 v2 模板生成,数字只改版本号/`block_upgrade.price/g/max_level`,`base_price`/`yield`/`gain` 逐项同 v2;`source.sha256` = S-16 提案 `b97dbcfc…7ae8d` |
| `docs/18-v1.1变更记录.md` | 版本、日期、变更点、逐文件影响、样例逐条清单、证据、未验证、与 S-16 偏差 |
| `tools/check_v11.mjs` | 三项范围证据:表 diff / 与 v1.0 逐 case 比对 / 独立复算 |
| `evidence/land_config_v3_vs_v2_diff.txt` | v3 vs v2 逐字段 diff(仅 10 个字段组变化,`base_price` 78 项/yield/gain 相同) |
| `evidence/compare_with_backup_v1.0.txt` | 与 v1.0 逐文件/逐 case 比对(347 同 / 98 变 / 18 增 / 0 删) |
| `evidence/v11_v3_recompute.txt` | 不复用生成器的独立复算(6 个价 + 满岛 + 上限夹取 + S07-P08) |

**修改文件**
- 文档:`docs/00`(状态行/文档地图/Q-PRICE/Q-BU 注 + 新增 §0.9 变更表)、`docs/03`(现行表=v3、§3.1 表说明、§3.4 latestConfig=3/不自动迁移/旧存档玩家删除/Q-CFG 未决)、`docs/05`(数字状态段、§5.2 上限 20 与 82.2219%、§5.3 现行 v3 价 + v2 历史值、O1)、`docs/06`(v3 yield/gain 不变、max_level)、`docs/09`(§9.5 v1.1 迁移决定)、`docs/13`(表数 463、v1.1 段、价格表 5 份)、`docs/14`(状态行、A6/A7/A9/A10、B10 3→4、新增 A31);`docs/15/16/17` 历史记录**未改**。
- 工具:`tools/gen_configs.mjs`(v3 生成 + 断言)、`gen_samples_a/b/c/d/e/f/h.mjs`、`g_load.mjs`、`lib_gen_g.mjs`(版本号/knownConfigs/latestConfig + v3 与 2↔3 用例)、`tools/make_evidence.sh`(v1.1 证据)、`tools/README.template.md`(状态/覆盖表/证据表/§4.1d/未验证/读过目录)。
- 重生成:`samples/*`(18 个文件)、`samples/INDEX.json`、`evidence/*`、`README.md`、`SHA256SUMS.txt`。
- **未改**:`docs/01/02/04/07/08/10/11/12/15/16/17` 与 v1.0 逐字节相同;`samples/config/land_config_v2_A1c_scope0.2.json`、`land_config_v9001/9002/9003_TEST.json` 逐字节相同;全部 v2/9001 数字样例未改;0.1 冻结规则与夹具期望未改。

**与 S-16 提案的偏差(如实记录)**
1. `max_level=20`(提案推荐 15,机主取备选 20)⇒ §9.2 的 U=15 期望(41,111/80.43%)未采用,改用 U=20 的 46,249/82.2219%。
2. S-16 §9.1 未列 `S10`,本任务按 `docs/03 §3.4`/`docs/09 §9.5`"新游戏/迁移 latestConfig=3"一并重生成(S10 36 例,仅版本号字段);否则 `S10-P01`"v3 新游戏信封"与正文矛盾。
3. S-16 §9.1 把 `S18-J08-P01` 列为"必须改期望",实际该 corrupt 路径不写新信封,本任务中它只随 `env` 元数据变化、期望结果不变。
4. 任务书"必须改期望的 24 条"与逐条核对结果不一致:实际按差异类型 = 期望输出 36 / 仅输入 31 / 仅元数据 31(合计 98 例有变化);本报告按实际列示。

## 3. 样例变更(逐条)

**新增 18 例(id 全新)**
- `S04-price`:8 —— `S04-V3-P01`(版本 3 + 表 sha256 + base_price 同 v2)、`S04-V3-N0-1_1`、`S04-V3-N0-2_0`、`S04-V3-N1-2_0`、`S04-V3-N39--3_4`、`S04-V3-N77-5_-1`、`S04-V3-N77-4_1`、`S04-V3-B01`。
- `S06-block-upgrade`:7 —— `S06-V3-U0-n1`(1,200)、`U0-n3`(3,600)、`U1-n1`(1,800)、`U5-n2`(18,225)、`U9-n1`(46,133)、`U9-n78`(3,598,299)、`S06-V3-B04`(满岛 + 上限 20:末级 `U=19,n=30` → 79,806,162;U=20 ⇒ `max-level`;U=64 夹到 20;占比 82.22%)。
- `S07-rates-costs-settle`:1 —— `S07-V3-P08`(满岛 + 三类 20 级:land 46,249 / total 56,249)。
- `S04b-config-version`:2 —— `S04b-P02`(2→3 成功)、`S04b-N05`(3→2 `bad-request`)。

**既有样例变化(98 例,对 v1.0 逐 case 比对)**
- 期望输出变化 36:S04-N02(未内置版本 3→4)、S10 8(P01/P02/P03/B01/B02/B03/B04/B07)、S10f 8(P02/P03/P04/N02/N03/N05/N07/B01)、S14 12(P01/P02/P03/P04/P05/P07/P08/P09/N02/N03/B01/B02;P06/N01 未变)、S14b 3(P01/P02/N01)、S18 4(J07-P02/J07-B01/J09-P01/J09-P02)。
- 仅输入变化 31:S10 28(B05/B06/B08、N05、N07..N29)+ S20-K1-N03/N04/N06(版本 3→4)。
- 仅 `env`/`config` 元数据变化 31:S10f 4(P01/N01/N04/N06)、S14 2(P06/N01)、S18 25(每例内嵌 env)。
- 其余 347 例与 v1.0 **逐字节相同**(含全部 v2/9001 数字样例);删除 0。
- 证据:`evidence/compare_with_backup_v1.0.txt`(独立复审员用另一套脚本复核:JSON 规范化与原文逐字节两路均 347 相同)。

## 4. 验证与复审

| 项 | 结果 | 证据 |
| --- | --- | --- |
| 全量重跑 | `bash tools/run_all.sh` → `ALL_DONE fail=0`(33 步全 exit 0);独立复审在包副本中重跑,输出与 `evidence/run_all_output.txt` 逐字节相同,副本与原包 `diff -rq` 无差异 | `evidence/run_all_output.txt` |
| v3 vs v2 表 | 仅 `land_config_version`/label/status/source.*/block_upgrade.price/g/max_level/note 变化;`price_formula_id`/`base_price`(78)/`yield`/`gain` 相同 | `evidence/land_config_v3_vs_v2_diff.txt` |
| 独立复算(复审员) | 6 个 v3 价、B04 末级价/夹取/占比、S07-V3-P08、8 个 S04-V3 全部一致;98 个变化例"version-only leaves 127 / unexpected expected-output diffs 0" | `复审报告.md` §2、`/tmp/s17/review/` |
| v2/9001 零改动 | 347 例逐字节相同;v2/9001/9002/9003 表逐字节相同 | `evidence/compare_with_backup_v1.0.txt`、复审 §1/§3 |
| 参考实现跑 v3 | `blockUpgradePrice`/`upgradeBlock`/满岛 `core/total` 与样例一致 | `复审报告.md` §4 |
| 文档抽查 | 5 项子项 PASS;1 项 FAIL(价格表份数写 6,实际 5)已修正;0.1 相关 10 份文档逐字节未变;README 重生成与 `SHA256SUMS` 校验通过 | `复审报告.md` §5、Lead 复核 §7 |
| 红线 | 无把 838800/1.35/上限 10 写成 v1.1 现行值的行;`source.sha256` 与提案实际 sha 一致;包内无游戏实现代码/被禁目录内容 | `复审报告.md` §6 |
| 快照完整性 | 解包后与工作区 `diff -rq` 无差异;包内 `sha256sum -c SHA256SUMS.txt` 全通过;123 文件 | 本报告 §5 |

**独立复审结论**:6 项 5 PASS / 1 FAIL(仅文档计数,已修正并由 Lead 复核);无阻断项。复审员只读、自写脚本、未复用 S-16 脚本、未派生。

## 5. 快照

| 项 | 值 |
| --- | --- |
| 文件 | `tasks-out/S-17/contract-0.2-R3-v1.1.tar.gz` |
| sha256 | `cb155cdd08e08261f828bf14abf9fe1839ccd327ec9353eaa37c6ca889593012` |
| 字节数 | **394,966 B** |
| tar 条目 | 132(123 文件 + 9 目录;v1.0 为 126 条目 / 117 文件) |
| 目录结构 | 与 v1.0 相同(根目录 `contract-0.2-R3/`;docs/samples/tools/evidence + README.md + SHA256SUMS.txt);**未放在项目根目录** |
| 校验 | 解包后与 `/tmp/s17/work/contract-0.2-R3` 逐文件一致;包内 `sha256sum -c SHA256SUMS.txt --quiet` 无输出 |

## 6. 未验证(不得当事实)

1. v1.1 新数字(1,200 / g=1.5 / 上限 20)仍是仿真建议值,**无真人/真机数据**;0.3 完整经济 UI 不存在。
2. 上限 20 的长期体验(0.3 第 46 天满级后)未验证;S-16 仿真在 240 天内与上限 15 等价,但未做长周期真人验证。
3. 老存档"玩家自行删除"的运营/客服流程未验证(游戏侧不实现 2→3 迁移是机主拍板)。
4. 契约包只证明"参考算法 ↔ 样例/0.1 夹具"一致,**不证明任何前端实现通过**;前端侧需按 `docs/14` 自测。
5. 本包未在任何真机/微信/手机浏览器上运行(S-17 不涉及实现)。

## 7. 待总监裁决 / 移交

1. **`Q-CFG`(价格表版本自动升级触发策略)仍未决**;v1.1 明确"不实现 2→3 自动迁移、默认不自动",但"何时/是否自动触发"仍需裁决(契约默认:不自动,仅显式 `UPGRADE_LAND_CONFIG`)。
2. **v1.1 冻结位置**:本任务只产出快照于 `tasks-out/S-17/`;**未**放入 `wyszz-new/` 项目根、**未**替换 v1.0 冻结包;是否冻结、放哪里由总监定。
3. **前端实现同步**:游戏侧(hm023 等)尚未内置 v3 表与 `max_level=20`;按任务边界本任务**未动任何游戏代码**,实现侧另开任务。
4. S-16 提案称"必须改期望 24 条",本任务实测 98 例有差异(期望输出 36/仅输入 31/仅元数据 31);建议更新 S-16 清单口径。

## 8. 交付物

- `contract-0.2-R3-v1.1.tar.gz`(快照,sha256 见 §5)、`contract-0.2-R3-v1.1.tar.gz.sha256`
- `总报告.md`(本文件)、`复审报告.md`、`进度.md`
- v1.0 冻结包留档:`contract-0.2-R3-FROZEN-v1.0.tar.gz`(sha256 `535e4bea…eb277`,与源包一致)
