# 42 · 经济 v1.2 提案：取消「城区/市区」独立层，合并进市政厅

> 任务：**S-22A**（经济方案 + 仿真）｜日期：2026-10-22｜工作树：`frontend-rebuild-hm033-econ`（0.3.2 基线副本）
> 性质：**提案与仿真，不落地**。本文件不改任何 `src/**`、不改契约冻结包、不改存档 schema、不改经济数值、不新增调试事件。
> 数据来源：本文每个数字都可指到 `tasks-out/S-22/econ/analysis/` 下的脚本输出行（见 §8）。仿真为**模型推演，非真人数据**。
> 交叉验证：`tasks-out/S-22/econ/sim/`（子智能体 S1 的独立实现）与本文附带的独立复算（§8.3）。

---

## 0. 给机主的 30 秒结论

**一句话：删层可以，但别把「城区」当成纯支出层——它同时是全区产速的乘数。保住乘数、砍掉按钮，就对了。**

| | 方案 | 三周末产速 | 三周末累计收入 | 第 1/2/3 栋楼开业 | 区费 | 契约改动量 |
|---|---|---|---|---|---|---|
| 现状 | BASE | 46,600 金币/分 | 7.66 亿 | **297 / 520 / 787 分钟** | 有（第 15–21 天占支出 4.4%~13.3%，见 §3.1） | — |
| **推荐** | **方案1c（混合）** | 30,384 金币/分 | 5.33 亿 | **19 / 42 / 64 分钟** | 无 | 小（1 条推导式 + 3 个门槛） |
| 备选一 | 方案2（彻底删 D） | 12,447 金币/分（−73%） | 2.30 亿（−70%） | 17 / 48 / 77 分钟 | 无 | 中（改产速公式本身） |
| 备选二 | 方案1b（激进） | 69,770 金币/分（+50%） | 12.45 亿（+63%） | 20 / 33 / 54 分钟 | 无 | 小 |
| 参考 | 方案1（/5 纯推导，门槛跟着 D 走） | 30,384 金币/分 | 5.32 亿 | **19 / 60 / 172 分钟** | 无 | 小 |

**三个必须知道的结论：**

1. **城区层是「乘数」不是「税」。** 现状第 21 天 D=25，对全区产速是 **×2.44**（`(94+6D)/100`）。直接删掉 D（方案2）会把三周末产速从 46.6k 砍到 12.4k（**−73%**）、累计收入砍 **−70%**——不是"少一个消耗点"，是"把后期经济规模砍到三分之一"。**方案2 若不配套补偿，0.3.2 的后期手感会明显变穷。**
2. **"区费占后期支出 21.9%"是 240 天口径，三周验收期内只有 4.4%~13.3%（策略敏感）。** 两套独立实现各跑一遍：本提案脚本 240 天累计 30.8%、子智能体 S1（另一套实现 + 15 分钟/天在线画像）**240 天 20.118%**、21 天后期 13.3%——**S-16 的 21.9% 被第二个独立实现复现了（20.1%，差 1.8pp）**。但把窗口缩到三周，占比掉到个位数（本提案 4.44%）。**结论：删掉这一层，前三周玩家对"少了个按钮"几乎无感；缺口是"第 4 周以后"的事。**
3. **开业节奏被彻底改写，而且是好方向的改写。** 现状要 **13 小时**才开完三栋楼（堵在"先攒 2100 金币升 D=2"这道闸上）；三个合并方案都在 **1 小时左右**开完。这是本次改动对玩家体验最直接、最可感知的变化。

---

## 1. 现状事实（逐条可指到源码）

### 1.1 公式表（0.3.2 实测，非记忆）

| 量 | 现状 | 源码位置 |
|---|---|---|
| 四栋楼定义 `b0 / base / openLevel` | 市政厅 10/20/1、居民楼 16/40/2、社区商店 25/100/4、公园 40/250/6 | `src/core/rates.ts:29-35` |
| 核心产速 | `coreMilli = round_half_up( Σ b0·(L+4)·(10+F)·(94+6D) / 5 )`，未开业贡献 0 | `src/core/rates.ts:84-95` |
| 土地乘数 | `landMilli = floor(coreMilli × Σnum / den)`，`num=Σ 212·(5+ρ−1)·(25+min(U,20))`、`den=10000·5·25` | `src/core/rates.ts:98-112`、`src/core/data/land_config_v3.json` |
| 总产速 | `totalMilli = coreMilli + landMilli` | `src/core/rates.ts:114-118` |
| 等级费 | `costLevel = ceil(B × 1.22^(L−1))`，市政厅 `C(1..5)=20/25/30/37/45` | `src/core/rates.ts:59`、契约 `docs/06 §6.5` |
| 设施费 | `costFacility = ceil(25B × 1.5^F)` | `src/core/rates.ts:61` |
| 宣传费 | `costPromo = ceil(4B × 1.5^A)`（**无经济收益**，只对声望/展示） | `src/core/rates.ts:63` |
| **区行政费** | `costDistrict = ceil(2100 × 1.45^(D−1))` | `src/core/rates.ts:65` |
| 开业费 | `costOpen = 2B` → 市政厅 40 / 居民楼 80 / 商店 200 / 公园 500 | `src/core/rates.ts:67` |
| 买地价 | `ceil(base_price[N] × (5+Q) / 5)`，`Q=q²+qr+r²`，N=0..77 | `src/core/config.ts:24-27` |
| 街区升级价 | `ceil(1200 × 1.5^U × n)`，上限 20 | `land_config_v3.json` `block_upgrade` |
| 开局 | 60 金币（`START_COINS_02_MILLI=60000`）+ 市政厅 1 级开业 ⇒ **10 金币/分** | `src/core/state.ts:35,43-56` |
| 市政厅等级上限 | **L=136**（费用×1000 > 2^53−1 ⇒ `max-level`，整数约束不是平衡参数） | 契约 `docs/06 §6.7` |

### 1.2 城区层到底值多少钱（拆成三件事）

