开始前：账号、空间与计费

先确认项目放在哪个空间、请求从哪个账户扣费。普通用户不需要配置 API、渠道或服务器。

• 登录平台

  使用平台模型、云画布和团队空间需要登录。仅整理当前浏览器里的本地素材时可以不发起生成。

• 选择项目空间

  个人空间保存自己的画布；Workspace 保存团队项目并按成员角色协作。创建画布前先确认当前空间。

• 确认计费账户

  打开右上角“账户”，选择个人或企业账户。之后的新请求从当前计费账户扣分，切换项目空间不会自动切换钱包。

• 使用公开模型

  管理员已经发布的模型会直接出现在节点里。图片、文本和视频不暴露底层路由；音频仍显示管理员公开且已定价的渠道模型。普通用户都不需要填写 API Key 或 Base URL。

五分钟做出第一张图

下面是画布内最短路径。关键是创建“图片生成”，不要把上传得到的纯资源节点当成生成节点。

1. 1

   打开新画布

   点击本页上方“开始第一张图”，或进入“工作台”后点击“新建画布”。

2. 2

   选择图片生成

   在画布真实空白处右键，在“生成节点”下选择“图片生成”。新节点会出现在点击位置。

3. 3

   打开生成面板

   单击选中节点。生成节点下方会显示提示词、模型、图片参数、预计积分和运行按钮。

4. 4

   输入画面描述

   写清主体、环境、构图和风格，例如“夜晚的海边咖啡店，暖色灯光，电影感”。第一次可保留默认模型和参数。

5. 5

   确认估价并运行

   预计积分正常后点击运行。重复点击会创建独立任务；同一节点按顺序执行，不同节点可以并行。

6. 6

   查看并保存结果

   完成后图片直接回写当前节点并进入历史。可以切换结果、下载原图、加入“我的素材”或继续连接下游。

工作台与项目管理

工作台按个人空间和 Workspace 管理云项目、空间模板与成员；系统工作流与公开素材从顶部模板库进入。

• 切换空间

  个人空间只显示自己的项目和模板；选择 Workspace 后显示该团队的项目、模板和成员。Workspace 与企业钱包是两个独立概念。

• 新建与导入

  点击“新建画布”创建空白云项目；“导入画布”可导入受支持的 ZIP 或 LXF，导入内容会经过节点数量、ID、坐标、输入槽和循环依赖校验。

• 管理项目

  项目卡片可打开、重命名、复制、分享或删除；分享只对当前项目生成只读链接，不会把编辑权限交给访客。

• 空间模板

  “我的模板”只显示个人模板，“团队模板”只显示当前 Workspace 模板；顶部“模板库”的工作流模板栏目只展示平台审核发布的系统模板。

• 成员权限

  Workspace Owner、Admin 和 Member 按权限编辑团队项目，Viewer 只读；成员角色不会自动改变企业钱包额度。

创建中心：单次图片与视频

不需要编排工作流时，从“创建中心”进入独立图片或视频创作台；复杂的多步骤任务再交给画布。

• 切换图片与视频

  图片/视频切换位于左侧创作设置顶部；两种模式都按左侧设置、中部等待队列、右侧成果区排列。

• 配置并提交

  图片集中设置模型、参考图、提示词、比例、清晰度、画质和数量；视频按模型能力组合图片、视频或音频参考。高级尺寸只在预设无法满足时使用。

• 整理生成结果

  中部队列显示当前任务和生成记录。把结果分到右侧“上桌”“备用”或“舍弃”，分类只整理结果，不会重复生成或复制文件。

• 保存与打包

  上桌结果可一次保存到“我的素材”或流式打包下载；单项保存、下载、编辑和失败重试仍可直接在结果卡操作。

• 保存提示词

  创建中心可把常用提示词保存到账号级“我的素材”，不会自动发布为模板。

• 进入画布

  需要多个节点、明确输入顺序、分支、Group、重复运行或团队协作时，使用画布工作流。

画布基础操作

掌握移动、缩放、选择、上传和撤销；节点拖动时面板会暂时收起，方便观察位置和连线。

• 移动视野

  触控板双指滑动或鼠标滚轮可以平移画布；按住空格再拖动，或使用鼠标中键，也可以平移。

• 缩放画布

  触控板双指捏合，或按住 Ctrl / Command 再滚动，会以指针位置为中心缩放；细微捏合会适度增强响应，右下角也有缩放按钮。

• 选择内容

  单击选择一个节点；按住 Shift 可追加选择；在真实空白处拖出选框可以框选多个节点。

• 新增与上传

  右键空白处可创建文本、图片、视频或音频生成节点，也可创建文本、图片或视频纯资源节点并上传本地素材。

• 撤销误操作

  左侧工具栏提供撤销和重做。拖动过程中按 Escape 会恢复原位；正常松手、窗口短暂失焦或浏览器意外中断已产生位移的指针时，保留屏幕上最后可见位置。

• 查找内容

  左侧“查找节点”可以定位远处节点；没有找到前不要重复创建同一内容。

• 修改标题

  双击节点标题或普通 Group 左上角标题可原位修改；Enter 或失焦提交，Escape 取消，键盘也可用 Enter/F2 进入编辑。

• 对齐与批量缩放

  拖动节点、选区、Group 或缩放时只显示实际边框的辅助线，中心对齐不再出线；辅助线只提示，不会强制吸附或拉动节点跳位。拖动开始时会冻结本次候选，不会因节点状态更新中途卡住。多选节点后，拖动任一选中节点原有角点，即可从它的对角位置等比缩放整组选区。

认识画布上的工具

先按位置找工具：节点和 Group 的工具只在选中后出现；左侧处理内容，左下角只调整视野，右下角打开网站 Agent。

• 节点工具

  单击节点后，节点上方显示当前节点工具。不同节点会显示不同按钮：常用项包括重命名、信息、转换和删除；文本可编辑正文与样式，媒体可替换、保存素材和下载，图片还可裁剪、蒙版、切图、多角度或查看大图。把指针停在图标上可看到名称。

