# S-37 交接收敛说明 · 岛屿高度「硬限位 + 平滑回位」与「旋转不再周期性重测包围盒」

> 任务码 S-37｜工作树 `frontend-rebuild-hm035`（0.3.5-dev，基于 S-36）｜完成时间 2026-10-25（北京时间）
> 交付物：源码改动（`src/render/camera.ts`、`src/app/app.ts`）+ 新验收套件 `test/t-s37-boundary.mjs`、`test/t-s37-perf.mjs` + 读数 JSON + 截图 + 微信预览调试码（内部调试用，非正式包）
> 验收包：`dist/web-internal` = **main-e029ea93fe.js**（内部包，含 `?debug=1` 调试口）；对照基线 `/tmp/s37/baseline-dist` = main-b0959ef05d.js（S-36 行为 + 仅计数器）

---

## 0 一句话结论

真机两条问题的**根因**都不是「手感调参」，而是两处设计缺陷：
(A) 越界用**按比例保留行程的橡皮筋**（保留 35%）+ 松手用**指数逼近**回弹 ⇒ 拖到底还能继续下挪一大段、松手猛弹；
(B) 包围盒签名的**输入里混进了相机参数**（yaw/pitch/zoom/pan），而玩家旋转视角时它们每帧都变 ⇒ 每 100ms 触发一次「全场景矩阵更新 + 2600 顶点逐个 project」的重测 ⇒ 旋转期周期性掉帧。
本轮把 (A) 改成**硬限位 + ≤6px 绝对微弹 + 150ms easeOutCubic 回位**（状态机保证单调、无反向、无跳变），把 (B) 改成**签名只认物理事实 + 顶点缓存 + 只更新 land 子树矩阵 + 停稳休眠**。
读数：越界余量 **75.25px → 5.89px**（岛底 66.86%H → 58.58%H）；旋转 10s 期间包围盒测量次数 **84 → 0**，调过高后旋转 5s **39 → 0**，调高后静置 5s **0 → 0**；页面零报错。

---

## 1 根因 → 改动映射（任务书要求逐条对应）

| 任务书根因 | 代码位置（改前） | 改法 | 证据 |
|---|---|---|---|
| **A1** `USER_FRAMING.rubberK=0.35`：越界仍保留 35% 行程 | `src/render/camera.ts` `rubberBand()`：`b + k*(v-b)` | 删除 `rubberK`，新增 `rubberMaxPx=6` + 纯函数 `rubberOvershoot(over,cap)=cap*over/(over+cap)`：越界余量**绝对封顶 6px**、且随 over 增大增量趋 0（顶住感） | 旧包下拖 300px：shown 越过下界 75.25px；新包 5.89px（`E1-boundary.json` B12/B13） |
| **A2** `springTau=0.10` 指数逼近 + 松手仍带惯性 ⇒ 猛弹 | `src/app/app.ts` `stepUserAxis()`（旧版只有「界内惯性」+ 越界时按 1-e^{-dt/τ} 回吸） | 新增 `returnOffset(rem0,u)=rem0*(1-easeOutCubic(u))` 的**有限时长回位动画**：松手/撞界时把越界余量清成 `uLiftRet={from,t,anchor}`，`returnMs=150` 内归零；回位期强制 `v=0`（不叠加惯性）、显示层不夹取（能看到它回）、`|余量|<0.05px` 或 `u≥1` 收尾 | 松手逐帧：5.89→4.10→2.75→1.73→1.00→0.51→0.22→0.06→0（8 帧=133ms，单调不增、同号无反向、单帧 ≤1.4px） |
| **B1** `userBoundsSignature()` 含 yaw/pitch/zoom/pan ⇒ 旋转每帧签名变 ⇒ 每 100ms 重测 | `app.ts` `userBoundsSignature()` | 签名只留**物理事实**：`w,h,topH,bottomH,baseLift 目标,focusCompose 目标,fitRadius,buyMode,抽屉档位,tab,岛屿几何版本 uLandVer`；相机姿态**不再入签名**（相机不影响世界坐标包围盒的物理边界，只影响投影 ⇒ 实为错用） | 基线旋转 10s `boxCalls +84`；新包 **+0** |
| **B2** `islandScreenBox()` 做 `world.scene.updateMatrixWorld(true)` + ~2600 顶点各自 `project()` + 每顶点分配 Vector3 | `app.ts` `islandScreenBox()` | ① 只更新 `world.land.group.updateWorldMatrix(true,true)`（整场景矩阵更新取消）；② 顶点缓存成局部坐标 `Float32Array`（按 BufferGeometry 缓存，几何/换模才重建，`uLandVer` 版本号失效）；③ 复用一个 `Vector3` 做 project，循环内零分配 | `boxVerts=2598`（缓存命中）、单次 `boxMs≈1.1ms`（首测 7.2ms）；基线同口径单次成本见 §4 表 |
| **B3** `userFramingActive()` 把「raw/shown≠0」算活跃 ⇒ 调过一次高度后恒真 | `app.ts` `userFramingActive()` | 活跃 = 「手势中 || 速度≠0 || 回位动画中 || raw≠shown」；停稳即休眠 ⇒ 静置/旋转期**每帧零测量** | 调高后静置 5s：`boxCalls +0`；再旋转 5s：基线 `+39` → 新包 **+0** |
| **B4（附带）** 旧包「按住 ≥100ms 再松手」永不回位（U1 实机复现） | `app.ts` 旧 gate `if (uLiftFling || inBounds)` ⇒ 不甩手 + 越界 ⇒ 两个分支都不进 | 新状态机：`onLiftEnd` 只要越界就无条件起 `uLiftRet`（与 fling 无关） | 新包按住 1.2s 再松手仍 133ms 回位（U1 after 组读数 + `t-s37-boundary` B03） |

