# REPORT · DDZ-BC84-049 r1 · L3 手机手感对齐老版微信

> 结论先行：**共享触控适配已实现，真实 Chromium 差分 21/21、Node 定向 55/55、WX 宿主 14/14 通过；可操作 390×844 手机触摸预览在 8067。**
> 这是**浏览器触控仿真候选证据**，不是微信真机/手机舒适度通过，也不是总监或机主签收。真机仍需机主按第 8 节验。

## 1. 预览入口（只读 GET/HEAD）

- 手机窄屏：`http://100.114.191.104:8067/?seed=049-preview-a&size=32`
- 本机：`http://127.0.0.1:8067/?seed=049-preview-a&size=32`
- 健康/自描述：`/__049_healthz`、`/__049_preview.json`
- 服务：本任务独立 8067，只读静态；未停 8061/8065，未清任何存档，未合并正式版本。
- 操作：等首帧 → 单指拖动岛旋转 → 双指捏合缩放/横拖平移 → 双指上下抬升 → 松手看 150ms 回位 → 双击岛外空白回全岛。HUD 区域触摸会被吞掉，不穿透到 3D。

## 2. 实现边界（生产白名单）

新增/修改仅 7 个生产文件：

| 文件 | 作用 |
|---|---|
| `project/src/bc84/p1/host/touch-math.mjs` | S31 常量/纯函数 1:1 移植；`userLiftBoundsSafe` 是唯一新增适配函数 |
| `project/src/bc84/p1/host/touch-input.mjs` | S31 `InputController`/`GestureGate` 状态机（阈值、S36 锁、tap/双击、HUD 吞、取消） |
| `project/src/bc84/p1/host/touch-camera.mjs` | 把 S31 归一化 drag/惯性/zoom/pan/lift 叠到新正交世界相机 |
| `project/src/bc84/p1/host/camera.mjs` | 新增 user-framing view offset（lift/panX）并保留原裁剪/购地取景 |
| `project/src/bc84/p1/host/web-host.mjs` | Web 触控接共享适配；鼠标仍走 044 `pointer-intents` |
| `project/src/bc84/p1/host/wx-host.mjs` | `wx.onTouch*` 接同一套 `touch-camera/touch-input` |
| `project/src/bc84/p1/host/pointer-intents.mjs` | 仅新增 `reset()`；鼠标 044 路径不变 |

未改 `world/model/规划/经济/建筑模型/地块布局`；未引入六角地图权威；未改正式经济。测试/工具/证据另列 `CHANGED-FILES`。

## 3. 旧 S31 → 049 精确对照

依据冻结工程（只读）：
`.../交付-S31-验收收口-20261029/工程/src/app/input.ts`、`src/render/camera.ts`、`src/game/gesture.ts`、`src/app/app.ts`。