• Group 工具

  单击 Group 标题后，组上方显示运行、暂停/恢复、停止、失败重跑、水平/垂直整理、配置组内模型、保存模板、折叠/展开、解组和颜色。权限不允许或当前状态不适用时，相关按钮会隐藏或禁用；“更多操作”里有重命名、复制、保存产出和删除组及内容。

• 右下角 Agent

  点击右下角 Agent 打开画布内助手，默认“网站”模式，直接使用平台发布的文本模型，不需要安装插件。先选中节点可把它作为上下文，也可上传图片、视频或音频；开启“工具确认”后，实际改动画布前需要在对话中批准。

• “本机 → 连接”复制完整 MCP 命令

  连接页先按当前主站或代理站域名生成完整 add + login 命令；NUV Studio 插件安装放在下方折叠补充。只有开发、私有部署或旧环境才展开底部“本地 Agent（高级补充）”，使用 npx、Local URL 和 Connect token。

• 左侧工具栏

  从上到下可打开模板库、查找节点、Workspace 评论和撤销历史，并提供撤销/重做、上传素材、我的素材、保存产出以及当前选区的创建 Group、折叠、保存模板、运行和删除。只读画布不会显示写入类按钮。

• 左下角视图工具

  小地图、重置视图、缩放滑杆、当前百分比、快捷键和专注模式只影响你如何观察画布，不会改变节点真实尺寸、位置或其他协作者的视口。

• 顶部项目栏

  顶部用于切换或新建画布、查看保存状态、分享、画布外观、系统公告、后台任务和账户入口。看到“云端保存失败”时先保留当前页面并按提示重试，不要把“保存产出”误当作云画布保存。

节点工具：查看、裁切、切分与自定义

先选中一个节点，再从节点上方工具栏操作。图片节点功能最多，本节按真实界面说明每个按钮会做什么、结果放在哪里以及为什么按钮可能不可用。

1. 1

   先单击要处理的节点

   单击节点主体后，节点上方才会出现工具栏。不要点标题旁的输入/输出端点；端点用于连线。工具栏消失时重新单击节点，或先关闭挡住画布的弹窗和侧栏。

2. 2

   悬浮图标确认名称

   把鼠标停在图标上会显示完整名称。图片节点默认前 8 个工具直接显示，“更多操作”固定在最右侧；节点没有图片、没有提示词、当前只读或模板权限受限时，部分工具会隐藏、禁用或无法提交。

3. 3

   自定义图片工具栏

   点击“更多操作 → 自定义工具栏”。拖动工具，或使用每行右侧的上下箭头调整顺序；前 8 个标为“直显”，其余标为“更多”。点击保存后同步到当前账号，换图片节点也沿用；移动顺序本身不会执行任何工具。

4. 4

   查看大图与下载原件

   点击“查看图片详情”，或双击图片节点主区域。等待 Original 加载完成后，用底部缩放控件检查细节，再点“下载原件”。关闭查看器不会修改节点；下载原件和节点工具栏的普通下载都交给浏览器下载中心。

5. 5

   裁切并替换当前结果

   点击剪刀图标，拖动裁切框内部移动范围，拖动八个白点改变大小；也可用方向键微调，按住 Shift 加速。按需切换自由比例或锁定比例，核对裁切尺寸后再确认。确认后当前节点显示裁切图，原图仍保留在右侧结果历史；取消或关闭不会改图。

6. 6

   切分为多个新节点

   点击切图图标并保持“生成新节点”，设置行数和列数。预览编号从左上角开始，按从左到右、从上到下排列；按钮会提前显示要生成的节点数量和单块尺寸。确认后每个宫格成为当前节点右侧的新图片节点，源节点不变。

7. 7

   把宫格派发到下游

   切换到“派发到下游”后，每个宫格只能选择一个已经直接连接的下游图片节点；同一下游不能重复选择，未选择的宫格会舍弃。没有合格下游或一个宫格都没选时，派发按钮保持禁用；先关闭弹窗完成连线，再重新切分。

8. 8

   放大图片像素

   选择 1K、2K 或 4K 长边，再选择高清插值、双线性或最近邻。目标尺寸必须大于源图；确认后会在右侧创建并连接一个“Upscaled Image”节点，源图不变。这是像素插值，不是 AI 超分，也不会调用图片模型。

9. 9

   局部遮罩编辑

   选择已有图片结果的图片生成节点，打开“局部编辑”。用画笔涂要修改的区域，用擦除修正遮罩，调整笔刷大小，再在“修改要求”写清替换内容。点击“AI 修改”会按当前公开图片模型估价并生成右侧子节点；源图不变，余额不足、没有可用模型或只读时不能提交。

10. 10

    AI 多角度

    左右角度、俯仰角度和镜头距离只控制重生成方向，左侧预览不是最终结果；标准/广角决定镜头感觉。点击“AI 生成”会创建并连接新的图片子节点并正常计费，不是把原图直接旋转。

11. 11

    替换、比例、素材与下载

    “替换图片”选择新的原始文件；“锁比例/自由比例”只改变画布上的显示缩放方式，不重采样原始图片；“存素材”加入我的素材；“下载”保存当前选中结果。图片尚未稳定上传或没有当前结果时，相关入口可能暂不可用。

12. 12

    提示词和通用节点操作

    生成图片有 Prompt 时可复制提示词；“反推提示词”会创建用于分析图片的文本和配置节点。“信息”查看节点 ID、类型、尺寸与状态；“转换节点”会清空不兼容内容和历史；“重命名”只改标题；“删除”会移除节点及关联连线，操作前确认没有选错节点。

13. 13

    文本、视频和音频节点

    文本节点提供正文编辑、放大编辑、文字样式和字号；视频节点提供原视频播放、下载、存素材和编辑；音频节点提供播放、下载及基础信息。不同类型不会强行显示图片专用工具，先看悬浮名称再操作。