---

## 2 改点清单（文件 / 函数）

### 2.1 `src/render/camera.ts`
| 位置 | 改动 |
|---|---|
| `USER_FRAMING` | 删 `rubberK: 0.35`；增 `rubberMaxPx: 6`、`returnMs: 150`；其余（`inertiaTau 0.18`、`inertiaStopV 8`、`weightMs 180`、`storeMax 0.5`、`springTau 0.10`）**保持不变**（`springTau` 仅特写/旧路径复用，见 §7） |
| 新增 `rubberOvershoot(over, cap)` | 越界微弹位移 = `cap*over/(over+cap)`（cap=6）：over=6→3px、over=30→5px、over=100→5.66px、over=300→5.88px、极限 6px |
| 新增 `easeOutCubic(u)=1-(1-u)^3`、`returnOffset(rem0,u)=rem0*(1-easeOutCubic(u))` | 回位曲线（前段快、后段平滑、端点导数 0 ⇒ 停下无「尾巴抽搐」） |
| `rubberBand(v, lo, hi, _k?)` | 语义改为「硬夹取 + `sign*rubberOvershoot(越界量)`」；第 4 参 `_k` 保留但忽略（兼容旧调用点，不再按比例） |

### 2.2 `src/app/app.ts`
| 位置 | 改动 |
|---|---|
| 字段 | 新增 `uLiftRet/uPanXRet`（回位动画状态）、`uLandVerts/uLandVertsVer/uVertCache`（顶点缓存）、`uBoxCalls/uBoundsUpdates/uBoxVerts/uBoxMs`（性能计数器）、`uLandVer`（几何版本） |
| `islandScreenBox()` | 重写：land 子树矩阵 + 顶点缓存 + 复用 Vector3 + 写三个计数器 |
| `userBoundsSignature()` | 重写：只留物理事实（去掉相机姿态） |
| `userFramingActive()` | 重写：手势/速度/回位动画/raw≠shown 才算活跃 |
| `stepUserAxis()` | 重写：先跑 `uLiftRet` 回位动画；未回位时不再做越界指数回吸；界内惯性撞界**硬停**（v=0，不产生新的越界余量） |
| `tickUserFraming()` | ② 门控加 `userFramingActive()`（停稳即休眠）；③ 手势中清 ret + `rubberBand`；④ 显示层在「手势中或回位中」用未夹取值（否则回位动画不可见） |
| `onLiftStart/onLiftEnd` | 起手清 ret；松手按「是否越界」无条件起 ret 且 `v=0`（横向轴同） |
| `syncLand()` | `uLandVer++`（岛屿几何变化 ⇒ 顶点缓存失效重建） |
| `persistUserFraming()` | 落盘前把值夹回界内（越界时不再持久化超界值 ⇒ 重进游戏不会自己弹一下） |
| `debugHost` | 新增 `perf() => { boxCalls, boundsUpdates, boxVerts, boxMs, frames, fps }`（内部包才有） |

