# S-38 / E2 报告 · 抽屉「建筑」行：玩家话文案 + 行高 56 + 320 不截断

> 工作树：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm035`（0.3.5-dev）
> 口径唯一来源：`tasks-out/S-38/接口约定-S38.md` §2 + 机主 2026-10-26 任务书（四类建筑统一格式）。
> 实现：新文件 `src/ui/drawer-rows.ts`（纯函数文案矩阵），`src/app/app.ts` 只读 dry-run 算数值，`src/ui/hud.ts` 排版/绘制。
> 套件：`test/t-s38-drawer-rows.mjs`（纯函数 + 浏览器读数 + 截图）。

---

## 1. 文案矩阵 before → after（逐行）

「before」= 旧口径 `buildingListStatus()` 通过 `drawerRows` 画出来的那行（0.3.3 经营面板文案，含 F/A 代号与两位小数）；
「after」= 本次矩阵（`buildDrawerBuildingRow`，逐字）。下例数字取自任务书矩阵/等价样例。

| 情形 | before（旧） | after 主行 title | after 副行 subtitle | 徽章 badge |
|---|---|---|---|---|
| 已开业（未满级） | `市政厅 · Lv40 F5 A1 +211.20/分` | `市政厅 Lv40` | `每分钟 +211.2 · 升级后 +257.6` | 已开业 |
| 已开业（非市政厅） | `已开业 · Lv12 F3 A0 +123.40/分` | `居民楼 Lv12` | `每分钟 +123.4 · 升级后 +XXX` | 已开业 |
| 已开业 + 满级 | `市政厅 · Lv10000 F10000 A10000 +X/分`（徽章「已满级」） | `市政厅 Lv10000 已满级` | `每分钟 +211.2` | 已满级 |
| 未开业（可开业） | `可开业 · 开业费 500 金币` | `公园 未开业`（不写 Lv0） | `开业费 500 金币 · 开业后 +40` | 未开业 |
| 未开业 + 金币不足 | `可开业 · 还差 450 金币` | `公园 未开业` | 同上；`subtitleWeakFrom=0`（价格段弱色 `#b3a695`，**不隐藏**；收益段仍 SOFT） | 未开业 |
| 未开业 + 区等级不足 | `需区 Lv 6（当前 1）` | `公园 未开业` | `开业费 500 金币 · 开业后 +40`（「开业后」按把区等级抬到该楼门槛的 dry-run 探测，见 §4） | 未开业 |

口径钉死项（全部在源码/输出断言）：
- `每分钟 +X` = **本楼**产速 `fmtRateShort(r.milliPerMin / 1000)`（与旧行 `+X/分` 同源、1 位小数、去 `.0`）。
- `升级后 +Y` = 等级线 +1 后本楼 `buildingMilli`（核心 `upgradeLine` dry-run，与 S-34/S-35 同一条路）；满级不出。
- `开业后 +Y` = 核心 `openBuilding` dry-run 后本楼 `buildingMilli`。
- 全列表 **0 处** `F\d` / `A\d` / `契约` / `区 Lv` / `+X.XX/分` / 省略号（套件 `S38-P15/P16`、浏览器 `S38-B02` 双向断言）。
- 徽章只有 `已开业 / 未开业 / 已满级`；`bizdir.ts` 的「需 LvN / 差金币 / 可开业 / 离线中」不进抽屉建筑行（该文件未改，经典 0.3.3 面板照旧）。

---

## 2. 源码改动

