# 60 · S-37 任务书：岛屿高度可调 · 手感与卡顿修复（S-36 真机问题）

> 机主 2026-10-25 真机反馈（S-36，微信调试码包）：
> ①「移到最下面之后，它不会挡住你继续往下挪，会让你继续往下挪，然后突然弹上来」；
> ②「弹上来之后，左右拖动视角、转动视角，它会一帧一帧不停地卡」。
> 总监已在代码里定位到两处根因（见下），本任务修掉并加"持续操作帧时间"验收。

## 根因（已核对代码，不是猜）

**① 边界会"继续下挪再弹回"**
- `src/render/camera.ts` `USER_FRAMING.rubberK = 0.35`：越界后仍保留 **35% 行程**（拖过头 300px 实际还会走 105px）；
- `springTau = 0.10s`：松手后 ~100ms 指数回弹，观感就是"突然弹上来"；
- 所以不是"没限位"，是**限位太软 + 回弹太快**。

**② 转视角周期卡顿**
- `app.ts` `userBoundsSignature()` 把 `yaw/pitch/zoom/pan` 都算进签名 ⇒ **每转一点签名就变**；
- 于是 `updateUserFramingBounds()` 认为"范围过期"，按 100ms 节流**反复重测**；
- 重测调 `islandScreenBox()`：里面 `world.scene.updateMatrixWorld(true)`（整场景矩阵重建）+ **逐顶点投影**（岛约 2600 顶点）⇒ 每 ~100ms 一次重活；
- 而 `userFramingActive()` 在"玩家调过高度"后恒为真（`uLiftShown≠0`）⇒ 不操作也一直在测。
- 两者叠加 = 旋转时每 100ms 卡一下，正是"一帧一帧不停地卡"。

## 任务书 S-37

