# S-37 / E2 · 性能与休眠（B 根因验收）

> 角色：E2（性能与休眠）。唯一口径：`tasks-out/S-37/接口约定-S37.md` §2 + Lead 追加口径（2026-10-25）。
> 采集夹具：`tools/s37-perf.mjs`；断言：`test/t-s37-perf.mjs`（15 项全绿）。
> 原始读数（含**逐帧间隔数组**，可复核）：
> - `tasks-out/S-37/E2-perf-baseline.json` / `-2` / `-3`：基线包 `/tmp/s37/baseline-dist`（main-b0959ef05d.js = S-36 行为 + 仅计数器）× 3 轮
> - `tasks-out/S-37/E2-perf-new.json` / `-2` / `-3`：新包 `dist/web-internal` = **main-e029ea93fe.js** × 3 轮
> - `tasks-out/S-37/E2-p08-baseline.json` / `E2-p08-new.json`：P08 单次测量成本（桌面 CPU + 8× CPU 节流）
>
> 每轮运行独立 launch 一个浏览器；每轮 ~49s；三轮同一时段交替跑（baseline/new/baseline/new…），机器 loadavg 见 JSON。

## 0 结论

| 项 | 结果 |
|---|---|
| B（旋转 10s 周期性重测） | **已消除**：基线 `boxCalls +93` → 新包 **0**（三轮全 0） |
| B 附带（松手惯性期仍在测） | 基线「旋转后同页静置 5s」`boxCalls +17`（三轮全 17）→ 新包 **0** |
| B3（调过高度后停稳休眠） | 基线「拖高后静置 5s」0 /「再旋转 5s」**+46** → 新包 **0 / 0** |
| 帧时间（环境受限） | p50 16.7ms、p95 **33.4ms**、max 50.1ms —— 两包**逐位相同**；≥50ms 长帧 基线 5 / 新包 8（见 §6 口径） |
| P08 单次测量成本（环境无关） | 手机级（8× CPU 节流）：旧 **1.0ms(p50)/2.47ms(mean)** → 新 **0.2ms(p50)/0.61ms(mean)** = **20%**；旧包 10s 主线程测量开销 **229ms** → 新包 **0ms** |
| 断言 | `node test/t-s37-perf.mjs` → **15/15 PASS** |

## 1 根因对照（改什么 / 为谁改 / 实测差值）

| # | 旧行为（基线包实测） | 新行为（本轮实测） | 证据 |
|---|---|---|---|
| B1 | `userBoundsSignature()` 含 `yaw/pitch/zoom/pan` ⇒ 旋转每帧签名都变 ⇒ `updateUserFramingBounds` **每 100ms 重测一次** | 签名只留物理事实（w/h/topH/bottomH/baseLift/focusCompose/fitRadius/buyMode/抽屉档位/tab/岛屿几何版本）⇒ 旋转期间签名恒定 | 旋转 10s `boxCalls` **93 → 0** |
| B2 | `islandScreenBox()`：`world.scene.updateMatrixWorld(true)`（整场景）+ ~2600 顶点逐点 `project()` + 每次 new Vector3 | 只更 `world.land.group` 子树矩阵；顶点缓存为局部坐标 Float32Array（按 geometry 缓存，几何变更才重建）；复用 Vector3 | 单次成本 1.0ms → 0.2ms（8× 节流）；`boxVerts=2598` 缓存生效 |
| B3 | `userFramingActive()` 把 `uLiftRaw!==0 \|\| uLiftShown!==0` 算活跃 ⇒ **调过一次高度后恒真**，停稳后每帧仍走测量路径（配合 B1 连旋转都测） | 活跃判据 = 手势中 / 速度≠0 / 回位动画中 / raw≠shown；停稳即休眠 | 拖高 85~99px 停稳后：静置 5s 0/0、再旋转 5s 基线 **+46** → 新包 **0** |

## 2 方法（可复核）

```bash
export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH
cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm035
# 采集（各跑 3 轮；第 2/3 轮只改 --out 后缀）
node tools/s37-perf.mjs --dist /tmp/s37/baseline-dist --out tasks-out/S-37/E2-perf-baseline.json
node tools/s37-perf.mjs --dist dist/web-internal   --out tasks-out/S-37/E2-perf-new.json
# P08 单次测量成本（桌面 + 8× CPU 节流）
node tools/s37-perf.mjs --p08-only --dist /tmp/s37/baseline-dist --out tasks-out/S-37/E2-p08-baseline.json
node tools/s37-perf.mjs --p08-only --dist dist/web-internal   --out tasks-out/S-37/E2-p08-new.json
# 断言（自动对同族多份 JSON 取中位数，打印对比表）
node test/t-s37-perf.mjs
```

夹具口径（为什么不用 s36-lift 的受控帧）：本次量的是**真实帧间隔**，手动 `__raf.step()` 推进的帧没有物理耗时、量不到卡顿。

