滑索

.workbuddy-ai/memory/2026-09-24.md

@@ -0,0 +1,26 @@
+# 2026-09-24
+
+## 滑索（Zipline）组件 —— 新增
+
+需求：Godot 4 第三人称滑索，要求全程用 Godot MCP 搭建。
+
+新增 / 改动：
+
+- `world/zipline/zipline.gd` + `zipline.tscn`：两个 Marker3D 锚点 + 抛物线下垂曲线。
+  缆绳网格在 `_ready()` 用 SurfaceTool 现造，子节点不给 owner → 不会被写进 .tscn。
+  对外接口：`sample / tangent / ride_point / closest_point`；手感参数（速度、刹车、吸附半径）都放在这一侧。
+- `character/player/player.gd`：新增 `_find_zipline / _attach_zipline / _detach_zipline / _ride_zipline`。
+  缆上直接写 `global_position`，不走 `move_and_slide()`；相机在缆上缓慢对齐到行进方向。
+- `character/player/player.tscn`：新增 `InteractHint`（Label3D），沿用 HealthLabel 的「节点配置」做法。
+- `project.godot`：新增 `interact` 输入动作（E）。
+- `world/main.tscn`：演示关卡 —— LaunchRamp（26.57° 斜引道）+ LaunchDeck（顶面 y=6.0）+ Zipline 实例。
+- `tests/test_zipline.gd`：13 项回归测试，钉住几何契约（端点、下垂量、切线方向、下滑方向、悬挂偏移）。
+
+验证：全量测试 20/20 通过（180 条断言）；实跑三次，按 E 后玩家从 `(0,0,0)` 滑到 `(0,0,18.8)` 缆末端。
+
+关键取舍：
+
+- `sag` 定义成「中点下垂深度」而不是比例 —— 调参所见即所得，不用解悬链线方程。
+- 出口固定为**较低**的那个锚点（滑索只能往下滑），两端等高时退回 A→B。
+- 模型里没有滑索动画片段，所以缆上复用下落姿态：`animator.set_motion(velocity, false, false)`，
+  没有为此在 `PlayerAnimator` 里加新状态。

.workbuddy-ai/memory/MEMORY.md

@@ -0,0 +1,24 @@
+# 项目长期记忆
+
+## 工程约定
+
+- 玩家控制器只认「运动结果」，不认识任何动画片段名；表现层在 `Body/PlayerAnimator`。
+  新增动作状态改 `player_animator.gd` 的 `ANIM_CLIPS`，不要往 `player.gd` 里塞片段名。
+- 组件的可调参数放在组件自己身上（如 Zipline 的速度 / 刹车 / 吸附半径），控制器只读不定义。
+- 头顶 UI（血条、交互提示）是 `player.tscn` 里的 Label3D 节点，不在代码里动态创建。
+- 测试用 `McpTestSuite`（`addons/godot_ai/testing`），脚本放 `res://tests/`。
+
+## Godot MCP 踩坑
+
+- **数值标量会被字符串化**：直接调 `node_set_property` 传 `1` / `false` 会报
+  `WRONG_TYPE: Cannot write String to a int/bool property`。
+  绕法：改用 `batch_execute`，把 value 放进每条 command 的 `params` 里（嵌套数字能正常保型）。
+  字符串、Vector / Color 对象不受影响。
+- **@tool 脚本现造的节点不会写进 .tscn**：`add_child` 后不给 `owner`，
+  `PackedScene::pack()` 就会跳过它。缆绳网格因此可以纯由锚点推导，不存在「文件和锚点对不上」的脏数据。
+- **新 `class_name` 要跑一次 `filesystem_manage(op="scan")`** 才进全局类表，
+  否则别的脚本把它当类型引用会解析不到。
+- `game_manage(op="suspend")` 期间**输入事件不送达**，`next_frame` 也拦不住物理帧；
+  想抓「运行中途某一瞬间」的画面不可靠，只能靠日志 / 属性断言验证。
+- 测试跑在编辑器进程里，`@tool` 节点必须真的 `add_child` 进编辑中场景才会跑 `_ready()`；
+  用完在 `teardown()` 摘掉，节点名以 `_McpTest` 开头可被测试运行器兜底清理。