# S-37 玩家锐评（U1 · 只读评审 · 初稿 v1）

**结论：P0=0 / P1=0 / P2=6 —— 机主报的两个真机现象在 after 包上都已消失，建议按验收线放行。**

> 一句话：**A「拖到底还能继续下挪、松手猛弹」**：旧包能一直往下拖（600px 手指 ⇒ 岛再下去 180px、岛底到 79.4%H、压进底部 HUD），松手一次性弹回（单帧 30px、566ms）；新包越界被硬限在 **5.9px**（岛底 58.7%H）、继续拖只是「顶手」（每再拖 30px 只多挪 0.01~2.7px）、松手 133ms 内平滑贴合（单帧 ≤1.77px，无反向无过冲）。**B「旋转周期性卡顿」**：旧包只要玩家拖过岛（位移≠0），就每 100ms 做一次全场景包围盒重测（同页交替实测 5s 内 26~27 次；Lead 口径 10s 84 次），新包同样场景 **0 次**。**附带**：旧包「按住 ≥100ms 再抬手 ⇒ 岛永久卡在界外不回位」（S-36 遗留 BUG-0）在新包已修（真时钟 233ms 内归位）。

---

## 0. 取证口径

| 项 | 值 |
| --- | --- |
| before 包 | /tmp/s37/baseline-dist，assets/main-b0959ef05d.js，sha256 b0959ef05dc34f6dd48c02d04c487044f2f0d74f12abf037fda7b2711cbea966，964001 B（S-36 行为 + 计数器） |
| after 包 | dist/web-internal，assets/main-e029ea93fe.js，sha256 e029ea93fe4d064615b7a2b135df119cdd70618ef8b695f58e74de894a8ff92c，966029 B（2026-10-25 15:27:44 构建，Lead 二次构建 hash 未变） |
| 版本/契约 | 0.3.5-dev 未变；returnMs=150（Lead 确认为有意调整，任务书 120~160 内）；云/取景默认/岛屿几何/经济/存档 schema/调试口名/land_config_v3.json 未动（本轮只读） |
| 环境 | node v24.15.0 + puppeteer-core + /usr/bin/chromium 154 headless（SwiftShader）；**390×844，dsf=2** 截图；帧时间另用 dsf=1 |
| 采集 A（确定性命中） | 受控 requestAnimationFrame 队列 + 假时钟，按 1/60s 逐帧泵（60fps 模型）：越界按住、逐帧回位曲线、惯性、上界、横向、静置 |
| 采集 B（墙钟/真机时序） | 真时钟 + 真 rAF：静置 5s、旋转 10s 的 perf().boxCalls / boundsUpdates 增量与帧间隔 |
| 采集 C（真机式触摸） | 真时钟 + CDP Input.dispatchTouchEvent 双指同向拖 / 单指横拖，「按住 300ms 再抬手」「立刻抬手」两种松手 |
| 权限 | **未改 src / test / tools / 配置 / 版本号**；临时脚本只在 /tmp/s37/；只写本文件与 u1-*.png |

### 0.1 复现命令（脚本不落工作树，避免占 tools 写权限）

    export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH
    cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm035
    node /tmp/s37/u1-play.mjs    --dist <包> --group before|after   # 受控 60fps：越界/回位/上界/横向/静置 + 截图 01~08
    node /tmp/s37/u1-real.mjs    --dist <包> --group before|after   # 真时钟：静置/旋转/按住松手/立刻松手/惯性 + 截图 12~19
    node /tmp/s37/u1-rot2.mjs    --dist <包> --group before|after   # 旋转归因：同页交替「干净态 / 已拖动态」各 5s
    node /tmp/s37/u1-inertia.mjs --dist <包> --group before|after   # 惯性/撞界（endLift 真速度收尾）

原始读数：/tmp/s37/u1-{before,after}.json、u1-real-{before,after}.json、u1-rot2-{before,after}.json、u1-inertia-{before,after}.json（结构化，含逐帧曲线）。pageErrors 全程 **0**。

---

## 1. 五问直答（玩家视角）