| 文件 | 改动 | 行数级 |
|---|---|---|
| `src/ui/drawer-rows.ts`（**新**） | `buildDrawerBuildingRow` 文案矩阵唯一实现；`planDrawerRowText` 窄屏降级判定；`drawerSubtitleSegments` 弱色分段 | 新文件 ~230 行 |
| `src/app/app.ts` | 新 `drawerBuildingOrder` / `drawerProbeState` / `drawerNextLineMilli` / `drawerOpenAfterMilli` / `drawerBuildingRows`；`refreshDrawer` 建筑分支改走新行；`debugApi.drawerRows()` 增 subtitle2/subtitleWeakFrom/textMode/subtitleSize/subtitleW/textAvailW/textFits | ~120 行 |
| `src/ui/hud.ts` | `DRAWER_BUILD_ROW_H` 用于建筑 tab 行高；`relayoutDrawer` 现算每行窄屏方案；`paintDrawerRows` 建筑行三行式绘制（主行 bold14@+20 / 副行 12@+41；two11 = 11@+34、+47）/ 弱色分段 / 徽章 y | ~80 行 |
| `src/ui/hud-layout.ts` | 新增命名常量 `DRAWER_BUILD_ROW_H = 56`（注释写清 48→56、间距 8 不变、其它 tab 44 不动） | +7 行 |
| `src/ui/drawer-content.ts` | `DRAWER_SECTION_HEIGHT`：`building 48→56`、`hall 52→56`（district 48 / other 44 不动）；注释同步 | 2 常量 + 注释 |
| `test/t-s32-ia.mjs` | S32IA-80 改口径（见 §5 留痕） | 1 条 |
| `test/t-drawer-layout.mjs` | `EXP.rowH 48→56` + L03 注释/文案（见 §5 留痕） | 2 处 |
| `test/t-s38-drawer-rows.mjs`（**新**） | 本套件 | 新文件 |

行高改动位置（全部命名常量，无散落 magic number）：
- `hud-layout.ts: DRAWER_BUILD_ROW_H = 56`（新增）；
- `hud.ts relayoutDrawer`：`const rowH = buildRows ? DRAWER_BUILD_ROW_H : DRAWER_ROW_H;`（gap 建筑 8 / 其它 6 不变）；
- `drawer-content.ts` 两个常量同步（该模块不被渲染路径使用，按任务书要求同步）。

---

## 3. 320 兜底策略（不截断、不压扁数字）

排版前在 `relayoutDrawer` 用**页面 canvas 真实 measure**（`hud.ts: makeMeasure` = `measureText × 1.06 + 1`）算可用宽：
`可用宽 = 行宽 − 12(左内边距) − 10(右留白) − 徽章宽(12px 实测 + 10 + 6)`。

`planDrawerRowText` 判定顺序（套件 S38-P17..P20 逐档断言）：
1. 副行 12px 放得下 ⇒ `one12`；
2. 否则 11px 放得下 ⇒ `one11`；
3. 否则若拆成 `subtitle` / `subtitle2` 两段在 11px 都放得下 ⇒ `two11`（两行均 11px、line-height 13，baseline `rowY+34` / `rowY+47`，仍在 56 内）；
4. 仍放不下 ⇒ `one11 + fits=false`：**按 11px 原样绘制，不用 `fillText(maxWidth)` 横向压缩、不省略**（Lead 2026-10-26 口径②），该情形记录进本报告。

实测（320×568 全档）：四行副行 12px 均放得下（见 §6 读数），`two11` 未触发；纯函数层用合成窄宽证明降级链可用。
「…」/「...」在行模型里根本不生成；套件对产出文案与页面实测文本均做省略号扫描。

---

## 4. 边缘情形（口径记录）

- **等级线不可升但未满级**：`drawerNextLineMilli` 依次试 `[level, facility, promo]` 中第一个 `state !== 'max'` 的线（核心 `upgradeLine` dry-run），取该线 +1 后的本楼 `buildingMilli`。实际数据里几乎只有市政厅会出现「等级 10000 但设施/宣传未满」，而 `buildingMaxed()` 判市政厅只看 `hallMaxLevel` ⇒ 该情形走「已满级」分支、不出「升级后」（任务书：满级不出）。
- **未开业 + 区等级不足（locked）**：`openBuilding` 会因 `district-level-too-low` 拒绝 ⇒ 探测副本把 `districtLevel` 抬到该楼 `openLevel` 再 dry-run，得到「开业后 +Y」；标题/副行仍按矩阵（全列表禁 `区 Lv`，不显示门槛数字）。
- **离线挂起（pending）**：探测副本清 `offlinePending=false` 再 dry-run；真实状态不变。
- **金币不足**：探测副本 `coinsMilli = MAX_SAFE_INTEGER` 让 dry-run 通过，只读 `buildingMilli`；真实余额不参与本行数字（价格弱色由 `openState==='poor'` 决定）。
- **防御**：非有限/负数产速按 0（`+0`），非法开业费按 0；不显示 NaN/负号（S38-P11）。
- **顺序不变**：仍「未开业且差得最少优先、已开业最后（市政厅在最后）」，`bizOrder` 与 region `bld-rowN` 不变；行点击=特写/滚动/`drawerScrollMax` 逻辑未动。

