人物控制器1

.workbuddy/memory/2026-10-09.md

@@ -54,3 +54,48 @@
 - **修复 2（碰撞例外）**：`_grab()` 里 `_current.add_collision_exception_with(_body)`，`_drop()` / `_throw()` 经 `_forget()` 用 `remove_collision_exception_with` 解除。只解除「物体 ↔ 玩家」这一对，物体与场景其他碰撞体照常交互。
 - 另加 `@export var max_drag_speed: float = 30.0` 速度上限，物体离得远时不会被一股脑拽飞。
 - **接口变更**：`PlayerPickup.setup(ray, hold_pos, body)` 多了第三个参数（玩家本体），`player.gd` 里传 `self`。`_grab()` 加了 `is_instance_valid(_current)` 早退，避免重复抓取时漏掉碰撞例外。
+
+### 玩家缩放层级（查明，供后续改尺寸参考）
+- `character/player/player.tscn` 的缩放链：`Player ×0.2` → 子节点 Collision(胶囊 r0.545/h1.406，本地 y0.703) / CameraRig(眼高 y1.6) / Body/mouse(×0.1824) 累计 ×0.2。
+- `Camera ×5` **是补偿值**，用来把相机子树抵消回世界缩放 1.0（0.2×5=1.0），因此 InteractionRay 世界长度 0.5 m、InteractionPos 世界距离 0.444 m。
+- 推论：**改 `Player.scale` 必须同步 `Camera.scale = 1 / Player.scale`**，否则交互距离/持握距离会跟着缩。另外 PlayerMotor 的 walk/sprint/jump/accl 是世界单位，不会自动缩放，改尺寸时需手动同倍调整。
+- 世界尺寸现值：碰撞胶囊半径 0.109 / 高 0.281，眼高 0.32 m。
+
+### 整体人物缩到 0.6 倍（已实施）
+- `player.tscn`：`Player` 缩放 0.2 → **0.12**；`Camera` 缩放 5 → **8.333333**（= 1/0.12，保持相机子树净缩放 1.0，**交互距离/持握距离不变**）。Camera 的位置偏移与 CameraRig 的 y=1.6 都自动随父级缩放，未改。
+- `player_motor.gd`：walk 5.0→**3.0**、sprint 8.5→**5.1**、acceleration 45→**27**、air_acceleration 12→**7.2**，均为 ×0.6；jump_velocity 5.0→**3.87**（×√0.6，因跳跃高度 = v²/2g，直接乘 0.6 会跳得偏矮）。
+- `player_animator.gd`：**基准速度也必须 ×0.6** —— walk 5.0→3.0、run 8.5→5.1、crouch 2.5→1.5、sneak 1.6→0.96。原因：模型缩到 0.6 倍后，同一片段一个循环跨出的世界距离也缩到 0.6 倍，不改基准速度脚步会明显打滑。同时修正了 `_resolve_state()` 里那句「jump 片段 0.5s ≈ 5/9.8 上升时间」的过时注释。
+- 未改动：`pick_power` 10（新滞后 3.0/10 = 0.3 m < 0.444 m 持握距离，且已有速度前馈，安全）、`throw_speed` 12（被扔的物体本身没缩，投掷距离不该变）、`mouse_sensitivity`（纯角度）。
+- 缩放后世界尺寸：胶囊半径 0.0654 / 高 0.169，眼高 0.192 m；跳跃绝对高度 1.276 → 0.766 m（相对身高观感不变）。
+
+### 再缩到「视觉高度 0.15 m」（已实施）
+- **口径确认（重要）**：用户选的是**视觉模型高度**，不是碰撞胶囊。两者不等：
+  - 模型：glb 顶点原始高 `8.557729`（min y -4.7746 / max y 3.7832）× mouse 节点缩放 `0.18240134` = 本地 1.560941；世界 = ×0.12 = **0.187313 m**（当时）
+  - 胶囊：本地 1.4063476 × 0.12 = **0.1687617 m**
+  - 模型底部在本地 y ≈ -0.0007（脚踩原点，与胶囊底部对齐），故测量可信。模型比胶囊高 11%（多出耳朵/尾巴）。
+- 缩放系数 `k = 0.15 / 0.187313 = 0.800799`。
+- `player.tscn`：`Player.scale` 0.12 → **0.096096**；`Camera.scale` 8.333333 → **10.406274**（= 1/0.096096）。
+- `player_motor.gd`：walk 3.0→**2.4024**、sprint 5.1→**4.0841**、accel 27→**21.6216**、air_accel 7.2→**5.7658**、jump 3.87→**3.4632**（×√k）。
+- `player_animator.gd`：walk_ref 3.0→**2.4024**、run_ref 5.1→**4.0841**、crouch_ref 1.5→**1.2012**、sneak_ref 0.96→**0.7688**。
+- 注释已改成「按同一系数同步缩放」的通用表述，不再写死 0.6，避免下次再失效。
+- 结果：胶囊世界 半径 0.05241 / 高 0.13514，眼高 0.08729 m，跳跃绝对高度 ≈ 0.612 m；拖拽滞后 = 2.4024/10 = 0.24 m < 0.444 m 持握距离，安全。
+- **可复用公式**：`Player.scale = 目标世界高 / (模型本地总高)`，`Camera.scale = 1 / Player.scale`，速度与动画基准速度均 ×k（jump 用 ×√k）。
+
+### 按 0.15 m 身高重新设计移动参数（已实施）
+- 用户明确：「不用管之前，按 0.15 的身高重新设计」→ 采取**以人类为参照的等比设计**，不再依赖旧基准。
+- 设计基准：人 1.75 m，游戏惯例 walk 5.0 / sprint 8.5 / accel 45 / air_accel 12 / jump 5.0（跳跃高度 1.28 m ≈ 0.73 身高）。系数 `k = 0.15 / 1.75 ≈ 0.0857143`。
+- `player_motor.gd`：walk 2.4024→**0.4286**、sprint 4.0841→**0.7286**、accel 21.6216→**3.8571**、air_accel 5.7658→**1.0286**、jump 3.4632→**1.4639**（×√k）。
+- `player_animator.gd`：walk_ref 2.4024→**0.4286**、run_ref 4.0841→**0.7286**、crouch_ref 1.2012→**0.2143**、sneak_ref 0.7688→**0.1371**。
+- 校验：两边都是「走路 = 2.86 身长/秒」「跳跃 = 0.73 身高」，比例一致。加速度给出约 0.11 秒加到全速；跳跃高度 0.109 m。
+- 拖拽滞后 = 0.4286/10 = 0.043 m ≪ 0.444 m 持握距离，安全。
+- **未改动**（有意保持）：交互距离/持握距离（射线 0.5 m、持握 0.444 m —— 若按 k 缩到 0.038 m 会够不到任何东西）、`pick_power` 10、`throw_speed` 12（被扔物体是世界尺寸，未缩）、`mouse_sensitivity`（纯角度）。
+- **世界尺度查不到可靠线索**：`world/main2.tscn` 有 295 个 `Transform3D`，但混入了嵌套实例的局部变换，位置跨度（X33/Z57）不可信；198 个实例缩放为 1.0，资产疑似米制。若实际关卡跨度大、用户觉得慢，把 walk/sprint 等线性量乘同一倍数即可。
+
+### 蹲伏真正生效（已实施）
+- 背景：**蹲下改速度、改摄像机高度这两件事从来没实现过**（原 `player.gd` 也只把 `crouching` 传给动画器切 CROUCH/SNEAK 片段），不是回归。
+- `player_motor.gd`：新增 `@export var crouch_speed: float = 0.2143`（= walk 的一半 = 2.5×k）。`step()` 里改为**蹲伏优先于疾跑**：`sprinting = wants_sprint and not crouching`，速度按 `crouch_speed > sprint_speed` 优先级取。
+- `player_look.gd`：新增蹲伏组 `crouch_height_ratio`(=0.6) / `crouch_transition_speed`(=10)；`setup()` 从场景读 `_stand_height = rig.position.y`（不写死 1.6）；新增 `set_crouching(bool)` 设目标高度；`_process()` 用 `1 - exp(-k·delta)` 指数收敛平滑升降（**渲染帧**，物理帧会一顿一顿）；`_ready()` 里 `set_process(false)`，`setup()` 才开 —— 远端玩家不调 setup 就不会跑。
+- `player.gd`：`_physics_process` 里 `motor.step(delta)` 之后加 `look.set_crouching(motor.crouching)` —— **蹲伏状态由 Motor 单点判定**，不让 Look 自己读蹲键，避免两处各判一次不同步。
+- `player_animator.gd`：`sneak_ref_speed` 0.1371 → **0.2143**，与 `crouch_speed` 对齐 —— 蹲着走播的就是 SNEAK 片段，两边不等会打滑（原来会以 1.56× 播放，逼近 1.6 的 clamp 上限）。注释里写明了这条配对关系。
+- 世界高度：站立 `1.6 × 0.096096 = 0.1538 m` → 蹲下 `0.0923 m`。
+- **未做（可以后续补）**：蹲下时没有缩小碰撞胶囊 —— 所以现在还钻不过低矮缝隙。要做需要额外处理「头顶有障碍时不许起身」的检测。