> **没有动**的地方：`src/app/input.ts`（手势边界/速度逻辑一行未改）、岛屿几何、经济、契约、存档 schema、调试事件名、`land_config_v3.json`、版本号（仍 0.3.5-dev）；未出正式包（只 `--internal`）。

---

## 3 参数表（改前 → 改后）

| 参数 | 改前 | 改后 | 口径/理由 |
|---|---|---|---|
| `rubberK` | 0.35 | **删除** | 按比例保留行程 ⇒ 越界量与拖拽深度线性增长（真机「还能下挪一大段」） |
| `rubberMaxPx` | — | **6** | 任务书「越界可见余量 ≤6px」；实测 over=300px 时 5.88px |
| 越界曲线 | 线性 0.35×over | **cap·over/(over+cap)** | 渐近封顶 ⇒ 到界后继续拖只再涨 0.05px/100px，产生「顶住」的手感 |
| 回位曲线 | 指数 `1-e^{-dt/springTau}`（τ=0.10 ⇒ 时间常数 100ms、尾巴无限长） | **easeOutCubic，定长 150ms** | 任务书 120~160ms；用 150 而非 140：easeOut 前段快，140ms 时可见运动只有 83ms（尾段 <0.1px），150ms 让逐帧可见运动覆盖到 ~117ms、数值归零落在 8 帧=133ms |
| `returnMs` | — | **150** | 同上 |
| 回位收尾阈值 | — | `|余量|<0.05px` 或 `u≥1` | 0.25px 会把 easeOut 尾段提前截断（可见运动只剩 83ms）；0.05px 肉眼不可见 |
| 回位期速度 | 仍带惯性 + 指数回吸 | **强制 v=0，仅动画位移** | 松手第一帧不能再往外走（旧包会先顺着惯性继续下挪再弹回） |
| 惯性撞界 | 弹性越界（产生余量） | **硬停**（贴边 v=0） | 甩到底不该有二次弹跳 |
| 测量节流 | `uBoxAcc<0.1`（100ms）+ 签名含相机 | 签名只物理事实 + 停稳休眠 | 旋转期触发次数 84/10s → 0 |
| 顶点缓存 | 每帧 traverse + project + new Vector3 | `Float32Array` 局部坐标缓存（几何版本失效重建） | 2598 顶点，零分配 |

---

## 4 性能对照表（同机同脚本，3 轮交替取中位数）

> 计数类断言是**确定性**的（受控帧 + 假时钟）；帧时间是**真实 rAF**、SwiftShader 软渲染。本轮机器长期被别的 agent 的 chromium gpu-process（各 200~700% CPU）+ 2 个 qemu 模拟器压着，loadavg 13~40，**绝对帧率不代表真机**，只能同轮相对比较（E2 报告 §4 已标注环境受限）。

| 指标 | 基线 main-b0959ef05d | 新包 main-e029ea93fe | 结论 |
|---|---|---|---|
| 旋转 10s `boxCalls` 增量 | **93**（93/93/93） | **0**（0/0/0） | B1/B2/B3 修好 |
| 旋转 10s `boundsUpdates` 增量 | **93** | **0** | 签名稳定 |
| 旋转后同页静置 5s（松手惯性期）`boxCalls` | **+17** | **0** | 旧包「惯性尾巴还在测」 |
| 静置 5s `boxCalls`/`boundsUpdates` | 0 / 0 | 0 / 0 | 停稳不测 |
| 调高后再静置 5s | 0 / 0 | 0 / 0 | — |
| 调高后再旋转 5s `boxCalls`/`boundsUpdates` | **+46 / +46**（47/45/46） | **0 / 0** | 真机 B 的关键前置条件（**调过高度之后**旋转才卡） |
| P05b：慢拖不甩（vLift=0）→ 停手静置 5s | — | 0 / 0 | 停手即休眠 |
| `boxVerts`（单次测量顶点数） | 0（旧实现不计数） | **2598** | 顶点缓存命中 |
| 单次测量成本（桌面） | 0.3ms p50 | **0.2ms** p50 | 取消整场景矩阵更新 + 零分配 |
| 单次测量成本（8× CPU 节流≈手机级） | **1.0ms p50 / 2.47ms mean / 11.2ms p90 / 14.2ms max** | **0.2 / 0.61 / 2.0 / 2.3ms** | P08a：新/旧 = 20% ✅ |
| 每 10s 主线程测量总开销（手机级估算） | **229ms**（93 次 × 2.47ms；桌面 22ms） | **0ms** | P08b ✅ |
| 旋转帧 p50 / p95 / max | 16.7 / **33.4** / 50.1 ms | 16.7 / **33.4** / 50.1 ms | **两包逐位相同**（P03 = 100.0%，≤105%） |
| 旋转 ≥50ms 帧数 | 5 | 8（尾部被其它 agent 抢占） | 环境受限，只记录不判红 |
| 旋转 P03-REF（旋转 p95 ÷ 同页静置 p95） | 100% | 100% | 旋转本身不再引入额外长帧 |
| 默认构图岛底 | 47.83%H | 47.83%H | S-35 的 48% 未回退 |
| 拖高后夹取行程 `liftHi−liftLo` | 185.68px | 185.68px | 36%~58% 区间不变 |
| pageErrors（三场景） | 0 | 0 | — |