- 页面：390×844、`?debug=1`、`#debug-only` 两包一致隐藏；`serve()+launch()` 来自 `test/lib.mjs`（SwiftShader 软渲染，绝对帧率不代表真机）。
- **每场景独立 launch**（前一个 WebGL 上下文销毁后 SwiftShader 会变慢，跨场景复用会污染帧率读数）。
- 激活用户位移：**真实 CDP 触摸**（`Input.dispatchTouchEvent`）两指同向纵拖上移 60px（间距不变 ⇒ lift），松手等 800ms；两包都走 `method='gesture'`（没有退回测试口）。
- 场景 R（旋转 10s）：单指 `pointerdown` 一次，之后**每帧**一次 `pointermove`（4px/帧同向、到屏宽折返 = 真实用户来回 swipe），事件走 canvas 生产监听器（`main.ts ⇒ input.pointerMove ⇒ cam.drag`）；同段页内 rAF 收帧时间戳。旋转后用**同页**再静置 5s（P03-REF 参考项，抵消环境负载）。
- 场景 I（静置 5s）：新页面只等就绪 +600ms，然后静置。
- 场景 F（B3）：调高 → 停稳 → 静置 5s → 再旋转 5s；再追加 P05b：**慢拖调高（不甩，vLift=0）**→ 松手立刻停手 → 静置 5s。
- 读数口：`__wyszzDebug.perf() = { boxCalls, boundsUpdates, boxVerts, boxMs, frames, fps }`；辅助 `userFraming()/islandBoxScreen()/camera()/inputStats()`。

## 3 最终读数（3 轮中位数；括号内为三轮原始值）

| 指标 | 基线 main-b0959ef05d | 新包 main-e029ea93fe |
|---|---|---|
| R 旋转 10s `boxCalls` 增量 | **93**（93/93/93） | **0**（0/0/0） ✅ |
| R 旋转 10s `boundsUpdates` 增量 | **93**（93/93/93） | **0**（0/0/0） ✅ |
| R 旋转后同页静置 5s `boxCalls`（惯性期） | **17**（17/17/17） | **0**（0/0/0） ✅ |
| I 静置 5s `boxCalls` / `boundsUpdates` | 0 / 0（全 0） | 0 / 0（全 0） ✅ |
| F 拖高后静置 5s `boxCalls` / `boundsUpdates` | 0 / 0 | 0 / 0 ✅ |
| F 拖高后再旋转 5s `boxCalls` / `boundsUpdates` | **+46 / +46**（47/45/46） | **0 / 0** ✅ |
| P05b 慢拖不甩 → 静置 5s | 0 / 0（vLift=0） | 0 / 0（vLift=0） ✅ |
| R 帧数（app frames 增量） | 433（434/432/433） | 419（419/429/418） |
| R 帧间隔 mean / p50 / p95 / max | 23.53 / 16.7 / **33.4** / 50.1 ms | 24.16 / 16.7 / **33.4** / 50.1 ms |
| R ≥33ms / ≥50ms / ≥100ms 帧数 | 168 / 5 / 0 | 177 / 8 / 0 |
| I 静置 frame p95 / max | 33.4 / 50.0 ms | 33.4 / 50.0 ms |
| `boxVerts` / `boxMs` | 0 / 0~1ms（旧实现不写 verts，Date.now 1ms 分辨率） | **2598** / 0.6~0.8ms |
| 默认构图岛底（`islandBoxScreen`） | 47.83%H（0.4784/0.4784/0.4783） | 47.83%（三轮一致） |
| 拖高后夹取行程 `liftHi-liftLo` | 185.68px（三轮一致） | 185.68px（三轮一致） |
| `liftShownPx`（真实手势调高后） | 89.0px（89.0/85.1/89.6） | 85.0px（85.0/89.5/99.3） |
| pageErrors（R+I+F） | 0 | 0 |

> 帧数/mean 差 3% 的说明：p50/p95/max **逐位相同**，差在尾部（≥50ms 帧 5 vs 8）；两包交替跑，尾部受机器上其它 agent 的 chromium/qemu 抢占影响，**不解释为产品退化**；P03 判据只看 p95（相对值），不受影响。如需更严格 mean 对比，需要在完全静默机器上复测（见 §7）。

## 4 断言结果（`node test/t-s37-perf.mjs` → **15/15 PASS**）