| 作用 | 现状数值 | 删掉/改造后的后果 |
|---|---|---|
| **① 收入乘数** | `(94+6D)/100`：D=5 → 1.24×、D=10 → 1.54×、D=25 → **2.44×** | 乘数没了 ⇒ 后期产速断崖（方案2 −73%） |
| **② 开业闸门** | 居民楼需 D≥2、商店 D≥4、公园 D≥6 | 三栋楼的开业时间完全由它决定（现状 297/520/787 分钟） |
| **③ 支出点** | **到达该等级要付的累计**（不是逐级求和）：D=2 **2,100**；D=4 **9,561**；D=6 **25,248**；D=15 **842,876** 金币 | 240 天口径占支出 6.6%~30.8%（策略敏感），三周口径 4.4%~13.3% |
| ④ UI/存档成本 | 独立面板（`src/game/session.ts:604-613`）、存档第 19 字段、错误码 `district-level-too-low`、事件 `UPGRADE_DISTRICT` | 删掉后 4 处 UI/文案/错误码可一并瘦身 |

> **口径提醒①**：`costPromo`（宣传线）在三周仿真里支出为 0——它没有任何经济收益，理性玩家不会买（与 S-16 §4.3 结论一致）。所以**宣传线不能当补偿消耗点**。
> **口径提醒②（D 的实际上限）**：市政厅等级被整数安全卡在 **L≤136**，所以推导方案下 **D 实际上限 = 1+floor(135/5) = 28**（/5 映射）或 **68**（/2 映射）——不是存档表里的 10000。现状独立升级链的实际可买上限是 **D=60**（`ceil(2100×1.45^59)×1000 ≤ 2^53−1`，D=61 起越界）。

---

## 2. 四个候选方案与数字

### 2.1 定义

| 代号 | 定义 | 区费 | 产速乘数 | 开业门槛 |
|---|---|---|---|---|
| **BASE** | 现状 | 有 | `94+6D`，D 花钱升 | D ≥ 2/4/6 |
| **方案1** | `D = 1 + floor((L−1)/5)` 由市政厅等级推导 | 删 | `94+6D`（D 自动） | **仍按 D 判** ⇒ 等价市政厅 **L6 / L16 / L26** |
| **方案1b** | `D = 1 + floor((L−1)/2)` | 删 | `94+6D`（D 自动） | 仍按 D ⇒ 市政厅 **L3 / L7 / L11** |
| **方案1c（混合·推荐）** | D 用 1 的 /5 推导；**门槛直接改看市政厅等级** | 删 | `94+6D`（D 自动） | **L3 / L6 / L9** |
| **方案2** | 删 D，`(94+6D)` 固定为 100 | 删 | 恒 1.00× | L3 / L6 / L9 |

**方案1c 为什么存在（本次最重要的设计发现）**：机主给的两个候选项各有一半是对的——
- 方案1 的乘数映射（每 5 级市政厅 +6%）让"区等级"这个中间层对玩家彻底消失，但**门槛跟着 D 走**会把居民楼/商店/公园顶到 L6/L16/L26（正确的是 **L16**，不是我最初口算的 L21：`floor((L−1)/5)=D−1 ⇒ min L = 1+5(D−1)`）。
  **补一个反直觉事实（经 S1 独立核对后修正我的初判）**：这三道新门槛比现状的区费闸门**更便宜**——到 L26 累计只要 13,031 金币，而现状到 D6 累计要 25,248 金币。所以方案1 **不是"毁前期"，它的三栋楼全部比现状更早开**（实测 19/60/172 分钟 vs 现状 297/520/787）。它真正的问题是**门槛数字不可解释**（对玩家"为什么是 16？"无解），且比 1c 慢（商店 +18 分钟、公园 +108 分钟）。
- 方案2 的门槛（L3/L6/L9）直观、可解释、节奏均匀，但它把乘数一起删了。
- **两者相加 = 1c**：门槛看市政厅（直观），乘数由市政厅自动推导（隐藏），玩家视野里只剩"市政厅"一条线。实测 19/42/64 分钟，节奏均匀（间隔 23 分钟 / 22 分钟）。

### 2.2 开局到第 1/2/3 栋楼开业的分钟数（10 金币/分起步，含买地节奏）

> 数据：`analysis/x-open-minutes-21d.csv`（每行 `方案,楼,分钟,天,开业时金币,开业时产速`）

| 方案 | 第 1 栋·居民楼 | 第 2 栋·社区商店 | 第 3 栋·公园 | 三栋开完 |
|---|---|---|---|---|
| BASE | **297 分**（4h57m） | **520 分**（8h40m） | **787 分**（13h07m） | 13.1 小时 |
| 方案1 | 19 分 | 60 分 | 172 分 | 2h52m |
| 方案1b | 20 分 | 33 分 | 54 分 | 54 分钟 |
| **方案1c** | **19 分** | **42 分** | **64 分** | **64 分钟** |
| 方案2 | 17 分 | 48 分 | 77 分 | 1h17m |

**为什么现状这么慢**：开局 60 金币、10 金币/分，而**居民楼的第一道闸是"区等级 D≥2"，要先攒 2,100 金币升 D=1→2**。不是"楼贵"（开业只要 80 金币），是"闸贵"。这一条是玩家前 5 小时的唯一体感，也是本次改动收益最大的地方。

**副作用（必须告诉机主）**：三栋楼从"13 小时"压缩到"1 小时"，意味着**前 3 天的内容节奏会突然空掉**——第 1 天就把 4 栋楼全开完，之后只剩数值增长。如果 0.3.3 的验收标准里有"第 1 天有持续解锁感"，需要同时把后面的内容（街区升级、地皮）往前推，否则会被打回"1 小时玩完"。

### 2.3 三周（21 天）节奏曲线关键节点

> 数据：`analysis/x-curve-21d-21d.csv`（逐小时 504 行 × 5 方案）；下表取第 1/3/7/14/21 天末快照。

