# projects

列出、新建或读取一张画布，绑定当前目录。`project` 是 `projects` 的别名。

```powershell
"{baseDir}/bin/drowup.exe" projects create 裂变主图 --json
"{baseDir}/bin/drowup.exe" projects list --json
"{baseDir}/bin/drowup.exe" projects list --keyword 毛衣 --json
"{baseDir}/bin/drowup.exe" project list --json
"{baseDir}/bin/drowup.exe" projects get PROJECT_UUID --json
"{baseDir}/bin/drowup.exe" project use PROJECT_UUID --json
"{baseDir}/bin/drowup.exe" project unuse --json
```

## 新建个人画布：projects create

用户要新画布时用这一条，不要先 `projects list`，不要自己拼 HTTP。

| 旗标 | 默认 | 说明 |
| --- | --- | --- |
| `<名>` 或 `--name` | 必填 | 画布标题，写入列表页卡片 |
| `--space` | `personal` | 个人画布。团队画布在网页建 |

返回 `projectUuid` / `projectUrl`，并写入当前目录 `.drowup/project.json`。立刻把 `projectUrl` 给用户。本地基址时链接是 `http://localhost:8080/#/layout/assetCanvas/canvas/{id}`。

复制、删除在网页完成。套个人工作流模板用 `workflow apply`，见 `commands/workflow.md`。

`project use` 把已有画布 UUID 写进当前目录 `.drowup/project.json`，绑定后本目录下 `node`/`runs`/`billing` 命令免 `-p`。`unuse` 解除。

`projects get` 返回节点 `id / type / data.label|content|prompt|model|modelId` 和边 `source / target / type`。后续 `node create --left` 用这些 id 或展示名，不要发明 ID。

用户点名已有画布时 `project use` 或带 `-p`，不要先全量 list。