| 编号 | 判据 | 结果 |
|---|---|---|
| BASE-OK | 基线/新包读数齐（各 3 轮，main hash 正确） | ✅ |
| B-REPRO | 基线旋转 10s `boxCalls>0`（根因 B 复现） | ✅ 93 |
| P01 | 旋转 10s `boxCalls=0` 且 `boundsUpdates=0` | ✅ 0 / 0 |
| P02 | 旋转 10s ≥50ms 长帧（**环境受限，告警口径**：基线自身有长帧 ⇒ 只记录不判红） | ✅ 新 8 / 基线 5（≥33ms 新 177 / 基线 168，p95 均 33.4ms） |
| P03 | 旋转 p95 ≤ 基线 p95×1.05（3 轮中位数） | ✅ 33.4 vs 33.4 = **100.0%** |
| P03-REF | 参考项：旋转 p95 ≤ **同页**静置 p95×1.10（抵消负载） | ✅ 100.0% |
| P04 | 静置 5s 增量=0 | ✅ 0 / 0 |
| P05 | 拖高后静置 5s / 再旋转 5s 增量=0（B3） | ✅ 0/0、0/0（基线旋转 +46） |
| P05b | 慢拖不甩（vLift=0）松手立刻停手 → 静置 5s 增量=0 | ✅ 0/0，vLift 0/0/0 |
| P06 | pageErrors=0 | ✅ 0 |
| P07 | 反向护栏：frames 正常增长（+419）、相机真实在转（摆动路径 5.86rad）、岛底 ≈48%H、夹取行程 185.68px（范围真的解出来） | ✅ |
| NOTE-PATH | 激活路径 = 真实两指纵拖（非测试口） | ✅ gesture |
| P08a | 单次全量测成本：新 ≤ 旧×0.5（手机级 8× 节流 p50） | ✅ 0.2 vs 1.0ms = **20%** |
| P08b | 基线每 10s 主线程测量开销 ≥200ms | ✅ **229ms**（93 次 × 2.47ms；桌面 CPU 22ms） |
| P08-NOTE | 口径说明（桌面 CPU 太快 ⇒ 200ms 阈值只在手机级成立） | ✅ 记录 |

## 5 P08：环境无关的单次测量成本（Lead 追加项）

做法：把页面 `Date.now` 换成 `performance.now` 派生值（`perf().boxMs` 内部就是 `uiNow()` 差值）⇒ 读到亚毫秒精度；
用 `setBuyModeNow` 来回切（生产路径设置 `uBoundsForce=true`）强制「立即重测」，warm 3 次后连续量 30 次（8× 节流下 20 次）。
旧包的 `updateUserFramingBounds` 只在「有用户位移」时才被调用（B3 的另一半）⇒ 先在两包都造一个非零位移再测。

| 口径 | 旧包 main-b0959ef05d | 新包 main-e029ea93fe | 比值 |
|---|---|---|---|
| 桌面 CPU（本机 V8）p50 / p95 / mean | 0.3 / 0.4 / 0.24 ms | 0.2 / 0.3 / 0.18 ms | 0.76× |
| **8× CPU 节流（手机级估算）p50** | **1.0 ms** | **0.2 ms** | **0.20×** ✅ |
| 8× 节流 mean / p90 / max | 2.47 / **11.2** / 14.2 ms | 0.61 / 2.0 / 2.3 ms | 0.25× |
| 每 10s 主线程测量开销（节流） | **229ms**（93 × 2.47） | **0ms**（0 × 0.61） | — |
| 每 10s 主线程测量开销（桌面） | 22ms（93 × 0.24） | 0ms | — |

解读：
- 旧包单次测量在**手机级 CPU** 上典型 1ms、尾部 **11~14ms**（≈ 一帧 16.7ms 预算的 2/3~85%）⇒ 10Hz 一次 = 玩家能感知的**周期性卡顿**；这就是 B 的真机机理。
- 新包把这一次的成本压到 0.2ms（B2），并把**次数**从 93 次/10s 降到 **0**（B1+B3）⇒ 主线程测量开销 229ms → 0ms。
- 桌面 CPU 上单次仅 0.2~0.3ms，所以「每 10s ≥200ms」在桌面上本就不成立（22ms）；200ms 阈值只在手机级口径下有意义，已显式写明。
- 注意：**P08a 的收益主要来自单次成本（B2），而 B 的感知收益主要来自次数归零（B1+B3）**；不要只拿单次成本比来代表整体收益。

## 6 环境说明（帧时间属于环境受限指标）

- 三轮运行 loadavg：基线 17.1/22.1、16.2/20.0、16.0/19.0；新包 13.5/20.4、16.1/19.4、16.6/18.6（`loadavg 1min/5min`，每轮 JSON 内可查）。
- 机器上长期有其它 agent 的 chromium `gpu-process`（各 200~500% CPU）与 qemu 模拟器；SwiftShader 软渲染 + rAF 量化（16.7/33.3/50ms）⇒ 两包 p95 都钉在 33.4ms，**绝对帧率不代表真机**。
- 按 Lead 2026-10-25 口径：|「无 ≥50ms 长帧」**不判红**（基线自身 5 个 ≥50ms 帧），只记录原始计数；两包原始帧间隔数组都保留在 `E2-perf-*.json` 的 `R.frames.intervals` 内。

## 7 未验证 / 待办

1. **最终包 hash**：本文件读数对 `main-e029ea93fe.js` 有效；Lead 若再构建（hash 变化），需对最终包重跑 3 轮并回填。
2. **真机**：P08 的 8× 节流是「手机级估算」，不是真机实测；帧率只认相对值。
3. 未覆盖尺寸：320/414/430 的帧时间（接口约定 §2 只要求 390×844）；其它功能的零回退由 Lead 全量回归覆盖。
4. 帧 mean 差 3%（尾部）需在完全静默机器上复测才能定性；p50/p95/max 已逐位相同。