---

## 5. 旧断言改口径留痕（逐条：文件 / 断言 id / 旧期望 / 新期望 / 原因）

> 规则：只改「与新口径直接冲突」的期望值；不删断言、不降强度（名称/副行/徽章/顺序/按钮仍逐项全等断言）。
> 期望值尽量由核心现算（`upgradeLine`/`openBuilding`/`buildingMilli` + 页面同一份 `state`），不硬编码数字。

| # | 文件 | 断言 id | 旧期望 | 新期望 | 原因 |
|---|---|---|---|---|---|
| 1 | `test/t-s19.mjs` | S19-D01 | `bRowNName === rowsCore[ord].name`；建筑行 `rect.h === 48` | 主行以核心楼名为前缀（`startsWith`）；`rect.h === 56` | S-38 §2：主行改 `名称 LvN`（满级/未开业带后缀）、行高 48→56 |
| 2 | `test/t-s19.mjs` | S19-D02 | 行状态含 `Lv…F…A…+X.XX/分` | 主行/副行/徽章 **三者全等**核心现算：`市政厅 LvN` / `每分钟 +X · 升级后 +Y` / `已开业` | 机主 2026-10-26 文案矩阵：禁 F/A 代号、产速 1 位小数 |
| 3 | `test/t-s19.mjs` | S19-G01 | 已开业行含 `Lv/F/A/+X.XX`；locked 行 === `需区 Lv N（当前 M）`；其余 `startsWith('可开业')` | 四行主行/副行/徽章逐字等于核心现算抽屉行（开业/未开业/满级三态） | 同上；顺序断言（差得最少优先、市政厅最后）保持原强度 |
| 4 | `test/t-s21.mjs` | S21-D02 | locked 行副标题 === `需区 Lv N（当前 M）` | 主行/副行/徽章 = 核心现算：`名称 未开业` / `开业费 X 金币 · 开业后 +Y` / `未开业` | 机主口径禁「区 Lv」；未开业行改为价格+收益 |
| 5 | `test/t-s21.mjs` | S21-D03 | 行副标题 === 门槛串 `需区 Lv N（当前 M）` | 同上核心现算三件套 + 断言行内 **0 处「区 Lv」**；特写 active/名字/`bld-open-btn`/`bld-line0` 动作条断言保持原强度 | 门槛信息不再写进行里，由特写动作条承载（机主口径） |
| 6 | `test/t-s32-shots.mjs` | SIZE-ROW（+ `EXP.rowH`） | 建筑 tab 行高 48（「旧 56 必须消失」）；`EXP.rowH: 48` | 建筑 tab 行高 56（命名常量 `DRAWER_BUILD_ROW_H`）；`EXP.rowH: 56`，居民 tab 仍 44/56 | S-38 §2 行高 48→56；文案改双行主/副行、320 可拆三行 |
| 7 | `test/t-s32-ia.mjs` | S32IA-80 | `building === 48`（且旧断言未含 hall） | `building === 56 && hall === 56`，district 48 / other 44 不变 | 同上；`drawer-content` 尺寸表同步 |
| 8 | `test/t-drawer-layout.mjs` | `EXP.rowH` + L03 | 建筑 tab 行高 48（注释「旧 56 必须消失」） | 建筑 tab 行高 56；居民 44/48 不变 | 同上 |
| 9 | `test/t-s34-accept.mjs` | S34-B02（行定位） | `rows.find(r => r.title === '市政厅')` | `/^市政厅/.test(r.title)` | 新主行是 `市政厅 LvN`（含 Lv 后缀），等值匹配找不到；点行→特写→弹窗行为断言不变 |