| 方案 | 指标 | 第 1 天 | 第 3 天 | 第 7 天 | 第 14 天 | 第 21 天 |
|---|---|---|---|---|---|---|
| BASE | 产速/分 | 2,682 | 8,065 | 18,615 | 33,251 | **46,600** |
| | 累计支出 | 1.52M | 17.19M | 93.54M | 352.88M | **763.85M** |
| | D / 市政厅 L / 地 | 9 / 39 / 20 | 16 / 51 / 30 | 20 / 59 / 50 | 23 / 66 / 65 | 25 / 70 / 76 |
| **1c** | 产速/分 | 3,433 | 7,077 | 13,965 | 22,216 | **30,384** |
| | 累计支出 | 2.85M | 18.11M | 79.15M | 262.13M | **523.55M** |
| | D / 市政厅 L / 地 | 9 / 43 / 22 | 11 / 52 / 31 | 12 / 58 / 50 | 13 / 65 / 61 | 14 / 68 / 72 |
| 方案2 | 产速/分 | 1,935 | 3,620 | 6,049 | 9,756 | **12,447** |
| | 累计支出 | 1.69M | 9.76M | 37.41M | 116.44M | **229.64M** |
| 方案1b | 产速/分 | 6,806 | 16,152 | 32,099 | 53,924 | **69,770** |

**读法**：
- 方案1c 第 1 天比现状**更富**（3,433 vs 2,682，因为省了 2,100 的 D2 闸费），但第 21 天只有现状的 **65%**（30.4k vs 46.6k）——省下的区费在第 4 天之后就被"丢掉的乘数"吃回去了。
- 方案2 从第 1 天就低 28%，第 21 天低 **73%**。它不是"更平衡"，它是"后期缩水"。
- 方案1b 全程高 30%~50%，属于**通胀**方向。

### 2.4 后期每小时金币产出 vs 消耗（第 15–21 天，145 个小时样本）

> 数据：`analysis/x-late-hourly-21d.csv`（逐小时 `收入/支出/净`）；下表为 145 小时均值。

| 方案 | 每小时收入 | 每小时支出 | 每小时净沉淀 | 支出/收入 |
|---|---|---|---|---|
| BASE | 2,477,565 | 2,463,207 | 14,358（0.6%） | 99.4% |
| 方案1 | 1,631,302 | 1,601,168 | 30,134（1.8%） | 98.1% |
| **方案1c** | **1,632,606** | **1,601,168** | **31,438（1.9%）** | **98.1%** |
| 方案1b | 3,816,726 | 3,816,366 | 359（0.0%） | 100.0% |
| 方案2 | 672,381 | 670,768 | 1,613（0.2%） | 99.8% |

**读法**：五个方案在"后期是否还能把钱花出去"上没有区别——支出都吃掉 98%~100% 的收入。**第 15–21 天的消耗点不会因为删掉城区层而消失**，因为等级线/设施线/买地/街区还在。真正的分水岭是**规模**：方案2 的每小时收支只有 BASE 的 27%。

### 2.5 三周末总对照（第 21 天末）

> 数据：`analysis/x-day21-21d.csv`

| 方案 | 金币余额 | 产速/分 | 累计收入 | 累计支出 | 支出结构（等级/设施/买地/街区/区费） |
|---|---|---|---|---|---|
| BASE | 1.87M | 46,600 | 765.7M | 763.8M | 304.3M / 150.5M / 198.6M / 75.6M / **34.8M** |
| 方案1 | 8.47M | 30,384 | 532.0M | 523.5M | 214.6M / 100.3M / 144.8M / 63.8M / 0 |
| **方案1c** | 9.35M | 30,384 | 532.9M | 523.5M | 214.7M / 100.3M / 144.8M / 63.8M / 0 |
| 方案1b | 6.43M | 69,770 | 1245.1M | 1238.7M | 580.2M / 251.0M / 232.1M / 175.4M / 0 |
| 方案2 | 0.18M | 12,447 | 229.8M | 229.6M | 101.9M / 44.6M / 56.5M / 26.7M / 0 |

**三周末最优可买项的回本时间**（衡量"还有没有值得买的东西"，`analysis/run-21d.log`）：

| 方案 | 最优可买项 | 价格 | 回本时间 |
|---|---|---|---|
| BASE | 等级 | 14.91M | **117.2 天** |
| 方案1 | 买地（还差 6 块） | 10.75M | 19.2 天 |
| **方案1c** | 买地（还差 6 块） | 10.75M | **19.2 天** |
| 方案1b | 等级 | 27.58M | 68.8 天 |
| 方案2 | 等级 | 4.98M | **88.3 天** |

> 这一列很说明问题：**现状三周末已经"没什么值得买"了**（最优选项要 117 天才回本），而方案1c 因为地皮没买完（72/78），三周末还留着一个"19 天回本"的选项。所以"三周内玩家是否还有东西可买"这个问题，**现状比取消城区层更糟**。

---

## 3. 后期消耗点补偿（把 21.9% 那笔账算清）

### 3.1 缺口量化：它不在三周内，在第 4 周以后

> 数据：`analysis/x-period-spend-240d.csv`（240 天贪心口径，BASE）

| 时间窗 | BASE 区费 | 该窗总支出 | 区费占比 |
|---|---|---|---|
| 第 15–21 天 | 18.26M | 410.97M | **4.44%** |
| 第 22–30 天 | 38.39M | 662.71M | 5.79% |
| 第 31–60 天 | 250.42M | 2,980.66M | 8.40% |
| 第 91–180 天 | 750.17M | 12,620.83M | 5.94% |
| 第 181–240 天 | 643.77M | 9,718.74M | 6.62% |
| **240 天累计** | 9.17e9（宽松口径）/ 2.07e9 | 2.98e10 / 3.04e10 | **30.8% / 6.8%** |

**三套模型的口径对照（这就是"21.9%"的来源与不确定性）：**

| 模型 | 玩家画像 | 三周后期区费占比 | 240 天累计区费占比 |
|---|---|---|---|
| S-16（2026-10-19） | 贪心 + 15 分钟/天 | — | **21.9%** |
| 本提案脚本（24/7 逐分钟） | 回本贪心 | **4.44%** | 30.8% |
| S1（独立实现，`sim/`） | 15 分钟/天 | 12.1%（cont）/ **13.3%**（act15） | **20.118%** |