| 交互 | 冻结 S31 真实行为（文件:行） | 049 实现 | 差分/实测 |
|---|---|---|---|
| 单指起手 | `input.ts:329-331`：触摸 10px（鼠标兼容分支 8px）前不动；过阈值后 `drag(dx,dy,viewH)`，**不补**阈值前 10px | `touch-input.mjs` 同；测试 `s31-differential` 首项 | 130px 轨迹 `dragEvents=6`，阈值前 theta 不变 |
| 旋转方向/归一化 | `camera.ts:691-697`：`k=PI*1.15/max(300,viewH)`，`tYaw -= dx*k`，pitch `+dy*k*0.8` | `touch-camera.mjs:88-102`：`theta += dx*k`（旧 yaw=`PI/2-theta`），`phi -= dy*k*0.8` | 844px 高 k=0.0042806 rad/px；130px 指尖量 0.55648 rad；总旋转 new=1.2365 / old=1.2333，Δ=0.0031 rad（0.18°） |
| 惯性 | `camera.ts:696` `vYaw=-dx*k*60`；`713-722` dt≤1/30、`0.02^dt` 衰减、zoom≥2 关闭 | `touch-camera.mjs:96-97, 287-297` 同号/同衰减 | `dragThetaSum=0.55648`，`inertiaThetaSum=0.67998`，合计约 1.2365；S31 1.2333 |
| 双指锁定 | `input.ts:271-285`：质心累计≥10px **或** 距离率>12% 才一次性锁定；`decidePinchKind` 判 zoom/pan/lift | `touch-input.mjs:210-224` 同常量同判定 | 100→130px 捏合：new=1.2999999999978，old=1.2999999999942，差 **3.7e-12** |
| 缩放死区 | `input.ts:293-315`：锁定帧补做 `d/d0`；之后 `|Δd|≥0.5px` 才 zoomBy | 同 | 浏览器捏合 1.3000 双方一致 |
| 平移死区/限位 | `input.ts:316-319` 质心累计≥0.5px；`camera.ts` `panLimit=0.95*fitR*(1-1/zoom)*panPitchScale`，zoom=1 时 0 | `touch-camera.mjs:107-140` 同公式，fitR 用新正交 bounds 半对角 | zoom≈3、横移 40px：屏幕位移 new=(41.17,-6.54) / old=(34.50,-0.31) px，cos=0.989；幅值 41.69 vs 34.50（+20.8%，在新 FOV/半径下属适配差异） |
| S36 抬升锁定 | `input.ts:286-307`：纵向占优且质心≥10px 才 lift；lift 独占；`app.ts:227-247` 1:1、6px 橡胶、150ms easeOutCubic、松指抑制 | `touch-input.mjs:216-224` + `touch-camera.mjs:145-181, 245-283`；`ADAPT_SAFE_BAND={top:8%,bottom:72%}` | 390×844 baseBox top=201.35/bottom=473.84 → lift 范围 lo=-133.84 / hi=+133.83；上抬 60px=60；越界 shown=139.33（hi+5.50，6px 内） |
| 抬升边界顶 | `camera.ts` 硬约束含“岛顶 ≥ topH+8px”；旧界 36%..58%H | `userLiftBoundsSafe`：`topSafe=67.52px`；实测橡胶顶 top=62.02px（比安全顶高 5.50px，正好是 6px 橡胶） | 反向从 200→80 px 立即回到 80（不粘边）；松手 100ms 仍 134.04，250ms 落在 133.83 |
| 点击防误触 | `input.ts` 拖动阈值 + `GestureGate` 只 claim 一次；HUD 指吞整段 | `touch-input.mjs:304-320` 同；双击需两次都 harmless、≤300ms、≤10px | HUD 指+世界指：世界 theta 变化 0，swallowed +1，drags 不增 |
| 双击回全岛 | `input.ts` 双击条件；`app.ts:1378` reset user framing | `touch-input.mjs:312-316` + `homeCamera()/syncHome()` | theta=0.78、phi=1.02、radius=59.517，lift=0 |
| 两指→单指 | `input.ts:324-327`：lift 中抬一指→0 速度+`liftDone` 抑制，不误点击、不歪 | 同；`s31-differential` 有专测 | 剩余指旋转 Δ=2.9812 / 旧 2.9365（差 0.0448，测试上限 0.05），taps 1→1 不增加 |
| 后台取消 | 旧宿主取消链 | Web `visibilitychange/pagehide` + WX `onHide` 调 `reset()` 并清 HUD swallowed | 取消后 pointers=0、lock=null；下一段拖动正常 Δ=2.7248 |

### 3.1 048 基线差异的玩家影响（为何必须改）

- 048 的 `pointer-intents` 在**每次** pointermove 就 `camera.orbit(dx,dy)`（`0.008` 常量），没有 S31 的 10px 起手门槛；手指轻微抖动或点击时的 1–9px 位移也会让岛先歪一下，虽然仍可能判 tap。
- 048 的触摸旋转速度固定 0.008 rad/px；在 390×844 上 S31 为 0.00428，048 快约 87%。049 触摸改用 S31 归一化；**鼠标**仍走 044 的固定 0.008，不把桌面手感改掉。
- 048 的双指是每次移动立即 pinch/pan；049 才有 10px/12% 一次性类型锁、0.5px 死区、lift 及 `liftDone` 抑制。

## 4. 真实差分结果（不是新实现自证）