14. 14

    工具点了没有反应时

    先确认当前选中的是正确节点且已有可用内容，再检查是否有弹窗、只读权限、受保护模板、素材上传中或运行状态提示。涉及 AI 的局部编辑和多角度还要确认公开模型、参数、余额和并发；结果不确定时先看任务中心和请求记录，不要连续重复提交。

画布内 Agent 使用与排错

右下角 Agent 直接理解当前画布。普通用户使用“网站”模式，先明确目标，再决定是否让工具执行。

1. 1

   选择“网站”模式

   点击右下角 Agent，保持顶部“网站”选中。它使用管理员发布的文本模型；输入区会显示当前模型、线路和每次模型调用的预计积分。

2. 2

   先选目标，再描述动作

   先单击或多选要处理的节点，它们会作为引用出现在输入框上方。尽量说清“对哪个节点做什么、放在哪里、是否运行”，例如“把选中的两张图连接到右侧视频节点，只连线，不运行”。

3. 3

   需要时添加附件

   可附加图片、视频或音频，单次最多 6 个。Agent 可以把附件放入同类型节点或新建素材节点；不支持的文件不会上传。

4. 4

   确认实际操作

   开启“工具确认”时，Agent 先展示准备执行的修改和预计积分；点击批准后才写入画布，拒绝则不会执行。关闭后工具会自动执行，仍受画布权限、估价和运行规则限制。

5. 5

   从历史和日志继续

   “历史”保存网站 Agent 对话，“日志”记录模型与工具阶段。失败时先复制“最近错误”，再核对画布和请求记录；新对话不会删除画布内容。

6. 6

   模型状态显示没有可用模型

   说明管理员尚未发布文本模型，或当前账号没有对应权限。到“模型状态”和“用户偏好”确认选择；仍为空时联系平台管理员发布模型，反复发送不会解决。

7. 7

   Agent 有回复但画布没有变化

   如果回复只是说明文字，通常是目标不清楚或模型没有返回工具调用。先选中具体节点，再用明确动作重新描述；看到“工具确认”卡片时还需要批准。不要把文字回复当作已完成。

8. 8

   提示节点、Group 或工具上下文不完整

   画布在估价或确认期间已经变化，或原目标已删除。重新选择当前节点/Group，再按原意发起一次；不要继续批准旧卡片。

9. 9

   积分、模型、并发或权限错误

   切换有余额且有权限的个人/企业计费账户，使用当前公开模型和合法参数；Viewer 或只读模板不能写入。已经提交的任务先去任务中心确认状态，不要连续发送。

10. 10

    附件上传失败

    确认文件是图片、视频或音频且浏览器仍能读取；一次不超过 6 个。素材损坏、类型不符或云媒体暂不可用时重新选择原文件，不能只把报错附件反复发送。

11. 11

    请求失败、服务暂时不可用或结果不确定

    先打开日志、后台任务和账户请求记录，确认是否已有运行中或成功请求。未确认失败或退款前不要重复运行；持续失败时提供发生时间、画布名称和脱敏错误，不要提供 Cookie、Authorization 或密钥。

12. 12

    连接页与本地兼容模式

    切到“本机 → 连接”时，可一键复制当前站点完整 MCP 配置；插件安装说明在下方折叠补充。只有你明确要运行本地 Agent 时，才展开底部高级补充并检查 Node.js、Local URL、Connect token 和浏览器本地网络权限。

安装 NUV Studio MCP 插件

普通用户不需要 Node.js、npm、本机 Agent 或连接 token；插件可在主站授权页选择已验证的主站或代理站账号，也可从画布 Agent 面板复制当前站点完整命令。

1. 1

   添加插件来源

   在终端只运行一次：codex plugin marketplace add liuchaoqi-7/nuv-canvas-agent --ref main。成功后回到 Codex，不需要继续在终端安装。

2. 2

   在插件页安装

   打开 Codex 的插件页，找到“NUV Studio”，点击下载或安装。插件标识 nuv-canvas@nuv-canvas-agent 主要用于排错，日常不需要记。

3. 3

   选择登录账号并授权

   安装后通常会打开 NUV 网页授权。选择已验证的主站或代理站账号，再核对读取、修改和运行权限。首次添加代理账号时会顶层跳到该站验证当前登录会话，然后自动返回选择页。

4. 4

   从设置里补授权

   还可以打开 Codex“设置 → 插件 → MCP 服务器”，找到 infinite-canvas 后点击授权。授权由 Codex 保存，不要把账号密码、Cookie、token 或授权链接粘贴到对话中。

5. 5

   代理站有两种连接方式

   推荐在插件内置主站授权页添加并选择代理账号；需要固定单站时，在该代理站画布“Agent → 本机 → 连接”一键复制本站完整命令。统一网关与直连令牌 resource 不同，不能互相复用。

6. 6

   新建对话并选择画布

   安装或重新授权后新建一个 Codex 对话，输入“列出我的 NUV Canvas 画布，让我选择后读取结构”。选择已有画布后，再直接描述移动节点、创建文本、上传素材或配置生成。

7. 7

   需要生成时先确认价格

   读取和编辑不会自动运行模型。让 Codex 生成文本、图片、视频或音频时，它会先展示实际参数和预计积分，得到确认后才提交；静态视频剪辑合成本身不扣 AI 积分。远程插件当前不运行整个 Group/DAG。

MCP 插件报错与解决办法

先按你看到的现象处理。授权、工具加载和画布权限是三件不同的事；生成结果未知时不要反复点击。

• 插件页搜不到 NUV Studio

  先确认添加来源的终端命令已经成功，再关闭并重新打开插件页。仍没有时运行 codex plugin marketplace list --json，确认存在 nuv-canvas-agent；不要删除其他插件来源。

• 已经安装，但对话里没有画布工具

  旧对话不会自动刷新插件工具。先确认 NUV Studio 已启用，再完全退出并重新打开 Codex，然后新建对话。若 codex mcp get infinite-canvas 显示 command、npx 或 stdio，说明旧本地 MCP 抢占了同名服务：移除该旧 infinite-canvas，本地兼容模式以后只使用 infinite-canvas-local。

