# S-17 契约 v1.1 独立复审报告

- **复审时间**:2026-10-19 19:20 PDT(2026-10-20 02:20 UTC)
- **复审对象**:`/tmp/s17/work/contract-0.2-R3/`(契约 v1.0 → v1.1 修订包)
- **v1.0 基线**:`/tmp/s17/v1.0/contract-0.2-R3/`(已解包快照)
- **复审员**:独立复审员(子智能体;低阶机械核对,不替作者裁决)
- **复审范围**:任务书 6 项(表差异、独立复算、既有样例零改动、参考实现/全量重跑、文档抽查、红线检查)
- **只读声明**:被复审包未写入;所有脚本/临时输出在 `/tmp/s17/review/`。全量 `run_all.sh` 在包的副本 `/tmp/s17/review/run_pkg/` 中执行,执行后副本与原包 `diff -rq` 无差异,原包 123 个文件 sha256 前后一致(`/tmp/s17/review/pkg_before.sha` vs `orig_now2.sha`)。

---

## 1. 表差异

**结论:PASS**

**复现命令**

```bash
cd /tmp/s17/review && python3 diff_v3_v2.py | tee diff_v3_v2.out
cd /tmp/s17/work/contract-0.2-R3
sha256sum samples/config/land_config_v3.json
for f in land_config_v2_A1c_scope0.2.json land_config_v9001_TEST.json land_config_v9002_TEST.json land_config_v9003_TEST.json; do
  cmp -s samples/config/$f /tmp/s17/v1.0/contract-0.2-R3/samples/config/$f \
    && echo "BYTE-IDENTICAL $f" || echo "DIFFERS $f"
done
```

**关键输出**

```text
differing leaves: 11
/block_upgrade/g[0]: v3=3  v2=27
/block_upgrade/g[1]: v3=2  v2=20
/block_upgrade/max_level: v3=20  v2=10
/block_upgrade/note: ...（版本说明改写）
/block_upgrade/price[0]: v3=1200  v2=838800
/label: ...（版本说明改写）
/land_config_version: v3=3  v2=2
/source/file: v3='frontend-rebuild-hm/tasks-out/S-16/提案.md'  v2='econ-sim-A1c/land_config.json'
/source/pointer: ...（版本说明改写）
/source/sha256: v3='b97dbcfc...7ae8d'  v2='43b52118...38fef'
/status: ...（版本说明改写）

base_price len 78 78 equal: True
yield equal: True
gain equal: True
formula equal: True
v3 block_upgrade: {"price":[1200,1],"g":[3,2],"gain":[1,25],"max_level":20,"note":"v1.1:price(U,n)=ceil(1200*(3/2)^U*n);gain=1/25(4%/级,与 v2 相同);max_level=20(机主 2026-10-19 批准)"}
v3 sha256=2b0a1c1fe468b522075dcf33f8868b81794742ab4848750468ebef7bc3daf54e

BYTE-IDENTICAL land_config_v2_A1c_scope0.2.json  cd32bf59a273cb3cd8c9bf3ebbcb9285c1f02022bb904bc6e017db268f208cfc
BYTE-IDENTICAL land_config_v9001_TEST.json       43d56a988534fbfbd6e38aa78b21ca58d9d99a24f5cff8ab8d19ffaaf32b4a24
BYTE-IDENTICAL land_config_v9002_TEST.json       84cf84f3ef0bcacd65bc3a5259ec93e8c6523fe205df6d2737d4db37bbe3880a
BYTE-IDENTICAL land_config_v9003_TEST.json       6a8d562396441bf3b212cc9d42dfff69356438af30d421f5091165ac7f445781
```

**备注**:11 个叶子差异 = 10 个字段组(`source` 的 file/sha256/pointer 合计一组);`block_upgrade.price` 仅 `[0]` 变、`[1]` 保持 1;`block_upgrade.g` 两个分量都按批准值变化。`price_formula_id`、`base_price` 78 项、`yield`、`block_upgrade.gain` 逐项完全相同。v3 文件 sha256 与任务书给定值一致。