| # | 问题 | 结论 | 关键读数（before → after） |
| --- | --- | --- | --- |
| ① | **拖到底是否「顶手」** | **是**（旧包不是） | 越界余量 75.25px → **5.84px**；每再拖 30px 的位移 10.5px（恒定，0.35×）→ **2.72/2.40/0.37/0.15/0.08/0.05/0.04/0.03/0.02/0.01px**（迅速趋 0） |
| ② | **回位是否自然** | **是**（旧包是「猛弹」） | 566.7ms / 34 帧、单帧最大 **30.04px** → **133.3ms / 8 帧、单帧最大 1.77px**；反向帧 0→0、越过界 0→0 |
| ③ | **旋转是否还卡** | **测量口径上不再卡**（headless 下帧间隔无法直接分辨，见 §3/§7） | 位移≠0 时旋转 5s 的 boxCalls：26~27 → **0**；boundsUpdates 26~27 → **0**；干净默认态两包均 0 |
| ④ | **惯性是否舒服** | **是**（界内惯性未改；撞界不再外冲） | 撞界下甩峰值越界 29.75px、回抽 417ms → **5.60px、150ms**；上甩 24.27px/400ms → **5.52px/150ms**；全程单调、无越界后反抽 |
| ⑤ | **限位是否让人以为卡死** | **不会**（新包给出清晰的「顶住」信号） | 6px 可视余量 + 位移增量趋 0 + 5.9px 松手微弹；旧包相反（可无限下拖、松手大跳、按住松手直接卡死） |

---

## 2. A 场景读数（两指下拖 / 上拖到底，390×844）

### 2.1 越界行程（「还能继续下挪」）

| 项 | before b0959ef05d | after e029ea93fe |
| --- | --- | --- |
| 默认岛底 | 47.80%H（403.4px） | 47.80%H（403.4px） |
| lift 界 lo/hi | −85.01 / +100.67px | −85.01 / +100.67px（**未改**） |
| 下拖 300px 按住：liftRaw / liftShown | −300 / **−160.26** | −300 / **−90.85** |
| 越界余量（shown−lo） | **75.25px** | **5.84px** |
| 岛底比例 / 岛底 y | **66.97%H / 565.2px** | **58.74%H / 495.8px** |
| 越过 58% 红线 | 75.7px（9.0%H，岛压进「街区」抽屉） | 5.9px（0.74%H，**在容差内**） |
| 继续拖到 600px：shown / 越界 | −265.26 / **180.25px** | −90.94 / **5.93px** |
| 岛底比例（600px） | **79.38%H / 670px** | **58.73%H / 495.7px** |
| 上拖 300px 按住：shown / 越界 | +170.44 / **69.77px**（hi=+100.67） | +106.50 / **5.82px** |
| 岛底比例（上界） | **27.68%H**（越过 36% 红线 70.3px） | **35.29%H**（越过 6.0px） |
| 松手后落点 | 100.67（贴界，仅「立刻松手」路径） | 100.67 / 35.90%H |

**关键判据**：旧包越界量与手指行程成**固定 35% 比例**（每 30px ⇒ 10.5px），所以「拖到底」没有墙；新包是 cap=6px 的饱和曲线 6·over/(over+6)，手指继续走、画面几乎不动 —— 这就是玩家说的「顶手」。

### 2.2 松手回位曲线（受控 60fps 模型，从最大越界处松手）

| 帧 | before（起点 −265.26） | after（起点 −90.94） |
| --- | --- | --- |
| 0（松手瞬间） | −265.26 | −90.94 |
| 1 | −235.22（**Δ30.04**） | −89.18（Δ1.77） |
| 2 | −210.18（Δ25.03） | −87.80（Δ1.38） |
| 3 | −189.32（Δ20.86） | −86.77（Δ1.03） |
| 4 | −171.93（Δ17.39） | −86.03（Δ0.74） |
| 5 | −157.45（Δ14.49） | −85.53（Δ0.50） |
| 归位帧数 / 时长 | **34 帧 / 566.7ms** | **8 帧 / 133.3ms** |
| 单帧最大位移 | **30.04px**（≈ 屏幕高度的 3.6%） | **1.77px**（≤2px 红线） |
| 反向帧 / 越过界帧 | 0 / 0 | **0 / 0** |
| 余量 rem0 | −180.25px | −5.93px |

> 读法：旧包是「按住时岛已经沉到 79%H，松手后头 3 帧各跳 20~30px 把它甩回来」= 玩家说的**猛弹**；新包全程只有 5.9px 要收，且每帧 ≤1.77px，肉眼是「轻轻一沉就贴合」。

### 2.3 旧包 BUG-0（S-36 遗留 · 本轮新发现 · 新包已修）

