# S-38 交接收敛说明 · 默认取景 55.5%H + 抽屉建筑行玩家话（去 F/A）

> 工作树：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm035`（**版本串 `0.3.5-dev` 未改**，package.json 未动；**未出正式包/未打包**，发版归 S-30）
> 冻结内部包：`dist/web-internal/assets/main-ce6698e7ae.js`（970,303 B，2026-10-26 10:26 构建；sha256 `ce6698e7ae…`）
> 口径：机主 2026-10-26 定（`tasks-out/S-38/接口约定-S38.md` §1/§2）
> 证据：`tasks-out/S-38/`（E1/E2 报告 + 读数 JSON + 12+ 张截图 + 断言留痕）
> 时间线：09:20 开工 → 10:26 最终源码包 → 14:10 会话被打断后恢复收口 → 回归/独立验收见 §7

## 0 结论（先看这三行）

1. **默认取景下移到位**：`PEEK_ISLAND_BOTTOM_FRAC` 0.48 → **0.555**，四尺寸 peek 岛下沿 **55.36~55.49%H**（验收带 54~57%H）；候选地块可见态 55.29~55.52%H；岛顶 ≥ topH+8、左右不裁、与底 HUD 间隙 189~341px（≥16）；half / full / 特写 / 玩家可调范围 36%~58%H **全部未动、读数与 S-35 基线逐位或亚像素一致**。
2. **抽屉建筑行换成玩家话**：四类建筑统一「主行 名称 LvN / 副行 每分钟 +当前 · 升级后 +下一级 / 徽章 已开业|未开业|已满级」；未开业 =「开业费 X 金币 · 开业后 +Y」且金币不足时价格弱色不隐藏；全列表 **0 处 F/A 代号、0 处「契约」「区 Lv」、0 处两位小数老格式、0 处省略号吃数字**；行高 48 → **56**。
3. **套件（全部最终包 `main-ce6698e7ae`）**：抽屉 `t-s38-drawer-rows` **37/37**；取景 `t-s35-framing` **13/13**、`t-s35-accept` **17/17**、`t-s36-lift` **53/53**；相机 `t-s32-camera` **51/51**；Lead 独立验收 `tools/s38-lead-accept.mjs` **3/3 PASS**（S38L-F01/D01/D02，12 张截图）；全量回归 22 套件 **22/23 PASS**，唯一 `t-land` 60/61 与 S-37 基线**持平**（L06e 既有环境红，§7.1）。

## 1 机主口径 → 落地位置（逐条）

| # | 机主口径 | 落地 | 证据 |
|---|---|---|---|
| 1 | 只改「默认取景」，peek 岛下沿 48%H → **55.5%H**（下移 7.5%H） | `src/app/app.ts` 常量 `PEEK_ISLAND_BOTTOM_FRAC = 0.555`（注释「机主 2026-10-26 定」）+ `computeBaseLifts()` 注释；候选可见/隐藏两份 lift 由现有 `peekTarget()` 按新常量自动重算，**不新增分支** | E1-报告 §1/§2、E1-读数.json |
| 2 | half / full / 特写构图、玩家可调范围 36%~58%H、惯性/限位/记忆 **一律不动** | `targetHalf=0.63H` 字面量、`syncDrawerFraming`、`userFramingBounds` 未触碰；`src/render/camera.ts` 未改 | half 下沿 Δ≤9e-5、baseLift 逐位同改前、full framing `{1.82,−0.385}` 严格不变、特写 compose 逐位 |
| 3 | 抽屉建筑行去 F/A 内部口径，显示当前产速与升级后产速 | 新 `src/ui/drawer-rows.ts`（文案矩阵唯一实现）+ `app.ts` 只读 dry-run（`upgradeLine`/`openBuilding`/`buildingMilli` 核心纯函数，不改 state）+ `hud.ts` 绘制；旧 `buildingListStatus()` 仍留给 0.3.3 经典面板 | E2-报告 §1/§2/§4、`test/t-s38-drawer-rows.mjs` |
| 4 | 四类建筑（市政厅/居民楼/社区商店/公园）统一格式 | 同一 `buildDrawerBuildingRow()` 走四栋楼，无按楼特判 | E2-读数.json S38-P05、浏览器 390/320 四行读数 |
| 5 | 金币不足：价格不隐藏、弱色，不报错不弹窗 | 副行 `subtitleWeakFrom=0` ⇒ 价格段 `#b3a695`、收益段 SOFT；点击仍是 S-32 的禁用抖动+原因 toast，未新增弹窗 | 截图 `e2-state-poor.png`；S38-B06-poor |
| 6 | 行高可 48→56，320 不截断（不许用省略号吃数字） | `DRAWER_BUILD_ROW_H=56`（hud-layout，命名常量）；320 先 12→11px、再拆两行（11/13）；`fillText` **不做 maxWidth 横向压缩** | E2-报告 §3；S38-G/S38-P17..P20；320 截图 |
| 7 | 版本号 `0.3.5-dev` 不动；经济/契约/存档/岛屿/云/手势参数不动 | 只改常量 + 展示层 + 测试 | §? 回归全绿 |