---

## 2. 独立复算新增/变更期望值

**结论:PASS**

**复现命令**

```bash
cd /tmp/s17/review
python3 indep_calc.py | tee indep_calc.out          # 纯 Python Fraction,不 import 包内 lib/gen/S-16 脚本
python3 semantic_check.py | tee semantic_check.out  # 98 例变更叶子逐一分类
node ref_v3_check.mjs | tee ref_v3_check.out        # 参考实现只在第 4 项使用
```

**关键输出**

```text
=== S06 V3 点价(U,n) 与样例期望 ===
S06-V3-U0-n1:  U=0 n=1  mine=1200     expected=1200     OK
S06-V3-U0-n3:  U=0 n=3  mine=3600     expected=3600     OK
S06-V3-U1-n1:  U=1 n=1  mine=1800     expected=1800     OK
S06-V3-U5-n2:  U=5 n=2  mine=18225    expected=18225    OK
S06-V3-U9-n1:  U=9 n=1  mine=46133    expected=46133    OK
S06-V3-U9-n78: U=9 n=78 mine=3598299  expected=3598299  OK
B04 last level U=19 n=30: 79806162 expected 79806162 OK
B04 upAtU19.costCoins: 79806162 OK

Sigma kappa (78 tiles): 16059/6250 = 2.56944  (== 128472/50000)
S_max = 144531/31250 = 4.624992
land all max = 46249 total all max = 56249 expected 56249
land no upg  = 25694 total no upg  = 35694 expected 35694
share all max = 0.8222190616722075 trunc2= 82.22 expected 82.22
share no upg  = 0.7198408696139407 trunc2= 71.98 expected 71.98
maxLevel 20; upAtU20 = {"ok": false, "reason": "max-level"}
clamp: min(64,20)=20；参考实现 U=64 的 totalMilli 与 U=20 同为 56249

=== S07-V3-P08 ===
core exact 10000 coreMilli mine 10000 expected 10000
land num/den 5781240 1250000 landMilli mine 46249 expected 46249
total mine 56249 expected 56249

=== S04-V3 ===
S04-V3-N0-1_1:  N=0  Q=3  mine=13      expected=13      OK milli_ok=True
S04-V3-N0-2_0:  N=0  Q=4  mine=15      expected=15      OK milli_ok=True
S04-V3-N1-2_0:  N=1  Q=4  mine=22      expected=22      OK milli_ok=True
S04-V3-N39--3_4:N=39 Q=13 mine=795600  expected=795600  OK milli_ok=True
S04-V3-N77-5_-1:N=77 Q=21 mine=17992000 expected=17992000 OK milli_ok=True
S04-V3-N77-4_1: N=77 Q=21 mine=17992000 expected=17992000 OK milli_ok=True
P01 landConfigVersion=3 configSha256=2b0a1c1f...daf54e
first15 Q3/Q4 matches: True
max over N,Q(3..21): 17992000 expected 17992000
```

**备注**

- 价格全部用 `Fraction` + 整数 `ceil`(`-((-num)//den)`),无浮点;S06 点价按 `ceil(1200×(3/2)^U×n)`,S04 按 `ceil(base_price[N]×(5+Q)/5)`。未 import `tools/lib_econ.mjs`、`lib_land.mjs`、`gen_*.mjs`,未使用 S-16 脚本。
- B04 的 n=30 采用样例自述“本样例住宅 n=30”;占比用解析式 `Σκ=128472/50000`、`S_max=Σκ×1.8=4.624992`、`land=floor(10000×S_max)=46249`、`share=46249/56249=0.82221906…`,两位截断 82.22,与样例一致。
- 2d 逐条核对(自己读 JSON + 规范):`S04-N02` 未内置版本 4;`S10-P01/P02/P03` 信封/迁移写 3;`S10f-P02/P03` 迁移 `storageAfter` 信封写 3;`S14-P01` 新游戏 `coinsMilli=60000`、`landConfigVersion=3`;`S14b-P01/P02/N01` 写 3;`S18-J09-P01/P02` 迁移 `storageAfter` 写 3;`S18-J07-B01` 为 `refused`/`unsupported-land-config`/`detail='4'`。另做全量叶子检查:`semantic_check.py` 对 98 个变化例给出 `version-only leaves: 127; unexpected expected-output diffs: 0`,即除版本号/`knownConfigs`/`latestConfig`/`detail` 外无数字或语义被改。