**结论：S-16 的 21.9% 可信（S1 用另一套实现复现到 20.1%，差 1.78pp 来自策略/街区价表差异）；但它是 240 天口径，不是三周口径。** 提案里讨论"补偿"时必须限定时间窗，否则会为了 3 周验收期去做一个 4 个月后才需要的补丁。

### 3.2 补偿的必要性：取决于你选哪个方案，而不是"删层"本身

| 方案 | 240 天末 60 天 支出/收入 | 谁接住了区费的份额 | 是否需要新补偿 |
|---|---|---|---|
| BASE | 100.70% | — | — |
| 方案1 / 1c | 101.24% | **等级线（91–180 天 5.66e9、181–240 天 4.15e9）+ 设施线（2.44e9 / 1.93e9）** | **不需要** |
| 方案1b | 106.02% | 等级线（10.42e9） | 不需要（但通胀） |
| 方案2 | 92.92% | 等级线 + 设施线，但**总量少了 17%** | **需要**（见 3.3） |

**这是本提案最反直觉的一条**：区费不是"唯一的后期消耗点"。等级线 `1.22^L` 和设施线 `1.5^F` 都是**指数费用、线性增益**，天然无上限（L 到 136、F 到约 58 才被整数范围卡住），它们的"吸金能力"比区费强得多。删掉区费后，贪心玩家把那笔钱投到等级/设施线上，240 天总支出几乎不变（BASE 2.98e10 vs 方案1 1.93e10——**注意：方案1 总量仍然少 35%，少的是被乘数拖累的收入，不是"钱花不出去"**）。

### 3.3 只有方案2 需要补偿，且要补的是「乘数」不是「消耗点」

方案2 把乘数固定 1.00×，直接后果：三周末产速 12.4k（BASE 的 27%）、累计收入 2.30 亿（BASE 的 30%）、240 天末 60 天支出/收入掉到 92.92%（唯一一个花钱明显变少的方案）。

若机主坚持"连乘数也不要，就要一条干净的市政厅线"，**必须同时补以下之一**（数值按 240 天口径折算）：

| 补偿候选 | 具体改法 | 数值效果 | 风险 |
|---|---|---|---|
| **C1 市政厅等级增益加强** | `(L+4)` → `(L+6)`（每级仍 +1，起点 +2） | L=70 时乘数 74/5 = 14.8× vs 11.0×（+34%），把方案2 的 27% 拉回约 36% | 与 0.1 冻结的 `R(L)=10×(1+0.2(L−1))` **直接冲突**（那是 0.1 兼容不变量），代价大 |
| **C2 设施线增益加深** | `(10+F)` → `(10+F×1.25)` | F=10 时单栋增益 20 → 22.5（+12.5%），三周末产速 +12% | 需要改产速公式结构，样例全变 |
| **C3 街区线增益加深** | `gain 1/25` → `1/20`（每级 +4% → +5%） | 满 78 块 20 级时土地乘数 5.4× → 6.7×（+24%） | 与 v1.1 已批准的 `gain=1/25` 冲突，需机主二次批准 |
| **C4（推荐）不改数值，改用方案1c** | 保留推导乘数，只删按钮 | 三周末产速 BASE 的 65%、240 天末 60 天支出/收入 101.24% | 无新参数 |

**判断：方案2 不值得为它付 C1–C3 的契约代价。** 如果目标只是"少一层按钮"，方案1c 用 1 条推导式就拿到了同样的 UI 瘦身，还保住了乘数与 0.1 兼容性。

### 3.4 三周内玩家是否还有东西可买？

**有，而且比现状更多。** 判据用"第 21 天最优可买项的回本时间"（§2.5 表）：
- 现状：117.2 天 ⇒ 理性玩家在第 3 周末基本停止投资（金币余额 1.87M 一直涨）。
- 方案1c：19.2 天 ⇒ 还有 6 块地可买，且买完每块仍是两位数天内回本。
- 方案2：88.3 天 ⇒ 比现状好，但不如 1c。

**给机主的直白结论：担心"删掉城区层以后没东西可买"是多余的；现状才是"三周末没东西可买"的那个。**

---

## 4. 存档与迁移（不加字段）

> 本节结论已与子智能体 S2 的逐条核对稿对齐：详见 `tasks-out/S-22/econ/draft/迁移方案.md`（边界表 M1–M10）与 `draft/契约v1.2-diff草案.md`（命中位置全表 + 21 行改动清单）。

### 4.1 字段现状与硬约束

`districtLevel` 是 v3 存档的第 **19** 个数值字段（`docs/09:28`）：`int, 1..10000`，由 `UPGRADE_DISTRICT` 维护，并受一条**跨字段一致性约束**（`docs/09:38`）：

> 未开业行必须是 `[0,1,0,0]`；下标 1..3 已开业要求 `districtLevel ≥ 2/4/6`。

另有两条实现事实必须先摆出来：
- **0.3.2 里 D 的实际上限是 60，不是 10000**：`ceil(2100×1.45^59)×1000 = 6.97e15 ≤ 2^53−1`，D=61 起费用×1000 越界 ⇒ `max-level`（`docs/05 O4`）。所以旧档 `D_old>60` 只可能来自篡改。
- **契约层没有"迁移事件"通道**（`docs/13 §13.3` 事件表无此项，且本任务禁止新增事件）⇒ 迁移只能"静默对齐 + 写实现内诊断日志"，不能落档、不能进事件序列。

**硬约束（本提案一律遵守）**：不新增字段、不改 `schemaVersion`（仍为 3）、不改 24 键键序与取值范围、不发放金币、不产生离线收益。

### 4.2 迁移算法（方案1c）：`D_eff = max(存档值, 推导值)` 的"只升不降棘轮"

