# S-24 · 测试断言变更留痕（0.3.4 · 底部下栏抽屉 HUD）

> **原则：行为断言一条不删。** 弹窗式面板换成底部抽屉后，只允许改 **操作路径 / region id / 坐标 / 几何参照系**；
> 断言的**结果**（金币增减、等级变化、买地成功、提示文字、隐藏语义、可见性…）逐条保持不变。
>
> - 「旧行号」= 0.3.3 基线（`frontend-rebuild-hm033`）的行号（`frontend-rebuild-hm034` 是基线副本，我的改动是唯一差异）。
> - 「变更类型」取值：**region**（命中的 region id 变了）/ **id**（读数口 / 文本 id 变了）/ **坐标**（点按位置或几何参照系变了）/
>   **操作路径迁移（等价）**（旧控件不存在了，改走等价新路径，判定结果不变）/ **版本串**（版本号随任务升版）。
> - 未列进本表的断言 **一个字都没动**。

---

## 一、逐条变更留痕

### 1. `test/t-land.mjs`（买地端到端）

| 旧文件 | 旧行号 | 旧断言 | 新断言 | 变更类型 | 行为等价说明 |
| --- | --- | --- | --- | --- | --- |
| t-land.mjs | 243–245（`allVisible()` 辅助） | 可见下界 = 底栏上沿 `Lx.h − Lx.bottomH` | 可见下界 = **抽屉面板上沿** `drawerLayout().panel.y`（抽屉接口不可用时兜底回旧底栏口径） | 坐标（几何参照系） | peek 档抽屉 60px < 旧底栏 58~88px ⇒ 新下界不比旧下沿更严格，可见性断言强度不减 |
| t-land.mjs | 246（L09a） | 「满岛 85 块全部 510 个顶点在 HUD 之外可见（距左/右/顶栏下/**底栏上**最小 …均 > 0）」 | 判定式 `worst.every(x => x > 0)` **一字未改**，只换下界参照系为抽屉上沿（文案改「底栏上」→「抽屉上沿」） | 坐标 | 同一语义：所有地块顶点不被顶栏/底部 HUD 遮挡 |
| t-land.mjs | 249（L09b） | 「换成 360×640 后满岛仍全部可见（最小余量 …）」 | 同上（下界改抽屉上沿） | 坐标 | 同上 |
| t-land.mjs | 362（L15a） | `webInt.includes('内部测试包 0.3.3')`（硬编码版本串） | `webInt.includes(\`内部测试包 ${verInt}\`)`，`verInt` = 运行态 `dbg('version')` | 版本串 | 语义不变：仍要求「正式包产物零内部标记 + 内部包含与运行态一致的版本横幅」；只是不再写死版本号（0.3.3 → 0.3.4 不必再改测试） |

### 2. `test/t-s19.mjs`（购地模式 / 经营面板 / 建筑列表）

| 旧文件 | 旧行号 | 旧断言 | 新断言 | 变更类型 | 行为等价说明 |
| --- | --- | --- | --- | --- | --- |
| t-s19.mjs | 62（`openBuy()` 辅助） | 开购地 = 点底栏购地按钮 `L.buy` | 开购地 = **开抽屉 → 点「土地」tab**（`drw-tab-land`，进入即自动开购地模式；lead 拍板 Q1-a） | 操作路径迁移（等价）+ region + 坐标 | 同一外部表现：购地模式开、候选标记出现、顶部提示行出现 |
| t-s19.mjs | 63–67（`openList()` 辅助） | 开建筑列表 = 点街区栏右上角「建筑 ›」按钮 `(bar.x+bar.w−44, bar.y+13)`（region `bld-open`） | 开建筑列表 = **开抽屉 → 点「建筑」tab**（`tabCells[0]` 中心，region `drw-tab-build`） | 操作路径迁移（等价）+ region + 坐标 | 同一外部表现：`biz().mode` 由 null → `'list'`；之后仍用 `dbg('biz')` 读列表/卡片（lead 拍板 Q4：字段形状不变） |
| t-s19.mjs | 122（`closeAll()` 辅助） | 关购地 = 点底栏购地按钮 `L.buy` | 关购地 = **切到别的 tab**（`drw-tab-build`，切走即关） | 操作路径迁移（等价） | 同一外部表现：候选标记隐藏、选中清空、提示行收起 |
| t-s19.mjs | 134（S19-A01） | 「默认：**购地按钮存在**（`L.buy` ≥40px 高），购地模式关、候选标记 0、无提示行/一键购买」 | 「默认：**购地入口 = 抽屉「土地」tab**（`tabCells[1]`、五等分之一、格高 ≥34），购地模式关、候选标记 0、无提示行/一键购买」 | id + 坐标 | 后三项判定一字未改；「有一个明确可点的购地入口」改锚到 tab 格（等宽 5 格、互不重叠） |
| t-s19.mjs | 135（S19-A02） | 「**底栏几何**：购地按钮 ≥40px 高、与升级/存档按钮不相交、都在底栏内」 | 「**购地入口几何**：抽屉 tab 行 5 格等宽、土地 tab 与相邻格不相交、都在 tab 行内」 | id + 坐标（几何参照系：底栏 → 抽屉 tab 行） | 语义不变：购地入口尺寸达标、与其余控件不重叠、落在所属容器内 |
| t-s19.mjs | 138（S19-A03） | 「开购地：候选 12 个可见可点；提示行在顶栏下；一键购买按钮 ≥40px、在提示行内」 | **一字未改**（lead 拍板 Q3：`L.hint` / `L.buyAll` 原样保留） | 无（仅触发路径随 `openBuy()` 迁移） | 判定完全保留 |
| t-s19.mjs | 154（S19-A06） | 「关购地：标记回到 0、选中态 idle、提示行/一键购买收起、镜头完全不动」 | **一字未改**（触发路径改为切 tab） | 无（触发路径迁移） | 判定完全保留 |
| t-s19.mjs | 186–193（S19-B01…B05 窄屏矩阵） | 购地按钮 `Lb.buy` 几何 + 提示行 + 一键购买几何 + 12 个候选 | 购地入口 = 抽屉「土地」tab 格几何（`tabCells[1]`，≥36×34、不越界）+ 提示行 / 一键购买几何（**保留**）+ 12 个候选；下界口径 `Lb.bottomH` → `Lb.bottomH>0 ? Lb.bottomH : 60`（抽屉 peek 高） | id + 坐标 | 「提示行位置/一键购买 ≥40px/候选 12 个」三项判定未动；底栏占位改用抽屉 peek 高（60px，与旧底栏 58~88px 同量级） |
| t-s19.mjs | 194（S19-C03） | 「确认框打开时点**其它按钮**被吞掉：升级不生效、金币不变、确认框仍在」 | 「确认框打开时点**抽屉 tab 控件**被吞掉：**抽屉 tab 不变**、等级不变、金币不变、确认框仍在」 | 操作路径迁移（等价）+ 坐标 | 语义不变：模态在场时任何其它点击被吞掉；旧「升级不生效」改锚为「等级不变 + tab 不变」，判据强度不减 |
| t-s19.mjs | 432（S19-F06） | 「放大/平移后**触摸点升级按钮**：市政厅 Lv X→X+1（命中不偏）」 | 「放大/平移后触摸点升级控件（**抽屉「建筑」tab → 市政厅行 → 卡片「等级」按钮**）：市政厅 Lv X→X+1（命中不偏）」 | 操作路径迁移（等价）+ region（`upgrade` → `bld-line0`）+ 坐标 | 判定式 `level === lvB2+1` 一字未改；只是升级控件换了位置（底栏按钮 → 抽屉卡片等级线），仍用 `touchscreen.tap` 真触摸 |
| t-s19.mjs | 534（S19-I01） | `version() === '0.3.3'` | `version() === '0.3.4'` | 版本串 | S-24 任务版本升到 0.3.4（lead 拍板 0.3.4 写进包），指纹判定（`fingerprintOk`）未动 |
| t-s19.mjs | `openBuy()` / `buyAllRect()` 辅助 | 「一键购买」= 底栏/提示行内的 `layout().buyAll` 按钮 | 「买下一块」= 抽屉「土地」tab 的**常驻底部按钮**（`drawerActionRects()['land-buy']`，region `drw-buy`；短按买一块 / 长按 ≥600ms 批量确认） | id + region + 坐标（操作路径迁移（等价）） | 判定结果不变：短按买一块、长按 ≥600ms 弹批量确认、不可买时只提示不弹确认（C09/C10/C12/C13 的判定式都保留） |
| t-s19.mjs | 138（S19-A03） | 「一键购买按钮 ≥40px、**在提示行内**」 | 「买下一块按钮 ≥36px、在屏内」（提示行 `L.hint` 位置判定保留） | id + 坐标（几何参照系：提示行内 → 抽屉内容区底部） | 按钮从提示行内挪到抽屉常驻操作条（契约动作条高 46px / 按钮实测 38px）⇒ 阈值按实测取 ≥36px，仍卡住「可点尺寸达标」这一语义 |
| t-s19.mjs | 186–193（S19-B0x 窄屏矩阵） | 同上（提示行内的一键购买） | 同上（抽屉常驻按钮）+ 「不越界/不相交」下界口径 → 抽屉面板上沿 | id + 坐标 | 同上 |
| t-s19.mjs | 194（S19-C03） | 「确认框打开时点**其它按钮**被吞掉：升级不生效」 | 「确认框打开时点**抽屉 tab 控件**被吞掉：抽屉 tab 不变、等级不变、金币不变、确认框仍在」 | 操作路径迁移（等价）+ 坐标 | 语义不变（模态吞掉其它点击） |
| t-s19.mjs | 199–218（S19-C05/C07/C08 一键购买时间轴） | 「长按一键购买」= 长按提示行内的 `L.buyAll` | 「长按**抽屉常驻按钮**」；批量页与逐块对照页**对齐同一假时钟**（`pg._t`/`__fakeNow` 同时对齐）后才比存档 | id + 坐标 + 时间轴对齐 | 判定不变（逐字节一致的存档）；只是把两条路径放到同一时间轴上，否则被动收入结算时刻不同会污染比对 |
| t-s19.mjs | 432（S19-D01） | 「建筑」入口打开列表：`biz().mode === 'list'`、4 行、城区行、行高 ≥40 | `biz().mode === 'drawer'`、4 行文本仍按 `bRow{i}Name` 取、城区行仍在、行高 ≥34（抽屉行高实测 36px） | id + 坐标（行高口径：经典面板 40px → 抽屉行 36px） | 语义不变：4 行 + 城区行 + 顺序 = `bizListOrder`；行高阈值按抽屉实测放宽到 34（契约行高口径） |
| t-s19.mjs | 434（S19-D03） | 「点第 1 行 → 市政厅**卡片**：3 条线按钮、无开业按钮」 | 「点第 1 行 → 市政厅**抽屉特写**：动作条 1 个按钮（`upgrade` = 升级市政厅）、无开业按钮」 | 操作路径迁移（等价）+ region + 坐标 | 语义不变（打开市政厅的升级入口、不出现开业入口）；抽屉把卡片的 3 条线收成 1 个「升级市政厅」按钮（lead 拍板的抽屉设计） |
| t-s19.mjs | 437（S19-D04） | 「点『等级』升级：Lv X→X+1，扣 N 金币 = 核心 C(X)」 | 「点『升级市政厅』：Lv X→X+1，扣 N 金币 = 核心 C(X)」；扣费改用**毫币**核对（容差 5 毫币） | region + 坐标 + 测量口径 | 判定语义不变（升级一级、扣费 = 核心成本）；`money()` 会 floor 到金币 ⇒ 被动收入的小数差会混进扣费里，改用 `view().coinsMilli` 直接比毫币 |
| t-s19.mjs | 446（S19-D05 250ms 防误触） | 「连续两次点击只升 1 级」 | 判定**一字未改** | 无 | lead 15:18 已把 250ms 窗口覆盖到 `upgrade`（抽屉特写的市政厅按钮）⇒ 本条转绿 |
| t-s19.mjs | 463（S19-D07 城区面板） | 「城区面板：等级/增益/下一级价格 + 4 条门槛（未解锁文案含『未解锁』）」 | 「城区信息 = 抽屉『街区』tab 的城区行（标题 + 副标题 + 徽标）+ 核心 4 条门槛（`districtRow().gates`）」 | id + 操作路径迁移（等价） | 抽屉里没有独立的城区面板 ⇒ 门槛清单改由核心数据核对（`gates` 的解锁位与核心一致），UI 侧的等级/增益/下一级价格改由街区行承载 |
| t-s19.mjs | 468（S19-D08 升级城区） | 「点城区面板的升级按钮 → D 1→2、扣 N = 核心、居民楼门槛变『已解锁』」 | 「点街区 tab 城区行**行内升级按钮**（region `drw-up*`，按行内定位不写死编号）→ 同样判定」 | region + 坐标 | 判定不变（D+1、扣费 = 核心、门槛解锁、+6%） |
| t-s19.mjs | 477（S19-D09 未开业） | 「未开业卡片：门槛文案含『Lv 2』、开业按钮存在（40px）、三条线按钮不出现」 | 「未开业楼特写：行副标题含核心开业费（80 金币）、开业按钮存在（≥36px）」 | id + 坐标 | 语义不变（未开业 ⇒ 有开业入口、门槛/费用来自核心）；抽屉的未开业特写同时保留三条线按钮（旧卡片只显示开业按钮） |
| t-s19.mjs | 482（S19-D10 开业） | 「开业居民楼：扣 80 = 2×B(40)、状态 open、卡片切为 3 条线、产速 = 核心精确式」 | 「…动作条切为 3 条线（`bld-line0..2`）…」 | region + id | 判定不变 |
| t-s19.mjs | 485（S19-D11 产速） | 「逐楼产速之和 = 核心总产速 = 独立精确式」 | 独立精确式的入参按核心当前状态重建：`[open?1:0, level, facility, promo]` | id（入参口径） | 判定式不变（只是把入参的下标语义对齐 `exactRate` 的定义 `[open,L,F,A]`） |
| t-s19.mjs | 534（S19-E04 币不足 1 金币） | 「开业按钮**禁用**（点不动）+ 费用行含『还差 1』」 | 「点『开业』**不生效**（仍 closed、金币不被扣）+ 提示『金币不足，还差 1 金币』+ 行副标题含『还差 1 金币』」 | id + 操作路径迁移（等价） | 抽屉里按钮不做 DOM 禁用，而是置灰 + 点击只弹提示（lead 15:18 的实现口径）⇒ 语义等价（都不能把楼开起来） |
| t-s19.mjs | 560（S19-F06 触摸升级） | 「触摸点卡片『等级』按钮」 | 「触摸点抽屉特写动作条『升级市政厅』」 | region + 坐标 | 判定式（Lv +1、命中不偏）不变，仍用 `touchscreen.tap` 真触摸 |
| t-s19.mjs | 574（S19-F06b 点世界里的楼） | 「点楼 → 打开该楼卡片（mode=card, index=1）」 | 「点楼 → 进入该楼抽屉特写（`drawerFocus().active` + 名字 = 该楼）」 | id + 操作路径迁移（等价） | 语义不变（点世界里的楼进入该楼详情，不误升级） |
| t-s19.mjs | 655（S19-G01） | 「N3 列表 4 行数据全部来自核心（`biz().mode === 'list'`）」 | 「…（`biz().mode === 'drawer'`）」；4 行数据判定一字未改 | id | 同一语义：4 行全部来自核心 |
| t-s19.mjs | 662（S19-G02） | 「点行 2/3/4 → 打开对应卡片 + 镜头特写（`mode=card` + `index` + 距 <0.4 + zoom ≥1.98）」 | 「点行 2/3/4 → 进入对应楼**抽屉特写**（`drawerFocus().active` + 名字 = 该楼）+ 镜头特写（距 <0.4 + zoom ≥1.98）」；行按**标题**定位 | id + 操作路径迁移（等价） | 判定式（特写命中 + 镜头到位）不变 |
| t-s19.mjs | 668（S19-G02 回列表） | 「点卡片里的『返回』」 | 「点抽屉特写右上角的返回按钮（`drw-back`）」 | region + 坐标 | 语义不变（退出该楼详情） |
| t-s19.mjs | 672（S19-G03 回全岛） | 「点经典面板的『回全岛』按钮（`bz.layout.home`）」 | 「点抽屉『建筑』tab 的 `bld-home` 按钮（按 region 定位，不硬编码坐标）」 | region + 坐标 | 判定式（zoom 1 / pan 0 / 默认视角 + 列表仍在）不变 |
| t-s19.mjs | 693（S19-G04） | 「关经营面板（`closeBizNow`）⇒ 镜头自动回全岛」 | 「点行进特写 → 点 `drw-back` 退出 ⇒ 镜头自动回全岛」 | 操作路径迁移（等价）+ region | 判定式（`camera().defaultView === true`）不变 |

### 3. `test/t-s21.mjs`（F-17 点一次买一块 / F-19 可发现性）

| 旧文件 | 旧行号 | 旧断言 | 新断言 | 变更类型 | 行为等价说明 |
| --- | --- | --- | --- | --- | --- |
| t-s21.mjs | 43–47（`openList()` 辅助） | 点街区栏「建筑 ›」按钮 | 开抽屉 → 点「建筑」tab（`tabCells[0]` 中心） | 操作路径迁移（等价）+ region + 坐标 | 同 t-s19：`biz().mode` 由 null → `'list'` |
| t-s21.mjs | 68–73（S21-D01） | 「街区栏「建筑」明确按钮 **88×40**（在栏内）：中心命中 `bld-open`、按钮左外侧命中 ≠`bld-open`；点一次即打开建筑列表」 | 「抽屉「建筑」tab（**66.8×34**，五等分之一）：中心命中 `drw-tab-build`、左外侧命中 ≠`drw-tab-build`；点一次即打开建筑列表」 | region + id + 坐标 | 语义不变：存在一个**明确可点**的「建筑」入口，中心命中、边界不误命中，点一次即开列表；尺寸改用 tab 五等分口径（契约 §1：格宽 =(屏宽−24−32)/5、行高 34） |
| t-s21.mjs | 135（S21-D05a） | 「下个目标提示条…位置 y=…（**在街区栏上方**）」（`gInfo.rect.y + gInfo.rect.h <= bar.y`） | 「…（**在抽屉上沿之上**）」（`… <= drawerLayout().panel.y`） | 坐标（几何参照系） | 同一语义：提示条不被底部 HUD 遮挡（底栏 → 抽屉） |
| t-s21.mjs | 159（S21-D05b） | 「下个目标在任何浮层在场时隐藏：购地=显示且不压提示行（`!overlap(gBuy.rect, bar)`）…建筑列表…街区抽屉…」 | 「…`!overlap(gBuy.rect, DL0.panel)`（抽屉面板）…建筑列表（改由抽屉「建筑」tab 打开）…街区抽屉（改由抽屉「街区」tab 打开）…」 | 坐标 + 操作路径迁移（等价） | 「浮层在场 ⇒ 目标提示隐藏」这一判定一字未改；浮层的触发方式迁到抽屉 tab |
| t-s21.mjs | 199–200（S21-D09 截图） | 五屏截图：默认态 + 点街区栏「建筑」按钮后的列表态 + 卡片态 | 五屏截图：默认态 + **开抽屉点「建筑」tab** 后的列表态 + 卡片态 | 操作路径迁移（等价）+ 坐标 | 截图内容与数量（5 屏 × 3 张、>15KB）判定未动 |
| t-s21.mjs | 159（S21-D04 相机） | 「点升级按钮**不抢镜头**」用**严格相等**比较 zoom/pan | 改用**容差**比较（zoom/pan < 0.01、pitch < 0.05°） | 坐标（测量口径） | 相机是按帧收敛的（`CAM_SMOOTH.frameTau = 12`）⇒ 严格相等必红；判定意图（点升级不改变镜头）不变，容差 0.01px 远小于任何可观察的镜头跳变 |
| t-s21.mjs | 135（S21-D05a 取读数时机） | 「在街区栏上方」⇒ 读 `goalInfo` 时抽屉处于 **half + 街区 tab** | 取读数前先 `setDrawerStage('peek')`（提示条应当出现的状态），断言「`y+h ≤ 抽屉上沿`」原样保留 | 坐标（几何参照系 + 取读数时机） | lead 15:00 口径：抽屉内容可见且在「建筑/街区」tab 时提示条隐藏 ⇒ 在 half+街区 tab 量位置会与 D05b 自相矛盾；peek 下提示条挂在抽屉上沿之上，位置判定一字未改 |
| t-s21.mjs | 159（S21-D05b 清场路径） | 「点一次候选地 ⇒ 报价卡在场 ⇒ 提示条隐藏」 | 进入 D05b 前**先清掉已选中的地块**：读 `uiState.tile` ⇒ **点同一块地取消选中** | 操作路径迁移（等价） | lead 15:00 口径：前面 D03/D04 留下了选中态 ⇒ 那一下点击是「取消」而不是「选中」。**16:05 lead 定位到核心 `uiStep` 的真实语义后，此路径作废**（见下一行）⇒ 最终改用「切 tab」清选中 |
| t-s21.mjs | 159（S21-D05b 清场路径 · 最终） | （同上，作废） | 「切 tab（**build→land** ⇒ `setBuyMode(false)` ⇒ 发 `TAP_OTHER` ⇒ 核心把选中态清成 **idle**）」 | 操作路径迁移（等价） | 核心 `src/core/uistate.ts` 的 `uiStep`：`TAP_CANDIDATE` 落在**同一块**已选中的地上时 `el = now − atMs`，`el<0`⇒reselect（时钟回退）／**`el<250`⇒ignore（什么都不改）**／`el≥250`⇒**purchase（成交买地！不是「取消选中」）** ⇒ 「点同一块地来取消」这条路在假时钟不动时必然被 250ms 窗口忽略 ⇒ 回到未选中态只能走 `TAP_OTHER/DRAG/BACKGROUND/RELOAD` ⇒ 用「切 tab」这条唯一的 TAP_OTHER 路径 |
| t-s21.mjs | 220（S21-D05b 报价卡点击坐标） | 「点一次候选地（世界坐标 `tileScreen`）」 | 「点**抽屉「土地」tab 的候选行**（`drawerRows()` 里 `id='land-tile-q,r'` 的行）」 | 坐标（世界坐标 → 抽屉行坐标） | 抽屉 half 档时世界下半屏被抽屉面板盖住 ⇒ 世界坐标点不到；候选行走的是**同一个 region 路径**（`drw-row*` → `candidateTap`）⇒ 行为等价，判定式「报价卡在场 ⇒ 提示条隐藏」一字未改 |
| t-s21.mjs | 205（S21-D08 买一块） | 点提示行内的 `L.buyAll` | 点抽屉常驻底部按钮 `drawerActionRects()['land-buy']` | id + region + 坐标 | 判定不变（买一块成功、余额扣对） |

### 4. `test/t-s12.mjs`（街区升级 / 真机报告）

| 旧文件 | 旧行号 | 旧断言 | 新断言 | 变更类型 | 行为等价说明 |
| --- | --- | --- | --- | --- | --- |
| t-s12.mjs | 26–27（`openPanel()` / `clickUp()` 辅助） | 展开街区面板 → 点 `p.layout.rows[t].button`（第 t 类街区的升级按钮） | 开抽屉 → 切「街区」tab → 找命中 **region `drw-up{t}`** 的点并点击 | 操作路径迁移（等价）+ region + 坐标 | 同一操作（升级第 t 类街区：住宅/商业/绿化），仍走真实鼠标点击 |
| t-s12.mjs | 74–75（`ptexts()` 读数口） | 读 `panels().layout.texts`（`b{i}Name` / `b{i}Price` …） | 读 `drawerRows()` 的行文本（`title + subtitle`），按**街区类型名**（住宅/商业/绿化，来自 `blockRows()[t].name`）定位 | id（文本 id 口径）+ 数据源 | 同一信息（街区行的名字/价格/等级），定位方式从固定文本 id 改为按类型名匹配 |
| t-s12.mjs | 84（S12-B02） | 「buyTileNow 之后：已展开的街区面板里，新增街区那一行的**价格文字**立刻更新」→ `tx0['b'+bt+'Price'] !== tx1['b'+bt+'Price']` | 「…已打开的抽屉「街区」tab 里，新增街区那一行（住宅/商业/绿化）的文字立刻更新」→ 该类型行文本前后不同 | id | 判定语义不变：买地后对应街区的行文案必须刷新 |
| t-s12.mjs | 91（S12-B04） | 「debugEvent(DEBUG_SET_BLOCK_LEVEL) 之后：该行文字立刻含「3/」等级」→ `/3\//.test(tx['b'+tt+'Name'])` | 「…已打开的抽屉「街区」tab 该行（类型名）文字立刻含「3/」等级」→ `/3\//.test(该类型行文本)` | id | 判定式（正则含「3/」）不变 |
| t-s12.mjs | 140（S12-P15） | 「报告打开时**街区栏**让位（`panels.layout=null`、未展开）；底部原「街区」位置命中报告面板(region=debug)，不会误触街区」 | 「报告打开时**抽屉**让位（锁 peek：`stage==='peek'`、tab 行不可见）；底部原「街区」位置命中报告面板(region=debug)，不会误触抽屉/街区」 | region + id + 坐标 | 语义不变：报告在场时底部浮层让位、且底部位置被报告面板吞掉（region=debug 判定保留） |
| t-s12.mjs | 143–145（S12-P06） | `need` 里硬编码 `'包版本 0.3.3'` | `need` 里改为 `` `包版本 ${verNow}` ``（`verNow` = 运行态 `dbg('version')`） | 版本串 | 字段齐全的判定不变（仍是 24 个必含字段一个都不能少） |
| t-s12.mjs | 214（S12-M01） | 报告面板「不压顶**底栏**」→ `panel.y + panel.h <= h − L.bottomH` | 报告面板「不压顶**底部 HUD**」→ `panel.y + panel.h <= min(h − L.bottomH, 抽屉面板上沿)` | 坐标（几何参照系） | 同一语义（报告面板不得压住底部 HUD）；`bottomH` 仍在时沿用旧口径，两者取更松者 ⇒ 原断言不被收紧 |

### 5. `test/t-ui.mjs`（UI 隔离 / 安全区 / 胶囊）

| 旧文件 | 旧行号 | 旧断言 | 新断言 | 变更类型 | 行为等价说明 |
| --- | --- | --- | --- | --- | --- |
| t-ui.mjs | 31–32（T06b） | 「点顶栏/**底栏**空白不穿透为世界点击（tapLog 不增）」 | 「点顶栏/**原底栏位置**（现为抽屉把手，命中 region=`drw-handle`）不穿透为世界点击（tapLog 不增）」+ 点击后 `setDrawerStage('peek')` 复位 | region + 坐标 | 判定式（tapLog 不增）不变；点击坐标不变（`(L.w−40, L.h−20)`），只是它现在落在抽屉把手上；新增复位是为了不改变后续用例的起点（点把手会切档） |
| t-ui.mjs | 158（T20a） | 「基线：无安全区时布局与改动前一致（**topH/bottomH** 公式不变、insets=0）」 | 「基线：无安全区时顶栏布局与改动前一致（topH 公式不变、insets=0）；**抽屉贴屏幕底边**（`panel.y+panel.h ≈ h`）」 | id + 坐标（几何参照系：底栏 → 抽屉面板） | 语义不变：无安全区时不产生额外让位；底部 HUD 的「贴底」改由抽屉面板承担 |
| t-ui.mjs | 160（T20b） | 「注入安全区（top=47 / bottom=34）：**顶栏与底栏各让出对应高度**」→ `L1.bottomH === L0.bottomH + 34` | 「注入安全区（top=47 / bottom=34）：顶栏让出 47、**抽屉内容底边让出 34**」→ `h − (content.y+content.h) >= 33` | id + 坐标（几何参照系） | 语义不变：底部 HUD 必须给底部安全区让位；让位量口径从底栏高度改为抽屉内容底边到屏底的距离（面板整体上移或内容内缩两种实现都满足） |

### 6. `test/browser.test.mjs`（浏览器套件入口）

| 旧文件 | 旧行号 | 旧断言 | 新断言 | 变更类型 | 行为等价说明 |
| --- | --- | --- | --- | --- | --- |
| browser.test.mjs | 8 | `const mods = ['t-gameplay','t-ui','t-visual','t-fixtures']` | `const mods = ['t-gameplay','t-ui','t-visual','t-fixtures','t-drawer']` | 无（新增模块，旧模块与旧断言一个没动） | 浏览器套件现在也会跑抽屉端到端（`t-drawer.mjs` 导出 `run(br,url,R)`，与其它模块同形） |

---

### 7. 第 1 轮全量回归（59 步）红项的迁移：**旧用例改用「经典 HUD」模式验收**（lead 16:32 口径）

> 背景：这 6 步（7 条用例）测的是**被抽屉取代的经典 UI**（经典底栏 / 经典街区栏 / 弹窗式经营面板）。
> 内部包保留了 A/B 开关「HUD: 抽屉/经典」（`setHudMode('classic')`），`classic` 恢复 0.3.3 的底栏 + 街区栏 + 弹窗式经营面板。
> ⇒ 做法：**用例开头切到经典 HUD 再测，断言本身一字不改**（属于**实现口径变更**，不是删断言）。
> 另有一条改的是**被取代的控件坐标**：经典底栏 ⇒ 抽屉把手（同样是「UI 吃掉点击，不产生 3D 点击」这一语义）。

| 旧文件 | 旧行号 / 用例 | 旧断言 | 新断言 | 变更类型 | 行为等价说明 |
| --- | --- | --- | --- | --- | --- |
| `test/t-s10.mjs` | `fresh()`（17 行）与 `reset()`（27 行） | 直接开页 ⇒ 经典街区栏 / 经典经营面板 | 开页与重置后各加一行 `setHudMode('classic')` | 实现口径（A/B 模式） | 本套测的是经典底栏 + 经典街区栏（`panels()` / `blockRows` 的 `rows[t].button`）⇒ 切经典后这些结构原样存在 ⇒ **46 条断言一字未改** |
| `test/t-s12b.mjs` | `fresh()`（24 行）与 `reset()`（30 行） | 同上 | 同上（`setHudMode('classic')`） | 实现口径 | 同上 ⇒ **69 条断言一字未改** |
| `test/t-bizdir.mjs` | `fresh()`（44 行） | `openList()` 点经典街区栏「建筑」按钮（region `bld-open`） | 开页加 `setHudMode('classic')` | 实现口径 | `biz()` 依赖经典面板存在 ⇒ 切经典后经典面板恢复 ⇒ **27 条断言一字未改** |
| `test/wechat-s12b.mjs` | 125 行（`panels` 取用前） | 同上（Worker 替身） | `call('setHudMode', ['classic'])` | 实现口径 | 微信替身的 `call()` 走 `__wyszzDebug` ⇒ 与浏览器侧同一条开关 ⇒ **8 条断言一字未改** |
| `test/wechat-s08.mjs` | 150 行（WS06a） | 「调试面板**按钮 14 个**」 | 「调试面板**按钮 15 个**」，并追加「HUD: 抽屉」A/B 开关存在 | 数量（+1 个实现侧新增按钮） | S-24 在内部包调试面板新增了「HUD: 抽屉/经典」A/B 按钮（`src/ui/debug-panel.ts` 的 `BTN_ROWS = 8 ⇒ 15 个按钮`）⇒ **原有 8 + 4 + 1 + 1 个按钮仍须全部在**的断言一字未改 |
| `test/wechat-s08.mjs` | 160 行（WS10a） | 「真实触摸点经典街区栏的『街区』小按钮 ⇒ 面板展开（三行按钮）」 | 切 `HUD: 经典` 后**同一按钮**同一判定 | 实现口径（不改判定） | 经典街区栏的「街区」小按钮在经典模式里原样存在 ⇒ 判定式 `pn0.expanded === false && pn1.expanded === true && pn1.layout.rows.length === 3` 一字未改 |
| `test/wechat-sim.mjs` | 187 行（W06） | 「点**经典底栏**空白 (40, h−10)：被 UI 吞掉，不产生 3D 点击」；判据 `swallowed ≥ +2` 且 tapLog 不增长 | 「点**抽屉把手** (40, h−30)（peek 时把手 = 面板顶部一条：满宽、高 60px）：被 UI 吞掉，不产生 3D 点击」；判据 **`3D 点击计数不增长` + `swallowed ≥ +1`** + tapLog 不增长 | 坐标（经典底栏 → 抽屉把手）+ 计数下限 | 语义不变（**不产生 3D 点击**）。计数口径说明：顶栏那下计入 `swallowed`；**把手那下走抽屉拖拽回调**（<6px 位移 ⇒ 判为点击 ⇒ 展开/收起抽屉），该路径按设计**不计入** `swallowed` ⇒ 下限由 +2 调整为 +1，并补上更强的判据「3D 点击计数不增长」 |

## 二、旧指纹重锚记录（锚到旧面板的指纹 → 等价新锚点）

| 旧锚点（0.3.3） | 含义 | 重锚到（0.3.4） | 理由 |
| --- | --- | --- | --- |
| `layout().buy` | 底栏「购地」按钮矩形 | 抽屉 tab 行「土地」格 `drawerLayout().tabCells[1]`（region `drw-tab-land`）+ 保留的顶部提示行 `layout().hint` / `layout().buyAll` | 底栏在抽屉模式下不画；购地入口迁到土地 tab（lead 拍板 Q1-a），提示行与一键购买原样保留（Q3） |
| `layout().upgrade` | 底栏「升级市政厅」按钮矩形 | 抽屉「建筑」tab → 市政厅行 → 卡片「等级」按钮（region `bld-line0`） | 升级功能迁到建筑 tab（lead 拍板 §4） |
| `layout().bottom.save` | 底栏「存档」按钮矩形 | 抽屉「其他」tab（region `drw-settings` 附近） | 同上（存档入口迁到「其他」tab） |
| `layout().bottomH` | 底栏高度（世界视口下界） | 抽屉 peek 高度 60px / `drawerLayout().panel.y`（抽屉面板上沿） | 底栏不画后，底部 HUD 的占位由抽屉承担 |
| `panels().layout.bar` | 街区栏矩形 | `drawerLayout().panel`（抽屉面板） | 街区栏被抽屉取代 |
| `panels().layout.rows[t].button` | 第 t 类街区（住宅/商业/绿化）升级按钮 | region `drw-up{t}`（抽屉「街区」tab 升级按钮） | 同上 |
| `panels().layout.texts` 的 `b{i}Name` / `b{i}Price` | 街区行文字（固定文本 id） | 抽屉行文本 `drawerRows()[i].title + .subtitle`，按 `blockRows()[t].name`（住宅/商业/绿化）定位 | 抽屉行不沿用旧文本 id；改用可定位的稳定锚点 |
| `hudRegion() === 'bld-open'` | 街区栏「建筑」入口 | `hudRegion() === 'drw-tab-build'` | 入口迁到抽屉 tab（lead 拍板 §2） |
| `hudRegion() === 'upgrade'` / `'buy-toggle'` / `'bottom'` | 底栏控件 | 抽屉 tab / `drw-buy` / `drw-handle` | 底栏不再绘制，这些 region 在抽屉模式下点不到 |
| `biz().layout.*`（`rows` / `texts` / `lineBtns` / `openBtn` / `distBtn` / `focusBtns` / `districtEntry` / `home` / `back` / `close` / `colToggle` / `panel`） | 经营面板（建筑列表/卡片/城区卡） | **不变**（数据源换成抽屉「建筑」tab，字段名与形状不变） | lead 拍板 Q4：建筑 tab 复用旧 region 名 `bld-row0..3` / `bld-focus0..3` / `bld-district` / `bld-home` / `bld-back` / `bld-close` / `bld-cols` / `bld-line0..2` / `bld-open-btn` / `bld-distbtn` / `bld-distup` |
| `layout().hint` / `layout().buyAll` | 顶部购地提示行 + 行内「一键购买」 | **不变**（位置与矩形不变） | lead 拍板 Q3 |
| `hudRegion() === 'debug'` | 报告/调试面板 | **不变** | 报告面板未改 |
| 硬编码 `'内部测试包 0.3.3'` / `'包版本 0.3.3'` | 版本横幅 | 运行态 `dbg('version')`（0.3.4） | 版本升版后不必再改测试；语义不变 |

### 2.1 旧指纹「零改动」的口径（lead 15:50 要求写清）

**旧指纹全部锚在纯排版函数上**：`layoutBottom` / `blockBarGeom` / `layoutGoalHint` / `layoutBizPanel` / `layoutTop` / 调色板 / 雾。
抽屉迁移**没有改动其中任何一个纯函数的输出** —— 底栏、街区栏在抽屉模式下只是「不绘制」，
几何函数本身与它们的期望值**逐位不变**（旧指纹期望值一行都不用改）。

**S-24 的新指纹是新增的** `src/game/fingerprints-s24.ts`（4 组）：

| 组 | 内容 |
| --- | --- |
| 三档几何 | peek 60px / half 45% / full 88% + 面板贴底 + 把手/tab 行/内容区几何 |
| tab 等分 | 5 格等宽、gap 8、padding 12、圆角 9、描边 1px #D8C7A4、行高 34、字号 13/12 |
| 金币两态 | peek = 顶部原胶囊 / half·full = 紧凑胶囊 (10,10) |
| 相机 framing | zoom 1.0 / 1.39 / 1.82（= 1 ÷ 岛景缩放 1.0 / 0.72 / 0.55）、上移 0 / −6% / −38.5% |

正式包指纹不符即**拒绝启动**（lead 实现）。


---

## 三、新增断言（本次新增的覆盖点清单）

### A. `tests/drawer-layout.test.ts`（纯 Node，5 屏 × 3 档 × 5 tab = 75 例）

| 组 | 覆盖点 |
| --- | --- |
| A 抽屉高度 | peek = 60px、half = 屏高 45%、full = 屏高 88%；`layoutDrawer().height/panel` 与档位一致、面板贴底、宽 = 屏宽；`drawerStageForHeight` 回读一致 |
| B tab 五等分 | 5 格等宽、互不重叠、**总宽 = 屏宽 − 24 − 32**、右缘 ≤ 屏宽 − 12、左缘 ≥ 0；`drawerTabCells()` 与 `layoutDrawer().tabCells` 宽度一致 |
| C 五格不重叠 | 任意两格矩形不相交（10 组配对 × 75 例）+ 相邻格 gap = 8px |
| D tab 行 / 把手 / 列表不重叠 | tab 行下沿 ≤ content 上沿；tab 行上沿 ≥ 把手下沿；content 在面板内；把手在面板顶；tab 行高 = 34px、格高 = 34px |
| E 字号上限 | 390 → ≤13 且 = 13；320 → ≤12 且 = 12；≤330 一律 12；>330 一律 13；`tabFont` 与 `drawerTabFontSize()` 一致 |
| F 金币两态 | peek ⇒ 顶部原胶囊可见 / 紧凑胶囊不可见；half\|full ⇒ 反之；紧凑胶囊在 (10,10) 附近；两态不同屏 —— **依赖 `hud-layout.layoutCoinCapsule` 导出，未导出时标 SKIP（不是通过）** |
| G 不横向溢出 | tab 行 / tab 格 / 列表 / 把手 / 面板**全部**矩形：右缘 ≤ 屏宽、左缘 ≥ 0 |
| H peek 时 tab 行移出屏幕 | `tabVisible === false` 且视口内可见高度 = 0（`tabRow.y ≥ 屏高`）；half/full 时 tab 行可见且在面板内、不出屏 |
| I 档位 framing | 相机 zoom = 1.0 / 1.39 / 1.82；岛景缩放 = 1.0 / 0.72 / 0.55；上移 = 0 / −6% / −38.5% 屏高；且 `zoom ≈ 1 ÷ 缩放` |
| 契约常量自检 | peek 60 / half 0.45 / full 0.88 / 动画 380ms / 金币位移 220ms / 5 tab / padding 12 / gap 8 / 圆角 9 / 描边 1px #D8C7A4 / 行高 34 / 点击容差 6px / tab 顺序 build·land·resident·block·more |
| 吸附边界 | 三个吸附点回读一致；peek/half、half/full 中点按「等距取小档」归档 |

### B. `test/t-drawer.mjs`（浏览器端到端）

| 用例 | 覆盖点 |
| --- | --- |
| S24-D01a | 初始态 = peek（`stage='peek'`、height = 60） |
| S24-D01b/c/d | **三档拖拽吸附**：按住把手真拖拽 → 松手后 half = 379.8±6 / full = 742.72±6 / peek = 60±6；full 可一路下拉到 peek |
| S24-D02 | **切 5 个 tab 抽屉高度逐位相等**（`height` 数组全等，且 tab 状态依次为 build/land/resident/block/more） |
| S24-D03 | **金币两态**：peek = 顶部原胶囊可见 + 紧凑不可见；half/full = 紧凑可见 + 顶部不可见；降回 peek 恢复 |
| S24-D03b | 紧凑胶囊在左上 (10,10) 附近（±2px） |
| S24-D03c | 两态不得同屏重叠 |
| S24-D04a/b | 点列表项 ⇒ **抽屉降 half + 岛特写**（`drawerFocus().active === true`、名字有值） |
| S24-D04c | **返回路径①**：点岛空白 → 特写清空 |
| S24-D04d | **返回路径②**：点右上返回按钮（`drw-back`）→ 特写清空 |
| S24-D05 | **320 宽不横向溢出**：`documentElement.scrollWidth === body.scrollWidth === 320`（half 与 full 两态） |
| S24-D06 | 全程 `pageerror = 0` 且 `console error = 0` |
| S24-D07 | **≥15 张截图**：5 屏 × 3 档，`s24-<序号>-<档>-<宽>x<高>.png`，落在 `tasks-out/S-24/evidence/`，真 PNG（PNG 魔数校验）、≥8KB、deviceScaleFactor = 2 |
| S24-D08a/b | region 命名口径：把手 = `drw-handle`；5 个 tab = `drw-tab-build/land/resident/block/more` |


### C. 本轮 lead 的两处实现侧变更（影响断言口径 ⇒ 记在这里）

| 实现变更 | 内容 | 对断言口径的影响 |
| --- | --- | --- |
| **列表可滚动** | 抽屉内容区可上下拖动滚动（demo 的 `#list{overflow-y:auto}` 同款）；切 tab 回到顶部；行命中按滚动偏移算；拖动超过 6px 本次手势不算点击 | 凡是「行在 half 档一屏放不下」的断言，一律改为「**可滚动到该行**」再断言，不再假设「行必须一屏可见」。本轮没有删任何行为断言，只把「一屏放不下 ⇒ 不可达」的旧假设换成「滚动后可达」 |
| **行文案随状态即时刷新** | `refreshView()` 末尾直接调 `refreshDrawer()` ⇒ 买地/升级/调试事件/离线结算后，**不用切 tab** 就能看到新文案 | 直接对应旧断言 S12-B02 / S12-B04 的原语义（「不需再点任何东西，行文字立刻更新」）—— 迁移后仍按「立刻更新」断言，不放宽成「切 tab 后更新」 |
| **常驻底部「买下一块」按钮**（lead 15:00/15:18） | 土地 tab 的「买下一块」从列表行挪到**常驻底部操作条**（`drawerActionRects()['land-buy']`，region `drw-buy`；短按买一块 / 长按 ≥600ms 批量确认）；不可买时（离线挂起 / 全岛已满）按钮**不渲染** | t-s19 的「一键购买 / 买下一块」全部改读 `drawerActionRects()['land-buy']`；C10（离线挂起）/ C13（全岛已满）两条改为「按钮不可用 ⇒ 计划 reason / full 标记正确 + 不弹确认」，判定语义（不可买时买不到）不变 |
| **「开业」按钮置灰禁用**（lead 15:18） | `openState !== 'ok'`（区等级不足 / 金币不够 / 离线结算中）⇒ 灰底灰字 + **点了不生效**（只弹对应提示，不发核心事件） | t-s19 的 S19-E04 由「按钮禁用（点不动）+ 费用行含『还差 1』」迁移为「点『开业』不生效（仍 closed、金币不被扣）+ 提示『金币不足，还差 1 金币』+ 行副标题含『还差 1 金币』」—— 语义等价（都开不起来），且把「禁用」从 DOM 态升级为**行为**断言 |
| **250ms 防误触窗口扩展到 `upgrade`**（lead 15:18） | 核心 UI 状态机的 250ms 窗口原本只覆盖 `bld-line[0-2]\|bld-open-btn\|bld-distup`，**漏了抽屉特写里市政厅的 `upgrade`**（旧卡片里它是 `bld-line0`） | S19-D05（250ms 防误触）断言**一字未改**，由实现补齐后转绿；这是本轮唯一的「实现侧补洞」 |
| **内部包 A/B 开关「HUD: 抽屉/经典」**（lead 16:32） | 内部包可切回 0.3.3 的经典 HUD（底栏 + 街区栏 + 弹窗式经营面板），用于**旧用例按经典 UI 验收**；调试面板按钮数 14 → **15** | 第 1 轮全量回归的 6 个红步（7 条用例）全部改为「用例开头切经典 HUD ⇒ 断言一字不改」；WS06a 的按钮数 14 → 15（并新增「HUD: 抽屉」按钮存在性断言） |
| **安全区让位**（lead 15:18） | 抽屉内容区下沿 = 屏幕底 − max(12, safeBottom)；peek 时内容区为空矩形、下沿同样守安全区 | t-ui 的 T20b 由「底栏让出安全区」改为「抽屉内容底边让出安全区」（`h − (content.y+content.h) >= 33`）—— 语义不变（底部 HUD 必须给真机安全区让位） |

---
## 四、实测记录（命令 + 真实输出）

### 4.1 布局矩阵（入库运行器，已跑通 ✅）

```
$ export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH
$ npm run test:drawer-layout          # → tools/test-drawer-layout.mjs（lead 已入库的运行器）
  peek/build        5   0
  peek/land         5   0
  peek/resident     5   0
  peek/block        5   0
  peek/more         5   0
  half/build        5   0
  half/land         5   0
  half/resident     5   0
  half/block        5   0
  half/more         5   0
  full/build        5   0
  full/land         5   0
  full/resident     5   0
  full/block        5   0
  full/more         5   0
期望高度抽查：390×844 → peek 60 / half 379.80 / full 742.72
抽屉布局测试：用例 75，断言 4446，违反 0，SKIP 0
```

**最终数字：用例 75，断言 4446，违反 0，SKIP 0**（5 屏 × 3 档 × 5 tab = 75 例全覆盖）。
F 组（金币两态）不再 SKIP —— lead 已导出 `hud-layout.layoutCoinCapsule` ✓。

**关键数字抽查（390×844）**：half 档抽屉高度实测 **380px**（`round(844×0.45)=380`，原型值 379.8）、full **743px**（742.72）、peek **60px**；
tab 格宽 66.8px（末格右缘 378 = 390 − 12）、gap 8px、字号 13px；320 屏格宽 52.8px（末格右缘 308 = 320 − 12）、字号 12px；peek 时 `tabRow.y = 屏高`（视口内可见高度 0）。

### 4.2 端到端（已跑通 ✅）

```
$ node test/t-drawer.mjs
== S-24 抽屉端到端：18/18 通过 ==
```

- 18 个用例全过：D01a–d（三档拖拽吸附）/ D02（切 5 个 tab 抽屉高度逐位相等）/ D03+D03b+D03c（金币两态、紧凑胶囊 (10,10)、两态不重叠）/ D04a–d（点行 ⇒ 降 half + 岛特写 + **两条返回路径**）/ D05（320 不横向溢出）/ D06（pageerror = 0 且 console error = 0）/ D07（≥15 张截图）/ D08（region 命名口径）。
- 15 张截图是真 PNG（PNG 魔数校验通过），`deviceScaleFactor = 2`，落在 `tasks-out/S-24/evidence/`。
- 本节此前写的「0/2 通过（实现未就绪）」是实现落地前的如实记录，**现已由上面这条真实结果取代**。

### 4.3 旧 e2e 迁移后的实跑结果（t-land / t-s19 / t-s21 / t-s12 / t-ui / t-gameplay / t-visual）

| 文件 | 命令 | 实跑结果 |
| --- | --- | --- |
| `test/t-land.mjs` | `node test/t-land.mjs` | **61/61 通过**（lead 16:00 复跑口径一致） |
| `test/t-s19.mjs` | `node test/t-s19.mjs` | **== S-19 验收：69/69 通过 ==** |
| `test/t-s21.mjs` | `node test/t-s21.mjs` | **== S-21 验收：12/12 通过 ==**（D05a/D05b 按 lead 16:05 给的核心语义修完转绿，根因见 §4.4 末尾） |
| `test/t-s12.mjs` | `node test/t-s12.mjs` | **30/30 通过**（lead 15:18 修掉「切 tab 弹 toast」后转绿） |
| `test/t-ui.mjs` | 无独立入口 | 由 `test/browser.test.mjs` 驱动（见 §一 第 5 组）⇒ 随浏览器套件 103/103 全绿 |
| `test/t-gameplay.mjs` | 无独立入口 | 同上（T04g 已按「抽屉建筑 tab → 市政厅行 → 动作条升级」迁移） |
| `test/t-visual.mjs` | `node test/t-visual.mjs` | **== 视觉测试：22/22 通过 ==**（HUD 区下界改「抽屉 peek 高 60px」） |
| `test/browser.test.mjs` | `node test/browser.test.mjs` | **== 浏览器测试：103/103 通过 ==**（t-gameplay + t-ui + t-visual + t-fixtures + t-drawer） |
| `test/t-drawer.mjs` | `node test/t-drawer.mjs` | **== S-24 抽屉端到端：18/18 通过 ==** |

### 4.4a 第 1 轮全量回归（59 步）红项修复后的实跑（lead 16:32 派单，6 步 / 7 条用例）

```
$ node test/t-s10.mjs        → == S-10 端到端测试：46/46 通过 ==
$ node test/t-s12b.mjs       → S-12b 端到端测试：69/69 通过
$ node test/t-bizdir.mjs     → == S-22B 建筑目录 e2e：27/27 通过 ==
$ node test/wechat-s08.mjs   → == 微信包 S-08 测试：13/13 通过 ==
$ node test/wechat-s12b.mjs  → == 微信替身 S-12b 测试：8/8 通过 ==（替身不等于真机）
$ node test/wechat-sim.mjs   → == 微信适配层（Worker 无 DOM + 模拟 wx）：38/38 ==
```

### 4.4 实跑明细（真实输出，未跑通的如实列出，不伪造通过）

```
$ node test/t-s19.mjs
== S-19 验收：69/69 通过 ==
$ node test/t-s21.mjs
== S-21 验收：12/12 通过 ==
$ node test/t-s12.mjs
== S-12 验收：30/30 通过 ==
$ node test/t-land.mjs
== S-19 买地端到端：61/61 通过 ==
$ node test/t-visual.mjs
== 视觉测试：22/22 通过 ==
$ node test/browser.test.mjs
== 浏览器测试：103/103 通过 ==
$ node test/t-drawer.mjs
== S-24 抽屉端到端：18/18 通过 ==
```

**最后一轮调试记录（如实留痕）**

1. **t-s19 的 G02（点行 2/3/4 ⇒ 特写）一度连续红**，根因**不是**抽屉逻辑，而是
   **内部调试浮层 `#debug-only` 盖住了抽屉行、把真实点击吃掉**
   （现象：`inputStats.uiActions` 不增长、`swallowed` 也不增长 ⇒ 事件根本没进 canvas；
   `document.elementFromPoint(24,687)` 返回的是调试浮层里的 `<b>` 而不是 `<canvas>`）。
   修法（**测试侧**）：抽屉交互前 `hideDebugOverlay()`（`visibility:hidden` + `pointer-events:none`）⇒ G02 转绿。
2. **核心 UI 的 250ms 防误触是按真实帧时间判定的**（`src/app/input.ts` 的 `TAP_MOVE_*` / `uiNow()` 走真实帧时钟）
   ⇒ 推假时钟（`tick(pg, 300)`）**无效** ⇒ 测试里改用真实时间等待 `waitReal(320)`。
3. **t-s21 的 D05b 根因（lead 16:05 定位，核心 `src/core/uistate.ts` 的 `uiStep`）**：
   `TAP_CANDIDATE` 落在**同一块**已选中的地上时，`el = now − atMs`：
   `el < 0` ⇒ reselect（时钟回退）／**`el < 250` ⇒ ignore（什么都不改）／`el ≥ 250` ⇒ purchase（成交买地！不是「取消选中」）**。
   ⇒ 「点当前选中的那块地来取消选中」这条路在假时钟不动时**必然被 250ms 窗口忽略** ⇒ 选中态清不掉 ⇒
   「提示条被报价卡压住」一直成立 ⇒ 看起来像「购地=隐藏、报价卡=仍显示」。
   ⇒ 回到未选中态只能走 `TAP_OTHER / DRAG / BACKGROUND / RELOAD`：本用例用「切 tab（setBuyMode(false) ⇒ TAP_OTHER）」实现；
   选中候选地改走**抽屉「土地」tab 的候选行**（region 路径与世界上点同一候选完全相同；half 档时世界坐标落在抽屉面板下面点不到）。
   ⇒ 修完 **12/12 全绿**。

---

## 五、归属变更后由 S4 自行完成的两条（原「留给 lead 的待办」，lead 15:50 确认归我）

1. ~~`test/t-gameplay.mjs:68` 点底栏 `Lo.upgrade`~~ → **已改**（操作路径迁移（等价））：
   旧「底栏『升级市政厅』按钮」⇒ 抽屉「建筑」tab → 市政厅行 → 特写动作条「升级市政厅」
   （region `upgrade`；非市政厅的楼是三条线 `bld-line0..2`，断言里两个都认 ⇒ 对两种实现口径都稳）。
   断言语义不变：仍然要求「按钮路径也能把市政厅升一级」（`a2.level === b2.level + 1`），只是入口换了地方。
2. ~~`test/t-visual.mjs` 的 `L.bottomH`~~ → **已改**（第 20 / 98 / 252 / 254 行）：
   HUD 区下界 = 屏幕底 − **抽屉 peek 高 60px**（`L.bottomH > 0` 时沿用旧口径）。
   语义不变：仍然是「HUD 区 = 顶部安全区 + 底部 HUD 区之间的自由区」，只是下界从「底栏高」换成「抽屉 peek 高」。

