# S-19 改数流程（经济参数安全变更手册）

> 目标：以后真要把「默认经济数字」从 0.3.0 的冻结值改成新值时，有一个可复现、可回滚、
> 不破坏契约/回归/指纹的固定流程。**0.3.0 本轮不执行任何改数**（只留流程）。
> 严禁改：0.1 冻结数字、契约 v1.1 已冻结数值、`contract-0.2-R3-FROZEN-v1.1.tar.gz`（只读）。

## 0. 先决条件

1. 先读 `经济参数地图.md`，确认要改的数属于“单一来源”的哪一行；**一次只改一个来源**。
2. 确认版本号：改数必须升 minor（0.3.0 → 0.4.0 或 0.3.x 内单点修，按项目惯例）。
3. 从 `frontend-rebuild-hm023` 的干净副本开工；`hm023` 永远是 0.2.4 回滚锚点，不许动。

## 1. 标准步骤（以“改 b0/B”为例）

| # | 动作 | 命令/文件 |
| --- | --- | --- |
| 1 | 改唯一来源 | `src/core/rates.ts` `BUILDINGS` 的 `b0`/`base`/`openLevel` |
| 2 | 同步文档表 | 本目录 `经济参数地图.md` §1 数值列（只改数字，不改结构） |
| 3 | 重算指纹期望 | `src/game/fingerprints-s19.ts` 里 `rates` 键的固定输入与期望串（若输入依赖 b0） |
| 4 | 重算验收断言 | `test/t-s19.mjs` 中 A04/C01/C11（地价）、D08（2100）、D11/E03（精确式）等**期望数字**；只许改期望值，**不许放松断言结构** |
| 5 | 重算契约 fixtures | `npm run test:fixtures`；若契约 06 产速表有冻结值 → 需契约新版本，本轮只读旧契约，不能就地改 |
| 6 | 编译 + 全量回归 | `npm run build && npm run scan:formal && B1_PACK_DIR=/vol1/ai/projects/wyszz-new/template-quickstart-pack npm run regress` |
| 7 | 记录 | `tasks-out/<新版本>/进度.md` 追加「改数单点 + 旧值→新值 + 影响的断言」；总报告写“完成度” |

## 2. 改“地价表”的额外步骤

1. 生成新 `land_config_v3.json`（78 项严格递增正整数）→ 新版本号 `land_config_version: 4`（示例）。
2. `src/core/config.ts` 的 `ConfigTable` 增加新版本映射；旧版本仍保留（老存档可读）。
3. 更新契约 fixtures 里按版本给的价格样例；`t-land` 的 L15 期望同步。
4. `priceCoins` 只需 `N` 与坐标，禁止在 UI 重算；`session.quote/bulkBuyPlan` 自动跟随。

## 3. 熔断与回滚

- 任一步失败 >20 分钟：记录失败点 + 降级方案，回滚到改数前的备份（`tasks-out/<版本>/hm03-开工备份.tgz`）。
- 指纹校验失败 → **停止发布**，按 `tools/fingerprints` 的差异打印逐个核对；不许“改期望让它过”来掩盖排版/接线错误。
- 正式包 `scan:formal` 必须 PASS（0 调试残留）；不 PASS 不得交付。
- 四包 `sha256sum -c` 全绿才可发下载链接；任何一包对不上按“未完成”处理。

## 4. 本轮（S-19）实际执行情况

- 改动经济数字：**0 处**（`git`/`diff` 口径：`src/core/rates.ts`、`src/core/config.ts`、`src/core/data/*.json` 均未改）。
- 新增“只读展示”函数 `buildingMilli`（\u6beb币/分，逐楼贡献），明确注释“不参与判定、不改变公式”，
  并纳入 S-19 指纹 `rates` 键做变异锚点；这是“为改数铺路”，不是改数。
- 数值总览（内部包调试面板）只读展示四栋楼 b0/L/F/A/贡献、区 D/增益/下一价、街区单价，无任何改值入口。