**为什么不直接 `districtLevel := 1+floor((L−1)/5)`（我最初的写法，被 S2 否掉）**：现有合法存档里存在 `L5 / D4 / 商店已开业`（样例 `S10-P04`）这种情况——强推 `D* = 1+floor(4/5) = 1`，则"商店已开业但 D=1 < 门槛 4"，**整档立刻判 `inconsistent-state`**。也就是说"强制取推导值"会让**升级后打不开自己的档**，这是不可接受的。

```
载入（loadV3）：
  1. 解析与校验完全照旧（24 键、范围、类型、键序、offlinePending 等，一律不改）。
  2. L  = level = buildings[0][1]（两者必须相等，否则照旧 inconsistent-state）。
  3. D* = 1 + floor((L − 1) / 5)                  // 纯函数：L1..5→1、6..10→2、…、10000→2000
  4. D_eff = max(districtLevel, D*)               // 只升不降；旧档付过钱的区等级一律保留
  5. districtLevel := D_eff                       // 覆盖后随既有 persist 写回，不需要"迁移标记"
  6. 一致性规则改为：已开业楼需满足 D_eff ≥ 2/4/6（P1 口径）
     —— 注意顺序：先按 docs/09:28 校验 D_old 范围，再算 D_eff，最后判已开业门槛。
     于是 S10-P04（D4/L5）通过、S10-N18（D1/L1 + 公园已开）仍判损坏，两个样例期望值都不变。
  7. 不碰 coinsMilli / carryNumerator / lastSettleTsMs / settleCount / offlinePending / lastGainMilli / totalGainMilli。
```

- **为什么不补偿金币**：旧档已经为 D 付过费（`D=4` 累计 9,561 金币），回收 D 等于没收；反过来"补发"等于白送。既不退也不收，是唯一两边都安全的选择。
- **为什么不能加"已迁移"标记**：加字段违反本任务硬约束；无标记 ⇒ 迁移必须是**无状态纯规则**（max 就是），任何"判断这是不是老档"的分支都不可实现。
- **离线挂起怎么办**：`D_eff` 抬升只影响**下一次结算起**的费率，不追溯、不补发。若 `offlinePending=true`，迁移只在内存里记 `D_eff`，等挂起结算走完再落盘（同 S2 §1.3）。
- **必加断言（实现层）**：`assert(next.coinsMilli === prev.coinsMilli)`、`assert(next.lastSettleTsMs === prev.lastSettleTsMs)`、`assert(next.settleCount === prev.settleCount)`。这三条是防"迁移顺手发钱"的唯一护栏（风险 R5）。

### 4.3 旧档 `D_old` 与推导 `D*` 不匹配的边界处置

> 完整十行表见 `draft/迁移方案.md §2`（M1–M10），这里给决策相关的主干：

| # | 情形 | 例子 | 处置（方案1c） | 方案2 处置 | 补偿 | 拒绝载入 |
|---|---|---|---|---|---|---|
| M1 | `D_old = D*` | L6/D2、L16/D4、L26/D6 | 原样 | 忽略（写回兼容值） | 无 | 否 |
| M2 | `D_old > D*`（旧档独立升过区，**最常见**） | `S10-P04` L5/D4；`S11-P01` L1/D2 | **以 `D_old` 为准**（max） | 忽略，写回 `max(D_old, 兼容值)` | **不补偿** | 否 |
| M3 | `D_old < D*`（L 高但没升区） | `S06c-B01` L135/D1；`S10-B07` L10000/D1 | **以 `D*` 为准**（抬到推导值） | 忽略（速率不变） | 无（也不收费） | 否 |
| M4 | `D_old` 越界（0/负/10001） | — | 既有解析规则 `out-of-range` ⇒ 整档损坏 | 同左 | — | **是** |
| M5 | `D_old` 缺失 / 类型错 | 字符串、1.5 | `missing-field` / `bad-type` / `not-integer` ⇒ 整档损坏 | 同左（**字段校验保留**，否则会变成"静默忽略"，削弱防篡改） | — | **是** |
| M6 | `L` 越界/缺失/类型错 | 10001、1.5 | 解析层先拒，迁移层不接管 | 同左 | — | **是** |
| M7 | 已开业楼与 `D_eff` 不匹配 | `S10-N18` 公园已开 + D1/L1 | `D_eff = max(1,1) = 1 < 6` ⇒ 仍 `inconsistent-state`（**校验强度不变**） | 规则已删 ⇒ 该档变合法，需重造 `S10-N18` | 无 | P1：是 / P2：否 |
| M8 | 已开业楼但 `L` 低于**新**门槛（P2 特有） | L5 商店已开（`S10-P04`） | 不适用（P1 用 D 判门槛） | **接收**：不关楼、不清 L/F/A，门槛只约束未来 `OPEN_BUILDING` | 无 | 否 |
| M9 | `D_old > 60`（越界篡改） | — | 不拒绝（拒绝=新版本打不开档），只记诊断日志；`D_eff` 仍 ≤ 10000 | 同左 | 无 | 否 |

### 4.4 幂等与回滚

- **幂等**：`D_eff = max(D_old, D*)`，第二次迁移 `max(D_eff, D*) = D_eff`（因为 `D_eff ≥ D*`），恒等。**可证**。
- **确定性**：`D*` 只依赖 `L`，无时钟、无随机 ⇒ 同档同结果。
- **回滚到 0.3.2**：旧版本读到 `districtLevel = D_eff`（合法 1..10000）会当成"玩家当前区等级"，表现为**区等级不降反升或持平**（因为 `D_eff ≥ D_old`）——**这正是选 max 棘轮而不选强制覆盖的关键理由：回滚不会让玩家掉级**。代价是：老玩家保留一个"比新玩家高"的 D 与乘数（`D_eff` 可以永远大于 `D*`），这是**永久性小优势**，属可接受的迁移税。
  - 若机主不接受这个永久优势，唯一替代是"强制覆盖 + 放宽已开业楼校验（grandfather）"，代价是 `S10-P04` 类存档要重造期望、且回滚会掉级。二选一，见 §7 的 A-1 / A-2 变体。