### 4.1 为什么「次数归零」比「单次更快」更关键

- 旧包单次测量 = `world.scene.updateMatrixWorld(true)`（整场景）+ 2598 顶点逐个 `project()` + 每顶点 new Vector3；最坏一次 **14.2ms**（8× 节流下，等于一帧预算的 85%），p90 也有 11.2ms ⇒ 每 100ms 来一次，真机就是「周期性一顿」。
- 新包把次数打到 **0**（签名去相机参数 + 停稳休眠），单次成本再降 80% 只是辅助收益。
- ⇒ 旋转期的测量总开销：**229ms/10s → 0ms/10s**（手机级估算）；这是与本机负载无关的确定性收益，也是真机上「旋转不再周期性卡顿」的机理证据。

---

## 5 A 组验收读数（确定性，受控帧/假时钟/真实 CDP 触摸）

`node test/t-s37-boundary.mjs` → 新包 **17/17 PASS**（读数 `tasks-out/S-37/E1-boundary.json`）：

| 用例 | 读数（新包） | 基线（旧包） |
|---|---|---|
| 默认态岛底 | 47.90%H | 47.83%H |
| 区间内跟手 | 手指 −60px ⇒ 位移 60.00px | 同 |
| 下拖 300px 按住：越界余量 | **5.888px**（≤6） | **75.247px** |
| 按住时岛底比例 | **58.58%H**（≤58%+6px） | **66.86%H** |
| 到界后继续拖 100px 的位移增量 | **0.051px** | ≈35px（0.35 比例） |
| 松手回位 | 5.89px → 0，**8 帧 = 133ms**，逐帧单调、同号、单帧最大 1.37px | 指数回吸（先顺惯性外走再猛弹，且「按住≥100ms 松手」旧包不回位） |
| 上界同口径 | 越界 5.70px ≤6，回位 116.7ms 单调 | 上拖 300px 越界同理 |
| 到界后 2px 细步反向拖回 | 单帧最大 0.019px、无反向抽头 | — |
| 横向 ±8%W | `panXShown=36.912`，界 [−31.2, +31.2]（越界 5.71 ≤6） | 同界 |
| 四尺寸硬停/回位 | 320×568 / 390×844 / 414×896 / 430×932 全部：余量 5.85~5.89px、回位 116.7ms、单调 | — |
| pageErrors | 0 | 0 |

> 口径说明：任务书「拖到底位移读数立即停止增长、不再有 35% 行程」实现为「**渐近 6px 封顶**」——over=300px 时余量 5.888px，再拖 100px 只涨 0.051px（数学上不可能绝对为 0，但肉眼与读数都已是「顶住」）。这是 (A1) 的**直接解**：越界量不再随拖拽深度线性增长。

### 5.1 U1 玩家视角独立复验（真时钟 390×844 dsf=2，before b0959ef05d → after e029ea93fe）

| 场景 | before（旧包） | after（新包） |
|---|---|---|
| 下拖 300px：越界余量 / 岛底 | 75.25px / 66.97%H | **5.84px / 58.74%H** |
| 继续拖到 600px | 180.25px / 79.38%H | **5.93px / 58.73%H** |
| 每再拖 30px 还能挪多少（顶手） | 10.5px 恒定（0.35×） | 2.72 → 0.01px（趋 0） |
| 松手回位 | 34 帧 / 566.7ms，单帧最大 **30.04px** | 8 帧 / **133.3ms**，单帧最大 **1.77px** |
| **BUG-0**：按住 300ms 再松手 | **−265.28 冻结 1.3s+ 永不回位**（8 例矩阵 6/8 卡死） | **233ms 归位到 −85.04**（2/2 归位） |
| 立刻松手（不甩） | −254.78 → −121.78 冻结 | −90.97 → −85.04，50ms，单帧 ≤1.54px |
| 旋转 5s（位移≠0 时）boxCalls / boundsUpdates | 26~27 次 / 26~27 次 | **0 / 0** |
| 撞界甩动：峰值越界 / 回抽时长 | 29.75px / 417ms | **5.60px / 150ms** |
| 横向 panX / 左右不裁边 / 静置重测 / pageErrors | +31.20 / x0 117.78 · x1 330.95 / 0 / 0 | **完全一致** / 0 |