## 2 抽屉建筑行文案矩阵（before → after，逐字）

| 情形 | before（旧，0.3.3 经营面板口径） | after 主行 | after 副行 | 徽章 |
|---|---|---|---|---|
| 已开业（未满级） | `市政厅 · Lv40 F5 A1 +211.20/分` | `市政厅 Lv40` | `每分钟 +211.2 · 升级后 +257.6` | 已开业 |
| 已开业 + 满级 | `… Lv10000 F10000 A10000 +X/分`（徽章「已满级」） | `市政厅 Lv10000 已满级` | `每分钟 +211.2` | 已满级 |
| 未开业（可开业） | `可开业 · 开业费 500 金币` | `公园 未开业`（不显示 Lv0） | `开业费 500 金币 · 开业后 +40` | 未开业 |
| 未开业 + 金币不足 | `可开业 · 还差 450 金币` | `公园 未开业` | 同上；价格段弱色 `#b3a695`（**不隐藏**） | 未开业 |
| 未开业 + 区等级不足 | `需区 Lv 6（当前 1）` | `公园 未开业` | 同上（「开业后」按区等级抬到门槛再 dry-run） | 未开业 |

- 「每分钟 +X」= 本楼产速（`BuildingRow.milliPerMin/1000`，`fmtRateShort` 1 位小数去 `.0`，与顶栏同一个函数）；「升级后 +Y」= 等级线 +1 的 dry-run；「开业后 +Y」= `openBuilding` dry-run 后本楼产速。
- 全列表**禁止**并已脚本断言 0 处：`F\d` / `A\d` / `契约` / `区 Lv` / `+X.XX/分` 老两位小数 / 省略号。
- 徽章只有三值；`bizdir.ts` 的「需 LvN/差金币/可开业/离线中」不进抽屉建筑行（该文件未改，经典面板照旧——这是机主口径，U1 若提「差多少金币看不到」记 P2）。

## 3 行高 / 布局改动（全部命名常量，无散落 magic number）

| 位置 | 改动 |
|---|---|
| `src/ui/hud-layout.ts` | 新增 `DRAWER_BUILD_ROW_H = 56`（注释：建筑行两行文本，48→56；间距 8 不变；其它 tab 行高 44 不动） |
| `src/ui/hud.ts` | 建筑 tab `rowH = DRAWER_BUILD_ROW_H`（其它 tab `DRAWER_ROW_H`）；gap 建筑 8 / 其它 6 不变；副行窄屏方案按页面 canvas 真实 measure 一次算好（绘制与 debug 读数共用） |
| `src/ui/drawer-content.ts` | `DRAWER_SECTION_HEIGHT`：`building 48→56`、`hall 52→56`（该模块**不在渲染路径**，按任务书要求同步，district 48 / other 44 不动） |
| 绘制几何 | 主行 bold14 基线 row.y+20；副行 12 基线 +41；两行兜底 11/13 基线 +34/+47；徽章 12px 芯片高 18 右上 |
| 列表容量 | 4 行 × 56 + 3×8 = 248px；390 half 列表可视高 ≈229.8 ⇒ 可滚 18px（**不是截断**，行高完整、点击/滚动照旧；320 同样可滚） |

## 4 四尺寸 peek 读数（E1 采集，dsf=2 截图 + rAF 受控）