```
S-37

【开工第一件事·防截断】用 create_goal 把本任务立为持久目标（objective = S-37 修复岛屿高度可调的真机问题：边界改硬停+平滑回位（不再"继续下挪再弹回"）、旋转视角不再周期性重测包围盒（消除每100ms卡顿）、并补持续操作帧时间验收）；每完成一个里程碑 update_goal 记进度；大段内容先落文件再给摘要；完成后再 update_goal complete。

你是实现工程师兼协调者，任务代号 S-37。工作树：`/vol1/ai/projects/wyszz-new/frontend-rebuild-hm035`（0.3.5-dev；S-36 已交付）。用中文回复，每 30 分钟一行进度写 `tasks-out/S-37/进度.md`。

【机主真机问题（必须复现后修）】
A. 两指把岛往下拖到底后，**还能继续往下走一段**，松手**突然弹回**。
B. 弹回之后**左右拖动旋转视角，会一帧一帧周期性卡顿**。

【根因（总监已核对，按这个修，但必须自己复现确认）】
A1 `USER_FRAMING.rubberK=0.35`：越界仍保留 35% 行程；A2 `springTau=0.10` 回弹太快 ⇒ 观感"继续下挪 + 猛弹"。
B1 `userBoundsSignature()` 含 `yaw/pitch/zoom/pan` ⇒ 旋转每帧签名变化 ⇒ `updateUserFramingBounds()` 每 100ms 重测；
B2 重测走 `islandScreenBox()`：`world.scene.updateMatrixWorld(true)` + 2600 顶点逐点 `project()` ⇒ 周期性重活；
B3 `userFramingActive()` 在调过高度后恒真 ⇒ 不操作也在测。

【修法（不许只调参糊过去）】
1. **硬限位**：手势中到达边界即**不再位移**；橡皮筋只留 **≤6px** 的视觉微弹（`rubberK` 语义改为"越界最大 6px 封顶"，不再按比例），且必须单调回位。
2. **回位平滑**：松手后越界余量在 **120~160ms** 内 eased 归位（`easeOutCubic`，非指数尾巴），全程**无反向抽动、无跳变**；`|余量|≤6px` 直接清零不算跳变。
3. **不再周期性重测**：`userBoundsSignature()` **去掉 yaw/pitch/zoom/pan**（旋转/缩放不改变"可安全叠加的行程"这一物理事实，只需保留：尺寸、topH/bottomH、抽屉档位、tab、购地模式、`baseLift` 目标变化、`fitRadius`、岛屿块数变化）；旋转视角时 `islandScreenBox()` 调用次数必须为 **0**。
4. **测量本身减负**：不再 `world.scene.updateMatrixWorld(true)`；只更新 `world.land.group` 子树矩阵；顶点在岛屿几何变化时缓存成 `Float32Array`（世界坐标），测量时只做矩阵乘法 + 投影，不每帧 traverse/allocate。
5. **停稳即休眠**：`userFramingActive()` 在「无手势 + 速度 0 + raw==shown + 无越界余量」时返回 false；停稳后每帧不得做任何 bbox 测量。
6. 其余行为不变：范围 36%~58%H、横向 ±8%W、双击复位、长期记忆、特写/报价卡冻结、1px⇔1px 跟手、S-35 取景 48% 默认、S-20 手势手感。

【只许写】`frontend-rebuild-hm035/src/render/camera.ts`、`src/app/app.ts`、`src/app/input.ts`（仅 lift 手势边界/速度）、`test/**`、`tools/**`、`tasks-out/S-37/**`、`/tmp/s37/**`。
【禁止】改云/取景默认值/岛屿几何/经济/契约/存档 schema/调试事件/`land_config_v3.json`/版本号；出码/打包正式包；新增依赖、联网；动其它工作树；node `export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH`。

【子智能体（1 主 + 2 实现 + 1 玩家锐评）】10 分钟开工。
- 主对话（你）：复现、根因确认、改法落地、回归与交付。
- E1「边界与回位」：硬限位 + ≤6px 微弹 + 120~160ms eased 回位 + 无反向抽动；手势中/松手后读数留证。
- E2「性能与休眠」：签名去相机参数、顶点缓存、只更新 land 子树、停稳休眠；加"测量调用计数"断言与帧时间采样脚本。
- **U1「玩家视角锐评」（独立，不改代码）**：真机式操作评：拖到底是否"顶手"、回位是否自然、旋转是否还卡、惯性是否舒服、限位是否让人以为卡住；产出 `tasks-out/S-37/玩家锐评.md`（截图帧 + P0/P1/P2），**先交机主看**。

【验收（缺一不可）】
- 拖到底：位移读数**立即停止增长**（不再有 35% 行程）；越界可见余量 ≤6px；松手后 ≤160ms 归位、无跳帧（逐帧位移单调）；
- 旋转 10 秒（连续单指拖动）：**`islandScreenBox` 调用计数 = 0**；不出现 ≥50ms 长帧；headless 下"旋转帧时间 p95"不高于改动前基线的 105%（同机对比，软渲染只看相对值）；
- 不操作静置 5 秒：测量计数 = 0 增长；
- 功能不回退：范围/横向/双击复位/记忆/特写冻结/跟手/默认 48% 全部按 S-36 验收重跑；
- 回归：`t-s36-lift` 按新口径更新并**逐条留痕**（53 项不许直接删）、`t-s20` 57/57、`t-s21-camera` 13/13、`t-land` 61/61、`t-s19`、`t-s21`、`t-s12`、`browser`、抽屉套件、`t-s35-accept` 全绿；pageErrors=0；
- 出内部调试码给机主真机复验（**只出内部包调试码，不出正式包**，按 docs/40 SOP）。

【交付】源码 + 截图/读数（限位、回位逐帧、旋转调用计数、帧时间对比、四尺寸）+ `tasks-out/S-37/交接收敛说明.md`（根因对照、改动点、参数表、性能对比表、未验证项）+ 内部调试码。
【时间盒】**2.5 小时**。卡住 >20 分钟记录并降级（先保 A 硬限位与 B 旋转不重测，其余次之）。
```
