# editor

> 编辑器实时操作(需 editor 模式+插件连接)。sync_start=开启场景树监听, sync_stop=停止监听, get_scene_tree=取当前场景树快照。

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

## Actions

- `sync_start`
- `sync_stop`
- `get_scene_tree`

## Parameters

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `action` | enum (3 项) | ✓ | 操作类型。sync_start=开启监听, sync_stop=停止监听, get_scene_tree=取场景树快照 |
| `project_path` | string |  | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） |

## 风险分布

读 3

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