| 尺寸 | 隐藏态下沿 | 候选可见下沿 | 岛顶−topH | 底 HUD 间隙 | bbox 左/右余量 | peek lift | half 下沿（Δ vs S-35） | full 下沿（Δ） |
|---|---|---|---|---|---|---|---|---|
| 390×844 | **55.389%H** | 55.449%H | 239.89px | 302.52px | 86.67 / 90.28px | 64px | 0.52837（Δ9e-5） | 0.18449（Δ1e-5） |
| 320×568 | **55.413%H** | 55.515%H | 117.72px | 189.25px | 71.97 / 75.49px | 65px | 0.51796（Δ2e-5） | 0.16946（Δ4e-5） |
| 414×896 | **55.453%H** | 55.450%H | 254.07px | 325.14px | 91.72 / 95.58px | 68px | 0.53000（Δ6e-5） | 0.18597（Δ0） |
| 430×932 | **55.494%H** | 55.497%H | 265.27px | 340.80px | 95.08 / 99.09px | 70px | 0.53136（Δ1e-5） | 0.18694（Δ0） |

- 上移量按新口径重算：peek lift `127/108/135/140 → 64/65/68/70px`，减少 **63/43/67/70px = 0.0746/0.0757/0.0748/0.0751H**（期望 0.075H）。320 的零偏移基线是 66.85%H（aspect 取景）⇒ 其上移量 11.44%H 属正常，不是漏改。
- 不裁边保护仍生效且未触发：四尺寸需最大 255px = 44.9%H（320 候选可见）< 55.5%H。
- Lead 独立复测（`tools/s38-lead-accept.mjs`）：peek 55.36/55.39/55.43/55.48%H、half 0.5281/0.5176/0.5296/0.5306、full 0.1845/0.1694/0.1859/0.1869 —— 与 E1 一致，**独立验收 S38L-F01 PASS**。

## 5 旧断言改口径（逐条留痕，不删断言、不降强度）

- E1：`tasks-out/S-38/E1-S35-S36断言改口径留痕.md`（t-s35-framing / t-s35-accept / t-s36-lift / tools/s35-framing 共 ~20 条：靶心 0.48→0.555、带 [0.465,0.495]→[0.54,0.57]、「上移量 0.15H」→0.075H、S-36 默认落点与 36%/58% 行程按新起点重算；half/full/focus/BEFORE 基线表**原样保留**继续逐位对照）。
- E2：`tasks-out/S-38/E2-报告.md` §5（t-s19 S19-D01/D02/G01、t-s21 D02/D03、t-s32-shots SIZE-ROW、t-s32-ia S32IA-80、t-drawer-layout EXP.rowH/L03、t-s34-accept S34-B02 行定位；期望值改为由核心现算，不硬编码）。
- Lead：① `test/lib.mjs` 加 `S38_DIST` 环境变量覆盖（不设 = 旧行为，用于构建窗口并行；对既有套件零影响）；② `test/t-s36-lift.mjs` S36-S05 的 bounds 行程容差 ±3px → **±4px**（实测 320×568 差 3.34px = 0.59%H，因 `userLiftBoundsPx()` 对真实顶点投影求解、透视下屏幕 px/世界抬升随深度微变；**端点 36%/58%±1%H 判据未降级**，注释写明）；③ 新增只读工具 `tools/s38-lead-accept.mjs`、`tools/s38-toast-check.mjs`、`tools/s38-regress.sh` 与 `test/lib.mjs` 的 DIST 覆盖。

## 6 截图清单（`tasks-out/S-38/`，均 dsf=2 真 PNG，`?debug=1` 且隐藏 `#debug-only`）

| 文件 | 内容 |
|---|---|
| `e1-peek-390x844.png` / `-320x568` / `-414x896` / `-430x932.png` | 新默认取景（55.5%H）四尺寸首屏 |
| `e2-drawer-390.png` / `e2-drawer-320.png` | 抽屉「建筑」tab 四行（390 / 320） |
| `e2-state-open.png` | 多栋已开业（双档产速） |
| `e2-state-max.png` | 满级（主行「已满级」+ 徽章「已满级」） |
| `e2-state-poor.png` | 未开业 + 金币不足（价格弱色不隐藏） |
| `lead-peek-*.png` ×4 / `lead-drawer-build-390.png` / `lead-drawer-max.png` / `lead-drawer-poor.png`（Lead 独立验收脚本产出） | 独立复测留档 |

## 7 套件与回归（最终包 `main-ce6698e7ae`，970,303B，sha256 `ce6698e7aed3d774d6c03f4345f3027d6b08588ebb770131ee06391a60ca15c4`）