---

## 3. 既有 v2/9001 样例零改动

**结论:PASS**

**复现命令**

```bash
cd /tmp/s17/review
python3 cmp_samples.py | tee cmp_samples.out     # 规范化 JSON 逐 case 比较
python3 raw_spans.py | tee raw_spans.out         # case 原文逐字节比较
python3 classify2.py | tee classify2.out         # 98 例按 期望/输入/env 分类
```

**关键输出**

```text
old 445 new 463
added 18 removed 0
common 445 identical(JSON canonical) 347 changed 98
raw_spans: common 445 raw-byte identical 347 raw-diff 98

per-file changed: {'S04-price.json': 1, 'S10-save-parse.json': 36, 'S10f-load-flow.json': 12,
 'S14-start-coins.json': 14, 'S14b-legacy-initial-state.json': 3,
 'S18-load-flow-R3c.json': 29, 'S20-r3d-rulings.json': 3}
total changed 98
expected 36 / input 31 / env 31
  expected by file: S04 1, S10 8, S10f 8, S14 12, S14b 3, S18 4
  input by file:    S10 28, S20 3
  env by file:      S10f 4, S14 2, S18 25

cases referencing v2/9001 ids: 16；其中 changed = []
S06-B04 unchanged; S07-P06/P07/P08/P10 unchanged
```

**备注**:新增 18 例 = `S04-V3-*` 8 + `S06-V3-*` 7 + `S07-V3-P08` 1 + `S04b-P02/N05` 2;删除 0。347 例不仅规范化 JSON 相同,case 原文逐字节也相同(`raw_spans.py`)。`samples/config` 下 v2/9001/9002/9003 四个文件逐字节同 v1.0(见第 1 项)。98 例变化内容经独立分类与 `semantic_check.py` 复核,全部为版本号语义(期望 36 / 仅输入 31 / 仅 env 或 config 元数据 31),未发现 v2/9001 数字被改。

---

## 4. 参考实现跑 v3

**结论:PASS**

**复现命令**

```bash
export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH
cd /tmp/s17/review && node ref_v3_check.mjs
# 只读保护:在包副本中全量重跑,不写原包
cd /tmp/s17/review/run_pkg/tools && bash run_all.sh > /tmp/s17/review/run_all_s17.log 2>&1
cd /tmp/s17/review && tail -5 run_all_s17.log
diff -rq /tmp/s17/work/contract-0.2-R3 /tmp/s17/review/run_pkg
```

**关键输出**

```text
=== blockUpgradePrice (reference impl, v3 cfg) ===
U0-n1 U=0 n=1 price=1200
U0-n3 U=0 n=3 price=3600
U1-n1 U=1 n=1 price=1800
U5-n2 U=5 n=2 price=18225
U9-n1 U=9 n=1 price=46133
U9-n78 U=9 n=78 price=3598299
upgradeBlock U0->1: {"ok":true,"reason":"ok","costCoins":1200,"coinsAfter":118800000,"blockUpg":[1,0,0]}
upgradeBlock U20: {"ok":false,"reason":"max-level"}

=== S06-V3-B04 recompute ===
coreMilli 10000n landMilli 46249n totalMilli 56249n
no-upg core 10000n land 25694n total 35694n
share all max % 82.22
U=64 clamp total 56249n == U20? true
```