**写域外、未改、需 Lead 收口时处理**（与上一轮报告 §5.3 相同，已在本轮 §5 之外单独列出，避免混淆）：
- `test/t-s32-shots.mjs` 的 `ISLAND-PEEK`（`EXP.peekRatio 60~66%H`）与 E1 的 peek 55.5%H 改动可能冲突 —— 属 E1/Lead 口径，本文件我只改了 SIZE-ROW（任务书授权范围）。
- `t-s19`/`t-s21`/`t-s32-shots` 其余与建筑行无关的用例未触碰。

## 6. 断言与读数（最终包 `main-ce6698e7ae` 实跑：**37/37 通过，FAIL 0**）

- 纯函数/几何/黑名单：`S38-P01..P21`、`S38-G01..G05`（26 条）。
- 浏览器（11 条，390×844 与 320×568）：
  - `S38-B01` 四行 id/region 仍 `bld-rowN` ⇒ 点击/特写路径不变；
  - `S38-B02` 四行 title/subtitle/badge 符合矩阵、数值与核心逐位一致、0 处黑名单；
  - `S38-B03` 副行宽度复核：页面 canvas `measureText` ≤ 可用宽（390：87/289、101/289、73/289、69/289；320：87/219、101/219、73/219、69/219）+ 无省略号 + 无横向压缩兜底，两尺寸都是 `one12`；
  - `S38-B04` full 档 4 行行高 56 / 间距 8 / `scrollMax=0` / 行中心命中 `bld-rowN`；
  - `S38-B05` 320：full 档四行可见、half 档 `scrollMax=142`（可滚、不截断）；
  - `S38-B06-open/max/poor` 状态注入 3 张截图（多栋已开业 / 市政厅满级 / 未开业金币不足 weak=0）。
- 套件汇总：**37/37 PASS**（`node test/t-s38-drawer-rows.mjs`，RC=0，日志 `/tmp/s38/regress/final-t-s38.log`）
- 读数 JSON：`tasks-out/S-38/E2-读数.json`（`summary.checks=37, failures=0`）
- 截图：`tasks-out/S-38/e2-drawer-390.png` / `e2-drawer-320.png` / `e2-state-open.png` / `e2-state-max.png` / `e2-state-poor.png`

---

## 7. 未验证项 / 已知风险

- `t-s19` / `t-s21` / `t-s32-shots` 三处旧断言（见 §5.3）未改（写域外），需要 Lead 按新口径更新后才能全绿。
- 「价格弱色 `#b3a695`」的实际观感需 U1 看图确认（截图已给）；套件断言的是 `subtitleWeakFrom=0` + 分段数据，不是像素颜色。
- 320 实测走 `one12`（未触发 11px/拆行）；11px 与拆行分支仅由纯函数合成窄宽测试覆盖，未在真机 320 上自然触发。
- 真机字体（iOS/Android WebView）与 Chromium+Noto 的 measure 差异未实测；实现按页面 canvas 实测宽判定，且留 6%+1px 余量。
- 390×844 half 档 4 行需滚动 18px（56×4+8×3=248 > 列表可用高 ≈229.8）；这不是截断（可滚、行高完整），截图用 full 档展示四行。

---

## 8. 收口复跑（Lead，2026-10-26 14:4x–15:0x，最终包 `main-ce6698e7ae`）

- `node test/t-s38-drawer-rows.mjs` ⇒ **37/37 PASS**（`E2-读数.json` summary.checks=37, failures=0；收口时在同一最终包上复跑一致）。
- Lead 独立验收 `tools/s38-lead-accept.mjs` 的 S38L-D01/D02 在最终包上 **PASS**：四行主/副/徽章符合矩阵、全列表 0 处 `F\d`/`A\d`/`契约`/`区 Lv`、320 无省略号、行高 56、满级徽章=已满级、金币不足价格不隐藏。
- 交叉套件（全量回归）对行高/文案的旧断言改口径后全绿：`t-s19` 70/70、`t-s21` 12/12、`t-s32-ia` 239/239、`t-s32-shots` 含 56、`t-drawer-layout` 41/41、`t-s34-accept` 42/42。
- 点击/特写不回退：`t-s38-drawer-rows` S38-B01/B04/B05 的 region/行中心命中 `bld-rowN`、full 档四行可见、half 可滚均 PASS；`t-s34-accept` 行点击→特写→升级确认弹窗 42/42。
