# 节点类型

`node create -t <type>`。一次只建一个节点。连线用 `--left` / `node <名> --right`，规则与网页画布相同。

| `-t` | 用途 | 典型 `--left` | 模型 | 数据契约 |
| --- | --- | --- | --- | --- |
| `-t text` | 文案、卖点、提示词源 | 无，或其它 text | 需要（chat） | `data.content + model + modelId` |
| `-t script` | 脚本/分镜（先生成脚本内容） | text（promptOrder） | 需要（chat） | `data.rows/prompt + model + modelId` |
| `-t image` | 主图、细节图、场景图 | text（promptOrder）或 image（imageOrder） | 需要（image） | `data.prompt + model + modelId`，产物在 `url/outputUrls/images` |
| `-t video` | 短视频、成片 | text（promptOrder）或 image（imageRole） | 需要（video） | `data.prompt + model + modelId` |
| `-t audio` | 口播、配音 | text（promptOrder） | 需要（audio） | `data.prompt + model + modelId` |
| `-t style` | 风格（当 prompt 源） | 无 | 不需要 | `data.content` |
| `-t mediaUpload` | 素材节点（参考图/视频/音频） | 无 | 不需要 | `data.assets: [{assetType, name, url}]` |
| `-t group` | 普通分组（收纳节点） | 无 | 不需要 | `data.childNodeIds: []` |

模型目录映射：text/script 查 `chat`，image/video/audio 查同名目录（`model search --type text` 实际查 chat）。

少见但 CLI 会原样提交的网页类型：`panorama` / `directorDesk`（当图源）。不要发明未在 `projects get` 里见过的类型名。

## 连线规则

| 上游 → 下游 | 边类型 |
| --- | --- |
| text / style → image / video / text / audio | `promptOrder` |
| image / panorama / directorDesk → image / text | `imageOrder` |
| image / panorama / directorDesk → video | `imageRole` |

`node <名> --left` 是「确保有这条边」，`--left-add` 是追加，`--left-rm` 是删边。

详细命令见 `commands/node.md` 与 `commands/group.md`。