| 场景（真时钟 + CDP 双指，390×844 dsf2） | before | after |
| --- | --- | --- |
| 下拖 600px → **按住 300ms** → 抬手 | liftShown **−265.28 冻结**、liftRaw 仍 −600、1.3s 后不动、**永不回位**（岛永久沉在 79.4%H，被抽屉压住） | −90.97 → **−85.04**，松手后 **233ms** 内归位（帧粒度 16fps：t=133.3ms 已 −86.80、t=233.2ms 精确 −85.04） |
| 下拖 600px → **立刻**抬手 | −254.78 → **−121.78 冻结**（只走了一步就停，永不归位） | −90.97 → −85.04，采样器测得 **50ms** 归位、单帧最大 **1.54px** |
| 旧包 8 例矩阵（下拖 100/300/600px × 按住 0/100/300ms） | **6/8 停在界外不回位**（−90.28 / −160.28 / −265.28 三档冻结） | —（新包 2 例均归位） |

根因（Lead 已确认，旧代码 gate）：松手时 fling 与 inBounds 两个条件都不成立（按住不动 ⇒ 速度 0；且处于界外）⇒ 只清速度、不进回位分支。玩家可感知后果：**拖到底按住想「定住」再松手，岛就留在那里挡住抽屉/建筑，只能靠双击复位救回来**。

### 2.4 上界 / 横向（回归核对，均未回退）

| 项 | before | after |
| --- | --- | --- |
| 上拖 300px 按住后松手 | 100.67（36%H） | 100.67（35.90%H） |
| 横向 +8%W（调试口设位）panX | +31.20px | +31.20px |
| 岛左右边 x0 / x1（不裁边） | 117.77 / 330.96 | 117.78 / 330.95 |
| 静置 5s：boxCalls / boundsUpdates | 0 / 0 | 0 / 0 |

---

## 3. B 场景读数（旋转视角是否还周期性卡）

> 口径说明：headless SwiftShader 只有 ~17~20fps，单次测量 0.1~0.3ms 量级在帧间隔里被淹没，**帧间隔不能用来判定旧包的 100ms 卡顿**（这点必须诚实写明）。能确定性判定的是「重测调用次数」：旧包每 100ms 一次全场景 islandScreenBox()，新包为 0。

同页交替采集（每次 5s，同一页面内先干净态、再拖 60px 后旋转，重复两轮，抑制 run-order 漂移）：

| 轮次 | 位移状态 | before boxCalls / boundsUpdates | after boxCalls / boundsUpdates |
| --- | --- | --- | --- |
| R1-clean | lift=0 | 0 / 0 | 0 / 0 |
| R1-drifted | +99.97（拖过岛、停稳在界内） | **26 / 26** | **0 / 0** |
| R2-clean | lift=0 | 0 / 0 | 0 / 0 |
| R2-drifted | +83.24 / +60.0 | **27 / 27** | **0 / 0** |
| 真时钟 10s 旋转（干净态） | lift=0 | 0 / 0 | 0 / 0 |
| 真时钟 10s 旋转（位移≠0，Lead 口径参考） | +60 | **84 / 84**（Lead 实测） | **0 / 0** |
| 弹回现场后旋转（旧包卡在 −265，污染样本，仅作旁证） | −265.28 | 23 / 23（10s，另一次 21/21） | —（新包该状态不存在） |

- 触发条件（旧包）：userFramingActive() = gesture || raw≠0 || shown≠0 || v≠0 || panX…≠0，**只要玩家拖过岛就恒为真**；再叠加 uBoxAcc<0.1 的 100ms 节流 ⇒ 旋转期每 100ms 一次 world.scene.updateMatrixWorld(true) + 全岛顶点逐个投影。玩家描述「弹回后旋转卡」正是「弹回后 shown 非 0」的状态。
- 新包：签名去掉 yaw/pitch/zoom/pan，且停稳后 userFramingActive() 为假 ⇒ 旋转、静置都 **0 次重测**；顶点按「岛屿几何」缓存（boxVerts=2598），测量只做 matrixWorld × local。
- 帧间隔（仅相对比较，NAS 上同时有 E2/回归负载）：before drifted 均值 50.2/53.9ms，after drifted 均值 51.3/63.8ms，干净态 before 52.9/46.0ms、after 53.8/55.8ms —— **无回退**，但 headless 无法给出「卡顿消失 X%」的绝对数字，建议以 E2 的 boxCalls/boundsUpdates=0 与机主真机观感为准。

---

## 4. 惯性（撞界 / 甩动）

| 用例（受控 1/60s） | before 峰值 / 回抽 | after 峰值 / 回抽 |
| --- | --- | --- |
| 界内起步下甩（5×34px，越界） | −114.76（越界 **29.75px**），回界 **417ms** | −90.61（越界 **5.60px**），回界 **150ms** |
| 上甩（5×34px） | +124.94（越界 **24.27px**），400ms | +106.19（越界 **5.52px**），150ms |
| 加力下甩（6×50px） | 越界 75.25px，500ms | 越界 **5.84px**，150ms |
| 从 +59px 上甩撞上界 | +178.51（越界 77.84px），500ms | +106.51（越界 **5.82px**），150ms |