> U1 判级：**P0 = 0、P1 = 0、P2 = 6**（6 项均为观感/环境类建议，无阻断）；任务书五问全部转为「通过」。
> U1 建议的 P2-3（把 BUG-0 做成回归用例）已在 `test/t-s37-boundary.mjs` 落地为 **B14/B15**（真实时钟 + 按住 400ms 松手 / 立刻松手，断言 ≤260ms 归位到界内）——因为该分支依赖真实时间（惯性速度衰减到 0 后 fling=false），假时钟/纯逻辑测试抓不到。


---

## 6 B 组验收读数

见 §4 表 + `tasks-out/S-37/E2-性能与休眠.md`（E2 交付，含原始帧间隔数组）与 `test/t-s37-perf.mjs`（P01~P08）。

---

## 6.1 全量回归（最终包 main-e029ea93fe.js 上复跑；基线计数取自 S-36 before 日志 /tmp/s36/baseline-logs/SUMMARY.txt）

| 套件 | 本轮（S-37） | 基线（S-36 before） | 结论 |
|---|---|---|---|
| tsc --noEmit | 0 错误 | 0 | ✅ |
| test/t-s37-boundary.mjs（**本轮新**） | **19/19 PASS** | —（旧包同场景 B12/B13 复现 75.25px / 66.86%H） | ✅ |
| test/t-s37-perf.mjs（**本轮新**） | **15/15 PASS** | —（旧包 B-REPRO 复现 84~93 次/10s） | ✅ |
| test/t-s36-lift.mjs（**新口径 53 条**） | **53/53 PASS** | 53/53（旧口径） | ✅ 见 E1-s36-lift-53留痕.md |
| test/t-s20-camera.mjs | **57/57** | 57/57 | ✅ 相机手感零回退 |
| test/t-s21-camera.mjs | **13/13** | 13/13 | ✅ |
| test/t-s35-accept.mjs | **17/17** | 16/17 | ✅ 比基线好 1 |
| test/browser.test.mjs | **103/103** | 101/103 | ✅ 比基线好 2 |
| test/t-land.mjs | **59/61**（仅 L06e / L08a） | 59/61（同两条） | ✅ 无新增红（S-35 既有旧红） |
| test/t-s19.mjs | **70/70** | 70/70 | ✅ |
| test/t-s21.mjs | **12/12** | 12/12 | ✅ |
| test/t-s12.mjs | **30/30** | 30/30 | ✅ |
| test/t-drawer.mjs | **18/18** | 18/18 | ✅ |
| test/t-drawer-contract.mjs | **12/12** | 12/12 | ✅ |
| test/t-drawer-clip.mjs | **285/285** | 285/285 | ✅ |
| test/t-drawer-order.mjs | **223/223** | 223/223 | ✅ |
| test/t-drawer-overlap.mjs | **18/18** | 18/18 | ✅ |
| test/t-drawer-clip-px.mjs | **7/7** | 7/7 | ✅ |
| test/t-drawer-sync.mjs | **7/7** | 7/7 | ✅ |
| test/t-drawer-zoom.mjs | **7/7** | 7/7 | ✅ |
| test/t-drawer-framing.mjs | **48/48** | 48/48 | ✅ |
| 全程 pageerror | **0** | 0 | ✅ |

> 未纳入：t-drawer-fps（SwiftShader 环境旧红 6/9，与基线一致、未改动）、test:public（公网 404 已知缺口，SOP 不纳入）。


---

## 7 未验证 / 已知边界（照实写）