```text
run_all.sh: 33 个步骤全部 [exit 0]（`grep -o "\[exit [0-9]*\]"` 统计：33 个均 exit 0）
最后一行: ALL_DONE fail=0
run_all_s17.log 与 evidence/run_all_output.txt 逐字节相同
副本重生成后与原包 diff -rq 无任何输出
```

**备注**:参考实现仅在本项使用,符合任务允许范围。`blockUpgradePrice`/`upgradeBlock` 的 6 个价、`max-level`、满岛 `core/total` 全部与第 2 项独立复算一致。`run_all.sh` 会写 `../samples`、`../evidence`,为遵守“被复审包只读”,在 `cp -a` 的副本中执行;执行后副本与原包逐文件无差异,且原包 123 个文件 sha256 前后完全一致,等价于原地重跑未产生内容变化。

---

## 5. 文档抽查

**结论:FAIL**(仅一处可修正的文档计数错误;其余子项均 PASS)

**复现命令**

```bash
cd /tmp/s17/work/contract-0.2-R3
grep -n "现行表\|land_config_version=3\|v2 表保留" docs/03-价格表读取与版本.md
grep -n "上限 \*\*20\*\*\|82.2219\|ceil(1,200×1.5\^U×n)" docs/05-街区类型升级与防溢出.md
sed -n '/## 0.9/,/## 0.10/p' docs/00-总览与冻结边界.md
grep -n "S04.*25\|S04b.*7\|S06.*23\|S07.*60" docs/14-验收清单.md
grep -n "463\|347\|98 例" docs/13-黑盒样例与事件序列.md samples/INDEX.json README.md
cd /tmp/s17/review/run_pkg && node tools/build_readme.mjs \
  && cmp README.md /tmp/s17/work/contract-0.2-R3/README.md \
  && cmp SHA256SUMS.txt /tmp/s17/work/contract-0.2-R3/SHA256SUMS.txt
cd /tmp/s17/work/contract-0.2-R3 && sha256sum -c SHA256SUMS.txt --quiet
for f in 01-地块与候选.md 02-买地事务与两步点击.md 04-种子队列算法.md 07-寻访声望新规则.md \
         08-居民与角色卡.md 10-离线结算与时间保护.md 12-错误码与失败原子性.md \
         15-R3b修订记录.md 16-R3c修订记录.md 17-R3d修订记录.md; do
  cmp -s docs/$f /tmp/s17/v1.0/contract-0.2-R3/docs/$f && echo "SAME $f" || echo "DIFF $f"
done
ls samples/config | wc -l
```

**关键输出**

```text
docs/03: 现行表(v1.1) = land_config_version=3；v1.0 的 v2 表保留，供老存档读取 —— OK
docs/05: 上限 20、ceil(1200×1.5^U×n)、82.2219%、S06-V3-B04 —— OK
docs/00 §0.9: v1.0 旧值 / v1.1 现行值两列表，含价格/增益/上限/占比/latestConfig —— OK
docs/18: 存在；347 same / 98 changed（36/31/31）/ 18 added / 0 removed 与实测一致 —— OK
docs/14: S04 25 例、S04b 7 例、S06 23 例、S07 60 例 —— 四个数均 OK
README 重生成: README_IDENTICAL, SHA256SUMS_IDENTICAL
sha256sum -c SHA256SUMS.txt --quiet: EXIT=0，无输出
0.1 相关文档 10 份: 全部 SAME

===== 本项唯一 FAIL =====
docs/13-黑盒样例与事件序列.md:46
  "配置 `samples/config/`(6 份价格表:v2、v3、9001/9002/9003 与独立测试表)"
docs/18-v1.1变更记录.md:40
  "docs/13 ... 配置表份数 5→6"
实际: samples/config/ 只有 5 个文件（v2、v3、9001、9002、9003）；v1.0 为 4 个。
即应为 5 份 / 4→5，而非 6 份 / 5→6。
```

