# animation_track

> 动画轨道与关键帧操作。轨道: add_track, remove_track。关键帧: add_keyframe, remove_keyframe, update_keyframe。曲线: set_curve。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。

| 属性 | 值 |
|------|-----|
| 所属层 | headless |
| 安全级别 | guarded |
| 需要 Godot | 是 |
| 需要编辑器 | 否 |
| 只读 | 否 |
| 长耗时 | 否 |

## Actions

- `add_track`
- `remove_track`
- `add_keyframe`
- `remove_keyframe`
- `update_keyframe`
- `set_curve`

## Parameters

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `action` | enum (6 项) | ✓ | 操作类型 |
| `project_path` | string |  | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） |
| `node_path` | string |  | AnimationPlayer 节点路径 |
| `animation_name` | string |  | 动画名称 |
| `track_type` | enum (9 项) |  | 轨道类型（add_track 时必填） |
| `track_path` | string |  | 轨道路径，如 "Sprite2D:frame"（add_track 时可选） |
| `track_index` | number |  | 轨道索引 |
| `insert_at` | number |  | 轨道插入位置，-1 为末尾（add_track 时可选） |
| `keyframe_index` | number |  | 关键帧索引（remove_keyframe/update_keyframe/set_curve 时必填） |
| `time` | number |  | 关键帧时间（秒）（add_keyframe 时必填） |
| `value` | any |  | 关键帧值（add_keyframe/update_keyframe） |
| `transition` | number |  | 过渡曲线，1.0=线性 |
| `in_handle` | object |  | 入控制柄坐标（set_curve） |
| `out_handle` | object |  | 出控制柄坐标（set_curve） |
| `load_autoloads` | boolean |  | 是否加载 Autoload 上下文（默认 true） |

## 风险分布

读 3 / 破坏性 3

---
<!-- AUTO-GENERATED by scripts/gen-tool-docs.mjs from capability-matrix.json v0.32.21. DO NOT edit manually; re-run npm run gen:tool-docs after tool changes. -->