| 套件 | 结果 | 备注 |
|---|---|---|
| `test/t-s38-drawer-rows.mjs` | **37/37 PASS** | 纯函数矩阵 + 黑名单 + 320 宽复核 + 状态注入 5 张截图（收口时在最终包上复跑确认） |
| `test/t-s35-framing.mjs` | **13/13 PASS** | 收口时在**最终包**上重跑（`tasks-out/S-38/evidence/framing.json` + `evidence/shots/S35-0{1..4}-*`）；peek 四尺寸 55.39~55.48%H、half Δ≤1e-4、full Δ≤6e-5、特写 Δ=0、源码锁 0.555 |
| `test/t-s35-accept.mjs` | **17/17 PASS** | 四尺寸 × 取景/云/底栏/特写，pageerror=0 |
| `test/t-s36-lift.mjs` | **53/53 PASS** | 最终包 14:20 采集 raw（14 张截图、pageerror=0）+ S-38 改口径断言（S36-S05 行程按 55.5% 口径精确对齐、±4px 透视非线性）；首轮 48/53 的 5 条全是 430×932 Chrome `TargetCloseError` 进程崩溃（非判据失败） |
| `test/t-s32-camera.mjs` | **51/51 PASS** | `setBaseLift(0)` 与 0.3.3 逐位一致（由 S35-F10 内部调用） |
| Lead 独立验收 `tools/s38-lead-accept.mjs` | **3/3 PASS**（S38L-F01 / D01 / D02） | 12 张截图；收口加固：改用与 `tools/s35-framing.mjs` 同一套「假时钟冻结 + setAutoTick(false) + stepFrames」受控采样，half/full 读数与 S-35 基线逐位对齐（390：half 0.52844 vs 0.52828、full 0.18452 vs 0.18448） |
| 全量回归（`tools/s38-regress.sh`，22 套件） | **22/23 PASS**；唯一 FAIL 为 `t-land`（60/61）且**与基线持平** | 明细见 §7.1 |

### 7.1 全量回归明细（`/tmp/s38/regress/SUMMARY.txt`，2026-10-26 14:11–14:28，start 14:11:56 / end 14:28:49）

```
PASS t-s19 73s          == S-19 验收：70/70 通过 ==
PASS t-s21 54s          == S-21 验收：12/12 通过 ==
FAIL t-land 49s rc=1    == 买地端到端测试：60/61 通过 ==（唯一 FAIL L06e，见下）
PASS t-s20-camera 29s   == S-20 验收：57/57 通过 ==
PASS t-s21-camera 43s   == S-21 相机验收：13/13 通过 ==
PASS t-s12 104s         == S-12 端到端测试：30/30 通过 ==
PASS t-s35-accept 210s  == S-35 Lead 独立验收：17/17 通过 ==
PASS t-s34-accept 32s   [t-s34-accept] 42/42 PASS · failures=0
PASS t-s32-ia 0s        [s32-ia] 239/239 PASS · failures=0
PASS t-s32-camera 0s    === S-32 D3 相机纯逻辑：51/51 通过 ===
PASS t-drawer 59s       == S-24 抽屉端到端：18/18 通过 ==
PASS t-drawer-order 0s  # 断言 223 条：PASS 223 / FAIL 0
PASS t-drawer-layout 19s == t-drawer-layout：41/41 通过 ==
PASS t-drawer-overlap 29s == t-drawer-overlap：18/18 通过 ==
PASS t-drawer-framing 0s == S-24F F3 相机 framing 验收：48/48 通过 ==
PASS t-drawer-clip 1s   ===== t-drawer-clip：285/285 PASS，0 FAIL =====
PASS t-drawer-contract 14s == S-24 契约核对：12/12 通过 ==
PASS t-drawer-reclaim 24s == t-drawer-reclaim：7/7 通过 ==
PASS t-drawer-zoom 15s  == t-drawer-zoom：7/7 通过 ==
PASS t-drawer-sync 38s  == t-drawer-sync：7/7 通过 ==
PASS t-drawer-clip-px 10s == t-drawer-clip-px：7/7 通过 ==
PASS t-drawer-shots 27s == t-drawer-shots：4/4 通过 ==
PASS browser.test 183s  == 浏览器测试：103/103 通过 ==
PASS=22 FAIL=1 TIMEOUT=0
```