• 安装后没有弹出授权页

  先到 NUV Studio 插件详情点击“授权/登录”；也可从“设置 → 插件 → MCP 服务器 → infinite-canvas”点击授权。仍无反应时运行 codex mcp login infinite-canvas。

• 授权请求无效、授权失败或授权失效

  关闭错误页，回到 Codex 重新点击授权，不要修改跳转链接。统一授权时重新选择目标站点账号；直连时确认网页 Host 与当前 MCP resource 完全一致。仍失败可重新 login 并新建对话，不要发送或粘贴 token。

• 代理站只显示主站画布

  使用插件内置 infinite-canvas 时重新授权，添加并选择对应代理站账号；使用本站直连时检查 URL 与 OAuth resource 是否都是当前代理域名。只启用当前要使用的 NUV MCP，重开 Codex 后新建对话。

• 代理站模型或价格不可用

  只使用代理站公开目录中的逻辑模型，不填写物理模型、渠道或 Billing Key。仍无法估价时由代理运营人员检查模型上架、用户零售价、主站批发价和批发钱包；估价失败不会提交生成。

• 提示缺少 canvas:run

  旧授权只能读写，不能估价或生成。重新授权并允许“运行生成任务”，然后在新对话中重新列出画布。该权限仍受画布角色、模型权限、余额和并发限制。

• 找不到画布、没有已连接画布或选择失效

  在当前对话重新说“列出我的 NUV Canvas 画布”，再按个人空间或 Workspace 选择。画布被删除、账号切换或权限变化后不能沿用旧选择，也不要让 Codex自动新建一个同名画布代替。

• 只读、没有权限或结构已变化

  Viewer 只能读取；需要修改或生成时请让 Owner/Admin 调整角色，或选择自己可编辑的画布。协作者刚修改结构时，让 Codex 重新读取后再执行原操作，不要覆盖整张画布。

• 生成、上传或合成结果未知

  先查看任务中心和账户请求记录，让 Codex 查询或恢复原任务。未确认失败、停止或退款前不要重复发起，否则可能重复生成和扣费；视频合成也不要新建第二个任务。

• 参数、余额、素材或服务暂时不可用

  按插件展示的可用模型和默认参数重试；余额不足先充值或切换合法计费账户；素材损坏、类型不符或无权访问时重新选择。持续显示服务暂时不可用时记录发生时间、画布名称、工具名和脱敏错误文案，勿提供密码、Cookie、Authorization 或 token。

节点、资源与输入连线

生成节点负责调用模型，纯资源节点只提供稳定内容。连线决定目标节点真正收到什么以及提交顺序。

• 生成节点

  可以接收输入、选择模型和参数并运行。文本、图片、视频和音频生成配置都保存在节点自身。

• 纯资源节点

  文本、图片和视频资源只向下游提供内容，不调用模型，因此没有生成配置和运行入口。资源文本可显示为普通卡片或透明横排/竖排文本，并调整字号和颜色。

• 连接输入

  从来源节点连接到目标生成节点。目标面板只读取直接入边，不会自动穿透更早的上游。

• 输入槽顺序

  输入 1、输入 2 等编号决定文字和参考媒体的提交顺序；可在资源栏拖动排序。直接上游移出当前视野后，资源栏仍会加载它的当前缩略图或视频封面。

• 断开连线

  点击输入缩略图右上角的 X 可直接断开该槽；选中目标节点后，也可按连线的删除门禁操作。

• 替换与继续运行

  运行中也可以替换媒体、断线或删除节点；已经提交的任务继续按自己的启动快照结算。

• 批量连线

  多选节点后，悬浮选区内外任意节点都会显示两侧加号。从选区连向外部节点会批量建立下游边；从外部节点连向选区会批量建立上游边。整批遇到循环、重复边或槽位不足时不会部分落边。

• 转换节点

  节点工具栏可在纯资源/生成用途和文本/图片/视频类型间转换；转换会清空不兼容内容与历史，保留节点 ID、位置、名称和 Group 归属。

模型、参数与预计积分

前台选择的是管理员发布的公开模型。可用参数、参考素材数量和价格会随模型与账户权限变化。

• 公开逻辑模型

  图片、文本和视频节点展示面向用户的公开名称与线路，不暴露真实供应商路由；音频显示管理员已启用并定价的模型。

• 图片参数

  质量、比例、数量和 1K/2K/4K 档位会影响可用线路与预计积分，具体选项以当前模型和账户为准。

• 视频参数

  清晰度、比例、时长、声音、水印及参考类型由视频模型配置决定；没有声明支持的模式不会显示。

• 预计积分

  运行前先确认按钮上的估价。显示“无法估价”或没有可用模型时先检查参数，必要时联系管理员。

• 已有节点不随默认变化

  新节点采用当时的后台默认模型；管理员以后修改默认项，不会静默覆盖已有节点选择。

结果历史与媒体查看

文本节点只持久化最新正文，图片、视频和音频节点保留有限的近期媒体结果；当前选中结果才会传给下游。

• 节点近期结果

  文本节点只保存最新正文；非文本云媒体近期结果最多保留 12 条。切换缩略图会改变当前结果和下游输入。

• 短期运行账本

  每次范围运行仍建立 run/attempt 用于恢复、结算和排查，但节点与 Group 的完整历史入口已经下线，服务端终态账本默认只保留 24 小时。

• 重复运行

  重复运行不会覆盖旧任务。同一节点按点击顺序串行，不同节点可以并行，每次任务使用自己的输入快照。

• 查看图片

  双击图片打开详情，可用按钮、滑杆或滚轮缩放，最大 999%；高倍率缩放围绕当前视口或鼠标焦点。

• 播放视频

  视频可直接在画布节点内播放、暂停、静音、拖动进度和全屏，不必先打开独立浮窗。

