开始菜单

.workbuddy-ai/memory/MEMORY.md

@@ -8,6 +8,11 @@
 - 组件的可调参数放在组件自己身上（如 Zipline 的速度 / 刹车 / 吸附半径），控制器只读不定义。
 - 头顶 UI（血条、交互提示）是 `player.tscn` 里的 Label3D 节点，不在代码里动态创建。
 - 测试用 `McpTestSuite`（`addons/godot_ai/testing`），脚本放 `res://tests/`。
+- 界面放 `res://ui/`。项目没有 Theme 资源，风格一律用节点上的 `theme_override_*` 内联写；
+  给容器（如 VBoxContainer）设 `theme_override_styles/*` 会**向下继承**给子按钮，不用逐个设。
+- 中文字体不用额外配：Godot 默认主题会回退到系统字体，实测中文正常渲染。
+- **`Net` 是 autoload，它的「联机测试」面板在 `_ready()` 里就 `visible = true`（CanvasLayer layer=20）**，
+  会盖在任何场景正中间。做开始菜单时要么让菜单的「联机」按钮接管它，要么在菜单期间把它藏起来。
 
 ## 动画（AnimationPlayer）
 
@@ -24,6 +29,17 @@
   第 4 个参数是「按住蹲键」这个输入事实（`crouch` 动作 = Ctrl），蹲着不动 → CROUCH、蹲着走 → SNEAK，
   这个区分在表现层做，控制器不需要知道两者差别。优先级：空中 > 蹲 > 移动。
 
+## 模型：mouse.glb
+
+- `body_mesh` 有**两个 surface**：`s0 "lambert1"`（身体，UV 几乎占满 0~1，贴
+  `mouse_mouse_lambert1_BaseColor.png`）、`s1 "face"`（面部，独立 UV 孤岛
+  u[0.142,0.356] v[0.038,0.238]，贴 `mouse_表情测试.png`）。
+  **面部是独立材质槽 → 换脸不用动 Blender**，`set_surface_override_material(1, mat)` 即可。
+- `mouse_表情测试.png` 是 1024² **RGBA 但 alpha 全 255**（实心蓝 #89B3FF 底 + 黑线脸），
+  不是透明覆盖层，只能当底图，不能当笔画层。
+- 面部孤岛只占 1024² 的 21%×20%，实际脸分辨率约 219×205 —— 要用 shader 把孤岛重映射到 0~1
+  再用方形小贴图，有效分辨率能翻一倍多。
+
 ## Godot MCP 踩坑
 
 - **数值标量经 MCP 会被字符串化**：`node_set_property` 传 `0.15` 能写进去，但回显是 `"0.15"`；