- 控制器对照：`test/bc84/touch/s31-differential.test.mjs` 10/10；相机对照 4/4；两者用 esbuild 把**冻结 S31 真实 `input.ts`/`camera.ts`** 打成 oracle，provenance 在 `test/bc84/touch/oracle/PROVENANCE.json`（源文件 SHA256 锁定）。
- 真浏览器双页：`test/bc84/touch/browser-differential.mjs` 在 390×844@DPR2 下，新页 8067 + 旧页 8068（旧页 import 真实 S31 `OrbitCamera`/`InputController`），用 CDP `Input.dispatchTouchEvent` 发同一触摸轨迹，**21/21 PASS**；JSON/日志：`evidence/touch/browser-differential.json/.log`。
- 关键截图：`evidence/touch/new-00-home.png`、`new-01-drag150.png`、`new-02-pinch.png`、`new-03-lift.png`、`new-04-lift-return.png`、`new-05-lift-top-rubber.png`、`new-06-continuous-drag.png`。
- 测试断言是“旧/新同一轨迹数值比对 + 方向/投影/阈值”组合，不是把新实现复制成 oracle；见测试源码中 `__S31` 真实控制器和旧页面。
- 旧页面 favicon 404 已消除；本次 `errors.new=[]`、`errors.old=[]`。

## 5. 持续操作帧时间 / calls / rebuilds

`test/bc84/touch/touch-perf.mjs`，真实 Chromium headless + SwiftShader（**软件 WebGL，不是手机 GPU**），390×844@DPR2：

| 场景 | 帧数 | 帧间隔 p50/p95/max | render p95 | draw calls | rebuild 帧 |
|---|---:|---:|---:|---:|---:|
| 连续单指拖动 2.2s | 279 | 33.3 / 50.0 / 250.0 ms | 2.5 ms | 30（恒定） | 0（`rebuildDelta=0`） |
| 连续双指捏合 2.2s | 223 | 33.3 / 66.6 / 100.0 ms | 4.5 ms | 26–30（视锥剔除） | 0（`rebuildDelta=0`） |

原始 `evidence/touch/perf.json/.log`。结论只支持“触控帧循环没有新增 rebuild、draw calls 不随手势增长”；**不支持**手机帧率/舒适度结论。这轮 perf 与 050 并行，`uptime` 负载约 13–20，p50 从早先干净轮的 16.7ms 退到 33.3ms；250ms/100ms 单次长帧是 headless 主线程抖动，render 最大 7.8/8.5ms。本报告按**保存的本次 JSON** 报数，不拿早先好数冒充。

## 6. 测试与构建（真实退出码）

```text
npm run build:bc84-p1                         EXIT 0
node --test test/bc84/touch/*.test.mjs \
  test/bc84/p1/044-orbit-direction.test.mjs \
  test/bc84/p1/038-camera-clip.test.mjs \
  test/bc84/p1/host-core.test.mjs \
  test/bc84/p1/wx-host-sim.test.mjs \
  test/bc84/p1/wechat-smoke.test.mjs          55 tests / 55 pass / 0 fail
node test/bc84/touch/browser-differential.mjs EXIT 0, 21/21 checks
node test/bc84/touch/touch-perf.mjs            EXIT 0
patch -p1 --dry-run < changes.patch            21/21 checking, EXIT 0
# 另在 /tmp 真实重建 048 副本 + patch -p1：21/21 应用，diff 无差异
```

日志：`evidence/touch/tests-node.log`、`build.log`、`browser-differential.log`、`perf.log`、`changes-patch-dryrun.log`、`changes-patch-reconstruct.log`。
WX 专项：`wx.onTouch*` 单指旋转走 S31 归一化、HUD 指吞世界指、购地/HUD/后台/写故障/重启全部通过（`wx-host-sim` 14/14，含 HUD 8px 过程量/onHide swallowed/报价冻结三项回归）。049 把 048 遗留的 `layout.tools.length 3!==4` 测试断言更正为 4（HUD 实际 4 个工具），不是放宽产品行为。

## 7. 适配差异（不是数值等价，必须说清）

1. **抬升安全带**：旧 S31 以 36%–58%H 为岛下沿硬约束；新 390×844 构图 baseBox 为 top 201.35 / bottom 473.84，直接搬旧比例会让岛顶被 header 吃掉。049 改为顶部 8%H、底部 72%H 的**安全可视带**，保留 1:1、6px 橡胶、150ms 回弹、反向即走。实测 hi=+133.83、橡胶顶 top=62.02（安全顶 67.52，6px 内）。
2. **平移世界轴**：S31 的 pan 在世界 yaw/半径下计算；新相机 theta/FOV/radius 与旧不同，世界平移量不能逐位相等。049 以 `fitR` 新正交 bounds 半对角 + 同 `panLimit` 公式适配，验收看**屏幕跟手方向/幅度**：cos=0.989，幅值 +20.8%，不是世界坐标逐位相同。
3. **缩放半径**：S31 以 `zoom=0.62..3` 乘旧 fit 半径；新相机半径 18..500，049 用 `baseRadius/zoom` 映射。捏合倍率 1.3000 与旧一致（3.7e-12），但屏幕像素尺度随新相机构图，不是旧地图尺度硬搬。
4. **鼠标**：Web 鼠标仍由 044 `createPointerIntents` 驱动，`rig.orbit` 0.008/0.007、`rig.panPx`、`rig.wheelZoom` 原样；049 只把 touch/pen 分流到 S31 共享适配。S31 的 8px 鼠标兼容分支未被生产 host 使用（044 用 6px tap slop 且每 move 即 orbit），这是有意保留。`049-mouse-preserved.test.mjs` 与 044 测试 4/4 守住。
5. **WX 只验证宿主接线与 Node 模拟**；没有微信开发者工具/真机触摸采样，不能把 Web 仿真称为微信真机一致。