• 保存原件

  上传或替换图片时，节点尺寸只影响画布显示；下载继续使用原始媒体数据。

• 预览自动恢复

  图片预览偶尔加载失败时，画布会清除失效预览并自动重新加载，不会改动原图。若原始媒体确实已不存在，仍会显示明确错误。

• 删除结果

  删除结果会从画布快照和媒体引用中移除，但当前版本不会立即物理删除云对象；服务器需通过后续安全回收任务释放真正无引用的对象。

运行节点、选区与 Group

工作流按 DAG 依赖推进，不是简单从左到右。依赖无关的分支可以并行，只等待自己需要的上游。

• 运行到此节点

  节点右键选择“运行到此节点”，只规划它需要的最小上游范围。

• 从这里继续运行

  从当前节点向下游继续，或选择“重跑下游节点”，无需每次运行整张画布。

• 运行 Group

  框选或多选节点后打组。Group 的“从头运行”会按当前输入重算范围内的生成节点。

• 处理外部输入

  Group 外连入的素材必须已有稳定结果；缺失、失败或仍不稳定的来源只阻断依赖它的步骤。

• 等待粘贴图片

  直接粘贴的图片尚在上传时也可点击运行；画布会冻结这次 Asset 与结果绑定，媒体就绪并写入画布后自动继续。上传只补全自己的结果，不会覆盖期间切换到的其他历史结果；准备期间主动修改 Prompt、模型、结果选择、输入槽或连线时，旧准备快照会被淘汰，画布按当前完整状态自动重新准备，无需再次点击。

• 失败支线

  Group 完成、失败或停止后，可以只重跑失败/被阻断的节点，也可以再次从头运行。

• 并发边界

  多个互不依赖的节点或 Group 可以同时运行；实际并行数仍受当前计费账户的并发额度限制。

暂停、停止与自由编辑

运行不会锁死画布。暂停、停止和后续编辑各有明确边界，迟到结果也不会覆盖新的内容。

• 暂停与恢复

  暂停只阻止尚未提交后端的步骤继续调度；已经提交的请求仍会轮询、保存和结算，恢复时不会重复请求。

• 立即停止

  停止会马上释放当前画布状态，随后可以重新开始、从头运行或操作其他节点；已提交供应商的请求不会被取消，仍在后台按真实结果结算。

• 停止后完成

  停止后才返回的有效结果会写入原运行的“停止后完成”历史，不覆盖新结果、手工内容，也不会重建已删除节点。

• 运行中自由编辑

  可以断线、删除节点、解组、撤销/重做和替换媒体；已经提交的 attempt 继续按自己的启动快照收口。

• 部分成功

  多图任务只要至少一张成功就保留成功内容并继续可执行的下游；全部失败才阻断依赖支线。

Group、嵌套与折叠组

Group 用结构化层级组织流程。折叠只改变画布上的代理展示，不会删除内部节点或依赖。

• 创建与嵌套

  框选或多选节点后选择“打组”。Group 可以嵌套、整体移动、复制、重命名、解组和保存产出。

• 整理组内工作流

  选中 Group 后，从组工具栏选择“水平布局”或“垂直布局”。没有前置输入的步骤位于第一层，后续步骤按最深的直接上游层级排列；最长主路优先保持顺直，独立流程会分开排列。

• 调整 Group 边框

  选中普通 Group 后，将指针移到边框或四角附近，出现拉伸光标时拖动即可调整范围。边框周围有透明热区，不必精确压在线条上，且不会缩到覆盖组内内容。

• 折叠权限

  折叠为节点和展开节点组属于平台管理员专属操作；普通用户不能改变折叠状态。

• 密封子树

  普通用户始终不能展开或直接解组折叠组；允许时可整体移动、复制、重命名或整棵删除，但含折叠组的内容不能再次保存为模板。

• 配置组内模型

  模板策略允许时，普通用户和平台管理员都可从组工具栏进入模型配置；只显示组内实际存在的生成类型。

• 统一或逐节点设置

  可以按文本、图片、视频或音频类型统一设置，也可以切换到单个节点；不会因此解锁提示词或其他受保护配置。

使用系统、个人与团队模板

模板按归属分开显示。“使用模板”创建独立项目；画布内“模板库”才是把流程插入当前画布。

• 系统模板

  顶部“模板库”的工作流模板栏目展示平台审核发布的系统模板，不与个人或团队空间模板混在一起；公开素材位于同一模板库的素材栏目。

• 空间模板

  工作台的“我的模板”只属于个人空间，“团队模板”只属于当前 Workspace。

• 使用模板

  无论普通用户还是发布者本人，点击“使用模板”都会创建并打开新的个人或 Workspace 云画布，不会回到作者原项目。

• 插入当前画布

  已经在画布中时，从左侧“模板库”选择插入，才会把个人、团队或系统模板内容加入当前画布。

• 媒体独立

  首次保存时媒体固化为模板资产；同一租户的新模板版本可复用已经固化的不可变媒体，使用模板时仍复制到目标个人或 Workspace。实例不依赖作者源画布或个人媒体权限。

• 固定版本

  新版本只影响以后创建或插入的内容；已经创建或插入的内容始终使用原版本，不会自动变化。

保存模板与权限保护

保存工作流模板时同时固化元数据、版本资产和权限策略；秘密提示词只在后端真正请求模型时注入。

• 保存入口

  从 Group、选区或项目入口选择“保存工作流模板”，填写名称、分类、标签、简介和封面。团队画布可保存到我的模板或当前团队模板，分类与标签来自管理后台配置；封面仍在处理时会短暂自动重试，无需重复点击。

• 创建新版本

  从个人或团队模板卡片菜单进入“创建新版本”或“版本记录”；可以从当前或任意历史版本创建独立编辑画布。

• 发布编辑副本

  编辑完成后选择“保存新版本”或“保存并提交审核”。若别人已先发布新版本，系统会提示冲突，不会覆盖对方内容。