**唯一 FAIL：`t-land` L06e「连续成交 3 次后 GPU 几何体数稳定 40,41,41 / 场景对象数 83,83,83」——既有环境红，非 S-38 回归**：

- 最终包与 **S-37 基线包**（`/tmp/s38/baseline-dist`，`S38_DIST` 指向它）同判据、同读数 `40,41,41 / 初始 34`（日志 `/tmp/s38/regress/t-land.log` vs `t-land-baseline.log`）⇒ **持平，未回退**。
- 根因：SwiftShader 软渲染下 `renderer.info.geometries` 的回收时机受负载影响（首轮 14:14 也是同一读数）；S-38 只改 peek 常量与抽屉文案/行高，不碰买地、几何体分配/dispose 路径。
- 同套件其余 60 条全过（L07 连买 78 次、L08a 满岛 85 块坐标、L11 写档失败、L12 拒启动等）；该套件在收口期高负载下 `L08a` 偶发（14:39/14:40 两次 59/61），干净轮复跑 **60/61、L08a=85/85**：`/tmp/s38/regress/t-land-clean.log`（attempt2，15:0x）、14:14 首轮 `/tmp/s38/regress/t-land.log` 亦为 60/61。
- 结论：**与 S-37 交付时「回归全绿或持平」的验收口径一致**；L06e 单列环境红，交机主复验时请看真机/低负载重跑。

## 8 未验证项 / 已知风险（如实）

1. **真机字体差异**：320/390 的「放得下」判定用 headless Chromium + Noto Sans CJK 实测宽（留 6%+1px 余量）；iOS/Android WebView 的 PingFang/系统字体宽度未实测。若真机更宽，兜底会降 11px / 拆两行，不会省略号吃数字。
2. **弱色观感**：套件断言的是 `subtitleWeakFrom=0` + 分段数据，`#b3a695` 的实际对比度观感由 U1 看图评（见 `玩家锐评.md`）。
3. **320 兜底分支**：390/320 实测都走 `one12`（12px 一行放得下）；11px 与拆两行分支只由纯函数合成窄宽覆盖，未在真机 320 上自然触发。
4. **t-drawer-fps**：本机 SwiftShader 软渲染 + 高负载下 FPS 阈值不可复现（S-32 起已知环境红），未列入本次回归；真机帧率待机主复验。
5. **U1 评审**：`玩家锐评.md`（会话在 10:40 被打断，U1 于 14:10 后补交）最终 **P0=0 / P1=0 / P2=7 ⇒ 实现层通过**。初评 3 条 P1 经反证改判：①「增量要心算」②「行内无升级价」两条来自机主已定文案矩阵、E2 逐字实现 ⇒ 移入「§3.1 口径建议（待机主裁决）」，不计实现缺陷；③「320 新手气泡压第 4 行」用基线包对照图（`u1-check-toast-320-baseline.png` 压得更狠：tab 行+标题+第 1 行）证明是**既有瞬态**（`app.ts:2686` new-game toast 4 秒、锚点固定不读行高）⇒ 降 P2-7。7 条 P2 见该文件（含状态词/徽章重复、弱色对比度、320 岛底离目标条约 20px、Lv10000 顶栏溢出等）。
6. **未出正式包/未打包**（按任务书，S-30 收口）；内部包用于真机复验。
7. 会话在 10:40–14:10 之间被基础设施打断，E1 的 t-s36-lift 首轮尾部 5 条为浏览器进程崩溃（TargetCloseError）；收口时用最终包 14:20 完整采集 raw（430×932 四档齐全、14 张截图、pageerror=0）重跑断言 ⇒ **53/53**，已区分「环境崩溃 vs 判据失败」。
8. **`t-land` L06e 既有环境红**：最终包与 S-37 基线包同读数 `40,41,41 / 初始 34`，与 S-38 改动无因果（详见 §7.1）；高负载下 `L08a` 偶发（14:39/14:40 两次 59/61；14:14 干净轮 60/61、L08a=85/85）。
9. **`lead-accept` 采样口径加固**：旧版用真实时钟 + `sleep(200)`，本机高负载 rAF 节流时会读到过渡中间态（full 下沿偶发 +0.45~0.54%H）；收口改为与 `tools/s35-framing.mjs` 相同的「假时钟冻结 + `setAutoTick(false)` + `stepFrames`」受控采样（`tools/s38-lead-accept.mjs`），half/full 与 S-35 基线逐位对齐。产品代码未因此改动。
