# 59 · S-36 任务书：岛屿高度可调（两指上下拖 + 惯性 + 记忆 + 限位）

> 机主 2026-10-24 确认：①**两指上下拖**调岛屿高低（单指仍是旋转）；②范围 **岛下沿 36%~58%H**；③松手**停住+惯性**、**双击复位**；④**长期记住**（存本地）；⑤**横向也给一点空间**。
> 前置：S-35（peek 默认 48% + 云风向 + 底栏收益）先收口，本任务在同一棵树接着做。

## 任务书 S-36

```
S-36

【开工第一件事·防截断】用 create_goal 把本任务立为持久目标（objective = S-36 岛屿高度可调：两指上下拖调整取景高度（默认48%，范围36%~58%）+ 惯性停住 + 双击复位 + 横向±8%W微调 + 本地长期记忆 + 不与缩放/平移手势冲突）；每完成一个里程碑 update_goal 记进度；大段内容先落文件再给摘要；完成后再 update_goal complete。

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

【机主已定（不许改）】
1. **手势**：**两指上下拖** = 调整岛屿上下位置；**单指拖动仍是旋转视角**（不许改单指语义）。两指缩放仍是缩放，两指平移仍保留，**新增"两指纵向拖"优先判定为调整高度**（见判定规则）。
2. **范围**：岛包围盒下沿 **36% ~ 58%H**；默认 **48%H**。横向允许 **±8%W**（岛中心相对屏幕中心），默认 0。任何位置都必须满足：岛顶 ≥ topH+8px、与底部 HUD 间隙 ≥16px、左右不裁出屏幕。
3. **松手**：**停住 + 惯性**（速度衰减到阈值停），到边界用**橡皮筋**（越界阻尼 0.35，松手弹回边界内）；**双击 = 回全岛并复位高度/横向到默认**（双击现有语义保留：复位旋转/缩放/俯仰/平移）。
4. **长期记住**：玩家拖到哪就存到本地，下次进游戏仍在该位置（**不改存档 schema**，用 `wyszz.settings.v1` 独立键：`islandLiftFrac`、`islandPanXFrac`，读档时 clamp 到合法范围，损坏值回默认）。
5. 版本串 `0.3.5-dev` 不动；经济/契约/存档/调试事件/岛屿几何/云一律不动（云与取景默认值由 S-35 负责）。

【手势判定（关键，避免打架）】两指落下后，在累计位移 ≥10px 时锁定一次手势类型（整段手势不再改判）：
- 两指距离变化率 > 12% → **zoom**（现有行为）；
- 两指同向、|Δy| ≥ 1.6×|Δx| 且中点位移 ≥10px → **lift**（调整高度，横向分量按 0.5 系数并入横向微调）；
- 其余 → **pan**（现有双指平移，保留但不允许把岛拖出范围）。
- 抽屉/按钮上的手指不参与 lift（沿用现有"手指落在 UI 上不驱动世界"的优先级）。lift 判定时**扣掉吸附/橡皮筋前的原始位移**，避免抖动。
- 判定为 lift 时不缩放、不平移；判定为 zoom/pan 时不改高度。

【实现要点】
- 新增一个"用户取景偏移"层：`userLiftPx`（下沿目标）与 `userPanXPx`（横向），最终相机偏移 = `autoLift(peek/half)（S-32/S-35 已算）+ userLiftPx`，横向 = `userPanXPx`；**叠加后统一 clamp**（36%~58%H / ±8%W / 岛顶≥topH+8 / 与 HUD≥16px），clamp 在求解层做，不要靠手指数值碰运气。
- `lift` 手势期间每帧更新目标（1px 屏幕位移 ≈ 1px 岛位移，拖动要跟手），松手转惯性速度（px/s），每帧 `v *= exp(-dt/0.18)`，|v|<8px/s 停；越界时只允许 0.35 倍行程并立即记录回弹目标。
- 横向同理：跟手、±8%W 夹取、惯性衰减同参数。
- 持久化：值变化后 debounce 300ms 写入 settings；读档时 clamp；双击复位同时把存储值写回默认（避免下次又跑偏）。
- **特写/购地报价卡期间不叠加用户偏移**（保持 S-32 特写构图与 S-35 报价卡取景），退出后恢复；进特写时若用户偏移很大，先平滑归位再进（≤200ms），不许瞬移。
- 首次成功触发 lift 手势时弹一次 toast：「两指上下拖，可调整岛屿高低」（每账号一次，存 settings，正式包与内部包都显示）。
- 保留：`setBaseLift(0)` 后与 0.3.3 逐位一致的断言（在 user 偏移为 0 时必须继续成立）。

【只许写】`frontend-rebuild-hm035/src/app/input.ts`、`src/app/app.ts`、`src/render/camera.ts`、`src/ui/hud.ts`（仅 toast 文案与必要提示）、`src/ui/hud-layout.ts`（如涉及）、`test/**`、`tools/**`、`tasks-out/S-36/**`、`/tmp/s36/**`。
【禁止】改云/取景默认值（S-35 范围）、岛屿几何/经济/契约/存档 schema/调试事件清单/`land_config_v3.json`/版本号；出码/打包正式包；新增依赖、联网；动其它工作树；node `export PATH=/mnt/ssd/apps/nodejs_v24/bin:$PATH`。

【子智能体（1 主 + 3 实现 + 1 玩家锐评）】10 分钟开工。
- 主对话（你）：手势判定状态机、偏移叠加与 clamp、持久化、回归与交付。
- E1「手势」：lift/zoom/pan 三态锁定判定 + 跟手（1px≈1px）+ 惯性 + 橡皮筋回弹 + 与抽屉/按钮手指的优先级。
- E2「偏移与记忆」：userLift/userPanX 叠加层、四尺寸 clamp、双击复位、settings 读写与损坏值兜底、特写期间冻结。
- E3「测试与截图」：手势矩阵单测、惯性/限位读数、reload 记忆、四尺寸截图（默认/上移/下限/横向偏移/特写态）、回归。
- **U1「玩家视角锐评」（独立，不改代码）**：评：两指上下拖是否跟手、有没有"拖不动/拖飞了"、惯性是否舒服、边界橡皮筋是否自然、双击复位是否好发现、记住位置是否让人困惑（下次打开位置变了会不会以为坏了）、横向微调是否多余。产出 `tasks-out/S-36/玩家锐评.md`（截图帧 + P0/P1/P2 + 同类做法），**先交机主看，不擅自改结论**。
提示词原样转发、禁止嵌套、目录写死、关键数字抽查。

【验收（缺一不可）】
- 两指纵向拖：390 下拖 100px，岛下沿移动 100±6px（跟手）；到 36% 与 58% 边界停止并橡皮筋回弹；松手有惯性且 <1.2s 停稳；
- 两指缩放不改变高度；两指横向拖仍可平移（若与 lift 冲突按判定规则）；单指拖动仍是旋转（截图/读数证明）；
- 横向：岛中心可移 ±8%W，越界回弹；不裁边；
- 双击：高度/横向复位到 48%/0，并写回存储；reload 后保持玩家上次位置；存储损坏 → 回默认不崩；
- 特写/报价卡期间不叠加用户偏移，退出后恢复原位置且无瞬移；
- 四尺寸（390/320/414/430）：任意允许位置下岛顶 ≥ topH+8、与 HUD ≥16px、左右不裁、UI 无遮挡；
- 回归：`t-s20` 57/57、`t-s21-camera` 13/13、`t-land` 61/61、`t-s19`、`t-s21`、`t-s12`、`browser`、抽屉套件、S-35 新增取景/云断言全绿；手势相关旧断言如需改口径**逐条留痕**，不许删断言；
- U1 报告 P0=0、P1=0（P2 记录并说明"改/不改/待机主定"）。

【交付】源码 + 截图 ≥12 张（默认/拖到上/拖到下/横向/惯性中/橡皮筋/双击后/reload 后/特写冻结/320 极窄）+ 手势判定矩阵表 + `tasks-out/S-36/交接收敛说明.md`（含：判定阈值、叠加与 clamp 公式、存储键、惯性参数、未验证项）+ 版本串 `0.3.5-dev`。**不打包、不出码**。
【时间盒】**4 小时**。卡住 >20 分钟记录并降级（先保"两指纵向拖能调 + 限位 + 双击复位"，惯性与记忆其次）。
```