• 区分保存与审核错误

  媒体仍在处理时系统会短暂自动重试；媒体不存在、无权使用或处理失败会显示对应原因。若模板已经保存但提交审核失败，可直接重新提交审核，不必再次创建模板。

• 选择保护方式

  可以选择完全开放、固定结构或受保护运行，并逐节点设置显示、输入、提示词、模型选择和单独运行权限。

• 秘密提示词

  受保护提示词不会进入普通用户浏览器、缓存或最终 Prompt 面板；运行时由后端按固定模板版本注入。

• 模型配置

  作者可以只开放模型和公开线路选择，同时继续锁定提示词、结构、尺寸或其他参数。

• 空间模板与系统发布

  来源模板始终保留在个人或团队列表；从来源模板提交的系统更新作为独立候选审核，审核期间旧线上版本继续可用，驳回不影响旧版本，候选通过后才用于以后创建或插入。

只读分享、克隆与团队协作

分享链接只展示权威快照和压缩预览；Workspace 协作继续通过成员权限、实时文档和评论完成。

• 创建分享链接

  项目管理者可从项目卡片或画布顶部打开分享，复制稳定链接，也可以轮换或撤销；旧链接在轮换或撤销后立即失效。

• 匿名预览

  未登录访客可平移、缩放、适应视图并查看只读画布和压缩媒体，不能编辑、运行、保存或加入协作。

• 登录后克隆

  未登录时点击克隆先提示登录；登录后可把读取时的权威快照和媒体复制成自己名下的独立个人项目。

• 实时协作

  Workspace 共享文档通过 Collab/Yjs 同步；写权限随实时角色变化，Viewer 保持只读，评论对所有团队成员开放。

• 多画布页签

  应用内可同时打开多个画布并保留各自视口、选区和草稿；运行中的页签可返回、取消关闭或在当前网页后台继续。

• 跨窗口接管

  同一项目在第二窗口默认只读；接管前原窗口需保存并释放编辑权，新窗口随后读取最新 revision。

云保存、协作与本地数据

个人和 Workspace 画布以云端为准；浏览器缓存用于加快打开速度，“我的素材”原件则仍主要保存在本机。

• 云画布权威数据

  节点、连线、Group、稳定媒体引用和个人视口保存到云端。同一账号可从工作台重新打开。

• 刷新先读缓存

  只有 `canvas_cloud_cache` 按账号和画布隔离保存完整 bootstrap；重新进入先显示缓存，再按文档和个人状态 revision 只补变化部分。

• 其他本地数据

  其他 LocalForage 运行缓存、导入暂存和“我的素材”各有自己的存储范围，不是云画布权威副本，也不能统称为按画布隔离。

• 团队实时协作

  Workspace 共享文档通过 Collab/Yjs 同步。成员应确认当前空间、角色和界面连接状态；只读成员不能写入项目。

• 关闭运行画布

  关闭仍有任务的应用内页签时可选“返回画布”“停止后续并转后台”或“后台继续”；已提交请求会保留后台控制与正常结算，后台控制器只在当前网页仍打开时工作。

• 刷新后的恢复边界

  已经提交并建档的任务可按运行记录与请求记录恢复；尚未提交后端的纯本地步骤会中断。

我的素材、导入与导出

“我的素材”用于跨空间复用内容；项目导入、产出下载和 WebDAV 解决的是不同问题。

• 我的素材

  保存常用文本、图片和视频，可从创建中心或画布加入，再插回个人或团队画布。

• 本地原件边界

  素材列表按账号同步部分信息，但原件仍主要在当前浏览器；清理站点数据或换设备前先导出重要素材。

• 项目导入

  工作台仍支持导入合法 ZIP/LXF；完整项目 ZIP 与 LXF 导出入口当前关闭，不能把“保存产出”当作工程备份。

• 保存产出

  Group 工具栏只列出当前显示结果，画布工具栏仍可选择全局当前/历史结果，并按工作流目录或同一目录下载 ZIP。

• WebDAV

  用于手动同步部分浏览器本地数据和媒体文件，不包含平台代理保存的渠道密钥，也不替代 PostgreSQL 与对象存储备份。

• 删除与空间

  删除“我的素材”会移除账号素材记录，并在没有其他本地引用后回收当前浏览器 Blob；云画布历史结果移除引用但暂不立即删除云端原件，需由服务端安全回收机制处理。

任务中心、积分与请求记录

节点状态用于快速操作，任务中心用于跨页面跟踪，请求记录用于核对上游、结算、扣费和退款。

• Free 账户默认值

  新注册账户不赠送积分，但默认个人并发为 15；充值后仍为 Free 时也沿用该并发默认值。平台管理员可在系统设置分别调整 Free 与普通用户默认并发。

• 等待并发

  “等待”通常表示正在等当前计费账户的并发名额，尚未向上游发起生成和扣费；重复提交会形成额外任务。

• 任务中心

  顶部任务中心可以查看后台任务或返回对应画布；已提交的文本、图片和音频需确认成功仍扣费、失败才返还后停止等待，视频任务不提供取消。关闭浏览器后不能承诺纯前端任务继续运行。

• 非视频自动补提

  文本、图片或音频节点已发送至供应商且供应商明确返回失败时，符合条件的请求可在 120 秒窗口内自动补提一次。视频不补提；超时、断网等结果不确定的情况也不会创建第二次请求。

• 补提积分流水

  第一次失败必须先完成结算并全额返还，系统才会为第二次重新预扣，所以流水可能短暂显示“返还后再预扣”。第二次成功时最终只保留一次费用；两次都失败时全部返还，净扣费为 0。

• 正在收尾

  生成进度到 100% 后，任务可能短暂显示“正在收尾”，表示结果仍在同步和结算。只有这些步骤完成后才会标记“已完成”，此时不需要重复运行。

• 请求记录

  进入“账户 → 请求记录”查看请求 ID、状态、耗时、扣费、退款和脱敏错误摘要。