**备注**

- 除上述计数外,文档数字与实测一致:`docs/14` 四集例数 25/7/23/60 均对;总计 463 在 `docs/13 §13.1`、`samples/INDEX.json`、`README.md` 中一致,但 `docs/14` 本身没有“总计 463”字样(只有分集例数),属任务书要求的位置差异,不改变 463 这个数字。
- `tools/README.template.md` 重新生成的 `README.md` 与原文件、`SHA256SUMS.txt` 均逐字节相同;`sha256sum -c` 无输出。
- 0.1 相关 `docs/01/02/04/07/08/10/12/15/16/17` 与 v1.0 基线逐字节相同;`docs/11` 也未变。其余变化的 docs 为 `00/03/05/06/09/13/14/18`。
- 文档措辞另见总结中的非阻断提示(`docs/18` 状态行与 README 状态行在复审结论产生前已写“经独立复审”)。

---

## 6. 红线检查

**结论:PASS**

**复现命令**

```bash
cd /tmp/s17/work/contract-0.2-R3
grep -rn -E "838800|838,800|1\.35|27/20|上限 ?10|max_level ?= ?10" docs/ README.md tools/README.template.md \
  | tee /tmp/s17/review/redline_grep.txt
sha256sum /vol1/ai/projects/wyszz-new/frontend-rebuild-hm/tasks-out/S-16/提案.md
jq -r '.source.sha256' samples/config/land_config_v3.json
find . -type d | sort
find . -type f | sed 's/.*\.//' | sort | uniq -c
```

**关键输出**

```text
redline grep 命中 23 行；逐条查看均为历史/变更记录语境：
- docs/05: "v1.0 旧表(land_config_version=2: 838,800×1.35^U×n、上限 10)... 不再以它为现行值"
- docs/06: "max_level 10→20" / "v1.0 v2 表为 10,仅老存档使用"
- docs/00 §0.9: 左列 v1.0 旧值、右列 v1.1 现行值
- docs/18: "v1.0 → v1.1" 变更表
- README: "v2 上限 10 满级 78.25%"(历史对照)
未发现把 838800/838,800/1.35/27/20/上限 10 写成 v1.1 现行值的行。

提案.md sha256 = b97dbcfc09faa57e0a9bb7814db19e20c28edd3784e2a6d0f724d4160547ae8d
land_config_v3.json.source.sha256 = b97dbcfc09faa57e0a9bb7814db19e20c28edd3784e2a6d0f724d4160547ae8d  (一致)

目录只有: ./docs ./evidence ./samples ./samples/config ./tools ./tools/testdata(/release_clean,/release_dirty)
无 src/app/game/node_modules/.git/dist 等游戏实现目录；包内无游戏实现代码。
tools/testdata/release_clean|release_dirty 的 main.js 是 scan_release 的正/反测试夹具（含故意调试词），不属于游戏实现。
```

**备注**:23 条命中全部有“v1.0 旧表 / 历史 / 变更记录 / v2 上限 10”等明确标注;`docs/14` 中被正则命中的一行是 v1.1 说明文字,不含旧数字作为现行值。`source.sha256` 与实际提案文件 sha256 逐字符一致。包内只有契约文档、样例、参考验证工具和 evidence;没有前端/游戏实现代码或被禁目录内容。

---

## 总结

**FAIL 项数量:1**(第 5 项“文档抽查”;其余 5 项 PASS)

**是否有需要契约维护者修正的问题:有**

1. **必须修正(文档计数事实错误)**
   - `docs/13-黑盒样例与事件序列.md:46` 写“配置 `samples/config/`(6 份价格表…)”;实际目录只有 **5 份**(`land_config_v2_A1c_scope0.2.json`、`land_config_v3.json`、`land_config_v9001/9002/9003_TEST.json`),应改为“5 份”。
   - `docs/18-v1.1变更记录.md:40` 写“配置表份数 5→6”;实际为 v1.0 **4 份** → v1.1 **5 份**,应改为“4→5”。两处是同一事实,改一处不够,建议同时改。