- 两包「惯性」本身参数未改（inertiaTau=0.18 / inertiaStopV=8）：S-36 已验自由滑行 = 0.18×松手速度、0.62s 停稳、区间内单调；本轮两包同参、未观察到回抽或二次弹跳。
- 变化的是**撞界后的外冲**：旧包甩到边会先冲出去 24~78px（画面上岛明显窜出去一截）再花 0.4~0.5s 拉回；新包最多 6px、150ms 贴合。玩家感受：旧包「甩一下会窜」、新包「甩到边就停住」。

---

## 5. P0 / P1 / P2

### P0（阻断/明显 bug）——**0 条**

### P1（明显体验问题）——**0 条**（旧包 2 条已修，留档）

| 编号 | 现象 | 旧包读数 | 新包读数 | 结论 |
| --- | --- | --- | --- | --- |
| ~~P1-1~~ | 拖到底能无限下挪、岛压进底部抽屉 | 越界 180.25px、岛底 79.4%H | 5.93px / 58.7%H | **已修** |
| ~~P1-2~~ | 松手「猛弹」 | 34 帧 / 566.7ms、单帧 30.04px | 8 帧 / 133.3ms、单帧 1.77px | **已修** |
| ~~P1-3（BUG-0）~~ | 按住 ≥100ms 再抬手 ⇒ 永久卡在界外 | 8 例中 6 例；−265.28 冻结 1.3s+ | 233ms 归位 | **已修** |

### P2（小瑕疵 / 观感 / 可发现性）——**6 条，均不阻断验收**

| 编号 | 问题 | 证据 | 建议 |
| --- | --- | --- | --- |
| P2-1 | 「6px 余量 + 133ms」在 60fps 上每帧只有 ≤1.8px，回位动作本身几乎看不见；顶手感主要来自「增量趋 0」 | §2.2 曲线 | 可接受，**建议不改**；若机主想要更明显的橡皮筋反馈，8~10px 是安全上限（仍 < 旧包 180px 的 5%） |
| P2-2 | 上界同源：36% 处只剩 5.8px（岛底 35.29%H） | §2.1 | 上下对称，无新问题；注意别把 35.3%H 误读成「越界失控」 |
| P2-3 | 旧包 BUG-0 这类「只在特定松手时序下出现」的分支，纯 fake 时钟与纯逻辑测试都抓不到 | §2.3 8 例矩阵 | **建议进回归**：真时钟按住 300ms → 松手 → 断言 150ms 内 abs(shown−bound)≤0.5；再加一例「立刻松手」 |
| P2-4 | 真机 60fps 观感未验（headless 17~20fps、NAS 上有 E2/回归并发负载） | §3 说明 | 帧时间只作相对比较；绝对「卡顿消失」建议以机主真机体感 + E2 计数断言为准 |
| P2-5 | 横向 ±8%W 仍只能通过调试口触达（默认视角 panLimit=0，纯双指横拖被锁成 zoom） | §2.4 | S-36 P2-8 遗留，本轮未变；不阻断 |
| P2-6 | 新包停稳后不再测量，但「拖过岛 + 窗口尺寸变化（转屏/地址栏收起）」仍会重测——这是正确行为，只提醒别在验收里把它当回归 | 签名含 w/h/topH/bottomH | 无需处理 |

---

## 6. 截图清单（19 对 = 38 张，390×844 dsf=2，均隐藏 ?debug=1 面板 = 玩家所见）

> 文件都在 tasks-out/S-37/，命名 u1-{before|after}-NN-tag.png；每对同一场景同一尺寸，读数见本行。

