# group

普通分组。语义：`group create <组名>` 只新建空组；`group list` 列出；`group use/unuse` 维护当前目录默认分组（写 `.drowup/project.json` 的 `groupNodeKey`）。

```powershell
"{baseDir}/bin/drowup.exe" group create 套图 -p PROJECT_UUID --json
"{baseDir}/bin/drowup.exe" group list -p PROJECT_UUID --json
"{baseDir}/bin/drowup.exe" group use 套图 --json
"{baseDir}/bin/drowup.exe" group unuse --json
"{baseDir}/bin/drowup.exe" group 套图 -p PROJECT_UUID --json
"{baseDir}/bin/drowup.exe" group 套图 -p PROJECT_UUID --node-rm 图A --json
"{baseDir}/bin/drowup.exe" group 套图 -p PROJECT_UUID --run --json
```

| 命令 | 说明 |
| --- | --- |
| `group create <名> [-p]` | 新建空组（`data.childNodeIds: []`）。同名或同 id 已存在时报「有 N 个同名节点」 |
| `group list [-p]` | 列出画布上全部 group 节点（id / label / childCount） |
| `group use <名>` | 把当前目录绑定到该组。之后本目录 `node create` 不写 `-g` 也会自动挂进这个组 |
| `group unuse` | 解除绑定（保留 project 绑定） |
| `group <名> [-p]` | 查询已有分组：返回 `groupId / label / childNodeIds / removed` |
| `group <名> --node-rm <节点>` | 把节点从组里解绑（可重复，改的是组的 childNodeIds） |
| `group <名> --run` | 整组生成：对组内生成型子节点逐个触发并阻塞；文本/素材节点跳过，没模型的报「未指定模型」跳过 |

挂组：`node create … -g 套图` 或绑定默认组后直接 `node create`。分组隶属关系只存在组的 `childNodeIds` 数组里，节点本身不带父组字段。

查看组内节点：`node list -g 套图`。分组内节点照常参与连线（组只是收纳，不改边规则）。

错误：组不存在报「找不到节点：套图」；请先 `group list` 核对，或 `group create` 新建。