• 个人与企业钱包

  有效企业成员无论使用个人钱包还是管理员分配的企业额度，新请求都按同一企业价格计费；企业价格由有效成员身份决定。计费账户只决定扣款来源，并沿用对应账户的钱包、并发和模型权益，不搬运积分，也不会在余额不足时自动改用另一个账户。

• 以最终结算为准

  失败、停止等待或网络中断后由后台继续收口。积分有疑问时以请求记录和流水为准，不只看节点瞬时提示。

节点运行报错分类与处理

先按错误归因决定是修改请求、等待恢复还是联系管理员；不是所有失败都适合直接重试。

• 节点用途或工作流结构

  纯资源节点不能运行；循环依赖、缺少目标、失效连线或受保护结构会在提交前拒绝。改用同类型生成节点，修正连线或权限后再发起新运行。

• 参数或输入素材错误

  网页中按当前模型能力选择参数；Remote MCP 的视频参数使用 defaultValue/允许的 auto，图片使用目录 defaultSize/defaultQuality（当前为 auto/auto），必要时切换目录默认模型并告知实际值。损坏、未就绪或无权访问的素材仍需重新上传或选择。

• 内容安全拒绝

  提示词或参考素材触发审核时不会自动重试。删除违规或高风险内容、明确合法创作意图后再提交；不要通过改写编码绕过审核。

• 权限、模型或余额不足

  确认画布可写、模型对当前个人或企业账户开放且积分足够。切换计费账户只影响后续请求，不会自动替旧任务补款。

• 等待并发或频率限制

  等待表示尚未获得执行名额，重复点击只会增加任务。保留当前任务等待或停止后再运行；供应商限流时稍后按原请求恢复。

• 上游繁忙、模型不可用或 5xx

  这是供应商容量或线路问题。开启且符合条件时平台会换线；非视频节点在供应商明确失败、首次费用已全额返还后，还可自动补提一次。不要因一次失败连续创建多个新任务。

• 超时、断网或响应不确定

  先到任务中心和请求记录确认任务是否仍在运行、成功或已退款。状态未知时复用原请求 ID/幂等键恢复，确认终态后才决定是否新建任务。

• 结果保存或结算失败

  供应商可能已成功，但媒体保存、画布写回或结算仍在收尾。不要删除节点或重复生成；保留请求 ID等待后台恢复，持续失败再联系管理员。

• 求助时提供什么

  提供任务码或请求 ID、发生时间、节点类型、页面错误文案和是否已扣费。不要发送密码、Authorization、Cookie、API Key、兑换码或完整密钥截图。

其他常见使用疑问

这些问题不会通过反复刷新或重复运行解决，先确认画布、节点、空间和计费概念是否一致。

• 每次对话都会新建画布吗

  不会。NUV Studio 先列出并选择已有画布，只有明确说“新建画布”才创建；名称不存在或权限不足也不会自动创建替代画布。

• 如何在同一对话切换画布

  直接说“切换到……”；插件会重新 canvas_list 和 canvas_select。选择令牌只属于当前对话和当前画布，不能复制到另一对话。

• 资源节点为什么不能运行

  资源节点只提供文字或媒体输入，不调用模型。需要生成时创建同类型生成节点，再把资源节点连接为输入。

• 个人与 Workspace 有什么差别

  个人画布远程写入后重新读取或刷新页面可见；正在打开的 Workspace 画布通过协作连接实时同步。Viewer 只能读取，不能修改或生成。

• 估价就是最终扣费吗

  不是。估价用于执行前确认上限，最终扣费、退款和收尾状态以账户请求记录与积分流水为准。参数或价格变化后必须重新估价。

• 附件会经过 Codex 对话吗

  MCP 只传文件元数据、SHA-256 和分片控制信息；原始分片直接上传到短期对象存储地址，不把 Base64、签名 URL 或供应商密钥写进对话和画布快照。

• 需要安装 npm 或本地 Agent 吗

  普通远程模式不需要。Node.js、npm、Local URL 和连接 token 只用于开发、私有部署或旧环境兼容。

• 为什么不能远程运行整个 Group

  当前 Remote MCP 支持单节点 AI 生成和专用静态视频合成。Group/DAG 运行仍由网页和服务端协调器负责，避免出现第二套调度、重复供应商请求和重复扣费。

• 视频剪辑为什么不估价

  它只把已经存在的稳定图片、视频和音频素材交给 FFmpeg 合成为 MP4，不调用 AI 供应商、不运行上游生成节点，也不创建 AI 请求或扣积分。

推荐推广：邀请、返佣与结算

推荐返佣按直接推荐关系和被推荐人的有效现金充值计算。先确认入口是否开放，再分享链接、核对关系和查看月度结算。

1. 1

   确认当前是否开放

   登录主站后打开右上角账户菜单。看见“推荐返佣”才表示当前账号已开放；页面显示尚未开放时不能通过反复刷新或重新注册解决，请等待平台通知。

2. 2

   分享推荐链接

   进入“推荐返佣”，复制完整链接或让对方扫描二维码；只在对方已经注册但还符合补填条件时使用“复制推荐码”。

3. 3

   让新用户从链接开始注册

   对方应先打开你的完整推荐链接，再在同一浏览器完成注册。注册后双方都可以在推荐中心核对关系；不要让对方先完成现金充值再补填推荐码。

4. 4

   已有账号补填推荐码

   只有页面显示推荐码输入框、尚未绑定且尚未完成首次现金充值时才可补填。输入后点击“绑定”；推荐关系一经确认不能更换，也不能邀请自己。

5. 5

   核对绑定结果

   被推荐人页面会显示已绑定的脱敏推荐人和绑定日期；推荐人的统计会出现新的推荐关系。只看聊天截图或链接点击数不能证明绑定成功。

6. 6

   选择返佣方式

   在“返佣方式”选择算力或现金。页面显示当前方式和下月方式，变更从下一个自然月生效；现金付款批次未开放也不影响预约下月现金返佣。