2. **非阻断文字提示**
   - `docs/14-验收清单.md` 只有分集例数 25/7/23/60,没有“总计 463”字样;463 在 `docs/13 §13.1`、`samples/INDEX.json`、`README.md` 一致,数字本身无误。若任务要求文档内直接出现总计,可补一行。
   - `docs/18-v1.1变更记录.md:3` 与 `README.md:5` 在本次独立复审结论产生前已写“经独立复审/已完成并经独立复审”。本次复审结论为第 5 项 FAIL,建议在这两处改为“待复审/复审中”,或在上述两处修正并复核通过后再保留“经独立复审”的表述(取决于维护者的发布流程)。
3. **未发现其他问题**:表差异、独立复算、既有 v2/9001 样例零改动、参考实现 v3、`run_all.sh`、红线检查均通过;被复审包未被修改。

**复审员边界说明**:本次只报告机械核对结果,未对“6 份/5→6”是否影响契约语义作裁决;该问题不影响任何价格数字、样例期望或 `run_all` 结果。

---

## 7. Lead 复核与修复确认(2026-10-19 19:30 PDT)

> 本节由 S-17 契约维护者(Lead)追加,不是复审员结论。复审员结论保持原文(第 5 项 FAIL,1 处文档计数错误)。

**修复项(对应总结第 1 条)**

1. `docs/13-黑盒样例与事件序列.md:46`:`6 份价格表` → **`5 份价格表:v2、v3 各 1 份 + 9001/9002/9003 三份合成测试表`**(与 `ls samples/config` 实际 5 个文件一致)。
2. `docs/18-v1.1变更记录.md:40`:`配置表份数 5→6` → **`配置表份数 4→5(v2/v3 + 9001/9002/9003 共 5 份)`**。
3. 采用非阻断建议:`docs/14` A31 补"合计 463 例(正 195/反 155/边界 113)";`docs/18`/`README` 状态措辞改为"独立复审通过(修正 1 处文档计数后)"。

**Lead 复核(在修复后的包上,2026-10-19 19:30 PDT)**

```text
$ cd /tmp/s17/work/contract-0.2-R3
$ cd /tmp/s17/work/contract-0.2-R3
$ ls samples/config | wc -l                     → 5
$ grep -n "5 份价格表\|4→5" docs/13*.md docs/18*.md
  docs/13:46 …5 份价格表:v2、v3 各 1 份 + 9001/9002/9003 三份合成测试表…
  docs/18:40 …配置表份数 4→5(v2/v3 + 9001/9002/9003 共 5 份)…
$ cd tools && node build_readme.mjs              → files hashed: 121
$ cd .. && sha256sum -c SHA256SUMS.txt --quiet   → 无输出(全部 OK)
$ find samples evidence -newer /tmp/s17/review/pkg_before.sha -type f | wc -l  → 0(复审后未动样例/证据)
```

- 复审第 1/2/3/4/6 项结论不受影响:表差异、独立复算、v2/9001 零改动、参考实现+`run_all`、红线检查均为 PASS(复审员原报告与 `/tmp/s17/review/` 输出为证);第 3 项的 347 例逐字节/98 例分类、第 4 项的 `ALL_DONE fail=0` 均未因本次文档修复变化(未动 `samples/` 与 `evidence/`)。
- 复审后仅修改:`docs/13`、`docs/14`、`docs/18`、`tools/README.template.md`、重新生成的 `README.md`/`SHA256SUMS.txt`;第二次 `build_readme` 幂等、`sha256sum -c` 全通过。
- **Lead 复核结论:第 5 项 FAIL 的两处计数错误已修正,修正后无新增问题;v1.1 修订包可进入 S-17.3 快照。**