- **若最终选方案2（删 D），迁移必须多写一步**（S2 红线）：`districtLevel := max(存档值, 已开业楼在旧门槛下的最低 D)`，否则回滚到 0.3.2 时按 `docs/09:38` + `savev3.ts:147` 会判 `inconsistent-state` → 单槽隔离 → **直接丢档**。这是方案2 在迁移上比方案1c 多出来的真实风险。

## 5. 契约 v1.2 条款级 diff 草案（只写文档，不改契约包）

> 依据：冻结包 `contract-0.2-R3/`（`docs/00、05、06、09、11、12、13、14`、`samples/`）。
> **本节已与 S2 的逐条核对稿对齐**（`draft/契约v1.2-diff草案.md`）：S2 用 `grep -rn '区行政\|区等级\|district' docs/ README.md` 穷举了区等级这条线的**全部**规范位置，结论是**规范上要改 21 行 = 16 条实质条款 + 5 条验收/索引/簿记**。下表是决策视角的摘要，逐行文本草案见 S2 原稿。
> "条款号"按冻结包现有编号体系书写；**实施时以 `docs/15-R3b…17-R3d 修订记录` 的下一节（R3e/v1.2）追加，不覆盖原文**。
> **影响面（S2 逐条核对结果）**：8 篇 docs（00/05/06/09 + 11/12/13/14）+ README + **6 个样例文件**（S06c/S07/S10/S11/S16/S10f）+ INDEX；**不改 `schemaVersion`（仍 3）、不改 24 键键位**（已用 `S10-P01` canonical 样例实测 `districtLevel` 仍第 19 位）。
> 两个**必须提前知道**的契约级代价：①方案1/1c 会让 `docs/06:58-65`、`docs/00:31` 的"0.1 产速恒等"**只在 L≤5 成立**——L6 起总产速比 0.1 的 `R(L)` 高 ×1.06、L16 ×1.18、L26 ×1.30、L136 ×2.62（L=10000 理论值 ×120.94，实务不可达）；②方案2 会让 `S07-O01` 那个"贴 2^53−1 的 BigInt 防溢出见证样例"失去意义（乘数固定后大数路径变少）。

### 5.1 条款 diff 表

| # | 文档·条款 | 现状原文要点（位置） | 方案1c 新值（推荐） | 方案2 新值 | 需同步样例 |
|---|---|---|---|---|---|
| D1 | `docs/06 §6.3` 产速公式 | `...(94+6D)...`，D = 区行政等级（`docs/06` 行 26） | **公式不变**，D 定义改为 `D = 1 + floor((L−1)/5)`，L = 市政厅等级 | 公式改 `94+6×1 = 100`（乘数固定） | `S07-rates-costs-settle` 全部期望值 |
| D2 | `docs/06 §6.3` 楼层表 | 表头"开业所需**区等级**"（行 19） | 表头改"开业所需**市政厅等级**"：1/3/6/9 | 同左 | `S06c`、`S10f` |
| D3 | `docs/06 §6.5` 费用表 | `区行政 D→D+1 ceil(2100×1.45^(D−1))`（行 85） | **整行删除** | 整行删除 | `S06c-core-upgrades` |
| D4 | `docs/06 §6.6` 差异表 | 区行政增益 **+0.06**、基础费 **2100**（行 97–98） | 两行标注"v1.2 起乘数由市政厅推导，不再有独立费用" | 两行标注"v1.2 起常数 1.00，不随等级变化" | `docs/38` 契约候选清单 |
| D5 | `docs/06 §6.7` 上限 | 市政厅 L≤136 | **不变**（105 行仍成立）；补充"D 上限 = 1+floor((136−1)/5) = 28" | 补充"D 恒为 1" | 无 |
| D6 | `docs/09 §9.2` 字段 19 | `districtLevel` int 1..10000 | **保留字段**，语义改"由 L 推导的只读镜像"，校验范围不变 | 保留字段，语义改"遗留，载入忽略" | `S09/S10/S14` 存档样例 |
| D7 | `docs/09` 行 38 一致性 | "已开业要求 `districtLevel ≥ 2/4/6`" | 改为"已开业要求 `L ≥ 3/6/9`" | 同左 | `S09` 坏档样例 |
| D8 | `docs/09` 行 91 迁移 | v1/v2→v3 写 `districtLevel := 1` | 写 `districtLevel := 1 + floor((L−1)/5)`（L 取 `level`） | 写 `districtLevel := 1` | `S14` 迁移样例 |
| D9 | `docs/11` 调试接口 | 4 个事件清单，明确**不含**"设置区等级"（行 23） | **不变**（不新增、不删除事件；`UPGRADE_DISTRICT` 之外无区相关事件） | 同左 | 无 |
| D10 | `docs/12` 错误码 | `district-level-too-low`（行 40） | 保留码值，含义改"市政厅等级不足以开业"（避免协议破坏） | 同左 | `S12` 错误码样例 |
| D11 | `docs/13` 事件表 | `UPGRADE_DISTRICT` | **v1.2 起废弃**（不再产生）；旧回放若含此事件 ⇒ 忽略并计入 `debugTaint`？→ **建议直接拒绝** | 同左 | `S06c` 事件序列 |
| D12 | `docs/00` 行 31 | 市政厅产速 `R(L)=10×(1+0.20(L−1))`，"只有市政厅、无地、**区等级 1**、设施 0 时恒等" | **不变量保留**，但需注明"区等级不再恒为 1"；等价条件改为"L=1 且 D=1" | 条件仍成立（D 恒 1） | `S07-C-hall1..5` |

### 5.2 不变量（v1.2 必须继续成立的 6 条）

1. **单调**：任何合法动作不减少 `level/coinsMilli/totalGainMilli`（迁移覆盖 `districtLevel` 不属于"动作"，且不改变金币）。
2. **幂等**：迁移重复执行结果一致；`D*(L)` 是纯函数。
3. **防溢出 `docs/05 O1~O8`**：区费行删除不影响 O1–O8 的任何一条（它们针对买地/街区/等级费用），需在 R3e 修订记录里逐条打勾。
4. **确定性结算**：`settle` 不变（速率仍是整数毫币/分）。
5. **旧档可读**：v1/v2/v3 全部可读；v3 存档**键集不变**（24 键）。
6. **0.1 兼容**：`R(L)` 在 D=1 时等于 `10×(1+0.2(L−1))`（方案1c 在 L<3 时 D=1 成立；L≥3 后总产速高于 R(L)，属**预期变更**，必须写进修订记录而不是偷偷改）。