## 8. 真机待验（机主）

- 微信真机：单指起手 10px 内不歪、过阈值跟手；双指捏合 10px/12% 锁；两指上下抬升、6px 橡胶顶、松手回位；抬一指不歪不误点；HUD 不穿透；切后台再回来无残留手势；双击空白回全岛。
- 手机浏览器：390×844 与至少一台真实 iPhone/Android 的 DPR/安全区差异；重点看 header/底部面板是否仍覆盖岛、边界顶是否顶手。
- 真机帧率/发热未测；本报告的 33.3ms/50ms p50/p95 只是并行负载下的 SwiftShader 软件渲染，早先干净轮曾到 16.7/33.4ms，不能当手机数。
- 机主验收前，本报告不宣称“手机舒适”或“微信手感完全通过”。

## 9. 独立 DSH 子智能体只读验收

- 子智能体：`4ae322b5-5257-4309-aa59-171f9564b8ba`（独立上下文；只读，未写任务树/未重启服务/未交付）。
- 报告原文：`evidence/independent-subagent-report.md`；verdict：**PASS WITH NOTES**（非签收，审计快照见文件头）。
- 审计 blocker 处理：
  - B1 报告数字：已按**最终保存 JSON** 更新（单指 1.2365/1.2333，Δ0.0031；pan 41.17/34.50；cancel 2.7248；pinch→one 2.9812/2.9365）。
  - B2 rebuild 假零：`touch-perf.mjs` 改读每帧 `rebuilds` 绝对值，输出 `rebuildStart/End/Delta`；最终两次均 `delta=0`、`framesWithRebuild=0`，不再读不存在的 `counts.rebuilds`。
  - B3 交付物：`SHA256SUMS`、本报告文件、最终 patch/dry-run 已补；子审 id 为真实启动 id，原文保留。
  - B4 WX HUD：`swallowed` 增加 `moved` 过程量（>8px 即取消，拖回起点也不激活）；`onHide` 清空 `swallowed`；新增两条 `wx-host-sim` 回归。
  - B5 lift 冻结：`liftAllowed` 已接到 Web（`!selected && !pending`）与 WX（`!selected`），适配器 `beginLift/liftMove` 都检查；删除无调用者的 `setLiftFrozen`；新增 WX 选中报价冻结 lift 回归。
- 未处理/保留 note：8px 鼠标阈值只存在于 S31 兼容分支，生产鼠标仍走 044 的 6px（TASK 要求；报告 §3 已注明）；WX 真机 HUD 拖回/后台恢复仍未真机复现；perf 受并行 050 负载影响。
- 本节不构成签收；独立子审的 PASS WITH NOTES 也不是机主验收。

## 10. 复现

```bash
cd /vol1/ai/projects/wyszz-new/frontend-rebuild-hm/tasks-out/DDZ-BC84-049/project
npm run build:bc84-p1
node test/bc84/touch/browser-differential.mjs   # 需 8067 预览 + 8068 oracle
node test/bc84/touch/touch-perf.mjs
node --test test/bc84/touch/*.test.mjs test/bc84/p1/044-orbit-direction.test.mjs \
  test/bc84/p1/038-camera-clip.test.mjs test/bc84/p1/host-core.test.mjs \
  test/bc84/p1/wx-host-sim.test.mjs test/bc84/p1/wechat-smoke.test.mjs
```

预览 8068 旧页仅用于差分；8067 是本任务只读预览。TASK SHA256：`702d1c1c1bd9ee896f956b115aa3a656d1cad05019e1d7792597931ff70a266b`。
