# signal

> 信号操作。connect/disconnect: 连接/断开信号。emit: 发射信号（参数仅基本类型）。list: 列出节点可用信号。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。

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

## Actions

- `signal_connect`
- `signal_disconnect`
- `signal_emit`
- `signal_list`

## Parameters

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `action` | enum (4 项) | ✓ | 操作类型 |
| `project_path` | string |  | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） |
| `source_path` | string |  | connect/disconnect/emit: 源节点路径（如 root/Player） |
| `signal_name` | string |  | connect/disconnect/emit: 信号名称 |
| `target_path` | string |  | connect/disconnect: 目标节点路径 |
| `method_name` | string |  | connect/disconnect: 目标方法名称 |
| `flags` | number |  | connect: 连接标志（可选，默认 0） |
| `args` | array |  | emit: 信号参数（仅 string/number/bool/null） |
| `node_path` | string |  | list: 节点路径 |
| `load_autoloads` | boolean |  | 是否加载 Autoload 上下文（默认 true） |

## 风险分布

读 3 / 写 1

---
<!-- 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. -->