### 5.3 样例与门槛对照（实施时逐条改）

| 样例 | 涉及现值 | 方案1c 新值 | 方案2 新值 |
|---|---|---|---|
| `S06c-core-upgrades`（区行政升级事件链） | D1→D2 扣 2,100 | **样例整组作废**（动作不存在） | 同左 |
| `S07-rates-costs-settle`（产速/费用大数） | 按 D 计动力 | 按 `1+floor((L−1)/5)` 重算 | 按 ×1.00 重算 |
| `S09/S10`（存档往返与坏档） | `districtLevel` 独立值 | 与 L 自洽（`L6→D2`、`L16→D4`、`L26→D6`） | 必须为 1 |
| `S13`（调试 4 事件） | 无区事件 | 不变 | 不变 |
| `S14`（迁移） | `districtLevel:=1` | `:=1+floor((L−1)/5)` | `:=1` |

---

## 6. 风险与不可逆点

| # | 风险 | 触发条件 | 后果 | 可逆性 |
|---|---|---|---|---|
| **R1** | **乘数丢失导致后期规模缩水** | 选方案2 且不做补偿 | 三周末产速 −73%、累计收入 −70%；240 天末 60 天支出/收入跌到 92.9% | **可逆**（补 C1/C2/C3 或改选 1c） |
| **R2** | **回滚后"区等级显示回退"** | 新档在 0.3.2 打开 | 玩家看到 D 从 25 变 14（不崩溃、金额不变，但与记忆不符） | **不可逆**（schema 不许加字段，无法标记"已迁移"） |
| **R3** | **第 1 天内容被一次性解锁** | 阈值降到 L3/6/9 | 三栋楼 1 小时内开完，前 3 天只剩数值增长 | 可逆（阈值上调到 L4/8/12 即可，实测会推迟约 1.5~2 小时） |
| **R4** | 三周验收期"几乎无变化"导致改动被质疑 | 只用 21 天数据验收 | 区费占比从 4.44%→0，玩家体感差异小于解锁节奏差异 | 可逆（验收口径改为 60 天） |
| **R5** | 迁移发金币/发离线收益 | 实现时误清 `lastSettleTsMs` | 一次性补发巨额金币，**经济不可逆污染** | **不可逆**（必须靠断言拦截） |
| **R6** | 推导映射选太激进 | 选 1b（/2） | 三周末产速 +50%、累计收入 +63%，数字膨胀回潮 | 可逆（改一个常数） |
| **R7** | 市政厅 L 上限 136 成为新天花板 | 长线（>240 天） | 等级线在 L=136 封顶，之后只剩设施线 | 结构性，短期无感 |

**两个不可逆点必须在实施前加护栏：**
- **R2**：发布说明写清"降级后区等级显示回退"，或在客户端把该字段的展示名改为"城市规模"（语义脱钩，回滚时玩家不易对比）。
- **R5**：迁移单测必须断言 `coinsMilli / lastSettleTsMs / settleCount` 三个字段**逐值不变**。

---

## 7. 机主拍板清单（3 选 1）

| | **A · 方案1c（推荐）** | **B · 方案2（彻底删 D）** | **C · 方案1b（激进保留增长）** |
|---|---|---|---|
| 玩家看到什么 | 只剩"市政厅"一条线；门槛 Lv3/6/9 | 只剩"市政厅"；门槛 Lv3/6/9 | 只剩"市政厅"；门槛 Lv3/7/11 |
| 三栋楼开业 | **19 / 42 / 64 分钟** | 17 / 48 / 77 分钟 | 20 / 33 / 54 分钟 |
| 三周末产速 | 30,384/分（现状的 **65%**） | 12,447/分（**27%**） | 69,770/分（**150%**） |
| 三周末累计收入 | 5.33 亿（现状 70%） | 2.30 亿（30%） | 12.45 亿（163%） |
| 三周末最优可买项回本 | **19.2 天** | 88.3 天 | 68.8 天 |
| 区费 | 删除 | 删除 | 删除 |
| 契约改动 | 小：1 条推导式 + 3 个门槛 + 迁移 1 行 | 中：改产速公式本身 + 收益结构 | 小（同 A，只换常数 5→2） |
| 后续补偿 | **不需要**（240 天口径支出/收入 101.2%） | **必须**（C1/C2/C3 之一，否则后期缩水） | 不建议（通胀） |
| 主要风险 | R2 回滚显示回退、R3 第 1 天全解锁 | R1 规模缩水、R5 | R6 通胀回潮 |
| 一句话 | **少一层，力度刚好** | 最干净，但把后期砍到三分之一 | 看着爽，第三者周期就爆 |

**我的建议：选 A（方案1c）。** 理由按权重：①它满足机主"不要一层套一层"的全部诉求（玩家视野里没有区等级）；②它保住了 `(94+6D)` 这个已经存在的增长乘数，不用动 0.1 冻结公式；③它三周末仍有 19 天回本的选项，是五个方案里唯一"三周后还有东西可买"的；④补偿成本为零。

**A 之下的一个子决策（也请一并拍板）**：迁移用哪种口径——
- **A-1 `D_eff = max(存档值, 推导值)`（推荐）**：旧档不掉级、回滚不掉级、所有现有样例期望值不变（`S10-P04` 等继续合法）；代价是老玩家保留一个略高的永久乘数优势。
- **A-2 强制 `D := 推导值` + 已开业楼 grandfather**：D 严格纯推导、语义最干净；代价是 `S10-P04` 类存档要重造、回滚会让玩家"区等级掉级"观感差。