| 成对文件 | 场景 | before 读数 | after 读数 |
| --- | --- | --- | --- |
| u1-*-01-overshoot-held300 | 两指下拖 300px **按住** | shown −160.26，岛底 **66.97%H**（压进「街区」抽屉） | shown −90.85，岛底 **58.74%H** |
| u1-*-02-overshoot-held600 | 继续拖到 600px 按住 | shown −265.26，岛底 **79.38%H**（几乎沉到底栏） | shown −90.94，岛底 **58.73%H**（与 300px 几乎相同 ⇒ 顶住） |
| u1-*-03-return-mid | 松手回位第 2 帧 | 单帧 Δ25.03px（整段 566.7ms） | 单帧 Δ1.38px（整段 133.3ms） |
| u1-*-04-return-settled | 回位停稳 | −85.01（耗时 566.7ms） | −85.01（耗时 133.3ms） |
| u1-*-05-rotate-mid | 单指左右拖旋转中 | 位移≠0 时每 100ms 一次重测（5s 26~27 次） | 0 次重测 |
| u1-*-06-idle | 静置（默认 48%H） | 静置 5s：boxCalls 0 | 静置 5s：boxCalls 0 |
| u1-*-07-top-limit | 上拖 300px 按住（上界） | shown +170.44，岛底 **27.68%H** | shown +106.50，岛底 **35.29%H** |
| u1-*-08-panx | 横向 +8%W 夹取（调试口设位） | panX +31.20，x0/x1 117.77/330.96 | panX +31.20，x0/x1 117.78/330.95 |
| u1-*-12-real-idle | 真时钟静置（dsf2） | 静置 5s：0 次重测 | 静置 5s：0 次重测 |
| u1-*-13-real-rotate-early | 真时钟旋转开始 | 干净态 0 次重测 | 干净态 0 次重测 |
| u1-*-14-real-rotate-mid | 真时钟旋转中段 | 0 次（本页干净态） | 0 次 |
| u1-*-15-real-held-hold | 真时钟下拖 600px **按住 300ms**（松手前） | shown **−265.28**（越界 180px） | shown **−90.97**（越界 5.9px） |
| u1-*-16-real-after-hold-release | 按住 300ms 后松手 1.2s | **仍 −265.28（卡死界外）** | **−85.04（233ms 归位）** |
| u1-*-17-real-held-quick | 下拖 600px 立刻松手前 | shown −254.78 | shown −90.97 |
| u1-*-18-real-after-quick-release | 立刻松手 1.4s 后 | **−121.78（卡死，只走一步）** | **−85.04（50ms、单帧 ≤1.54px）** |
| u1-*-19-real-fling-settled | 下甩惯性停稳 | 峰值 −107.78 → −85.01（450ms 抽回） | 峰值 −90.53 → −85.04（150ms 贴合） |
| u1-*-09-real-overshoot-held | 真时钟越界按住（比例参照） | 岛底 79.49%H | 岛底 58.7%H |
| u1-*-10-real-return-settled | 真时钟回位停稳 | 卡死 −265.28（未回位） | −85.04 |
| u1-*-11-real-rotate-mid | 真时钟旋转中（玩家视角全图） | 0 次重测（本页干净态） | 0 次 |

---

## 7. 局限与不确定性

1. **headless 帧预算**：SwiftShader 17~20fps，无法用帧间隔量化旧包 100ms 级卡顿；B 的结论建立在「重测调用次数」（确定性计数）与代码路径上，绝对体感请以机主真机为准。
2. **并发负载**：after 组采集时 NAS 上还有 E2/回归任务在跑，帧时间数字只做 before/after 相对比较，不作为性能承诺。
3. **界内惯性**：本轮甩动都撞到了界（行程 170~300px > 单边行程）；界内自由滑行沿用 S-36 结论（0.18×v、0.62s 停稳）与「两包同参数」推断，未在 after 包上重测。
4. **未覆盖**：iOS/Android 真机、WeChat 内置浏览器、三指以上、平板/横屏、切后台 flush、购地报价卡冻结期的回位交互。
5. **时序脆弱性已证实**：旧包同一动作在「立刻松手 / 按住松手」下结果完全不同（§2.3），说明这类「松手收尾」分支必须用真时钟+真触摸覆盖，纯逻辑单测会漏。

---

## 8. 与我上轮（S-36）意见的关系

- S-36 我报的 P2-9「橡皮筋 k=0.35 越界 35%」本轮被任务书直接改判为缺陷（A 现象），旧包实测确为恒定 0.35 比例（每 30px ⇒ 10.5px），新包按 6px 饱和曲线重做 —— **我撤掉 P2-9**。
- S-36 我报的「甩到界会卡在界外」当时按 F9 修成「贴边停」，本轮发现另一条漏网分支（按住后松手、无 fling）仍会卡死，即 BUG-0；新包已覆盖，**建议沉淀成回归用例（P2-3）**。
- 其余 S-36 P2（双击复位可发现性、记忆无提示、横向不可独立触达、斜向/捏合判定带）本轮**未复测**，状态按 S-36 原样保留（不在本轮改动范围内）。

**验收结论：按我的判级 P0=0 / P1=0，A、B 两个真机现象在 main-e029ea93fe 上均已消失；P2×6 不进验收线，仅 P2-3（BUG-0 进回归）建议 Lead 在交接收敛里落一条。**