7. 7

   理解返佣计算

   返佣按被推荐人在 NUV 直接完成的有效现金充值计算，不包含优惠、赠送、测试、补单、白牌或异常交易。页面展示的比例、积分换算和政策版本才是当期依据。

8. 8

   查看客户与流水

   在“推荐客户”查看脱敏客户和累计有效充值；在“返佣流水”核对充值、退款、拒付、比例和返佣数值。负向事件只追加扣回，不删除原流水。

9. 9

   查看月度结算

   在“月度结算”查看本期产生、扣回、净结算和状态。算力返佣在平台完成月结和入账后进入账户；处理中不要重复提交任何操作。

10. 10

    设置现金收款资料

    可以提前在“现金付款”设置支付宝或银行卡资料。准确填写持有人、账号和银行信息；页面之后只显示脱敏内容，资料待验证或付款批次未开放时都不能视为已可付款。

11. 11

    遇到异常先记录证据

    保存推荐码、双方脱敏账号、绑定时间、流水或结算月份和页面错误文案，再联系平台客服。不要发送密码、验证码、完整银行卡号或登录令牌。

平台代理：开通与日常运营

代理站使用独立域名和独立管理入口。平台负责开通、品牌、模型与路线，代理人员只管理本代理用户、零售余额、模型售价和脱敏请求记录。

1. 1

   先确认自己的身份

   平台管理员在主站 `/admin` 配置所有代理；代理负责人、管理员和运营专员必须在分配的代理域名进入 `/manage`；终端用户只使用代理站创作页面。三类入口不能混用。

2. 2

   平台创建代理

   平台管理员进入“平台代理”，点击“创建平台代理”，填写名称和标识后保存。新代理先用于补齐配置，不向终端用户发布注册地址。

3. 3

   平台完成全部配置

   补齐并验证域名和品牌，配置 Owner、六位管理验证码、运营主体和客服、三份法律文档、功能策略、可售模型与价格，再审核预存并确认批发钱包已入账。商业生命周期不是运营人员需要逐级点击的配置项。

4. 4

   平台设置代理可售范围

   进入“代理定价”，选择代理商后，按逻辑模型、路线和规格开放销售。代理商只负责上下架和填写用户售价，物理渠道与运行配置仍由主站统一管理。

5. 5

   检查后投入运营

   “上线检查”全部通过后，点击“投入运营”。服务端会重新检查并一次设置正式运营和正常服务；失败会列出尚未完成项，不会只改一半，也不要求运营人员手动维护申请、审核、签约、入款和试运营状态。

6. 6

   代理人员从正确域名登录

   打开平台分配的代理域名并登录自己的代理管理账号，再进入“代理运营后台”。主站账号、其他代理账号或错误域名的登录状态不能跨站使用。

7. 7

   完成管理验证

   进入 `/manage` 时输入平台提供的六位管理验证码。它不是短信验证码，也不是 TOTP 密钥；验证码更换或疑似泄露时由平台主管轮换，代理人员不能自行查看旧码。

8. 8

   按角色操作

   Owner 可管理用户、调整零售余额、修改模型售价和导出；Admin 可管理用户与模型售价，但不能调余额或导出；Operator 主要查看用户和请求，可发送一次性密码重置，不能调余额或修改售价。

9. 9

   管理终端用户

   进入“用户”搜索或创建用户，打开详情后可启停账号、发送一次性密码重置并查看零售流水。只有 Owner 可以填写调整数值和原因后修改零售余额。

10. 10

    设置模型售价

    进入“模型售价”，按逻辑模型、路线和规格选择上架状态，直接填写用户售价后保存。新售价只影响之后的新请求；需要增加可售模型、路线或规格时联系平台主管。

11. 11

    查看请求和导出

    “请求记录”只显示公开模型、状态、用量和零售扣费，不显示用户 Prompt、媒体、生成结果、物理路线、供应商密钥或平台批发成本。只有 Owner 完成近期验证后可在概览导出脱敏摘要。

12. 12

    知道何时联系平台

    域名、品牌、管理成员、管理验证码、法律文件、功能策略、可用模型、主站路线、批发余额和服务状态都由平台主管处理。发现跨代理数据、单边扣费、无法退款或管理码泄露时应立即停止相关操作并升级处理。

管理员与企业账户

普通创作者可以跳过本节；这些入口负责平台运维、模型发布和企业计费。

• 企业账户

  企业管理员邀请成员、分配企业积分与并发并查看企业流水；它不等同于 Workspace 项目协作。

• 管理后台

  平台管理员管理用户、企业、渠道、逻辑模型、价格、模板审核、请求记录、审计、公告和 SMTP。模板审核默认打开只读画布预览，可平移、缩放和适应视口，再切换审核配置；预览不能编辑、运行或查看秘密 Prompt。已发布模板需要修改时先由来源模板提交候选，不要在没有待审候选时直接保存策略。

• 物理视频协议

  先在“API 渠道”中为每个视频渠道模型明确选择实际执行协议。系统不会根据模型名自动猜测；同一渠道里的不同物理模型也可以使用不同的视频适配器。

• 生图模型配置

  在“生图模型”中新增一条渠道路线后，只选择一次物理模型，再勾选开放的 1K、2K、4K，并分别填写每张积分、账户权限、优先级和备用状态。

• 视频模型配置

  新建视频逻辑模型使用简化配置：每条路线可选择不同协议的物理模型，直接多选支持的生成类型、清晰度、比例和时长，并按清晰度分别设置每秒积分。前台参数会随当前模型、线路和库存组合联动。

• 旧视频模型升级

  已有视频模型继续按旧版逻辑模型级协议和 Schema 运行，不会自动改写。为其所有物理路线补齐协议后，编辑页才允许显式升级到简化配置；升级只在保存后生效。

• 公告中心

  首页首次遇到未读版本会展示公告弹窗；顶部公告入口可再次查看通知正文和系统公告时间线，今日关闭只暂停当天自动弹出。

• 安全提醒

  API Key、SMTP 密码和其他密钥不要写进画布、提示词或聊天记录。