**若机主更在意"数字别膨胀"，那就选 A 但把映射换成 `/7` 或 `/8`**（三周末产速会更低，代价是后期更穷）——这是 A 的一个参数微调，不改变结构，建议实施时留成一个常数 `DIVISOR`，方便用一条命令扫参数。

---

## 8. 复跑与数据溯源

### 8.1 脚本

| 文件 | 作用 | 跑法 |
|---|---|---|
| `tasks-out/S-22/econ/analysis/lead-crosscheck.mjs` | Lead 独立复算（5 方案 × 21/240 天，确定性） | `DAYS=21 node lead-crosscheck.mjs`；`DAYS=240 node lead-crosscheck.mjs`；旋钮：`HORIZON`（回本阈值，默认不设限）、`FAC_MUL`、`BLOCK_MAX` |
| `frontend-rebuild-hm033-econ/tools/sim-economy.mjs` 等 | 子智能体 S1 的独立实现（对照用） | 见 `tasks-out/S-22/econ/sim/README.md` |

**确定性**：脚本无 `Math.random()`、无 `Date.now()`、无网络、无外部状态；同一环境变量下输出逐字节一致（校验：`for i in 1 2 3; do node lead-crosscheck.mjs | sha256sum; done`，三次相同，见 `analysis/自检.md`）。

### 8.2 数字 → 文件映射

| 本文数字 | 出处 |
|---|---|
| 开业分钟数、开业时金币/产速 | `analysis/x-open-minutes-21d.csv` |
| 21 天逐小时曲线（504 行 × 5 方案） | `analysis/x-curve-21d-21d.csv` |
| 第 15–21 天每小时收支 | `analysis/x-late-hourly-21d.csv` |
| 三周末末态（金币/产速/D/L/地/支出结构/最优可买项） | `analysis/x-day21-21d.csv` + `analysis/run-21d.log` |
| 240 天分期支出结构与区费占比 | `analysis/x-period-spend-240d.csv` |
| 240 天末 60 天支出/收入比 | `analysis/run-240d.log`、`x-comp-ratio-240d.csv` |
| 费用表（区费/等级/设施/街区/买地） | `analysis/cost-tables-precheck.txt`（与 S1 `sim/cost-tables.csv` 对照） |

### 8.3 策略假设（全部是假设，不是实测）

| 项 | 取值 | 说明 |
|---|---|---|
| 玩家在线 | 24 小时连续（离线结算等价于在线） | 0.1 冻结的离线算法只在"离线一次性结算"上不同，本仿真用逐分钟等价 |
| 投资策略 | **回本时间贪心**：每分钟把"最划算的可买项"买到买不动（每分钟最多 3 次） | 与 S-16 §2.3 同族；默认**不设**绝对回本阈值（= S-16 口径），另设 `HORIZON` 旋钮做"理性玩家"对照 |
| 买地顺序 | 固定取候选块中白名单序最靠前者 | 确定性；与实际点击顺序可能有差 |
| 宣传线 | 不买（无经济收益） | 与 S-16 一致 |
| 调试事件 | **不使用**（仿真直接构造状态，不走调试接口） | 不新增、不修改任何调试事件 |
| 随机性 | 无 | 地块类型队列用契约 `mulberry32(20261014)` 复刻 |

### 8.4 交叉验证（两套独立实现）

| 指标 | 本提案脚本（24/7） | S1 脚本（15 分钟/天，`sim/`） | 一致性 |
|---|---|---|---|
| 21 天末产速 BASE | 46,600/分 | 49,345/分 | 同量级（−5.6%） |
| 21 天末产速 P1 | 30,384/分 | 29,065/分 | 同量级（+4.5%） |
| 21 天末产速 P1b | 69,770/分 | 63,061/分 | 同量级（+10.6%） |
| 21 天末产速 P2 | 12,447/分 | 12,909/分 | 同量级（−3.6%） |
| **方案排序** | 1b > BASE > 1 ≈ 1c > 2 | 1b > BASE > 1 > 2 | **完全一致** |
| 240 天区费占比 | 30.8% | **20.118%**（≈ S-16 的 21.9%） | 同量级，S-16 结论被复现 |
| 开业分钟数（BASE 第 1 栋） | 297 分 | 114 分（cont 画像） | 画像不同（24/7 vs 分段在线），序不变 |

> 差异全部来自**玩家画像**（在线时长分布）与**投资策略细节**，不是公式实现差异——S1 另外用 esbuild 把 `src/core` 真实实现打包到 `/tmp` 做了 4,254 项逐值对照（0 失败），证明"公式层无分歧"。结论对拍板不敏感：所有方案的**排序**在两套实现下一致。

### 8.5 自检结果（本任务要求的 3 项）

| 自检项 | 做法 | 结果 |
|---|---|---|
| ① 仿真连跑 3 次结果一致 | `for i in 1 2 3; do node lead-crosscheck.mjs \| sha256sum; done` | 三次同为 `7a4c68ae…d0e9c`；CSV（`x-day21.csv`/`x-curve-21d.csv`）三次哈希也全同 |
| ② `node --check` 所有新脚本 | 本提案脚本 + S1 的 4 个 `sim-economy*.mjs` | 5/5 通过 |
| ③ 每个数字可指到脚本输出行 | 见 §8.2 映射表 + `analysis/spotcheck.txt` | 抽查：`C(1..5)=20/25/30/37/45`、`costDistrict(1..6)=2100…13461`、仅市政厅 L1/D1/F0 ⇒ 10,000 毫币/分 = 10 金币/分，三项与契约原文逐值相符 |

### 8.6 已知偏差

- 仿真把"1 分钟"当成"玩家在线 1 分钟"，没有建模点击间隔/滑动窗口操作上限（只加了 3 次/分上限），实际真人的支出速度会更慢，**三周曲线会整体右移**。
- 未建模广告/内购/活动/声望的经济作用（0.3.2 里声望本身无金币产出）。
- 上升节奏的拐点对"等级线 vs 设施线"的相对优先级敏感（贪心策略下二者交替），不同策略下第 21 天产速可能相差 ±15%。
