自由画布
用途
在无限画布上摆放文本/图片/视频/音频等节点，连线组织关系，对节点触发生成，并管理素材与多窗口协作。画布同时承担两类管理工作：
- 资产管理：把画布上的节点按类型整理成可搜索的资产目录，随时定位回画布。
- 版本管理：图片/视频/音频重新生成或替换文件时保留历史版本，可对比并随时切回。
入口
- 侧栏 自由画布（
/canvas）列表 - 画布编辑
/canvas/:id - 分享只读页
/share/canvas/:token（持有链接者）
前置条件
- 已登录（分享页按链接权限访问）。
- 生成依赖管理端模型与积分配置。
- 大画布保存时，客户端可能分批提交 operations；中途失败需按提示重试，勿假设已全部落库。
操作步骤
列表与新建
- 打开自由画布列表，新建或进入已有画布；卡片封面是画布内最多三张媒体的拼图，并显示归属项目与更新时间。
- 从短剧项目进入时，画布可能已关联项目上下文。
编辑画布（高频）
- 顶栏左侧打开画布菜单，包含视图切换、主页、新建画布、删除当前画布、保存（⌘ S）、导入素材、搜索节点（⌘ F）、撤销（⌘ Z）与重做（⌘ ⇧ Z / ⌘ Y）；顶栏中部是「画布 / 资产」视图切换，右侧提供搜索、导入第三方画布（LibTV / TapNow）、专注模式（Shift + Ctrl/Cmd + F）与分享。
- 使用底部工作条切换指针/抓手等工具；打开 素材 托盘查看数量并拖入节点。
- 添加文本、图片、视频等节点；图片节点保持比例；名称可点铅笔或单击编辑。
- 连接节点表达引用/流程；左下角可开「设置隐藏节点连线」——默认隐藏，悬停/选中时再显示关联线。
- 在节点上选择模型与参数，提交生成；成功后媒体节点可显示产出模型等信息（若外观设置开启）。
- 图片工具条提供「区域标注」等编辑工具：框选多个区域，在提示词里用 @区域1、@区域2 分别描述修改。
- Agent 修改画布后，镜头会自动移到被改动的节点，节点外圈轻闪一次提示刚才动的是哪里。
- 缩放、平移时注意浮层（modal/下拉）上的操作不会误触画布手势；带
data-canvas-no-zoom等区域不响应缩放。 - 需要时使用分享功能生成链接（权限以页面为准）。
资产视图
- 顶栏切换到「资产」视图后，当前画布节点被整理为「类型 → 资产 → 版本」的目录，可按名称搜索，也可直接上传文件。
- 分类网格中单击卡片查看详情，双击在画布中定位；详情页支持重命名（点击标题或铅笔）、下载，以及「在画布中定位」。
- 多版本资产的详情页可为历史版本「设为主版本」，写操作回到画布的现有保存路径。
媒体版本与重新生成
- 图片/视频/音频原位重新生成或上传替换文件时，旧媒体自动进入节点版本历史（保留最近 30 个版本）；生成中的新版本在列表末尾显示进度。
- 通过节点右键菜单「版本历史」打开版本面板：缩略图条悬停即预览、←/→ 浏览、Enter 切换；图片支持「单张 / 对比当前」的滑杆对比。
- 面板内可「切换到 V{n}」（只替换媒体，提示词与连线保持不变）、「另存为新节点」或删除非当前版本。
批量下载
框选多个节点后右键，菜单显示「下载 N 个资源」；图片、视频、音频资源会逐个下载。
上传素材
- 通过「导入素材」、拖拽文件到画布或粘贴剪切板图片上传；占位节点首帧即显示本地图片并叠加上传进度，不再等待服务器。
- 多文件上传按 3 个并发排队，节点按网格排布，整体进度按已完成数量展示；单个文件失败原因保留在各自节点上，汇总提示成功/失败数量。
- 把文件拖到已有媒体节点上可替换文件；替换后旧媒体进入版本历史，可随时切回。
多窗口协作
同一账号多窗口打开同一画布时，顶部可显示在线设备数与光标；只读自己与他人的轻量预览，最终内容仍经保存合并。
字段与含义
| 概念 | 含义 |
|---|---|
| 节点 | 画布上的内容单元 |
| 连线 | 节点关系；可隐藏 |
| 素材托盘 | 当前可用素材快捷入口 |
| 产出模型 | 生成成功时冻结的模型，不等于下次选用模型 |
| 资产视图 | 由画布节点派生的结构化目录（类型 → 资产 → 版本），重命名/设主版本回到画布写路径 |
| 媒体版本 | 节点内媒体的历史记录；切换版本只替换媒体，节点 ID 与连线不变 |
| 主版本 | 资产多版本中的当前生效版本，可在资产视图或版本面板切换 |
| 区域标注 | 图片编辑工具：框选多个编号区域，提示词按 @区域N 分别描述修改 |
结果如何验证
- 刷新后节点与媒体仍在；生成失败节点保留错误信息而非假成功。
- 分享链接在无登录或按规则下可预览（以实现为准）。
- 上传的文件上传完成前后提示不同：「已保存在本机，尚未上传到服务器」表示本地暂存，等待自动同步，不代表服务端已保存。
常见失败
| 现象 | 处理 |
|---|---|
| 生成失败 | 查节点错误详情、模型与积分；管理员看请求明细 |
| 保存不完整 | 大批量变更可能分批；失败后按提示重放，勿重复盲目编辑 |
| 视频一直转圈 | 成功前需完成资源缓存；失败会保留失败态 |
| 找不到连线 | 检查是否开启了隐藏连线 |
| @ 素材缩略图空白 | 签名地址过期或加载失败时会自动换新地址重试（有冷却间隔）；仍异常时重开面板或刷新页面 |
| 上传失败 | 节点上保留失败原因；可按原因重试上传，或把文件重新拖到节点上替换 |
| 版本不能切换/删除 | 节点锁定或生成中时面板会提示原因；当前版本不能删除 |