画布概览与基础操作

配图占位：无限画布与统一资产目录入口。

用途

无限画布用于非线性探索：把文本和媒体输入、AI 生成、短剧创作、工具与资源节点组织成可见流程。每个节点单独运行，画布不会自动执行整条下游链路。

使用前准备

创建或打开“无限画布”项目，并在个人或项目配置中准备所需的文本、图片、图片编辑、视频或语音模型。

操作步骤

从节点目录按“输入、AI 生成、Meme 创作、短剧创作、工具”添加节点，或从资产目录放入已有资源。
从输出端口拖到类型兼容的输入端口；非多值端口的新连线会替换旧连线。
在节点卡片或右侧工作区填写参数。AI 生成节点可在“节点模型”中手动覆盖模型；留空时使用项目配置，项目配置未覆盖时使用账号默认模型。
检查必填端口、输入版本、模型和预计费用，然后手动运行节点。
结果完成后继续连线；上游版本变化时，检查标记为“需更新”的下游节点并按需重跑。

常用画布操作包括缩放、平移、框选、复制节点、自动布局、收纳子节点和打开资产目录。自动布局会把人物、场景和道具放入独立泳道，并让同一资产的设定、设计与图片链保持同行；同一人物的多个形象会排列在相邻子行。节点组的展开或收起状态会在后台同步和节点目录加载时保持不变。触控板横向滑动会保持在画布内，不会触发浏览器前进或后退。删除节点不会删除已保存到创作资产库的产物。

结果与状态

节点显示“待配置、生成中、已完成、失败、需更新”。生成产物保存为资产版本；结构化短剧流程还会创建可继续连接的资源节点。提交中的状态不会被自动保存覆盖，失败时可在修正原因后重试。页面可见时，画布每 15 秒同步一次服务端变更；重新聚焦窗口或切回标签页时也会立即同步，因此 CLI 或其他协作者新增的节点和连线无需手动刷新页面。后台同步和节点尺寸测量不会被当成用户编辑，只有实际移动节点、调整视口或修改画布内容才会触发自动保存。

权限和限制

项目所有者可使用自己的全局创作资产；管理员代管他人项目时，只能读取该项目生成或画布已引用的资产。
必填端口未满足时不能运行。普通文本可连接语义文本端口，图片、视频和音频必须遵守媒体类型。
画布运行不会自动触发下游；重复运行付费节点会新增模型调用和版本。
“生产画布”是标准项目内部的已发布流程能力，不是第三种项目类型。

常见问题

为什么连线被拒绝？

确认输出端口与输入端口类型兼容，并检查目标端口是否已被另一条单值连线占用。详见节点参考的端口规则。

为什么上游更新后下游没有自动运行？

画布只把下游标记为“需更新”，避免未经确认产生费用。检查新版本后手动运行目标节点。

画布加载错误与重试

进入无限画布项目时，前端会调用 readCanvasSnapshot 拉取画布数据；如果后端返回错误，画布会显示专门的错误页（不再是裸错误提示）。四种错误态分别对应不同的引导动作。

触发场景与用户提示

错误码 / HTTP 状态	触发场景	页面文案	建议动作
`FREEFORM_CANVAS_NOT_FOUND` 或 `404`	项目下尚未创建无限画布，或画布已删除	“画布尚未创建或已删除，请返回项目主页初始化。”	点击重试重新拉取，或点击返回项目主页离开画布页
`401 UNAUTHORIZED`	登录会话过期、token 失效	“登录已过期，请刷新页面或重新登录。”	刷新页面或重新登录后重试
`403 FORBIDDEN`	当前用户没有访问该画布的权限	“您没有访问此画布的权限。”	联系项目所有者申请权限，或返回项目主页
`5xx`（500/502/503/504 等）	服务端暂时不可用	“画布服务暂时不可用，请稍后重试。”	等待几秒后点击重试

其它错误（例如网络断开、status=null）会沿用画布原有的 toast 提示：显示在顶部并自动消失（2.5 秒），不会停留在错误页。

重试与返回

错误页提供两个按钮：

重试：调用 retryLoadCanvas，重新触发一次 readCanvasSnapshot。会重置 loadError 并清空 message，再走一次加载流程。
返回项目主页：调用 router.replace('/workspace/[projectId]')，退出无限画布页回到项目工作区。

错误页的 DOM 标识为 data-testid="canvas-load-error"，便于 E2E 选择器定位。

实现位置

状态字段：src/app/[locale]/workspace/[projectId]/canvas/InfiniteCanvasClient.tsx 第 278 行 loadError state。
错误分支：同文件第 810–839 行 4 状态码分支（404 / 401 / 403 / 5xx）。
重试回调：同文件第 847–851 行 retryLoadCanvas。
错误页渲染：同文件第 2093–2112 行（canvasLoadErrorActions 已抽到 infinite-canvas.module.css）。

统一资产面板

点击底部工具栏的 资产管理 打开统一资产目录。面板使用项目与目录面包屑，在同一文件列表中展示当前位置的直接子目录和资产，不再显示独立的“全部资产”框或“全部资产”标题。

可以浏览有权限的项目、目录、未分类 和 回收站。只有当前画布项目的活动目录可以上传，也只有当前项目的活动资产可以点击或拖入画布。其他项目不能在当前画布中上传或加入资产，但可在已授予的项目权限范围内复制、移动、删除或下载。回收站中的内容只能恢复或下载。当前位置支持搜索、类型筛选、下载全部或下载所选；加载失败时可点击重试重新加载当前位置。

没有目录字段的历史资产集中显示在 未分类，升级后仍可访问。详见无限画布资产目录。