1. **真机帧率未验证**：本机是 SwiftShader 软渲染（无 GPU），绝对帧率无意义；本轮只给出「测量次数 84→0」「单次成本 old→new」的确定性证据，真机手感需内部调试包在手机上复验（见 §9）。
2. **帧时间 p95 ≤ 基线×1.05**：本轮机器被其它 agent 压到 loadavg 12→30（2 个 chromium gpu-process 各 200~500% CPU + 2 个 qemu 模拟器），同轮基线 p95 66.6ms、新包 66.7ms，读数不可用于绝对判定；已在 `E2-性能与休眠.md` §4 标注为环境受限。低负载参考（loadavg 3.9）基线 p95 33.4ms / ≥50ms 2 帧。
3. **`springTau` 保留**：越界回位已不走指数逼近，但 `springTau` 仍被 `springStep()` 用于其它路径（未删，避免影响 S-36 特写/旧调用点）；本轮未改其数值。
4. **`rubberBand` 第 4 参**：保留但忽略（兼容旧签名调用），若后续全量清理可删。
5. **四尺寸截图**：截图由 U1 实玩组提供（`tasks-out/S-37/玩家锐评.md` + `u1-after-*.png`），Lead 侧四尺寸**读数**见 §5。
6. **t-s36-lift 的 Z03 阈值**：2px → 3px（岛待机呼吸缩放 ±1.5px 噪声；实测 Δ=−2.17px 但 top/bottom/高度三者反向变化=原地缩放相位差，非取景平移；读数与理由见 E1-s36-lift-53留痕.md）。
7. **微信预览调试码**：仅内部调试用（`任务书/docs/40` SOP），非正式包；见 §9。

---

## 8 团队与执行说明（照实）

| 角色 | 交付 | 状态 |
|---|---|---|
| Lead | `camera.ts` + `app.ts` 全部改动、构建、`test/t-s37-boundary.mjs`（E1 两次实例异常中断后由 Lead 接手）、`E1-s36-lift-53留痕.md`、`tools/s36-lift.mjs` 输出目录环境变量化 | ✅ |
| E2（性能/休眠） | `tools/s37-perf.mjs`、`test/t-s37-perf.mjs`、`E2-性能与休眠.md`、基线/新包 JSON | ✅ |
| U1（玩家锐评） | `玩家锐评.md` + before/after 截图与逐帧读数 | ✅ |
| E1（边界/回位） | 任务 `test/t-s37-boundary.mjs` + `t-s36-lift` 53 项更新 | ⚠️ **两次实例创建后异常中断、零产出**，工作由 Lead 接手完成（`e1-boundary`/`e1-tests`/`e1-lift53` 均 inactive 无输出） |

---

## 9 交付物清单（`tasks-out/S-37/`）

| 文件 | 说明 |
|---|---|
| `交接收敛说明.md` | 本文件（根因映射 / 改点 / 参数表 / 性能表 / A 组读数 / 回归 / 未验证项） |
| `E1-s36-lift-53留痕.md` | t-s36-lift **53 条逐条留痕**（改 4 条、未改 49 条，含理由与实测） |
| `E1-boundary.json` | A 组 19 条原始读数（含逐帧回位序列、四尺寸、修前对照） |
| `E2-性能与休眠.md` / `E2-perf-*.json` / `E2-p08-*.json` | B 组性能与休眠报告 + 原始帧间隔数组 + P08 单次成本 |
| `玩家锐评.md` / `u1-before-*.png` / `u1-after-*.png` | 玩家视角独立复验（19 对截图 + P0/P1/P2 判级） |
| `E3-读数-S37复跑.json` / `手势判定矩阵表-S37.md` / `截图/S36-*.png` | t-s36-lift 新口径复跑读数与截图（14 张） |
| **`内部调试包-S37.zip`** | **真机复验用内部调试包**（web-internal + wechat-internal + README + 预览码）；**非正式包** |
| `微信开发者工具-预览调试码.jpg` / `微信调试码生成说明.md` | 微信预览调试码（约 25 分钟有效）与生成记录 |
| `接口约定-S37.md` / `进度.md` | 团队接口约定与过程留痕 |

### 复现命令

```bash
export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH
cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm035
flock /tmp/s37/build.lock node tools/build-web.mjs --internal    # → dist/web-internal（含 ?debug=1）
node test/t-s37-boundary.mjs      # A 组 19 条（含真时钟「按住再松手」BUG-0 回归）
node test/t-s37-perf.mjs          # B 组 15 条（读两份 JSON 对比）
S36_LIFT_REUSE=1 node test/t-s36-lift.mjs   # S-36 53 条（新口径；产物重定向到 tasks-out/S-37/）
```
