AI Canvas 操作说明书
从首次生成到完整创作

00 · 界面位置图

下面保留此前桌面应用的真实截图，用于辨认主要区域；近期入口变化按对应章节核对。画布中的媒体是位置演示素材，不是安装后自动提供的内容。

123456

1. 1项目区域：当前画布名称、新建画布及项目切换。
2. 2添加与素材：添加节点、项目、资产、角色等入口。
3. 3助手与设置：打开 AI 助手；齿轮菜单内有设置、帮助、关于。
4. 4节点工作区：每个节点承载内容、参考素材或生成结果。
5. 5画布笔记：矩形、箭头、自由绘制、文字与图片笔记。
6. 6视图控制：小地图、缩放比例、网格和连线样式。

应用设置从哪里找

1234

01 · 创作前先配好项目设置

开始做一组图片、短片或分集前，先给当前项目确定画风、通用要求和常用模型。后续创建节点和生成内容时，就能沿用这些设置。第一次试用也可以保留默认值，等模型配置好后再补充。

1.1 · 打开入口与作用范围

1. 在左上角新建或切换到要制作的画布。点击顶部当前画布名称右侧的滑杆图标，打开“项目设置”。
2. 先核对面板标题下的项目名称；下面所有设置针对这个项目。正在编辑分集时，针对当前这一集。
3. 面板内部可以向下滚动。截图下方还有视频、音频、视觉理解、Agent 自动选模型以及“输出默认”，不要只看首屏。
4. 修改后点击底部保存，出现“项目设置已保存”后再关闭或切换项目。可重新打开一次，核对已保存的值。

每个项目、每一集都可以有自己的设置。新增分集会带入剧集当时的设置，之后独立保存；修改当前集，不会同步改掉其他分集。需要全剧统一时，应逐集核对，而不是只改其中一集。

1.2 · 整体画风（文字预设）与锁定

1. 点击选择画风，选用写实摄影、动漫、水彩、电影质感等预设，也可在画风选择器中添加自己的预设。
2. 希望各镜头统一使用这一文字画风时，开启旁边的锁定；必须先选中画风，锁定开关才可用。
3. 需要某个节点采用不同画风时，回到这里解除锁定并保存，再到该节点选择画风。

这是给模型的文字风格要求。锁定只管理画风选择，不会锁住节点内容、模型、尺寸或提示词编辑，也不能保证所有模型生成完全一致的风格。

修改已经保存的自定义画风

在节点的画风选择器中找到自定义画风，点击该项的编辑图标，可修改名称、提示词和缩略图后保存。后续使用前重新核对画风内容；修改预设不会重新生成已有图片。内置画风与自己的画风分别管理，只有提供编辑入口的自定义项可修改。

1.3 · 风格母图：自动提供视觉参考

1. 点击上传风格母图，选择希望作品参考的图片，例如卡通、电影画面或已确认的风格样片。支持 PNG、JPG/JPEG、WebP、GIF、BMP。
2. 上传后检查缩略图与文件名，保持启用开关打开，再点击保存。
3. 在当前项目中继续生图。软件会把母图放在图像参考输入的第一位，再加入节点里的角色、场景等内容参考，不必每次手动 @ 母图。
4. 临时不用时关闭“启用”；换样片时点击更换；不再使用时点击清除，然后保存。清除解除母图设置，不等于删除已上传的素材文件。

母图用于传递画风、色彩、材质和光影，角色身份、具体场景和构图仍应通过内容参考图与提示词说明。文字画风和风格母图可以同时使用，建议选成一致的方向。

1.4 · 项目提示词后缀：按类型填写通用要求

点击文本 / 图像 / 视频 / 音频标签，分别填写该类节点长期共用的要求。四个标签各存一份内容，每类最多 2000 个字符；切换标签是切换编辑对象，最后统一点击“保存”。

在接入项目设置的节点生成中，最终要求会组合为：本次提示词 → 适用的画风文字 → 对应类型后缀。这些内容在生成时加入，不一定直接显示在节点提示词编辑框里。图像后缀也用于归到图像类别的动画与全景；助手调用媒体生成时沿用对应后缀，普通聊天不会因此自动追加“文本”后缀。

后缀适合放跨镜头的固定要求，每一镜的动作、场景与台词仍写在节点中。它是提示文字，不能替代比例、分辨率、时长或音色等真实参数；个别工作流或专用入口是否采用这些内容，应先验证一次。

1.5 · 默认模型、视觉理解与 Agent 选模型

在“默认模型”里分别选择文本、图像、视频和音频模型。保留跟随应用默认表示不为本项目指定独立默认值；下拉里找不到目标模型时，先在 API Key 设置中添加并启用，再回到这里选择。工作流不在这组项目默认模型菜单中，仍在节点模型选择器里选择。

1.6 · 输出默认：图片与视频的常用参数

向下滚动到输出默认。图片、视频各有独立开关；关闭时显示跟随节点，开启后可编辑项目偏好。

这些值用于新建节点的初始化和部分助手生成的默认参数，不会批量重设已有节点，也不会改变已生成文件。当前模型支持哪些值，应以节点参数选项与接口要求为准。

1.7 · 保存后怎样检查

1. 点击保存，确认“项目设置已保存”；若提示保存失败，先处理失败原因再继续。
2. 重新打开项目设置，检查画风、母图启用状态、四类后缀及模型是否保留。
3. 创建一个新的图像节点，检查默认模型、画风与输出参数；用一条小任务验证后缀和母图效果，确认后再批量制作。
4. 切换项目或分集后重新核对设置，尤其是复制项目、追加分集或使用已有节点时。

底部取消、右上角关闭、点击面板外或按 Esc 都不会提交这次项目设置草稿。上传文件和在画风选择器里新建预设是独立操作，取消项目设置不等于撤销这些操作。

02 · 先跑通一次生成

初次使用，先在启动页新建或打开项目，再完成一张图片。已经打开画布并配好厂商和模型的用户，可以从第 3 步开始。

1. 点击左侧底部齿轮 → 设置 → API Key。添加已开通的厂商，填好 API Key，勾选要使用的模型并保存。使用自己的中转服务或专用接口时，阅读第 06 章。
2. 回到画布，在左上角新建一个画布，或进入项目库选择已有项目。开始制作前，按第 01 章检查项目画风、后缀与默认模型。
3. 点击左侧添加节点 → 生成图像；也可以在未输入文字时按 2。
4. 选中节点，按 Space 打开完整编辑面板。填写提示词，例如：一只坐在窗边的小猫，清晨柔和自然光，干净背景，水彩插画。
5. 选择已配置的图像模型，按模型可用选项设置比例或尺寸。第一次可以不加参考图。
6. 确认后点击生成。这一步会真实调用模型，可能产生服务商费用。完成后查看节点结果和输出历史，再决定是否重新生成或接到视频节点。

03 · 启动页、项目、剧本与分集

从原著或全剧剧本出发，先确定每集讲什么，再写成本集正文，最后进入分镜和画布制作。剧集栏负责资料与分集管理，剧本创作工作台负责逐集写作。

3.0 · 启动页：选项目，或先看最近使用的素材

默认启动视图是项目列表。先选项目再进入画布，也可在启动页下方的资源库 → 最近使用查看近期素材。想直接恢复上次工作时，在设置 → 常规 → 启动时打开选择上次画布；已有设置以实际选项为准。

1. 用搜索项目按名称查找，按最近更新 / 创建时间 / 项目名称排序；点击新建建立项目，或点击已有卡片打开。
2. 查看“最近使用”中的素材。点击图片打开图片与生成信息，点击视频打开播放器；其他类型可进入资源库查看。
3. 点击进入资源库打开整页浏览；没有最近记录时，也可点浏览资源库或已登记的文件夹入口。
4. 需要把素材放进画布时，先打开目标项目，再从资产侧栏或资产管理面板拖入。整页资源库适合集中浏览文件。

最近使用按素材的预览或成功拖入画布等使用行为记录，不是磁盘修改时间排行榜。列表为空时仍可进入资源库，不能据此判断文件丢失。资源卡片也支持右键文件操作。

返回启动页后的项目预览

返回启动页时，项目卡片按离开时可见的画布范围重新生成缩略图，媒体和正文预览可能稍后更新。缩略图是有界概览，不是整张画布的完整截图；素材无法读取或预览生成失败时保留旧图。项目正文保存与封面生成分别处理，不能只用封面判断正文是否已保存。

新建、切换与整理项目

1. 打开左上角画布 / 项目入口，进入项目库。新建画布后，为它起一个容易辨认的名字，例如“短片 · 第一次测试”。
2. 在项目库点击卡片进入项目；最近打开的项目可通过顶部标签快速切换。
3. 项目卡片菜单可重命名、复制、导出项目包或删除。需要试不同方案时，先复制项目再继续编辑。
4. 点击当前项目名称右侧的设置图标，按第 01 章确认画风、母图、后缀及默认模型。

点击左上角返回启动页会先保存当前项目；保存失败时保留画布，处理提示后再重试。项目预览图可稍后更新，不作为正文保存成功的依据；关闭应用后重开，预览可能仍是上一张，应以实际画布内容为准。

首次进入画布：跟随入口引导

首次打开画布时，入口引导依次指出项目设置、操作记录、剧集与分集、文件保存位置。点击下一步继续，或跳过结束；最后一步可进入设置自行选择保存位置，不会自动更改文件目录。需要重新查看时，在画布中打开侧边栏头像菜单的帮助 → 入口引导；更多操作技巧可查看手势和快捷键。

3.1 · 准备原著或全剧剧本

单击窗口右侧中部的细竖条展开剧集栏。剧集栏管理整部剧共用的原著、全剧剧本和分集；进入工作台后，再分别编写每一集的大纲与正文。

1. 已有小说或原文：点击“原著”右侧上传按钮，选择 .txt / .md 文件。原著需要保存到项目素材目录，使用桌面版添加。添加后检查显示的文件名。
2. 已有完整剧本：点击“剧本”下方的未填写，点击编辑或铅笔图标，粘贴全剧内容，点击弹窗底部保存。
3. 原著与全剧剧本可以同时保留。后面进行 AI 拆分时，明确选择本次使用哪一种素材。
4. 需要更换原著时使用更换按钮；移除引用（不删文件）只解除当前登记，项目目录里的原稿仍保留。

3.2 · 按章节浏览原著，并交给助手分析

1. 在剧集栏的“原著”旁点击章节浏览；也可从剧本创作工作台 → 章节浏览进入。剧集栏入口需先添加原著；只有全剧剧本时可从工作台进入。
2. 在素材来源切换“原著 / 全剧剧本”，从左侧目录选择章节。软件可识别常见中文章节、英文 Chapter / Part 和 Markdown 标题；没有标题时按“全文”阅读。
3. 在搜索章节或正文输入关键词，点击匹配章节定位相关段落。正文较长时使用上一段 / 下一段续读；左侧的更多章节展开剩余目录。
4. 点击让助手分析本章，回到对话输入框，补充需要分析的人物、情节或改编目标，检查文本模型后发送。这个按钮只准备草稿，尚未调用模型。
5. 更换原著或修改全剧剧本后，点击重新读取，重新选择章节。若助手提示材料版本已变化，也应重新准备章节引用。

从工作台交给助手前，会先保存本集未保存的编辑，保存失败则留在当前操作。章节浏览读取的是整部剧的原著或全剧剧本，不会自动写入本集正文，也不会自动创建分集。

3.3 · 手动建立和管理分集

想自己决定每集内容时，点击剧集栏中的转为剧集并新增分集或新增分集。前一个按钮会先保留原画布为第 1 集，再额外新增一集空白画布；已经因添加原著或保存剧本而有了第 1 集时，可以直接编辑它，不必再为“第一集”多建一次。

点击分集名称切换画布；点击行内的修改分集名称铅笔按钮可改名，剧本创作工作台的分集列表也有同一入口。改名不切换当前分集，也不丢弃正在编辑的剧本文字；鼠标移到分集行可看到上移、下移和删除入口。删除按钮需要再次点击确认，应先核对集名。每集分别创作，素材、角色、原著和全剧剧本按剧集共享；删除单集不删除整部剧共用的素材目录。

从顶部加号或剧集栏新增分集时，先在弹窗填写分集名称，默认提供“第 N 集”，点击创建分集后才会创建；取消或关闭不会新增分集。名称为空时不能提交，保存失败时保留弹窗以便重试。

3.4 · 让 AI 先生成分集草案

1. 点击剧集栏的生成 AI 拆分草案，或进入剧本创作工作台后点击右上角AI 拆分草案。
2. 在拆分素材中选择全剧剧本或原著。所选素材未添加时，“在对话中生成预览”按钮不可用，需要先回到剧集栏准备资料。
3. 填写目标总集数和单集秒数。初始值为 24 集、每集 90 秒；允许范围分别为 1–100 集、15–600 秒。按作品需要修改，不必使用默认值。
4. 点击在对话中生成预览。这一步只把请求放进对话输入框，不会自动发送。关闭工作台，回到 AI 助手，选择已配置的对话文本模型，核对请求后发送；实际模型调用可能计费。
5. 检查 AI 给出的逐集标题、本集任务、核心冲突、3–5 个情节点、开场钩子、反转或情绪爆点、结尾卡点，以及原著来源范围。还应检查它列出的遗漏和重复剧情。
6. 不满意时，继续在对话中要求调整节奏、集数或事件分配。确认后，明确指出哪些草案需要创建，并要求先核对已有分集，避免重复。
7. 创建分集需要可写模式。规划模式可看草案，但不能创建；协作模式会对创建操作请求确认，自主模式按已授权任务执行。完成后返回剧集栏，检查新增的分集名称和大纲。

拆分创建会得到新的空白分集画布，并写入对应的本集大纲。完整剧本正文和结构化创作要点还需要逐集编写；看到“已创建分集”不代表这些内容已经全部完成。

先核对当前已有分集，列出这次需要新增的分集清单，避免重复。
只按我确认的清单新增分集并写入对应大纲，保留已有分集。
本轮先不生成完整剧本正文，也不调用图片、视频或音频模型。

3.5 · 在剧本创作工作台逐集编辑

1. 点击打开剧本创作工作台，在左侧选择要写的分集，先核对顶部显示的剧集和集名。
2. 在本集大纲写清这集要推进的事件、主要冲突和结尾。已由 AI 拆分创建的分集，可以从已写入的大纲继续调整。
3. 切到创作要点，补充下表中的字段，尤其是本集任务、主要情节点和目标时长。
4. 切到本集剧本，手动输入完整正文，或使用右侧的根据集纲写正文准备 AI 写作请求。
5. 编辑后点击底部保存本集，或在工作台内按 Ctrl + S；底部显示已保存后再切换到下一集。

本集任务、核心冲突、开场钩子、反转、结尾卡点和主要情节点旁有 AI 生成 / AI 润色：字段为空时显示生成，已有内容时显示润色。点击后会准备该字段的对话请求，通常给出三个候选；选择后只回填确认的字段，也可以手动复制到相应输入框并保存。来源范围和目标时长直接手动填写。

3.6 · 从全剧剧本提取人物、场景和道具

在剧集栏 → 剧本填写并保存完整的全剧剧本，再打开剧本创作工作台。右侧的全剧资产提取提供提取人物、提取场景、提取道具三个按钮；全剧剧本为空时按钮不可用。这里读取的是整部剧共用的剧本，不是当前分集的正文，也不是原著文件。

1. 确认当前项目已配置可用的文本模型，并检查全剧剧本内容已经保存。
2. 按需要分别点击提取人物、提取场景或提取道具。每次点击都会调用文本模型分析全剧剧本；请等待结果提示，模型调用可能计费。
3. 成功后，提示会显示本次提取的数量，结果自动合并到剧集共享的创作资产库。打开左侧的创作资产核对人物、场景和道具；人物还可继续在角色库补充形象图、声音等资料。
4. 提取结果仍需人工审阅：检查重名、重复条目、描述是否准确，并按实际制作需要补充或修订。需要更新时，先保存新的全剧剧本，再重新提取。

3.7 · 右侧 AI 写作按钮怎样使用

这些按钮共用同一套流程：选择分集 → 点击创作按钮 → 回到对话核对并发送 → 审阅草案 → 确认写回或手动粘贴 → 检查保存结果。点击创作按钮时，工作台会先尝试保存当前未保存的编辑；保存失败则不继续准备请求。工作台仍挡住对话时，先关闭工作台再查看输入框。

3.8 · 看懂创作诊断

右侧顶部的正文、场景、对白占比、预计时长和简短提示，会根据当前编辑内容做本地静态分析，不调用 AI。下方深度创作诊断则准备一条需要发送给模型的创作请求，两者的用途不同。

“仅提示，不阻断”表示这些提示不会阻止保存。没有发现静态格式问题，也不代表人物动机、剧情逻辑和情绪强度已经合格，仍需审稿。

1-1 旧书店 内 日
人物：林晚、店主
林晚把一封信放在柜台上。店主伸出的手停在半空。
林晚：这封信上的字，是你写的吗？
店主：谁让你找到这里的？
门外传来敲击声。林晚回头，信封里滑出一张旧照片。

3.9 · 保存、切集与排错

工作台里的大纲、正文和创作要点有独立的编辑草稿。底部显示有未保存修改时，使用保存本集或工作台内的 Ctrl + S 保存；不要仅凭画布有自动保存功能就直接退出。

有未保存内容时关闭工作台或在左侧切换分集，会提示当前修改还没有保存，要先保存吗？。选择继续编辑留在当前集；保存并继续保存后切换或关闭；放弃修改会丢弃本次未保存的编辑。剧集栏中的全剧“剧本”编辑弹窗使用自己的保存按钮，也应保存后再关闭。

3.10 · 从本集剧本进入分镜制作

确认本集正文后，点击工作台的生成本集分镜。软件会先保存当前编辑，再在该集画布创建一份剧本来源快照和空分镜表，并打开生成弹窗。检查文本模型、正文引用与目标时长，再点击生成；创建表格本身不调用模型。

后续的镜头编辑、补图、改稿复核、配音/视频节点及时间轴操作见第 16 章。人物、场景、道具与角色动作库见第 14 章。修改剧本后请复核已有分镜；再次“生成本集分镜”会新建制作内容，不会自动同步旧表。

04 · 画布、节点与连线

节点重命名：使用共用标题栏的节点可双击名称、在右键菜单选重命名，或选中单个节点按 F2，进入同一个标题编辑框并全选名称。按 Enter 或移开焦点保存，按 Esc 取消；设置中隐藏标题时，右键或 F2 会临时显示编辑框，结束后恢复隐藏。

两种画布交互方式

在设置 → 常规切换交互方式：Figma 模式用右键或中键拖动画布、滚轮缩放；经典模式用左键拖动画布、Ctrl + 滚轮缩放。刚切换模式时，先在空白处试一下拖动与缩放。

AI 应用节点只能由内部 Agent / MCP 创建，不能通过菜单、快捷键、复制粘贴或拖拽复制建立副本；选区或分组中含有 AI 应用时，整次复制也会被阻止。已有应用仍可移动、打开、使用和删除。

小地图统计、缩放与大画布浏览

按 M 显示小地图。点击小地图任意位置，画布会以当前倍率居中到对应位置。小地图位于缩放工具栏上方，右边缘与工具栏对齐；把鼠标移到小地图上，可查看各类型节点数量和总数。统计跟随当前画布中实际展示的节点；被收纳隐藏的节点不计入，不等于磁盘素材文件数。

Figma 模式下普通鼠标滚轮直接缩放，macOS 普通鼠标也使用这一方式；触摸板保留双指平移与捏合。经典模式使用滚轮平移、Ctrl + 滚轮缩放。光标位于输入框、列表或弹窗时，先移回画布空白区域再操作。

缩到远景时，部分图片和视频节点会暂时只显示预览与连接点；停止缩放或平移后，软件逐步恢复细节。选中、编辑、播放、生成中或报错的节点会优先保留完整界面。此过程不删除节点、不压缩原始素材，也不产生新的撤销记录；检查清晰度时请打开全屏原图。

最近项目与画布操作记录

将鼠标移到窗口顶部中央的短横线，展开最近打开的项目栏；点击项目标签切换。剧集会归到整部剧的标签，当前分集的创作设置仍在项目设置中单独保存。

将鼠标移到画布右上方的短竖线，或用键盘聚焦入口，展开操作记录。可查看结构操作、撤销和还原；点击图钉可固定显示，再用展开 / 收起按钮控制列表。助手在主窗口展开时，入口会向左让出空间。

05 · 文本、图像、视频与音频

不同模型展示的参数不同。某个模型没有显示的能力，不能仅靠在提示词里写“8K”“60 帧”就当作已配置。更换模型后，重新检查参数和参考素材。

参考图、批量生成与输出历史

参考图可以来自上传、画布上的已有图片或角色库。添加后检查缩略图是否正确。普通图像模型支持批量且未选择工作流时，长按生成按钮可选择 2–8 张；不满足这些条件时，以当前按钮提供的选项为准。

同一节点可以多次生成，使用输出历史比较结果。实际失败或超时时，先检查服务端任务状态与输出历史，再决定是否重新提交，避免重复计费。

图片与视频生成时显示已等待时长，表示已经等待多久，不是预计完成时间。macOS 中仅选中视频节点时保持封面，需要播放时再加载；媒体预览超出资源预算时显示占位，可减少同时播放或展开的大图后再试。

图片节点：PNG / JPEG 无损压缩

1. 在桌面端选择已有图片的图像节点，在浮动工具栏或更多菜单中点击无损压缩。
2. 确认源文件为 PNG 或 JPEG。应用读取原图并进行无损压缩，不用缩略图代替原文件。
3. 只有文件体积确实减小时，才保存独立文件并在画布新增压缩副本；原图及原节点保持不变。根据完成提示核对节省比例与新节点。
4. 没有体积收益时不会创建副本；格式不支持、读取或保存失败时，先处理提示，原图仍保留。

该工具仅支持桌面端的 PNG / JPEG，源图上限为 32 MiB、2400 万像素及单边 16384 像素。不支持的格式不会自动改成有损压缩；它也不等同于上传参考图时的素材准备。

图片质量、透明背景与比例

1. 在图像节点或提示词窗口打开参数入口，分别核对分辨率、质量、背景和比例。选项按当前厂商的准确型号提供，同名模型在不同渠道的档位可能不同。
2. 需要透明图时，选择支持该能力的型号，将背景设为透明。接口默认表示省略背景参数；自动是服务商明确提供的另一选项，两者不同。
3. 切换模型后，用户选择的比例与节点尺寸会保留；重新检查新型号能否接受该组合。不支持的质量或背景应先改为合法值，再提交。
4. 生成后检查实际透明区域及保存文件。透明结果沿用原始图片保存；若接口要求输出格式，透明背景只使用该渠道支持的 PNG / WebP，不能与显式 JPEG 配置共存。

自定义连接在图片参数能力中明确声明质量、背景及所需默认值；未声明时不会自动发送。调用协议分别映射 {{imageQuality}} 和 {{imageBackground}}，不要把质量写成分辨率。GPT Image 2.5 官方与 APIMart 快速模板包含已确认的背景合同；未知 JSON 中转需按自身文档补能力，GPT Image 2 不自动获得背景能力。

切换视频模型，保留兼容参数

1. 在视频提示词窗口打开参数入口，明确选择所需的比例、分辨率、帧率、时长及音轨，再切换视频型号。
2. 用户已选的比例不会随型号默认值自动改变；兼容的其他参数继续保留，不先整组清空；未设置的字段按当前入口原有的模型或接口默认规则处理。
3. 核对新型号和当前输入模式的支持范围。不支持的参数按面板和错误提示调整；明确不支持生成音轨的型号会清除旧的“有声”要求，能力未声明不等于明确不支持。
4. 生成前确认参考图、首尾帧及音视频的组合。某些首尾帧接口按输入素材决定实际画面比例；RunningHub 标准模型和云工作流使用各自的专属参数，不能用普通视频参数代替其必填项。

时长选项的选中颜色与样式沿用参数控件的主题，与分辨率等选项保持一致。修改参数只影响后续生成，不改变已有成片；已有视频继续按真实媒体尺寸预览。

直接引用视频和音频文件

1. 先在资源库关联素材目录，确认目标视频或音频文件可访问；不必为引用额外创建一个画布素材节点。
2. 在视频生成节点的提示词中通过 @ 选择对应文件资产。检查插入的胶囊与文件名，必要时打开预览，确认不是同名的其他素材。
3. 选择支持相应参考视频或参考音频的模型或工作流，再核对素材数量、格式和时长限制。生成时视频与音频作为独立参考媒体传入；不支持这类素材的模型不会因此获得新能力。

文件引用依赖原文件及目录授权，重命名、移动或删除素材后应重新核对。用于生成的提示词素材与自定义接口真实试跑的公网素材地址是两条入口；不能把本地文件路径直接填成厂商可访问的试跑 URL。

异步图片、视频与音频：续查原任务

异步生成已收到远端任务 ID 后，断网、查询超时或结果下载 / 保存失败会保留原任务。只有文件保存和节点回填都成功后，才清理相应恢复记录。上游明确失败与暂时查询失败分别处理；未拿到 ID 的中断提交显示状态未知，先到平台核对。

1. 看到暂停或交付失败时，先恢复原服务的网络、连接配置和磁盘空间，核对项目及任务身份。
2. 在原节点或提示词窗口使用重试或继续查询 / 保存，取回同一个任务的产物；此操作不会重新提交生成。成功后检查文件与节点是否都可预览。
3. 需要再次生成时，先核对旧结果。应用会把尚未交付的旧任务保留到独立恢复节点，再提交新任务；再次生成是新的调用，可能再次计费。
4. 重启应用或返回原项目后，已有恢复任务等待用户续查，不自动重投。批量任务也不会按缺少的结果数量擅自补发生成。

这套恢复要求渠道提供可查询的真实任务身份，不把同步调用或未知提交当作可续查任务。ComfyUI 显示 100% 后仍可能编码、下载和保存；工作流排错见13.9，本地文件播放问题见播放排错。

最近新增的内置媒体模型

在设置 → API Key打开相应厂商连接，勾选需要使用的模型并保存，再回到媒体节点选择。新模型不一定自动启用；不同平台的同名模型也可能具有不同参数。

旧的 APIMart Omni-Flash-Ext 节点保留兼容处理；新建任务请在当前目录中选对应型号。APIMart 连接验证成功时可附带显示账户余额；余额查询失败不一定表示模型连接失败，也不表示本次生成免费。模型费用以服务商实际结算为准。

按分镜组织成片时，可直接用分镜表的推送时间轴，同时装配对白字幕和已就绪配音，再按下方流程精剪。

即梦 OAuth：启用普通 Seedance 2.5 与 Mini

1. 打开设置 → API Key → 即梦，编辑已有 OAuth 连接，在模型列表切到视频分类。
2. 搜索并勾选普通 Seedance 2.5（seedance2.5）或 Seedance 2.0 Mini（seedance2.0mini），保存连接后在视频节点选择。
3. 重新登录只更新账号状态，不会替你启用新型号；旧连接也应在设置候选中核对勾选及视频分类显示。

样片模式与样片转高清尚未接入。普通 480p 生成不等于样片模式；不要用网页名称猜模型 ID 或请求参数。实际生成仍受即梦账号权限、CLI 与该型号限制约束。

把素材剪成视频

1. 选中有素材的视频节点，右键选择编辑视频；多选视频与图片后可选择编辑视频（N 个素材）。这个右键入口要求选择中至少包含一个视频。
2. 在独立剪辑窗口点击添加素材加号，从素材库、本机文件或画布图片节点添加内容。
3. 拖动时间轴片段调整顺序，拖动入点和出点裁切。把播放头放到需要切开的位置，点击分割或按 S；Space 播放 / 暂停。
4. 按需要添加叠加轨、音频轨，在右侧属性 / 文字 / 转场中调整画面、文字和衔接。
5. 右上角导出到本地保存 MP4；导出为新节点把成片回填画布；导出当前帧可回填图片节点。

在属性 → 导出查看当前使用“无损直通”还是“合成（重编码）”。混合分辨率、编码或使用叠加等处理时会走合成；尺寸和帧率按界面可用项选择，实际支持取决于本机编解码能力。

按节点编号连续查看图片

1. 打开一个有图片的图像节点的全屏预览。
2. 用两侧切换按钮，或 ↑ / ↓（也支持 ← / →），按当前项目的节点展示编号顺序浏览。
3. 空图片节点和已收纳到角色库的隐藏节点会跳过；到第一张或最后一张时不循环。切换图片会复位缩放，不改变画布当前选择。
4. 按 Esc 退出。切换项目或当前图片节点消失时，预览也会退出。

音频试听与全屏音乐播放器

有音频的节点，在尚未选中时单击先选中；已选中后单击音频展示区播放或暂停。双击音频展示区可打开占满应用窗口的音乐播放器，生成音频和源音频均可使用。

1. 点击播放 / 暂停，拖动进度条定位，按需要调整音量或静音。
2. 使用上一曲 / 下一曲，或方向键，按当前项目节点展示编号的数值顺序切换。空音频节点和已收纳隐藏的角色库节点会跳过，首尾不循环。
3. 播放结束会顺序进入下一曲，最后一曲结束后停止。打开全屏会暂停节点内播放并接续当前位置，避免重复出声。
4. 按 Esc 或关闭按钮退出；退出会停止全屏播放。切换项目也会关闭预览。

播放时的频率曲线来自实际音频信号。部分音源不能进行频谱分析时，会提示此音频暂不支持频谱分析，仍可正常播放；这与音频本身播放失败分别处理。频谱仅用于观察，不是降噪、修音或音色质量评分。

固定输出历史，连续定位结果

打开输出历史，启用顶部的固定面板。面板会缩成右下角常驻小窗，点击记录可定位对应节点并看到短暂的聚焦动效，面板保持打开，画布仍可操作。需要搜索、导出或清空历史时，先取消固定回到完整面板。固定状态下按 Esc 只折叠面板主体，也可用标题栏折叠按钮展开；固定选择随设置保存。这里的输出记录与画布撤销/重做的操作记录分别管理。

火山方舟：预计费用与本地用量记录

桌面版中，实际通过火山方舟连接执行的图片、视频节点可显示费用预估。点击节点模型选择器旁的预计金额 / 待估价，或在设置 → API Key → 火山方舟连接点击用量记录，打开同一份本地账本。

1. 先检查项目、模型类型、状态、模型 ID 和日期筛选。默认查看当前项目、本月记录；查不到旧记录时先调整范围。
2. 查看列表的预计与核算金额，打开详情核对提交参数、返回用量和价格快照。未知金额会显示待核对，不应当作免费。
3. 需要留档时点击导出 Excel。默认脱敏；只有确实需要分享完整内容时，才勾选导出完整提示词并核对接收对象。
4. 需要清理时切到清理记录，先核对筛选范围与数量、导出备份，再按界面要求输入确认文字。只清理已结束的本地记录，运行中和待核对任务保留。

账本独立于项目包。需要更换存放位置时，在用量窗口点击更换目录，成功后再核对记录；原账本保留，目标目录已有同名账本时拒绝覆盖。清理本地记录不会删除媒体或云端账单。最终扣费以方舟官方账单为准。

06 · 自定义接口：先添加厂商与模型

先准备四项资料：服务基础地址、API Key、准确模型 ID，以及该模型的请求与响应文档。这些通常由你购买服务或部署网关的平台提供。

1. 打开齿轮 → 设置 → API Key → 添加厂商 → 自定义接口。
2. 填写连接名称，例如“我的图像服务”。选择下面说明的对话协议。
3. 在接口地址填写基础地址，例如 https://api.example.com/v1。这是占位域名，使用时换成服务商提供的地址；不要把管理后台网页地址填在这里。
4. 把密钥填入专门的API Key输入框。密钥值是否带前缀要按配置方式判断，通常输入原始密钥；不要把整行 Authorization: Bearer … 粘成密钥。
5. 可点击验证连接、拉取模型。成功后勾选要启用的模型；平台没有模型列表接口时，也可手动添加。
6. 手动添加时，在手动输入模型 ID中填写准确 ID，可再填写显示名称、选择文本 / 图像 / 视频 / 音频分类，然后点加号。
7. 检查模型是否勾选、分类是否正确，以及是否允许在对应类型节点中显示。需要特殊请求格式时，先勾选模型，再点击该行调用协议。
8. 检查完成后，点击底部添加厂商或保存更改。返回对应类型节点，确认模型已出现在选择列表里。

“对话协议”应该选哪个

模型能选到，但参数缺了一项

模型行的图片参数能力或视频参数能力决定节点提供哪些选项；调用协议决定这些值发送到接口的哪个字段。图片包括分辨率、比例、质量、背景、批量数量、参考图及 Base64 限制；视频还包括任务类型、时长、帧率、音频开关和各类参考素材。能力与协议要同时匹配。

1. 在设置 → API Key → 编辑对应连接，找到准确模型 ID，打开该行的图片或视频参数按钮。
2. 按当前渠道文档设置支持范围和默认值；不知道的项目可保留未声明，不必全部填写。未知网关的同名型号不能直接当作官方接口。
3. 打开同一行调用协议，核对每个可调参数对应的请求变量。例如比例使用 {{aspectRatio}}，时长按接口类型使用 {{duration}} / {{durationText}}，视频分辨率按所选协议映射。
4. 点击底部保存更改，回到节点重新选择模型，核对选项与参考素材角色。图片参数未完整声明时，节点参数按钮会直接打开所属连接的当前模型设置。

“声明可调音频开关，但没有映射变量”表示能力与请求体冲突：如果渠道不提供该开关，在视频参数能力中改为未声明或不支持；确实支持时，按文档映射 {{generateAudio}} / {{disableAudio}}。普通参考图不会自动成为首帧或尾帧，角色要在节点明确指定。

看到“未配置可执行的提交 / 轮询协议”时，进入该连接的当前模型行 → 调用协议，选择与实际渠道一致的模板或按文档手动配置；仅调整比例、分辨率或参考图数量不能补齐提交与查询接口。

图片快速适配：GPT Image 与 Nano Banana

1. 在当前模型的图片参数能力中，打开 GPT Image 快速适配或 Nano Banana 快速适配下拉列表。
2. GPT Image 提供 2 / 2.5，以及 OpenAI 官方 Images、中转 JSON（images）、APIMart 异步格式。Nano Banana 提供原版 / Pro / 2 / 2.1，以及 Google 官方 generateContent、中转 Gemini 原生透传、APIMart 异步格式。按渠道实际协议选择。
3. 点击应用模板，同时更新当前模型的参数能力、调用协议与参考图方式；保留模型 ID、名称和其他模型。核对模板的路径、数量与参考图限制，最后保存连接。

模板不会验证渠道实际可用，也不会发起生成；应用会覆盖当前模型的相关草稿，已有手工配置可先导出留档。GPT 2 / 2.5 高分辨率为实验档；Google 原生参考图还受应用 Base64 预算限制。不要用模型名字代替接口文档。

LibAPI：直接选择四类预置模型

打开设置 → API Key → 添加厂商 → LibAPI，即可浏览应用已适配的 67 个预置型号；不用先拉取目录，未填写 Key 时也能查看。型号不会自动全部勾选，也不会因浏览列表发起生成。

1. 填写自己的 LibAPI API Key，按文本、图片、视频或音频筛选，勾选实际要用的型号并保存；回到相应节点，在独立的 LibAPI 分组选择。
2. 需要核对当前账号权限或刷新目录时，再点拉取模型 / 验证连接。成功后以这次返回且已适配的型号更新列表和勾选；失败保留原列表并显示错误，不把本地预置当成远端验证成功。
3. 选择 TTS 时检查音色和格式。GT 提供六种预置音色，GM 提供三十种；MiniMax / 豆包必须填写平台已有的真实音色 ID。格式、语速按型号提供，未支持的选项不显示，当前不开放原始 PCM。
4. 选择 Suno Music 时填写提示词，按需补标题和歌词；当前普通生成不提供 BPM、时长或独立自动写词开关。本批语音与音乐均不提供参考素材即传即克隆；MiniMax / 豆包如需使用自己的声音，应先在平台创建音色，再填写真实音色 ID。

图片 / 视频使用本地参考素材时，经当前 LibAPI 连接上传，需具备平台对应权限；普通参考、首帧和尾帧按型号规则配置。异步任务中断后按原任务恢复继续取回，不反复提交生成。

ToAPIs 与 RunningHub：国内 / 国际站切换

打开设置 → API Key → 添加 API 厂商 → ToAPIs。已添加的连接可直接编辑；列表卡片的站点按钮用于快捷切换，编辑窗口内也有API 站点选项。

1. 选择国内站（toapis.cn）或国际站（toapis.com），在专用输入框填写 API Key。两站共用账号和 Key，切换会保留 Key；“前往厂商控制台”跟随所选站点。
2. 验证连接，按需点击拉取模型，勾选需要的型号并保存。目录以当前站点和账号实际返回为准，应用的文本目录仅匹配预设的 9 个型号，不展示平台的全部文本模型。
3. 切站后需要刷新目录时，再进入该连接拉取并保存；卡片快捷切换会保存站点，本身不会自动重新拉取模型或替你迁移已有远端任务。

CCC API：统一管理分组 Key

设置的 API Key 列表只显示一张 CCC API 卡片，点击管理后可同时编辑各分组的 Key 和模型，最后点击保存全部分组。各组的 Key 与启用选择分别保留，无需切换分组或重复输入；节点和对话的模型菜单也归入同一个 CCC API，模型名称仍标注所属组，调用时自动匹配该组的 Key。

各组内部提供复制已保存配置（不含 Key）和单组删除；列表外层删除整张 CCC 卡片会移除全部分组。单组删除后该组恢复空白输入，不会被后续保存全部重新恢复；其他组尚未保存的编辑保留。预置模型不代表当前 Key 已获授权，拉取后以该组 Key 返回的目录为准。

自定义连接：导出与导入 JSON 文件

1. 先保存自定义连接。在 API Key 列表中，点击该连接的导出 JSON（不含 API Key）图标，选择文件名与保存位置。桌面端弹出另存为，浏览器使用文件下载。
2. 在目标应用的 API Key 页点击从 JSON 文件导入自定义连接图标，选择之前导出的 .json 文件；不用粘贴剪贴板内容。
3. 导入后按提示补填 API Key，核对接口地址、模型及协议，保存并在对应节点重新选择。专用 Key 不随文件导出，也不会从文件恢复。

文件包含已保存的模型清单、逐模型图片/视频能力与调用协议；自定义工作流 API 连接还携带相应工作流定义。取消文件选择不会修改配置。这里只导入应用导出的自定义接口 / 工作流 API 连接配置，不能把厂商请求示例、普通工作流 JSON 或项目包当作连接文件。CCC 等内置线路沿用自己的配置入口。

0.10.2 · 已有厂商怎样使用新增模型

本版内置 APIMart、GRSAI 等目录补充了文本、图片、视频与音乐型号。打开设置 → API Key → 编辑对应厂商，检查模型列表；需要读取当前账号可用清单时点拉取模型，勾选需要的型号并保存。新增条目不会自动全部启用；模型缺失时先清空搜索、检查分类与节点显示开关，再核对账号权限。

接口地址失焦时会清理首尾空格、末尾斜杠及部分误贴的完整接口后缀；验证或拉取模型后也可能更正地址。操作后应再次检查界面中最终保存的基础地址。

07 · 自定义接口：接口说明与手动配置

0.10.7 已移除自定义连接的“导入文档”界面。拿到厂商调用示例后，在连接中手动添加模型，再进入该模型的调用协议配置提交与轮询；旧章节链接继续定位到这里。

1. 从厂商说明确认基础地址、模型 ID、模型分类和鉴权方式，API Key 仍单独填写。
2. 在该模型的调用协议选择匹配的接口格式；复杂接口使用高级自定义 JSON。
3. 对照调用示例填写提交路径、请求体和响应结果路径，使用变量面板插入提示词、尺寸、参考素材等动态参数。
4. 异步接口还要配置任务 ID、查询路径及完成/失败判断，并使用已完成响应核对最终素材路径。
5. 先检查脱敏请求预览和响应路径，再保存厂商设置。试跑可能产生实际模型费用。

也可以让 AI 助手协助整理

可以把厂商接口说明交给助手，请它核对提交、任务查询和结果字段，并预览配置草稿。说明模型分类及参考素材要求；规划模式只读取资料，协作模式的配置写入需确认，自主模式沿用既有配置工具权限。

08 · 自定义接口：手动配置调用协议

在模型行点击调用协议。接口与现成预设一致时使用对应预设；字段、路径或轮询方式不同，选择高级自定义。高级自定义的文本和图片模型直接编辑 JSON；视频模型默认进入 JSON，也可切换表单，音频与工作流按界面提供的表单 / JSON 编辑。两种视图共用本地请求预览和响应示例与路径校验，无需为了预览切换视图。

表单和 JSON 编辑同一份协议：通过校验的修改会同步。表单的提交请求体 JSON也采用左侧变量、右侧编辑框布局；轮询请求体保持紧凑编辑。无效 JSON 或子表单草稿不会同步。切换视图、模板或模型前，遇到放弃草稿提示时，选继续编辑可保留当前内容；只有明确放弃才丢弃未同步文本。切换视图不等于保存连接。

8.1 · 在 JSON 中插入变量、核对预览

1. 选高级自定义 JSON，在右侧声明式协议 JSON填写完整协议；协议版本使用 2。可从第 10、11 章的示例起步，再逐项替换成厂商文档中的字段。
2. 先在 JSON 中定位光标，或选中要替换的值，再点击左侧可用变量。软件插入完整的 {{变量名}}，并把光标移到插入内容后；键盘聚焦变量后按 Enter 也可插入。悬停可看变量说明。
3. 变量按钮只插入模板，不会自动补双引号、逗号或字段名。例如字段值应写 "prompt": "{{prompt}}"。没有定位过光标时会追加到末尾，插入后检查 JSON 是否仍有效。
4. 展开本地请求预览，填写示例变量，检查替换后的方法、相对路径、Header 和 Body；再把真实接口的脱敏响应粘到响应示例与路径校验，核对任务、状态和结果路径。
5. 需要 AI 协助时点复制给AI修改，将复制的当前草稿、字段说明与可用变量交给助手，并补充厂商文档。把返回的完整 JSON 粘回编辑器后，重新检查错误和预览，最后保存厂商设置。

8.2 · SD2.0、SD2.5、H3 视频预设

视频 JSON 标题旁的SD2.0 / SD2.5 / H3按钮明确使用 APIMart 模板。点击会替换当前 JSON 草稿，并应用对应视频参数能力，保留当前模型 ID；不会自动生成视频。已有手工配置需要保留时，先复制到自己的文本文件，再切换模板。

模板适合使用相应 APIMart 兼容接口的模型。使用火山直连、MiniMax 官方或其他网关时，核对视频能力页的Seedance 快速适配 / MiniMax H3 快速适配，选择实际平台对应的模板；路径、鉴权、请求字段和返回结构仍以该服务文档为准。不能仅凭模型名字相同就判断兼容。

地址拼接：最常见的 404 来源

假设连接地址是 https://api.example.com/v1，协议路径是 /images/generations：

如果接口文档写 /v1/images/generations，可以用“不含 /v1 的连接地址 + 完整相对路径”，也可以用“含 /v1 的连接地址 + /images/generations”。不要在 append 模式里把 /v1 两边都写一遍。

自定义模型连接当前仍要求非空 API Key；新工作流 API连接则按每个工作流的鉴权设置检查，全部选择“无需鉴权”时可以不填密钥。平台若要求 Authorization 原样发送 Token，使用专门的鉴权设置并将前缀留空，不要在额外 Headers 中硬写 Authorization。详见13.6。

09 · 自定义接口：变量与结果路径

把固定示例改成跟随节点的请求

变量用双花括号，在 JSON 中写成字符串，例如 "{{prompt}}"。字段名必须保留服务商要求的名字；变量名表示从 AI Canvas 取哪一个值。

{
  "model": "{{model}}",
  "prompt": "{{prompt}}",
  "n": "{{n}}",
  "image_urls": "{{imageUrls}}"
}

整项变量会保留类型。"{{n}}" 可以替换为数字，"{{imageUrls}}" 可以替换为数组，不会因为模板中有引号就全部变成字符串。

变量按模型类别提供，以编辑器的可用变量为准，悬停可看解释。整项变量没有可用值时，该字段会省略；缺失变量如果嵌在普通文字里，例如 "prefix-{{missing}}"，会报错。可选素材是否允许省略，还要符合服务端要求。

工作流 API 的自定义参数使用 {{parameters.参数名}}，例如 {{parameters.duration}}；这个参数对象由工作流的“能力与参数 JSON”提供，普通模型不会自动提供它。工作流媒体数组还包括 {{videoUrls}} 和 {{audioUrls}}，完整配置见13.7 的可复制示例。

9.1 · 多参考素材与可选项

视频的普通参考图、首尾帧、参考视频和音频使用不同变量。{{referenceImageUrls}} 是普通参考图，{{firstImage}} / {{lastImage}} 是明确指定的首尾帧；带角色数组可用 {{imageWithRoles}}。接口要求一组对象时，使用 $forEach 逐项展开，不能把 URL 数组直接放进单个对象。

{
  "model": "{{model}}",
  "content": [
    { "type": "text", "text": "{{prompt}}" },
    {
      "$forEach": "{{referenceImageUrls}}",
      "$value": {
        "type": "image_url",
        "image_url": { "url": "{{referenceImageUrls}}" }
      }
    }
  ]
}

$forEach 仅用于 JSON 请求体的数组元素，支持 referenceImageUrls、referenceVideoUrls、referenceAudioUrls，并须属于当前类别的可用变量；在对应 $value 内，同名变量代表当前项。需要只在素材存在时发送某个数组元素，可用 $whenPresent 配合 $value，条件必须是完整变量模板。不要写脚本、表达式或动态字段名。

软件怎样从响应中找到结果

返回值路径用点号访问对象，数字访问数组，* 提取多个结果。不要把整个 JSON 对象当成媒体地址。

{
  "data": [
    { "url": "https://media.example.com/result-1.png" },
    { "url": "https://media.example.com/result-2.png" }
  ]
}

如果返回的是 Base64，填写对应的 Base64 路径，并提供 image/png、audio/wav 等正确 MIME 类型。原始二进制响应则选择对应响应类型，不要强行当作 JSON 解析。

10 · 完整示例：同步图像接口

教学占位示例 以下域名、模型 ID 和路径只演示配置方法。示例通过当前版本的静态校验与本地请求构建；没有调用真实厂商，不能作为任意平台的通用配置。

这个例子假设服务这样工作

• 基础地址：https://api.example.com/v1。
• 模型 ID：image-model-example，模型分类选择图像。
• 以 Bearer 密钥调用 POST /images/generations。
• 接口直接返回上一章 data[].url 形式的图片地址。

1. 按第 06 章添加连接和图像模型，勾选该模型。
2. 打开调用协议 → 高级自定义 → JSON，将下面的完整协议粘贴进去。
3. 保持 JSON 页，展开本地请求预览，在示例变量 JSON中填写模型 ID、提示词、尺寸和数量。确认相对路径为 /images/generations，请求体里的 n 是数字。该区域不展示真实连接地址；结合本例基础地址和 append 模式，实际请求地址应为 https://api.example.com/v1/images/generations。
4. 在下方的响应示例与路径校验粘贴示例响应，确认 data.*.url 能提取图片地址。
5. 改成真实厂商资料后，如需联调可执行一次试跑；检查返回结果，最后保存厂商设置，回到图像节点使用。

{
  "model": "image-model-example",
  "prompt": "一只坐在窗边的小猫，水彩插画",
  "size": "1024x1024",
  "n": 1
}

{
  "version": 2,
  "mode": "sync",
  "auth": { "type": "bearer" },
  "submit": {
    "method": "POST",
    "path": "/images/generations",
    "pathMode": "append",
    "bodyEncoding": "json",
    "body": {
      "model": "{{model}}",
      "prompt": "{{prompt}}",
      "size": "{{size}}",
      "n": "{{n}}"
    }
  },
  "response": {
    "type": "json",
    "result": { "urlPath": "data.*.url" },
    "errorPath": "error.message"
  }
}

换成你的平台，需要改哪里

核对实际基础地址、模型 ID、鉴权方式、提交路径、请求体字段与结果路径。例如服务只返回 {"output":{"image":"…"}}，就将 urlPath 改成 output.image；服务不接受 n，按它的文档移除该字段。修改后重新检查预览与响应匹配。

11 · 完整示例：异步视频接口

很多视频接口先返回任务编号。AI Canvas 保存这个编号，再定期查询，直到任务成功、失败或超过限制。任务编号、状态、结果地址分别在不同位置，必须逐项配置。

教学占位示例 假设基础地址为 https://api.example.com/v1，模型 ID 为 video-model-example，分类选择视频。

{
  "data": { "id": "job-example" }
}

{
  "data": {
    "status": "completed",
    "output": { "url": "https://media.example.com/result.mp4" }
  }
}

使用 JSON 或表单逐项核对

可将下方完整协议粘贴到默认 JSON 页，或切换表单逐项填写；两种方式都可直接使用下方预览。展开本地请求预览，在示例变量 JSON 中给 model、prompt 和数字 duration 赋值。预览展示相对路径，真实地址还需结合连接地址与路径基准核对。

响应示例与路径校验一次只有一个输入框：先粘贴上方提交响应，检查任务 ID；再换成完成响应，检查状态和最终视频地址。另一阶段的字段暂时未匹配是正常的，不要求两类响应在一次输入中同时通过。

{
  "version": 2,
  "mode": "async",
  "auth": { "type": "bearer" },
  "submit": {
    "method": "POST",
    "path": "/videos",
    "pathMode": "append",
    "bodyEncoding": "json",
    "body": {
      "model": "{{model}}",
      "prompt": "{{prompt}}",
      "duration": "{{duration}}"
    }
  },
  "response": {
    "type": "json",
    "taskIdPath": "data.id",
    "errorPath": "error.message"
  },
  "poll": {
    "method": "GET",
    "path": "/tasks/{{submit.data.id}}",
    "pathMode": "append",
    "intervalMs": 3000,
    "maxAttempts": 200,
    "maxDurationMs": 600000,
    "response": {
      "statusPath": "data.status",
      "successValues": ["completed"],
      "failureValues": ["failed", "error"],
      "result": {
        "urlPath": "data.output.url",
        "mimeType": "video/mp4"
      },
      "errorPath": "data.error.message"
    }
  }
}

带参考图的视频怎样改

先查服务要求。有的平台接收 "image_url":"{{firstImage}}"，有的平台接收图片数组或嵌套对象；不能把它们互换。模型支持首帧时，才在节点中添加首帧，并将对应变量放进文档要求的字段。参考音频、视频同理，以编辑器可用变量和平台素材限制为准。

轮询限制与取消

最大次数或最长时长任一达到，就会结束本轮等待；两项都留空表示不限。实际视频节点已拿到任务 ID 时，超时会保留任务并提供重试续查；协议编辑器的真实试跑也可按暂停与续查说明继续处理已有任务。查询可对部分临时网络错误重试，默认针对 408、429、500、502、503、504 等状态，连续最多 3 次；提交生成请求不会自动重试。

试跑中可暂停查询或停止等待。停止本地等待不代表服务商已经撤销云端任务或退费；再次提交前先查平台任务记录。服务端任务完成后，软件还需要成功取得并保存结果，才算得到可用视频。

11.1 · 完成后同源下载：轮询只返回状态，没有文件 URL

有些接口的完成响应只有状态，文件需要另发请求下载。例如本例完成时返回 {"data":{"status":"completed"}}，再调用 GET /tasks/任务ID/content 取得 MP4 二进制。这时不能把任务 ID 当 URL，也无需为不存在的 URL 字段填写路径。

1. 仍按实际接口填写提交、任务 ID、查询路径和成功 / 失败状态。
2. 在视频或音频的高级自定义表单中，将结果获取方式设为完成后同源下载；填写结果下载路径（GET）、路径基准和备用 MIME 类型。JSON 编辑使用下例的 poll.response.result.download。
3. 下载路径或 Query 必须引用本次提交的任务 ID。本例 ID 位于 data.id，所以写 {{submit.data.id}}；不要写死某个旧任务编号。
4. 下载必须与连接地址同协议、同域名、同端口，鉴权沿用当前连接。Query 和允许的额外请求头可在 JSON 中配置；不在其中硬写 API Key 或 Authorization。
5. 完成后检查下载与保存状态。下载失败或取消不会重新提交生成；先保留原任务 ID，支持恢复的节点使用继续查询 / 保存，避免再次付费生成。

{
  "version": 2,
  "mode": "async",
  "auth": {
    "type": "bearer"
  },
  "submit": {
    "method": "POST",
    "path": "/videos",
    "pathMode": "append",
    "bodyEncoding": "json",
    "body": {
      "model": "{{model}}",
      "prompt": "{{prompt}}",
      "duration": "{{duration}}"
    }
  },
  "response": {
    "type": "json",
    "taskIdPath": "data.id",
    "errorPath": "error.message"
  },
  "poll": {
    "method": "GET",
    "path": "/tasks/{{submit.data.id}}",
    "pathMode": "append",
    "intervalMs": 3000,
    "maxAttempts": 200,
    "maxDurationMs": 600000,
    "response": {
      "statusPath": "data.status",
      "successValues": [
        "completed"
      ],
      "failureValues": [
        "failed",
        "error"
      ],
      "result": {
        "mimeType": "video/mp4",
        "download": {
          "method": "GET",
          "path": "/tasks/{{submit.data.id}}/content",
          "pathMode": "append"
        }
      },
      "errorPath": "data.error.message"
    }
  }
}

本例基础地址仍为 https://api.example.com/v1；若任务 ID 是 job-example，最终下载地址应为 https://api.example.com/v1/tasks/job-example/content。备用 MIME 使用 video/mp4，音频接口按实际格式改为 audio/mpeg 等；它不会把错误页转换成媒体。

12 · 自定义接口：验证与排错

各类检查不是同一个“测试”

试跑前后逐项检查

1. 先修正当前协议草稿中的 JSON 和字段错误，包括表单里的 Header、Query、Body 子项；有错时试跑不可用，软件不会退回旧草稿替你执行。
2. 填写真实基础地址与 API Key。自动兼容预设不走声明式协议，不能在此试跑；缺地址、缺密钥或当前草稿无效时，先处理按钮旁的提示。
3. 展开真实试跑配置。视频按文生视频 / 首尾帧 / 多参考素材选择当前场景，并在对应字段填写厂商可访问的真实公网图片、视频或音频 URL。首帧场景不混入多参考素材，多参考场景不使用首尾帧；本地路径和示例占位地址不能代替公网素材。
4. 在试跑参数 JSON中核对真实模型 ID、短提示词、受支持的最小时长或数量；未声明的可选参数可以留空。试跑配置与本地预览变量彼此独立，视频素材以当前场景字段为准。
5. 先检查本地请求预览与响应路径匹配，再点一次试跑。它使用当前草稿、连接凭据与真实试跑配置发送请求，可能计费；异步接口会继续轮询，可暂停等待后续查原任务。
6. 查看试跑详情，核对解析出的结果地址、文本与任务 ID。HTTP 成功不等于结果可用；文本须非空，媒体结果须匹配当前类别。确认后保存连接，再在实际节点中生成并验证文件可预览。

试跑成功不会自动保存连接，也不会把示例提示词写入画布节点。配置预览、真实接口响应和最终媒体保存需要分别检查。

暂停试跑后继续查询同一个任务

1. 异步试跑已获得任务 ID 后，可点击暂停查询；提交仍在等待响应时，按钮显示停止等待。保留详情里的任务 ID，不把本地暂停当作服务端取消。
2. 网络恢复或想再次查看进度时，点击继续查询。软件使用原任务的查询配置，不重新提交生成；关闭并重开已保存连接的设置窗口后，也可在当前应用进程内继续查询。
3. 需要结束本地记录时，先去厂商平台核对原任务，再明确选择放弃记录。放弃记录不停止上游任务，再次试跑会创建新任务并可能再次计费。

保存配置、保护草稿与查看本地状态

切换模型、协议视图、模板或离开自定义连接时，若提示有未同步协议文本或未保存修改，选继续编辑保留当前面板与选择；只在确定不要这些内容时选放弃草稿 / 放弃修改。保存期间等待结果，不重复提交或继续改字段。此处保护的是自定义模型连接草稿，不扩展通用工作流 API 的父级草稿保存范围。

API Key 列表中的Key 已填写只表示输入过凭据；协议待配置、配置需修正和本地校验通过反映配置状态，不能代替真实模型调用验证。导入 JSON 失败时，按页面列出的模型名称、索引和字段路径修正全部问题，再重新导入；有错误的文件不会部分写入或静默丢弃模型协议，专用 Key 仍需另行填写。

13 · 本地与云端工作流

安装官方 ComfyUI 便携版

1. 在 Tauri 桌面版打开设置 → ComfyUI，点击ComfyUI 安装目录旁的安装。
2. 按当前机器选择运行环境，填写新建文件夹名称，再点选择位置。软件会在所选位置下新建文件夹；已有同名目录不会直接覆盖。按界面预计下载量预留额外解压空间。
3. 按需勾选安装完成后启动 ComfyUI，点击开始安装。依次等待下载、SHA-256 校验、解压、环境检测及安装目录保存；取消时原有安装与选择保留。
4. 看到目录已记住后，可点击启动 ComfyUI，等待服务可用，再检查工作流所需模型和自定义节点。安装成功不等于工作流和模型已全部就绪。

一键安装支持 Windows x64 / ARM64，使用包含独立 Python、PyTorch 和前端依赖的官方便携包，不修改系统 Python；显卡驱动、模型与第三方插件仍需按需准备。其他系统或已有安装请按官方方式安装后，使用更换选择目录。

GitHub 下载超时与国内加速

公开 GitHub 资源先直连；连接 / 读取超时或瞬时网络故障时，最多切换一次国内加速源，并从零重新下载、重置进度。导演台、通用文件、插件市场、ComfyUI 资源及应用更新包共用这一规则；不影响模型 API 请求，也不改道带凭据请求。取消、体积超限、磁盘错误、摘要或签名校验失败会停止，不通过切源跳过检查。

ComfyUI 安装器遇到 HTTP 200 返回 HTML 拦截页或响应长度异常时，也允许尝试一次加速源。文件仍需通过固定大小和 SHA-256 校验；取消不会触发重试，摘要不符不会解压。

ComfyUI 本地管理与模型去重

在桌面版打开设置 → ComfyUI → 设置，进入独立管理窗口。运行控制台可以启动、停止由应用托管的 ComfyUI，并查看实时输出；关闭管理窗口不会停止服务。安装、插件与版本信息会缓存，外部修改后使用刷新按钮重新读取。

同一次管理窗口会话内，模型去重扫描结果、搜索与选择在切换页面后保留；更改 ComfyUI 版本、插件或依赖后需要重新扫描。关闭窗口仍会清理临时目录授权，不把旧扫描结果当作文件当前状态。

1. 进入模型去重，选择模型目录、插件目录、指定文件夹或整个磁盘；外部范围须通过系统目录对话框选择。扫描仅比较支持格式且至少 1 MiB 的模型文件，同内容、不同文件名可归为一组。
2. 先备份测试副本并停止 ComfyUI，逐组选择保留项及待替换副本，再选择硬链接或软链接。确认前核对全部选中组和数量；不会因扫描结束自动替换。
3. 完成后检查原路径和文件名仍可读取，并重启 ComfyUI 测试加载。部分失败或中断时先使用恢复入口处理；最近操作历史用于核对处理结果，不代表文件当前状态或自动回滚。

先确认工作流由哪里执行，再选择入口。保存工作流只是保存配置；在生成节点点击生成，或让助手实际执行时，才会运行任务。

13.1 · 配置 ComfyUI，并绑定服务器

1. 先在自己的 ComfyUI 环境确认工作流能运行。在设置 → ComfyUI填写默认服务地址并检查连接；端口使用该服务的实际端口。
2. 有多台机器时，添加额外服务器，分别填写便于识别的名称和地址，例如“本机生图”“远程视频”。连接状态只说明服务可达，不证明模型和节点已齐备。
3. 进入管理工作流，将导入来源选为ComfyUI 工作流，填写名称、分类并导入API 格式 JSON。普通界面格式的 nodes / links 文件用于保留布局，不能直接代替执行所需的 API 格式。
4. 检查识别出的输入并保存。在工作流卡片的服务器选择中绑定目标服务器；未绑定时使用默认服务。
5. 回到对应图像、视频、动画或音频节点，在模型/工作流选择器中选中工作流，检查参数与素材，再生成一条验证。

未显式绑定服务器的工作流沿用默认服务；已经绑定的服务器被删除或地址被清空时，必须重新选择有效服务器，不会静默回落到另一台机器。修改服务地址后，重新核对模型、文件与工作流输入。助手动态创建的工作流同样在发现、校验和执行时核对所选服务器，不沿用过期校验结果。

在对话中可先要求助手“列出已配置的 ComfyUI 服务器”，再明确指定服务器名称，让它检查模型和节点、校验工作流、执行并保存。实际执行沿用当前会话模式和生成权限；服务器名称应与设置一致。

13.2 · 默认输入、显式引用与参数

1. 展开工作流卡片，点击输入节点徽章，把提示词、图片、视频或音频的目标设为★ 默认输入。
2. 在生成节点中写提示词并添加参考素材。没有显式分配时，该类型内容交给对应默认输入。
3. 需要指定具体位置时，在提示词里 @ 工作流输入节点并赋值。同一类型只要有显式分配，该类型就按显式输入处理，不再额外使用默认节点；其他类型的默认输入仍可生效。
4. 检查比例、分辨率、帧率和时长在工作流中是否存在可识别的对应字段。自定义节点的特殊参数不能仅靠提示词中的数字来配置。

在提示词输入 @ → ComfyUI → 工作流输入 后，可用全部 / 图片 / 视频 / 音乐 / 文本筛选候选；“音乐”对应音频输入，“文本”对应提示词输入。筛选不改变工作流节点类型，选中后仍需为目标输入赋值。

ComfyUI 角色参考包（RefMod）

前置条件：目标 ComfyUI 已安装受支持的 RefMod 加载器、已有真实参考包，并准备好包含对应加载槽位的 H3 本地视频 API 工作流。这个入口不会下载模型、生成参考包，也不会把普通角色照片自动转换为 RefMod。

1. 打开资源库的ComfyUI 角色，选择参考包所在的已配置服务器，再刷新目录。名称、标签及角色关联只是显示信息，文件仍由该 ComfyUI 服务读取，不复制到项目目录。
2. 需要按角色整理时，打开角色卡的ComfyUI 角色参考包（RefMod）→ 关联参考包，选择已有包；角色主参考图可作为资源预览，不会替换参考包本身。
3. 在视频节点选择相应本地 H3 工作流，在提示词中输入 @ → ComfyUI → ComfyUI 角色，选取当前服务的参考包。选择目标加载器槽位和可用的强度后，插入独立引用胶囊。
4. 多个加载节点或槽位不明确时，按提示选择实际目标；自动分配只使用空槽。要覆盖已有模型须明确选择该槽位，软件不会覆盖由上游连线控制的输入。原版与 Francky 读取加载器声明的强度范围；RefMods Lab 的强度沿用原工作流内的 Combine 设置。
5. 可双击 RefMod 胶囊修改槽位或强度，也可从资源库选择或拖入多个包形成手工绑定。在生成前再次检查引用与手工绑定；同槽位存在不同文件或强度时，先解决冲突。

提示词内的引用随胶囊删除、复制和撤销；从资源库添加或拖入的手工绑定另行保存，删除其他胶囊不会清除这些绑定。执行只修改本次提交的工作流副本，不改保存的工作流定义或连线，RefMod 也不作为普通参考图片上传。

13.3 · 在 ComfyUI 编辑，再保存回 AI Canvas

1. 在工作流卡片点击在 ComfyUI 中编辑，等待“正在载入”结束并确认节点图实际出现。失败时查看错误，再点击重试打开。
2. 修改节点或参数后，在应用打开的 ComfyUI 窗口使用保存到 AI Canvas；要保留旧版则使用另存到 AI Canvas创建新记录。
3. 多标签编辑时，先切到需要保存的那张图再保存。软件按标签对应的工作流保存；不要只凭同名文件判断覆盖目标，导出过程中也不要切换标签。
4. 返回管理面板检查更新后的工作流和 ★ 默认输入。删除过的输入节点不会继续作为默认目标，必要时重新指定。

应用内编辑与保存回写依赖桌面版，自动载入/保存桥接仅用于本机回环服务。远程 ComfyUI 可以执行工作流，但编辑窗口不具备同样的自动回写能力；按提示在服务端编辑并重新导入。临时断线时先恢复连接，不必关闭已有未保存的编辑窗口。

13.4 · RunningHub：模型密钥与工作流密钥

先选当前要使用的国内 / 国际站，卡片按钮与编辑窗口均可切换。两站密钥独立保存，每站的模型 Key 和工作流 Key 可只填一项；切到未配置站点时需要补填，详见站点差异。

打开设置 → API Key → RunningHub。连接卡片分别显示“模型连接”和“工作流连接”的配置状态，可只配置当前需要的一种。工作流缺少密钥时，不代表已经配置的模型密钥失效。

云工作流导入界面也允许选择“模型 API Key”连接；应使用平台授予该工作流访问权限的密钥，不要把两类凭据视为可无条件互换。

13.5 · 导入 RunningHub 云工作流或 AI 应用

1. 打开管理工作流，在“导入工作流”的来源中选择“RunningHub 云工作流”或“RunningHub AI 应用”。右侧列表随来源筛选，找不到旧条目时先检查来源及输出分类。
2. 填写名称、输出类型（图片 / 视频 / 音频）、使用连接，再填写平台链接或 ID。
3. 点击从 RunningHub 读取定义。也可展开从官方 API JSON / 调用示例导入，粘贴 JSON / curl 或选择 JSON 文件，点击解析并预览。这两种读取操作不生成素材。
4. 逐项检查参数映射中的节点 ID、字段名和类型。固定设置选“固定值 / 每次可调整”；文本输入映射“本次提示词”；媒体输入分别映射图片、视频或音频参考。
5. 媒体参考序号在界面中从 1 开始，图片、视频、音频分别计数。检查必填项、默认值；不想覆盖的参数使用不覆盖此参数。只需某些结果时，可填写限定输出节点。
6. 按实际账号权限选择默认 / Plus 实例和个人队列；Plus 可能增加费用。点击添加云工作流或保存修改。
7. 在对应媒体节点选择工作流，展开云工作流参数填写本次值，并用连线或 @ 提供参考素材。检查后生成，在节点查看上传、排队、执行和保存结果。

本地参考素材通过 RunningHub 的上传入口处理。云工作流的类型化参数与 ComfyUI 的 ★ 默认输入是两套配置；切换导入来源后应按该平台的界面重新核对。

13.6 · 通用工作流 API：添加平台与多个工作流

这个入口适合平台已经把工作流发布成 HTTP API 的情况。一个连接保存平台地址和密钥，连接内可以创建多个命名工作流，每个工作流分别配置输入和输出。只有固定 AutoDL 模板、看不到下述按钮时，需要安装包含通用工作流 API 更新的版本。

1. 进入设置 → API Key → 添加厂商 → 工作流 API，填写连接名称、平台基础地址及专用 API Key / Token。
2. 点击添加自定义工作流，填写工作流名称并选择输出类型。需要 H3 时也可点击添加 AutoDL H3 模板，再按平台文档修改。
3. 点击编辑调用路径与参数映射，配置同步/异步、鉴权、提交路径与请求体、任务 ID、查询路径、状态和结果路径。表单 / JSON 的用法与第 08–12 章相同。
4. 在能力与参数 JSON声明需要多少图片、视频和音频，以及每次可以填写的参数。下面的 13.7 给出完整示例；能力声明和发给平台的请求体需要分别填写。
5. 使用检查配置和协议编辑器里的本地预览排查格式。它们不会创建计费任务，也不证明 Token 权限或服务端运行已经验证；工作流卡片的协议编辑器用于本地校验，真实执行从生成节点发起。
6. 点击底部添加厂商 / 保存更改。一个连接可继续添加多个工作流；每张工作流卡片都需填写有效名称、能力及协议，单张无效也会影响保存。
7. 回到相同输出类型的生成节点，在选择器中选保存的工作流。展开工作流输入，填写本次参数，添加参考素材后生成。

节点中留空的参数使用工作流声明的默认值；必填但没有默认值的项需要填写。声明了一个参数不等于平台已经收到它，还要在请求体中用 {{parameters.参数名}} 映射。保存连接分享文件时不包含 Token，导入到另一连接或电脑后需重新配置凭据，并核对工作流的连接归属。

13.7 · 可复制示例：输入能力与请求协议怎样配合

下面假设一个视频工作流需要 1–4 张图片、可选 1 段音频，并接收时长、分辨率和随机种子。路径、字段、枚举及返回值均为占位示例，复制后按真实平台文档修改；它不是 AutoDL 或 RunningHub 的现成配置。

{
  "references": {
    "image": { "min": 1, "max": 4 },
    "video": { "min": 0, "max": 0 },
    "audio": { "min": 0, "max": 1 }
  },
  "parameters": {
    "duration": { "type": "integer", "label": "时长（秒）", "required": true, "default": 5, "min": 1, "max": 15 },
    "resolution": { "type": "string", "label": "分辨率", "default": "720p", "options": ["480p", "720p"] },
    "seed": { "type": "integer", "label": "随机种子" }
  },
  "prompt": { "required": true, "maxLength": 10000 }
}

{
  "version": 2,
  "mode": "async",
  "auth": { "type": "bearer" },
  "submit": {
    "method": "POST",
    "path": "/workflows/run",
    "pathMode": "origin",
    "body": {
      "prompt": "{{prompt}}",
      "image_urls": "{{imageUrls}}",
      "audio_urls": "{{audioUrls}}",
      "duration": "{{parameters.duration}}",
      "resolution": "{{parameters.resolution}}",
      "seed": "{{parameters.seed}}"
    }
  },
  "response": { "type": "json", "taskIdPath": "data.task_id", "errorPath": "message" },
  "poll": {
    "method": "GET",
    "path": "/tasks/{{submit.data.task_id}}",
    "pathMode": "origin",
    "intervalMs": 3000,
    "maxDurationMs": 7200000,
    "response": {
      "statusPath": "data.status",
      "successValues": ["completed"],
      "failureValues": ["failed", "cancelled"],
      "errorPath": "message",
      "result": { "urlPath": "data.results.*.url" }
    }
  }
}

示例提交响应为 {"data":{"task_id":"demo-task-1"}}；完成响应为 {"data":{"status":"completed","results":[{"url":"https://media.example.com/video.mp4"}]}}。若实际响应中任务 ID 叫 id，就需同时修改任务 ID 路径与查询变量。{{model}} 在工作流中表示工作流标识，不应盲目当作上游的模型名；接口要求固定模型或远端工作流 ID 时，按文档填入实际值。

多图、多音频的两种映射方式

接口接收数组时，使用上例的整项变量 "{{imageUrls}}"、"{{audioUrls}}"。接口使用编号字段时，逐项填写 "ref_image_0": "{{imageUrls.0}}"、"ref_image_1": "{{imageUrls.1}}" 等，直到覆盖允许输入的数量；音频同理。这里的数组下标从 0 开始。

未提供的编号变量会省略该字段。传入多张图却只映射 .0，会提示“未映射全部参考素材”；应补全数组或编号映射，而不是把几张 URL 拼成一个普通字符串。自定义参数整项替换会保留数字、布尔或字符串类型，seed 未填写且无默认值时可省略。

13.8 · 从 AutoDL H3 模板开始

在工作流 API 连接点击添加 AutoDL H3 模板，可得到“H3 多图多音频生视频（升级画质）”的起步配置。模板的地址、参数和映射均可编辑；使用前仍需确认所用平台部署的是对应工作流。

H3 模板中的多张图片是按顺序提供的参考素材，不自动赋予视频首帧/尾帧的专属语义。旧版固定 H3 配置仍可使用；在新连接中编辑并保存后，以新版参数定义为准。

云工作流：从底部入口调整参数

选择 RunningHub 云工作流或通用工作流 API 后，在节点输入框底部点击参数入口，打开浮层。比例按真实枚举多列选择，分辨率与时长按声明范围或离散选项使用滑块；调度器使用下拉，其他字段按实际类型编辑。主提示词和参考素材仍在节点输入框中填写，浮层不重复提供正文。

修改后关闭重开并核对当前值；需要清除覆盖时使用恢复默认。完整参数原值会保留，显示缩写不改变请求值。工作流没有提供的比例或能力不能从界面补造；生成期间参数只读，遇到缺少必填素材应先修复再提交。

13.9 · 断线、停止等待与结果保存失败

关闭 AI Canvas 会停止本地等待，平台已提交的任务可能继续运行。重新打开后回到原项目核对恢复记录和结果。ComfyUI 图片、视频和音频任务在取得任务 ID 后，只有文件保存并成功回填对应节点才清理恢复记录；取回或保存失败时，按节点显示的暂停原因处理，再点重试或继续查询 / 保存。正在保存同一结果时不重复续取；切项目或节点已变化时，旧结果不会写回错误目标。任务按原服务续查，没有收到提交 ID 时不应把重新生成当作恢复。

13.10 · 可选参考、时长与实时进度

ComfyUI 工作流中的图片、视频或音频输入如果确实是可选项，未提供素材时可以留空；提交前会绕过能够确认的空可选分支。必填连接、无法识别的结构和独立输出仍保留，不能靠留空来跳过必填条件。遇到校验错误时，检查节点是否缺失、文件输入是否有效，以及实际必填关系。

视频节点没有设置秒数或旧帧数时，ComfyUI 路径默认显示并提交 5 秒；已有旧帧数按帧率换算。实际工作流能否接受该时长还取决于节点声明的参数范围，修改后应核对服务端执行结果。

生成中可查看经过时间、当前执行节点和可用的采样进度。百分比表示当前执行节点的进度，不是整条工作流的总进度；切换执行节点后可能重置。当前节点达到 100% 后仍可能编码、保存和下载，只有媒体结果实际回到画布才算完成。实时进度连接不可用时仍可依靠任务查询判断状态，已有任务按 13.9 继续查询。

13.11 · AuK / Qwen3 语音工作流

在工作流管理查看内置语音工作流，按 13.1 绑定已准备好的 ComfyUI 服务器，再在生成音频节点中选择。内置模板不会自动安装节点、下载模型或启动 ComfyUI。缺少工作流所需节点或模型时，先在目标服务器解决依赖，再执行生成。

1. 选择匹配任务的工作流，正文只写要生成的新台词。
2. 克隆或参考路径通过角色主声音、@ 声音引用、连线或显式音频输入提供样本。先试听确认，避免多个不同样本来源混淆；工作流显式音频输入优先。
3. 打开节点下方的语音参数。AuK 在纯文本状态显示声音类型；有参考时以参考音色为准，并支持添加、替换、移除参考。语速通过描述引导，不能当作精确倍速。
4. Qwen3 按所选工作流显示原声克隆 · 参数、声音抽卡 · 参数或参考音频抽卡 · 参数。先设置语言、参考或声音描述、固定 / 抽卡模式；高级采样与模型运行选项可先保持默认。
5. 先生成一小段并试听，检查漏字、截断、发音与音色，再按段落继续。生成完成后保存实际音频，用于 视频剪辑或角色库。

AuK 的生成时长与 Qwen3 的生成长度上限不是同一个参数。Qwen3 不提供精确生成秒数，token 上限过低可能截断台词；01 克隆不显示无效的描述式语速，02 用声音描述引导语速，03 的最终时长还受转换参数影响。切换 Qwen3 工作流会保留各自参数；恢复此工作流默认参数仅清除当前工作流的覆盖设置。

只有包含可识别语音节点与连接的工作流才显示专用参数面板。面板没出现时先核对所选工作流与实际结构，不要将其他厂商的音色 ID、语速倍率或秒数参数照搬进来。工作流提交后按 13.9 处理查询或保存失败。

14 · 资源库、文件夹与创作资产

先分清素材属于哪个项目、是否引用外部目录，再浏览、预览或放回画布。人物、场景、道具和角色资料在同一章说明；整部剧的分集共用创作资产和项目角色，切集时可继续引用。

14.1 · 资源库入口、页签与资产侧栏

启动页的进入资源库打开整页浏览；画布内通过资产入口打开资产管理大面板，或按 Tab 打开 / 收起左侧资产库。它们提供同一套资源入口，展示范围由当前页签决定。输入框获得焦点时，Tab 仍用于正常输入导航。

在全局资产 → 添加选择添加文件或添加文件夹；在画布中也可上传文件或拖入素材。按 Alt + Space 搜索项目、全局及已添加外部目录中的素材；备用快捷键是 Ctrl + Shift + Space。全局资产中的人物、场景、道具是创作资料分类，导入文件与外部文件夹仍按真实文件浏览；人物沿用全局角色库资料。

文件排序与最近使用

在文件列表标题旁选择名称、创建时间、修改时间、文件大小或最近使用，再切换升序 / 降序。默认名称升序，数字按自然顺序排列；选择最近使用时默认降序。偏好随应用配置保存，筛选后的完整结果先排序再分页。

没有时间或使用记录的文件排在末尾，缺少创建时间不会借用修改时间。预览或成功拖入素材后更新最近使用；播放预览期间暂缓重排，关闭后再刷新顺序。扫描目录、取消拖拽和导入失败不算成功使用，不会补造以前丢失的使用历史。

左侧资产库：查找、定位与连线

1. 按 Tab 打开左侧资产库。每次从画布打开默认跟随当前项目；项目文件可另选范围，节点列表始终是当前画布。
2. 切到所需页签后搜索。项目文件按文件名、标签或类型筛选；节点列表按名称、类型或编号查找。列表较长时继续向下滚动加载。
3. 在节点卡片点击查看节点定位到画布；左侧面板保持打开，大面板则关闭后定位。节点卡片直接展示图片、视频封面、文字摘要或音频播放器。
4. 从卡片的输出端口拖到目标画布节点输入端口，或从卡片输入端口连接已有上游输出端口。也可落在目标节点对应的左右半区；检查实际连线方向与端口类型。
5. 松开后生成正常画布连线，可以撤销/重做。重复连接、自连接和同方向端口连接会被拒绝；拖到空白处不会自动新建节点。笔记等没有对应端口的卡片不能强行连线。
6. 按 Esc 或点击收起按钮关闭。拖线时按 Esc 会先取消当前拖线。

视频缩略图、完整预览与播放控件

列表中的视频先显示静态封面。资源库和启动页最近使用中的视频可打开完整预览，查看画面、提示词、保留的生成参数、视频尺寸与时长；部分引用入口使用悬浮播放。播放时列表位置保持不变，预览不会修改原视频。

1. 点击封面或播放入口。若浏览器阻止自动播放，点击播放器中的点击播放。
2. 完整预览底部可暂停、拖动进度、调节音量与静音；播放速度支持 0.25×–2×，时间菜单可切换已播放或剩余时间。
3. 需要复用文字时点击复制提示词；未关联生成记录的外部视频可能显示暂无生成信息，不影响实际播放。
4. 按 Esc 或点击关闭按钮退出预览。播放器的全屏按钮取决于当前窗口支持，出现“此窗口暂不支持播放器全屏”时可继续使用当前预览。

同一入口切换视频、项目、页签或筛选时会收起旧预览。封面加载失败和视频文件无法播放要分别排查：先尝试播放或重试，再检查原文件与本机编解码支持。

14.2 · 创作资产：从剧本提取人物、场景和道具

截图中“项目文件 44、创作资产 0”表示已经有素材文件，但尚未建立人物、场景和道具资料。上传剧本文件、生成一张图片或打开面板，都不会自动完成资产提取。

1. 在文本节点中准备需要分析的剧本内容，并选好可用文本模型。
2. 输入 /，选择提取人物、提取场景或提取道具，按指令要求提供文章内容并执行。三类分别提取；这是实际文本模型调用，可能计费。
3. 成功解析后，结果会整理成简介表并合并到创作资产。返回资产管理 → 创作资产，用“全部 / 人物 / 场景 / 道具”筛选，再搜索名称或简介。
4. 检查角色是否重复、场景名称是否一致、重要道具有无遗漏。点击卡片编辑，修正名称、简介、外形/视觉要点和剧情功能，点保存。
5. 需要更多人物资料时，点击打开角色库继续编辑该人物。创作资产里的本项目人物和角色库里的本项目角色是同一套资料。

跨项目复用人物、场景与道具

1. 进入资源库 → 全局资产，在左侧选择人物、场景或道具，新建资料并填写名称、简介和视觉要点。普通文件夹不会自动按名称归类。
2. 上传图片，或从已有文件的菜单创建 / 加入全局创作资产。人物可继续管理参考图、声音和动作；场景与道具可在参考图中管理多张图片、标注角度或时段，并选择主图。
3. 点击人物卡片主体打开该人物，声音或动作按钮进入对应资料。关闭子界面后回到原资源库，保留分类和浏览位置。
4. 在图像、视频等提示词输入 @ → 引用资产，切到全局范围并选择分类；人物有多图、声音或动作，或场景 / 道具有多图时，继续选择具体素材。引用弹框用于选择，管理仍回资源库操作。

全局创作资产可跨项目使用，与同名项目资产保持独立；全局人物沿用原角色记录，场景和道具新增独立存储。全局主图保存为受管素材，不依赖原项目节点；删除卡片保留共用媒体文件。项目创作资产仍按项目 / 剧集共享范围管理，不能把两种作用域混用。

创作资产多选、搜索与排序

1. 打开资产管理 → 创作资产，或在全局资产左侧选择人物、场景、道具。用名称、简介或设定关键词查找；人物别名、声音与动作说明，场景时段、道具类别，以及参考图标题也参与搜索。可用空格组合多个关键词。
2. 在创作资产工具栏选择名称、创建时间或更新时间并切换升序 / 降序。这里整理的是卡片；普通文件仍使用文件排序。
3. 点击多选，勾选需要的卡片，或全选当前筛选结果。核对“已选 N 项”后选择导出所选、复制到全局或复制到本项目。切换搜索或分类后，隐藏的条目会移出选择，操作前重新核对数量。
4. 复制会创建独立资产，之后修改不双向同步；从全局复制到本项目时，绑定媒体会一并固化到项目素材目录。跨项目复制前先打开并保存目标项目；批量中断时，以提示中的已成功数量为准。

创作资产包：导出、预览与选择导入

.aicassets 用于迁移人物、场景、道具及其绑定媒体；.aicanvas 用于迁移整个项目。资产包不包含画布布局、分集剧本、对话、应用配置或整份外部文件夹，也不携带原项目节点链接、远端人像绑定和模型凭据。

1. 在项目创作资产工具栏点击导出，导出本项目 / 剧集的全部创作资产；全局分类中的导出只包含该分类。顶部导出不受搜索限制，需要部分条目时先多选并使用导出所选。卡片上的导出图标只导出当前一项。
2. 选择保存位置。默认文件名以项目、分类或资产名称加-资产结尾，并使用 .aicassets 扩展名；后缀文字随界面语言变化。包中包含所选条目的参考图、角色声音和动作媒体。媒体缺失时会指出对应资产及素材项，先修复后重试。
3. 在目标项目创作资产，或全局人物 / 场景 / 道具分类点击导入，选择资产包。先在预览中核对分类、条目、媒体数量和体积，再勾选需要的内容并点击导入所选资产；取消预览不会添加资产。
4. 同名提示仅帮助核对，不会覆盖原条目。导入生成新的资产和子素材身份，只复制所选条目实际关联的媒体；导入全局时按包内类型分别加入人物、场景、道具。
5. 完成后使用查看本次导入核对新增卡片，必要时切到其他分类；检查图片、声音和动作，关闭后重新打开确认已保存。点击显示全部资产恢复列表。

场景与道具：不同角度、时段与细节

1. 在场景或道具卡片点击参考图，通过上传参考图添加图片，或在选择画布图片后点击添加图片。旧版单主图会作为已有参考图保留。
2. 为每张图填写标题，例如“白天正面”“夜晚侧面”或“材质细节”，按需要填写说明；点击设为主图选择卡片默认展示图，再保存。每个场景或道具最多保存32张参考图。
3. 在图像或视频节点的 @ 资产中找到卡片，有多张图时继续选择具体一张；助手输入中的场景 / 道具图片也可按单张选择。人物仍使用角色库已有的多图、声音和动作入口。
4. 改变主图不会替换之前已明确选择的单图。移除参考图需确认，原文件仍保留，但指向该图的精确引用会失效；生成前恢复该图或重新选择引用，不会自动改用另一张主图。

项目参考图可跟随已绑定画布节点的生成结果更新；全局参考图保存自己的受管媒体，不依赖原项目节点。资产包导入导出和 MCP 绑定沿用相同的单图身份。

查看使用位置，删除前核对影响

1. 在普通文件右键菜单选择查看使用位置，或在创作资产卡片点击使用位置。
2. 等待扫描当前画布与已保存项目、创作资产、生成历史、对话、助手任务和剪辑工程等使用位置。结果按实际文件身份或资产引用匹配，不按同名猜测；带定位节点的结果可打开目标项目并定位。
3. 删除前核对结果。确认时会重新读取使用位置，发生变化需再次核对；读取失败不会当作“未使用”继续删除，也可取消扫描后稍后重试。

删除创作资产卡片只移除卡片资料，绑定媒体保留，但已有资产引用可能失效；删除实际文件会影响依赖它的图片、声音或视频。系统回收站恢复文件后仍应重新检查引用；没有扫描到使用位置不代表外部软件没有使用该文件。

素材失效：重新选择文件或文件夹

1. 先检查磁盘、网络目录与访问权限。权限错误不会被当作文件已丢失；未登记过的文件请重新导入。
2. 在资源库文件列表使用修复失效素材查看已登记的失效项，或在文件菜单选择重新定位文件。移动了整个外部目录时，使用外部文件夹标题右侧的重新定位按钮；登记了多个根目录时先选择目标目录。
3. 明确选择原文件或移动后的目录。目录方式先按原相对路径寻找；核对类型、大小和可用的内容摘要。缺少已有摘要时，候选只能显示元数据匹配，需要逐项确认，不按同名自动重连。
4. 检查候选状态，勾选已确认的项并点击确认重连所选素材。可使用选择内容摘要一致项选择已确认摘要的候选；身份冲突、文件变化或无法读取的项不会直接提交。
5. 修复成功后重新预览文件，并打开相关项目核对画布、参考图、声音和动作。受管素材需要时会复制到合适目录，用户选择的原件保留；修复不会自动把不相同的内容当作原素材。

处理时可以取消，已经成功保存的修复以完成提示为准。一次最多处理500项，较大的资源库按目录分批修复。

确认缺失后，清理失效记录

1. 在修复失效素材窗口切到清理失效记录。只有本次扫描确认文件缺失的项可勾选，权限错误、冲突或未扫描项不能当作缺失处理。
2. 勾选要清理的项，点击清理所选失效素材，先审阅使用位置与关联信息。提交前会再次核对文件仍缺失、索引及位置未变；文件已恢复或状态有冲突时不继续清理。
3. 明确确认后，检查清理结果与保留项目。相关索引、资产专属提示词 / 标签 / 参考图关联、最近使用及对应输出历史会一并移除；仍需要的素材应选择重连而不是清理。

14.3 · 先生成参考图，再绑回资产

人物、场景与道具的单图和多图引用胶囊使用一致的展示样式；具体素材仍按明确选择的引用身份解析，不因显示样式统一而替换引用内容。

1. 创建或打开一个图像生成节点，在提示词中输入 @，切到资产，选择目标人物、场景或道具。
2. 尚未绑图时，引用会提供该条资产的简介。继续输入 / 选择适用的人设参考或场景参考等指令，也可以直接写清所需的定妆图、环境图或道具特写。
3. 检查项目画风、模型、比例和提示词，执行生图。先确认图中的人物、空间或道具符合设定。
4. 返回创作资产，在对应卡片点击绑图，从当前画布中选择已经有图片的节点。检查缩略图和“已绑图”标记。
5. 之后在其他生成节点里再次 @ 这条资产，就可以使用绑定的图像参考。生成前仍需确认模型支持参考图，且自定义接口或工作流已正确映射图片输入。

“绑图”记录参考关系，不会替你生成新图。绑定节点重新生成后，资产参考会跟随更新；需要保留已确认造型时，先保留那一版图片，再把资产绑定到保存该版本的节点。

14.4 · 角色库：新建档案与跨项目复用

1. 点击左侧角色库图标，或在创作资产中点击打开角色库。
2. 先选本项目或全局资产。只用于当前作品的角色放本项目；需要跨项目复用的角色可放全局。
3. 点击右上角或空白区的新建角色。填写角色名称，再补充身份、故事定位、简介、外观特征、性格、默认服装和声音特征。至少需要角色名称；可以先保存纯文字档案，之后补图。
4. 需要参考图时点击添加图片，可多选。选中每张图，设置图片用途并记录图片提示词；最后点击保存角色。
5. 保存后从底部角色列表切换角色，用顶部搜索查找名称、身份或简介。已有角色点击编辑角色修改后再次保存。
6. 选中本项目角色后，可点击复制到全局资产；选中全局角色后可复制到本项目。复制得到独立角色副本，之后的修改不会双向同步。

需要在当前项目的节点中 @ 一个全局角色时，先复制到本项目，再从节点的资产列表选择。全局角色复制会携带已保存的参考图、声音和动作资料；完成后应核对目标范围里的素材能否预览。

已有画布图片，直接收进角色库

1. 在已有图片的画布节点上右键，选择添加到角色库。
2. 选择形象参考，再选保存范围，以及新建角色或已有角色。设置图片用途和图片提示词。
3. 检查添加后隐藏画布节点是否符合需要，再点添加到角色库。隐藏是收纳显示状态，图片仍可在角色库中使用。
4. 需要回到画布时，在角色库选中参考图，点击显示并定位节点、定位画布节点或添加到画布；按钮会随当前是否已有对应节点而变化。

14.5 · 多视角参考图、头像与角色声音

角色编辑弹窗中的参考图和声音各最多添加 16 份，超过时按提示处理。参考图应尽量保持同一人物的外观一致；多图拼接会缩小单张细节，特写镜头可优先选择最合适的单张。

保存角色声音并用于配音

1. 在编辑角色 → 角色声音点击上传音频，补充名称、用途等信息，试听后保存。也可以直接在角色库中点击绑定画布音频节点，选择已有音频结果。
2. 为多个样本按用途区分音色参考、台词样本、情绪演绎等，需要时点击设为主音色。文字“声音特征”只是描述，真实声音样本需要单独上传或绑定。
3. 点击用这个声音生成台词，软件会创建配音节点，并把声音连线作为音色参考。接着填写台词，选择支持相应声音输入的模型，再执行生成。

创建配音节点不会直接得到配音成品。是否支持声音参考、音色复用或克隆，以所选音频模型的能力为准；先试听一条结果再批量使用。

展开、试听和引用已有角色声音

1. 角色库中的声音列表默认收起。选中角色后，点击下方工具栏的展开角色声音图标；换角色或重新打开角色库时，需要再次展开。
2. 在声音条目点击试听，确认样本内容，再按需要设为主音色。收起列表或关闭面板会停止试听。
3. 在音频节点的 @ 资产列表中选择有声音的角色，插入角色声音引用；适用的参考语音工作流还提供角色主声音下拉，可先试听再选。下拉中的显式选择优先于 @ 或连线参考，清空后才恢复使用其他参考来源。
4. 参考样本决定声音来源，节点正文填写这一次要朗读的新台词。不要把样本录音中的旧台词当作新文案，也不要把“声音特征”文字当作已经上传的音频。
5. 在支持参考音频的视频节点中，用角色旁的声音入口选择具体片段；卡片的试听按钮只试听，不插入引用。需要该角色的画面时再引用其图片，并明确写出谁说什么。

引用会保留已选声音片段；后来更换角色主音色不会自动把旧引用换掉。片段已删除或失效时，重新选择有效声音。视频请求会整理角色图片和声音的对应关系，但实际外观、音色与口型效果仍取决于所选模型，不能由引用成功推定。

画布声音节点在哪里

声音条目在当前画布有来源节点时提供显示 / 隐藏操作。隐藏后可从角色库恢复，恢复显示后再定位；定位会有短暂聚焦动画。直接上传的音频可能没有画布来源节点，因此不一定有定位入口。解除声音关联时，没有其他角色库关联的隐藏来源节点会恢复显示；移除关联不等于删除磁盘音频。

14.6 · 角色动作库：保存动作说明与演示素材

动作库附属于具体角色。先在角色库建立并选中角色，再点击角色动作库按钮。截图中的“主角”是当前角色名；“0 个动作”表示还没有保存动作条目。

1. 核对顶部角色名称，也可以在动作列表上方的角色下拉框切换。需要换“本项目 / 全局资产”范围时，先回角色库切换范围。
2. 在右侧“添加动作”中选择动作类别。可选站立、行走、奔跑、跳跃、坐姿、蹲伏、躺卧、攀爬、游泳、攻击、防御、受击、死亡、施法、互动、舞蹈、表情动作或自定义；自定义时填写分类名。
3. 填写动作名称，例如“警戒站姿”。在动作提示词中描述姿势、重心、手部动作、运动方向与节奏。
4. 点击添加多份图片、GIF 或视频，选择演示素材并检查预览。不需要演示素材时也可以先保存名称和动作说明。
5. 点击底部添加到动作库，看到“动作已添加”并在左侧出现卡片后才算完成。仅选好文件、仍显示在右侧待添加区时，动作条目还没有保存。
6. 用左侧筛选 → 全部类别或具体类别查看动作。一个动作可包含多份不同视角、速度或阶段的演示，不必每次都建新条目。

双脚与肩同宽，左脚略向前，重心压低。
上身微微前倾，右手保持警戒，左手护住躯干。
头部先向右观察，再缓慢转回正前方；动作克制，保持人物外观一致。

给已保存的动作继续补素材

• 上传图片 / GIF / 视频：在该动作卡片内选择本机文件，可一次添加多份。常用支持格式为 PNG、JPG/JPEG、WebP、AVIF、GIF、MP4、WebM、MOV、M4V；视频能否播放还取决于编码。
• 从画布添加：在动作卡片中打开选择器，选当前画布已有图片、GIF 或视频结果的节点。同一节点已经加入该动作时，会提示已添加。
• 从节点直接收纳：在支持的图片/GIF/视频节点中打开“添加到角色库”，切到动作素材，选择已有角色，再选新建动作或追加到已有动作并保存。没有角色时，先回角色库建立档案。
• 预览与移除：视频卡片可以播放；媒体右上角的 × 移除单份演示，动作标题旁的垃圾桶删除整个动作条目及其媒体关联。这两类移除直接生效，操作前核对对象。

从画布收纳素材后，怎样找回节点

“从画布添加”和节点的“添加到角色库 → 动作素材”都提供添加后隐藏画布节点，默认勾选。保存动作素材后，来源节点会收起；在动作缩略图右下角点击显示画布节点 / 在画布中隐藏切换。

按钮提示“没有唯一对应的画布节点”时，当前画布没有可确认的唯一来源，不能直接切换显隐。移除动作素材、动作或角色后，没有其他角色库关联的隐藏节点会恢复显示；原媒体文件不会因此自动删除。

在生成提示词里 @ 指定动作素材

1. 先在本项目角色中保存动作和图片、GIF 或视频素材。全局角色需要先复制到本项目，才能从当前项目资产引用。
2. 打开生成节点，在提示词输入 @，切到资产并选择角色。即使角色没有主视觉，只要有动作，也能进入选择。
3. 点击角色名称旁的动作入口，先选动作，再选具体的一份图片、GIF 或视频。一个动作的多份素材需要按实际用途分别选择，不会一次附带整个动作库。
4. 补充动作说明、角色外观和镜头要求，再检查模型支持的参考类型。图片和 GIF 使用参考图通道；动作视频需使用支持参考视频的生成模型，并符合时长和数量限制。
5. 检查引用标签后生成。提示“动作素材引用已失效”时，回角色库确认该素材仍存在，再重新选择；软件不会自动改用主视觉代替丢失的动作。

动作引用使用入库时保存的素材，来源节点隐藏、删除或重新生成不会自动替换已选动作；更新动作参考时，应把新结果重新加入动作库再选择。动作文字说明仍需按镜头需要写进提示词，不能仅靠素材标签传达全部要求。

14.7 · 保存、共享与常见问题

创作资产删除和“清空本类”会请求确认，清空应先核对当前类别。本项目人物在创作资产和角色库中共享资料，删除会影响两处；剧集各分集也共用这些角色。全局角色删除会影响以后从全局复用，但已复制到项目的独立角色不会一起删除。需要保留内容时先做好项目与素材备份。

14.8 · 用 / 调用快捷指令和 Skill

图片、视频、文本和音频提示词框提供同一 / 入口。长按节点工具栏进入自定义后，右侧始终显示快捷指令栏；点击管理快捷指令可打开当前类型的分类，新建或修改后保存，返回即可添加到工具栏。管理弹窗操作保留布局草稿；添加后可排序或移除，再点完成保存布局。无可用指令或全部已添加时显示对应提示，各类型指令独立管理。

在节点提示词中输入 /，或点击对应按钮，选择内置指令、自定义指令或 Skill。进入管理快捷指令可设置模板、模型和尺寸；高级模式可定义参数、多步骤和执行方式。

原图参考、依赖并发与 JSON 分享

1. 编辑高级快捷指令时，逐步设置参考来源：选择原始输入（触发节点）让多个步骤共用同一份原图，或选择上一步结果形成连续处理链；第一步始终使用触发节点。
2. 选择顺序执行，或按依赖并发。并发最多同时执行 3 步；依赖上一步结果的步骤会等待前一步成功。失败后停止启动新步骤，已开始的步骤完成收尾，已有结果保留，不自动重投模型调用。
3. 在管理器中编辑好当前指令后，点击复制 JSON或导出 JSON分享当前草稿。复制或导出不等于保存原指令，仍需按需保存自己的编辑。
4. 接收方点击导入 JSON，粘贴内容或选择文件，核对后保存为独立新指令。重复导入生成新副本，不覆盖已有指令，也不会自动运行；错误或保存失败时保留输入供修正。
5. 运行前检查模型、工作流、参考素材与预期调用次数。JSON 不携带 API Key、素材文件或工作流文件，名称 / ID 引用需要接收方自行配置；预览配置不代表已经生成。

上传 Skill 文件或压缩包

1. 在节点或助手输入框的 / 菜单选择上传 Skill 文件；文件夹使用上传 Skill 文件夹。
2. 桌面版可选择 .md / .txt / .json，也支持 .zip / .tar.gz / .tgz 压缩包。应用读取 Skill 入口和文本参考资料，不会执行其中的脚本。
3. 导入后在 Skill 菜单或管理窗口核对名称和内容，再引用到提示词。入口缺失、路径不合法或超出限制时应整理包内容后重试；导入不改变助手权限或审批规则。

14.9 · 全局资产：添加文件、引用目录与逐层浏览

以下本地文件操作在桌面版使用。添加文件会复制到应用管理的“导入文件”；添加文件夹只登记外部目录，文件仍在原位置。先按用途选择，再整理内容。

1. 进入全局资产 → 添加。只想收纳几份素材时选添加文件；已有整理好的素材目录时选添加文件夹。
2. 在文件夹导航中选择全部资产、导入文件或某个外部目录。窄侧栏中的导航收在文件夹按钮里；展开目录箭头可进入子层级。
3. 选中具体目录后，列表显示本层文件；子文件夹需另行选择。“导入文件”显示导入根目录本层，“全部资产”用于汇总查看。
4. 在当前范围按名称、标签或类型筛选。切换文件夹会清除类型和标签筛选，搜索词仍需按需要清空。
5. 需要新目录时，右键具体文件夹或“导入文件”，选择新建子文件夹，输入名称并创建。名称已存在或目录不可写时，按提示修改。

外部文件夹旁的移除文件夹引用只取消登记，保留磁盘文件。目录离线时先检查移动硬盘、网络位置或访问权限；出现已达到扫描上限时，可单独添加需要的子文件夹继续浏览。

14.10 · 复制文件夹、拖入文件与移动图片

文件夹粘贴读取的是系统剪贴板中的文件夹；单个文件卡片的“复制”和这里的目录“粘贴”用途不同。拖入目录前，确认落点有高亮反馈；全部资产是汇总视图，不是存放目录。

复制、导入或移动时查看进度，完成后核对目标目录与原有引用。取消或失败可能留下已完成的副本；先检查源文件、目标文件和提示，再决定是否重试。应用之外保存的路径引用仍需自行检查。

14.11 · 右键文件操作、删除与系统回收站

1. 在资源库或启动页最近使用中右键文件卡片；也可先聚焦卡片，再按 Shift + F10 打开菜单。
2. 选择复制取得文件，选择复制提示词取得已保存的文字；无提示词时按提示检查生成信息。用打开文件所在目录到系统中确认原文件位置。
3. 需要删除时选择删除，核对确认窗口的文件名，再点击移入回收站。这会移走磁盘原文件，可能影响画布、分集或外部应用的引用。
4. 误删时到系统回收站恢复文件，尽量恢复到原位置，再回应用重新打开资源库并检查预览。提示词、参考图关联和生成历史会保留，但它们不能替代原媒体。

文件离线、当前环境不支持或操作正在进行时，文件菜单项可能不可用。删除失败时先检查文件占用与权限，确认原文件仍在，再重试。

14.12 · 图片预览：提示词、参考图与生成参数

1. 点击资源库或最近使用中的图片，打开图片与生成信息。双击图片缩放，拖动查看局部；列表中有多张图时，用上一张 / 下一张或 ← / → 切换。
2. 在右侧查看提示词、可解析的引用标签与参考图。点击参考缩略图可查看，使用返回原图回到当前成果。已失效的引用需要回到实际素材核对。
3. 查看保留的模型、供应商、生成时间和参数，以及实际图片尺寸与文件大小。外部导入图片没有历史记录时，不会凭图片推断原始模型或提示词。
4. 需要复用文字时点复制提示词。桌面版中，可用编辑提示词与参考图补充素材说明或添加本地参考图，修改后明确点击保存。
5. 等待保存成功再切图或关闭；取消编辑放弃本次草稿。出现未保存提示时，选择继续编辑或放弃；保存失败会保留草稿供处理。

编辑图片信息用于整理资料，不会重新生成或改变图片像素。参考图最多 16 张；添加参考图不是调用模型，也不等于已自动加入某个生成节点。真正创作时，仍需在节点中选择模型、引用所需素材并检查参数。

图片被外部程序替换后，旧信息可能不再适用。出现内容变化、信息冲突或读取失败时，先核对原图，再重新打开读取；不要仅凭旧提示词判断新文件的生成来源。

14.12.1 · 标签、改名与单张反推

图片信息编辑现在同时支持提示词、标签与参考图。在“编辑提示词与参考图”中输入标签后按 Enter 添加，点击标签的移除按钮可删掉当前草稿项，最后点击保存。标题旁的修改文件名会修改磁盘文件名，并同步引用该图片的画布节点标题和已保存项目；先保存或取消当前信息草稿，再确认新名称，完成后检查引用和预览。更新前已经出现名称不同步的图片，需要再次实际改名才会触发同步。

1. 在图片预览中点击反推提示词和标签。
2. 选择能够读取图片的文本模型，检查供应商与账号配置，再点击开始反推。这是一次真实文本模型调用，可能计费；仅能处理纯文本的模型不能完成识图。
3. 生成成功后，新内容会自动替换并保存提示词和标签，原有参考图保留。等待出现已保存后检查结果；需要调整时再进入编辑并保存。保存失败时保留结果草稿，先处理冲突或文件问题，再重试保存。

反推是在描述图片中可见的内容，不能恢复原始提示词、原始模型或随机种子。失败时先检查模型是否支持图像输入；生成信息读取失败时，先“重试读取”，再编辑。

14.13 · 资源库排错速查

14.14 · 批量反推提示词和标签

桌面版资源库的项目文件 / 全局资产提供批量反推。适合为一批本地图片补齐描述与分类；它处理当前文件夹或筛选结果中的图片，不包括视频，也不局限于屏幕上已经显示的缩略图。

1. 先选择正确项目或文件夹，使用分类、搜索和标签缩小范围，再点批量反推。弹窗固定这次筛选的图片清单，先核对总数。
2. 等待识别已有提示词。已有内容的图片标记已有提示词，默认不选中；只想补缺时保留默认选择。要重写旧内容时手动勾选；全选也会选中已有提示词的图片。
3. 选择能够读图的文本模型，将同时处理设为 3、4 或 5 张（默认 3）。账号限流时降低并发；每张图片都会调用模型，按当前供应商计费。
4. 点击生成并替换后查看逐项状态：待生成 → 正在反推 → 正在保存 → 已替换并保存。每张成功后立即替换并保存提示词和标签，不再弹出逐张保存确认。已有标签整组替换，不与新标签合并；参考图与原始图片保留。
5. 需要暂停处理时点停止。已保存结果保留，可在当前窗口继续处理剩余图片；失败项保留原内容，排查后点重试失败项。不会自动重复调用失败项。
6. 关闭窗口、离开资源库或切换项目 / 素材范围会停止当前队列，不会转成后台任务。重新打开前先检查已保存结果，再决定剩余范围；停止本地请求不表示服务商退款。

单张与批量反推都会在成功后自动保存提示词和标签；需要逐张检查结果时使用单张入口。找不到批量入口时先切到项目文件或全局资产，等待列表加载；没有可用本地图片、文件操作忙或非桌面环境时，按钮可能不可用。

15 · AI 助手与任务

1. 点击左侧AI 助手，选择可用的对话模型。
2. 描述你的目标，例如“整理这几个镜头的顺序，并指出缺少的画面”。先说清范围和期望输出。
3. 用 @n 引用节点、@a 引用资产、@m 引用模型；用 / 调用 Skill。引用能让助手更明确地使用指定材料。
4. 如果要生成图片、视频或音频，建议在本轮消息中显式引用目标媒体模型，并说明参考素材及参数。未指定时，协作模式会弹出模型选择确认卡；自主模式可使用项目默认模型，或在项目开启自动选择后挑选模型。配置方法见项目默认模型。
5. 选择合适模式后发送；在任务时间线查看步骤、处理确认或选择题，需要时暂停、继续或停止。

任务可在应用运行期间后台执行。关闭软件后不会继续运行；重启后未完成任务会处于暂停状态，需要检查后再恢复。切换画布时，可回到原项目的对话与任务中查看进展。

15.1 · 继续上次任务，或修改刚才的结果

1. 回到同一个项目、同一个会话，检查上一轮回复、任务时间线及实际节点。
2. 直接说明接下来要做什么，例如“继续刚才的镜头整理”“把刚才生成的三张图改为竖版”。多个结果容易混淆时，用 @n 引用目标节点，补充需要保留或修改的内容。
3. 执行中可以补充要求。助手会在后续轮次接收补充，不代表已经完成的付费请求能被撤回；查看时间线确认下一步采用了新要求。
4. 遇到回复长度上限或上下文暂停，先阅读保留下来的部分回复，再点击任务继续或发送明确的后续要求。部分文本不代表本轮工具已执行。

续聊会利用近期对话及同会话的工具结果摘要，保留节点、资产等引用。跨项目或新建会话时，请重新说明目标与材料。输入框旁的上下文占用是估算；接近上限时，较早内容会被压缩为摘要，原始历史不会因此删除。长任务仍受预算约束，暂停后应先检查原因。

继续刚才的分镜整理，先核对已完成的节点和缺少的素材。
保留已有成品，只补充仍未完成的部分。
涉及状态未确认的生成任务，先查询原任务和输出，确认后再决定是否重新生成。

15.2 · 内嵌助手、独立窗口和会话草稿

1. 在助手顶部点击独立窗口，把对话移到单独的桌面窗口；需要放回画布旁时点击收回内嵌。
2. 切换展示方式后，继续查看原会话、模式、模型和任务。切换窗口不会重新启动任务；保持主应用运行。
3. 切换会话后，各会话未发送的草稿会在当前运行期间分别保留。关窗或收回时会交接最后一次编辑，回到对应会话检查后再发送。
4. 如显示初始化或同步等待，等真实会话状态就绪；不要把尚未同步的空白视图认定为历史丢失。

会话列表、对话和任务中心视图可随展示方式切换。未发送草稿只保证当前运行期间的交接，不保证退出或重启后恢复；重要长文先保存到自己的文档。智能体安装和项目记忆等管理入口在主窗口使用。

给助手上传参考图

1. 先打开项目并选择普通会话，点击输入框旁的添加图片或文本附件按钮，选择 PNG、JPEG 或 WebP 图片；文本文件仍按会话授权读取。
2. 核对输入框中的附件缩略图，移除不需要的图片，再填写分析要求或直接发送图片。每条消息最多 6 张，单张最多 8 MB、总计最多 24 MB，每张图片最多 1600 万像素。
3. 支持看图的对话模型会接收图片；纯文本模型需要已配置的视觉描述模型。遇到参考图读取或视觉配置错误，应先修复附件或项目配置，不能把错误当作图片已发送。
4. 切换到独立窗口后检查同一会话的附件草稿；草稿仅在本次运行期间保留。图片已复制到项目文件，但不会自动创建画布图片节点。

15.3 · 安装智能体包，并使用 Skill

1. 在主窗口的助手顶部打开智能体中心。不安装任何包也可使用默认助手。
2. 点击选择文件夹链接本机包，或选择压缩包导入 .aicanvas-agent / .tgz / .tar.gz。文件夹保持只读链接，压缩包导入应用管理目录。
3. 先查看预检提醒、智能体大纲及 Skill 清单，确认来源和用途后安装 / 启用。上传预检不会执行包内脚本。
4. 在助手输入框输入 /，选择已启用包中的 Skill，再补充当前项目目标与素材。节点的提示词润色入口也可使用受支持的智能体。
5. 外部 MCP 客户端需要读取包内 Skill 时，按包开启MCP 只读；此开关允许列出、加载和读取 Skill，不授予执行包内脚本的能力。

Skill 提供操作知识和步骤，实际画布写入、文件操作或媒体生成仍遵循当前会话模式。智能体包与用户插件各有安装入口；不要把插件仓库地址填进智能体包导入。

15.4 · 项目记忆和只读子智能体

在主窗口助手顶部打开项目记忆，查看作品设定、偏好及来源。需要长期沿用时，明确让助手提议记忆并检查内容；规划模式不写入，协作模式确认后保存，自主模式可直接写入。关键设定变化后，请同步核对已有记忆。

在子智能体配置角色和允许读取的材料，再让父任务分配分析工作。子智能体只读，可辅助检查人物、剧情或镜头，不能直接写画布；父任务再根据结果及当前模式执行。每个父任务最多六个子任务，调用子智能体也可能产生模型费用。

15.5 · AI 应用节点：让助手制作画布小工具

在桌面版打开项目后，可以让内部 Agent 或外部 MCP 客户端创建一个带界面的小工具，用来筛选素材、整理文本、展示对比或计算清单。AI 可以定义界面、交互和可重复调用的动作；节点上会标明AI 应用 · 由 Agent / MCP 创建。这里的画布节点与 RunningHub 平台的 AI 应用分别使用各自入口。

1. 先在当前画布准备文本或图片素材，在助手消息中用 @n 引用要交给应用的实际节点，说明用途、界面、动作和需要保留的状态。
2. 选择协作或自主模式发送。规划模式只分析；协作模式的创建、更新与保存需要确认，自主模式和 MCP 会话按已开放权限直接执行。
3. 节点出现后，核对应用名称、版本、绑定素材数与动作数，点击打开应用。在应用内操作，或点击顶部无需必填参数的动作按钮，完成后展开结果摘要检查。
4. 动作标注需填写参数时，在应用内填写，或让 Agent / MCP 传入参数；顶部按钮不会替你猜测必填内容。
5. 需要保留本次筛选条件、编辑状态或结果时，等待动作完成，点击保存状态与结果，确认出现状态与结果已保存后再关闭。重新打开会从最近保存的状态开始。
6. 需要增加功能或更换绑定素材时，在助手中引用这个应用节点并说明修改要求。新代码先经过初始化校验；更新失败会保留旧版本。应用仍可像普通节点一样移动或删除，但不能复制为新实例。

请基于本条消息引用的素材创建一个 AI 应用节点，名称为“素材筛选器”。
只读取我引用的节点，提供名称关键词输入框、筛选按钮和素材清单。
提供可由 Agent / MCP 重复调用的筛选动作，返回匹配项的节点 ID 和名称。
把筛选条件放入应用状态，方便我点击“保存状态与结果”后下次继续使用。

应用能读取哪些材料

停止、重新加载与版本变化

动作执行中可点击停止。超时或无响应时应用会停止，运行与保存按钮变灰；检查提示后点击重试，从已保存状态重新加载。切换项目、更新代码、改变绑定素材，或在动作执行期间修改画布，都可能使旧会话失效；回到正确项目，核对节点和素材后再打开应用。重启不会继续上次在途动作。

保存和更新会纳入画布操作记录，可按操作记录撤销或还原。更新保留已保存状态，但首版不自动迁移不兼容的旧数据；若新界面无法使用旧状态，让助手核对当前版本并明确修复。迁移电脑时使用桌面项目包保留项目记录和应用定义。

16 · 分镜制作与 3D 导演台

用分镜表把剧本、画面、对白和时长关联起来，再准备各镜头的图片、视频与配音，最后推送剪辑时间轴。每一步都检查实际生成的内容，创建节点不等于媒体已经生成。

16.1 · 创建分镜表并核对镜头

1. 从剧本创作工作台 → 生成本集分镜开始。软件先保存当前集，再创建剧本来源快照和空表，打开文本模型生成弹窗。也可在画布按 Alt + 6 手动建表。
2. 检查当前分集、引用的剧本、文本模型和目标时长，点击生成。手动制作时使用加一镜；按需要用列控制显示字段。
3. 逐镜核对镜号、画面内容、对白、时长、景别、运镜等字段。AI 拆分只是初稿，尤其要核对人物关系、剧情顺序、镜头连续性和总时长。
4. 在镜头画面栏选择真实图片或视频节点。已有绑定需要调整时使用换画面；仅在描述中写一个文件名不会建立素材绑定。

一张表最多 200 镜。使用工作台创建的表会保留本集剧本快照，便于后续复核；手动创建或旧表没有明确来源时，不会自动猜测它对应哪一集。

画面与生成视频列统一固定为 96px，沿用相同的 16:9 预览，普通与全屏视图共用；这两列不能拖宽，旧媒体列宽设置也不再影响展示。镜号与时长仍为固定列；其他列可拖动表头或在列菜单中按比例调整。

16.2 · 为没有画面的镜头补图

1. 先写好有效的镜头描述，并按第 01 章确认项目画风、母图与生成参数。
2. 点击补齐空镜，选择图片模型，核对这批镜头数量。每批最多 12 镜，按顺序逐镜调用图片模型。
3. 开始后查看进度；完成的结果会保存为真实图片节点并绑定对应镜头。
4. 需要停止时点击取消补图。已经完成的图片保留；再次补图只处理仍未绑定画面的镜头。

16.3 · AI 诊断、单镜优化与改稿复核

这些按钮都先准备对话草稿，不会自动发送、重建整表或生成媒体。复核显示的是文本变化范围，不能代替语义判断；来源快照会持续保留，因此“剧本已修改”也不等于助手一定尚未处理过。确认修改后再检查表格和素材绑定。

16.4 · 准备配音、视频和导演台节点

新准备的视频使用指定镜头的稳定引用胶囊。每次生成时读取该镜的景别、运镜、画面与动作、对白、音效和时长，再解析其中的角色与素材引用；调整镜头顺序后仍指向原来的镜头。可以在胶囊外补充本次要求，手动设置视频时长时以实际参数为准。被引用镜头已删除或素材失效时应先修复，不会退回整张表生成。

1. 点击分镜表顶部或单镜行的镜头制作准备。
2. 勾选要处理的镜头，每次最多 12 镜，再选择配音节点、视频节点或导演台节点。
3. 应用会定位新建或已有的同类制作节点。分别检查内容，再选择模型、音色、参考素材或导演运行时。
4. 需要媒体时，在相应节点实际生成并试听/预览；需要 3D 构图时，再打开导演台编辑。

重复准备同镜头、同类型时优先复用已有节点，不覆盖人工修改；改完剧本后也应自己核对已有制作节点内容。同一镜头出现多个同类来源时，先在画布处理重复关系，再继续操作。

旧视频中的静态提示词不会自动变成稳定镜头引用。需要同步使用本镜内容时，以精确镜头胶囊替换旧复制正文，把人工附加要求保留在胶囊外，并检查模型参数和参考素材；修改提示词不会重新生成已有视频。

16.5 · 从宫格分镜裁出一张真实画面

1. 在同一画布准备已有图片的宫格分镜节点，核对分割方式与实际画面。它与记录镜头行的“分镜表”是不同节点。
2. 打开目标镜头的画面选择器，点击从宫格取画面。
3. 选择宫格节点，以及“第几行、第几列”的位置。均分网格、自定义分割线和已有单格覆盖图按当前宫格设置处理。
4. 点击裁片并绑定镜头。已有画面时按钮为裁片并替换画面，先核对替换对象。
5. 检查新图片节点和分镜缩略图。原宫格与原画面节点保留，当前镜头绑定改为裁出的图片。

已经提取为空且没有覆盖图的格子不能再次裁切；分割线无效时先修正宫格。失败或取消不会用整张宫格冒充单格结果，其他镜头不会被批量替换。

生成视频列：确认每镜成片

分镜表的画面用于制作参考，常驻的生成视频列独立保存该镜的成片。按稳定镜头来源生成的视频成功后回填对应行，也可在这一列手动选择或拖入已经就绪的视频，播放、更换或解除绑定。手动改绑或解绑后，在途旧任务不会覆盖你的决定。

升级不会把旧“画面”里的图片或视频自动迁成成片。旧表需要逐镜检查，把确认的就绪视频绑定到“生成视频”列；素材名称相同或只有参考画面都不等于已经完成这一镜。

16.6 · 只用成片推送时间轴

1. 检查镜头顺序、时长和生成视频列，只将已就绪的真实视频作为成片。缺片镜头会跳过；全部缺片时不创建或覆盖剪辑工程。
2. 需要对白文字时勾选附带对白字幕；需要声音时先完成配音，再勾选附带已就绪配音。字幕和配音都跟随本次实际采用的成片镜头序列。
3. 点击推送时间轴。若分镜或素材在等待期间发生变化，回表格核对后重新推送。桌面与 MCP 入口采用同样的成片选择规则。
4. 进入独立剪辑窗口，播放并检查对白、配音与镜头切换，再调整字幕、音量和片段边界，按第 05 章导出成片。

16.7 · 从 3D 构图得到参考画面

1. 创建3D 导演台节点，也可在画布操作状态按 7，或从“镜头制作准备”建立。
2. 选择可用运行时。使用 Blender 时，在设置 → 文件与应用 → Blender检测安装；存在多个版本时手动选择应用。Windows 选择 blender.exe；包含 macOS 安装检测更新的版本可选择 Blender.app。
3. 双击节点或点击打开导演台 / 打开 Blender，等待实际场景与摄影机就绪，再摆放场景和调整镜头。
4. 回到节点点击同步当前帧，确认有效参考画面已经回填且可预览。
5. 把参考画面交给图像或视频生成节点，继续设置风格、动作与镜头变化。

当前 Blender 兼容范围包含 4.5、5.0、5.1、5.2 系列的稳定版本；是否可用以应用检测结果为准。检测到安装路径不等于启动校验已通过，预览版或不支持的版本需按提示处理。安装选择可在本机保留，启动前仍会重新检查。

导出参考视频取决于运行时能力与状态。Blender 窗口关闭或进程退出不表示结果已经成功保存；仍需检查 AI Canvas 是否收到当前摄影机画面。没有活动摄影机、渲染失败或结果不完整时，根据具体错误修正后再同步。首次缺少运行时则按应用提示安装或下载。

16.8 · 逐镜工作台：检查物料与批量生成视频

画布存在镜头组、视频生成节点或已保存的视频批次时，底部会出现逐镜工作台。它处理已有视频节点，不自动把剧本拆成镜头；需要制作节点时先按 16.4 准备。

1. 选择生成范围：本集镜头、选中镜头组，或待生成 / 失败项。需要整理镜头组时选择 1–4 列并点击统一布局。
2. 点击检查物料或生成本集视频，先打开检查表。核对提示词、模型 / 工作流、引用素材和生成时长；点击镜头名称可定位节点。
3. 修复缺项后重新检查。ComfyUI 会探测在线状态，其他接口的鉴权和可用性在提交时验证；预检通过不代表生成或画面质量已验收。
4. 检查已有结果与待更新项。只有确实需要重做时，才勾选已有结果也重新生成，并保留旧版本。
5. 点击生成就绪镜头开始付费提交。按镜号串行执行，每镜使用自己的参数；在查看队列检查完成数量、状态和错误。
6. 失败项先定位节点排错，再用重试失败项重新预检；待核对项先核对平台原任务与输出，确认需要重新提交后再处理。

16.9 · 用文字生成 AI 镜头预演

1. 在 3D 导演台节点选择AI 镜头预演，打开预演编辑器。
2. 选择文本模型，在场景与运镜描述填写空间、人物走位、摄影机起止、焦距和时长。例：人物穿过走廊，摄影机从背后跟拍，最后绕到正面，8 秒，35mm 起步，结尾 50mm 中近景。
3. 需要参考图片或完整分镜表时，按 @ 或点击素材引用。仅连线不会发送材料；图片最多六张，需使用支持视觉输入的文本模型。
4. 点击生成镜头预演，已有场景时为按描述修改预演。这一步调用文本模型，可能计费；生成并保存后检查空间、角色与运动方向。
5. 在镜头 / 空间 / 俯视之间切换，播放时间轴查看轨迹。可调整片长、画幅、速度、焦距和摄影机关键帧；当前片长支持 1–60 秒。
6. 手动调整后点击保存镜头调整。保存完成后使用同步当前镜头或导出参考视频，回到导演节点检查图片 / 视频成果。

场景保存后，节点可自动生成起始摄影机截图；在编辑器停到目标时间再同步，可取得该时刻画面。输出使用摄影机视角，空间视图的轨迹与摄影机辅助标记不会进入成果。浏览器模式可查看和调整示例，模型生成、项目保存及节点输出需要桌面版。

17 · 插件与 MCP 控制

安装与管理插件

在设置 → 插件查看市场，或填写 GitHub 仓库地址后点击从仓库安装。安装前核对名称、版本、说明和权限。安装后可启用、停用、更新或卸载；插件入口可能出现在节点右键菜单、浮动工具栏或节点选择器。

Python 插件作为可信本机代码运行，具有当前用户权限。只安装信任的来源，并按原生确认窗口审核。遇到按钮缺失，先确认插件启用状态以及它适用的节点类型。

已安装插件卡片的地址、权限等信息收在详细信息里，点击展开查看。节点右键菜单的插件操作集中在插件工具 → 具体工具二级菜单中；鼠标移入或点击即可展开。支持多语言的插件可跟随宿主语言切换，具体翻译内容仍由插件提供。

支持相应能力的插件可以把当前画面或本地线稿作为参考，调用已配置的图像模型并生成画布节点。实际入口与输入要求以该插件说明为准；先核对目标模型、当前画面和返回结果，不是所有插件都会提供此功能。

视频复刻：指定角色与恢复任务

1. 先将 AI Canvas 升级到 0.10.13 或更高版本，再在插件设置安装或更新视频复刻 0.2.1，核对来源、权限与原生确认，并准备插件所需运行环境。
2. 从源视频节点的插件工具入口打开视频复刻。把目标角色图导入画布或资产库，在替换角色中用 @ 选择该图，再填写角色、场景与风格要求。只写文件名不会建立图片引用；多视图设定图按同一个角色使用。
3. 选择支持相应参考素材的视频模型、可选视觉分析模型及控制类型，核对时间轴切点、声音选项、比例和分辨率，确认后点击一键复刻。分析会把关键帧拼成带时间标注的联系表，并同时读取替换参考图：目标角色的面容、发型、服装依据用户图，原片提供动作、构图和运镜。
4. 查看分段与最终成片，确认角色外观、镜头顺序和声音符合要求。新任务只创建控制视频、音频、生成片段与完整成片，按段排列；旧任务已经创建的节点不会自动删除。

只关闭插件面板或独立窗口时，主应用可在后台继续任务；从同一项目的同一源视频节点重新打开，恢复本轮表单和进度，不会重复提交。已确认失败或停止后可点击重新开始，重新选择引用、检查设置，再明确启动新任务。已提交状态不确定或暂停时先查询任务状态并核对已有片段，不自动重投；退出整个应用后仅恢复任务摘要并暂停或待核对，不自动续跑。真实角色替换效果、模型费用与运行环境仍需用户检查实际结果。

让外部工具通过 MCP 操作 AI Canvas

1. 打开设置 → MCP 控制，默认显示排在前面的外部控制本应用；助手连接外部服务在另一页签。默认页签不代表自动启动会话，仍需手动开启，或明确配置自动开启。
2. 同一电脑上的客户端优先使用stdio，复制应用生成的配置到支持 MCP 的客户端。按该客户端要求完成配置。
3. 保持 AI Canvas 主应用运行。会话重启、端口或令牌变化后，重新复制当前配置，必要时重连客户端。
4. 先让外部工具读取项目或列出画布内容，确认连接到正确项目，再给出具体的编辑任务。

远程 Streamable HTTP 是另一种传输，开启前需要确认。它当前是明文 HTTP，只用于受信网络或隔离环境；令牌鉴权不等于传输加密。同机接入无需为了使用 MCP 而改成远程传输。

按需发现工具

在 MCP 设置的工具发现方式中，默认使用按需加载。客户端先通过 tools_search 查找能力，必要时用 tools_describe 读取完整参数，再由 tools_call 调用；后续可以复用已经取得的参数说明。需要完整列表时可切换模式，并在客户端刷新或重连；目录支持分页，客户端取得下一页游标时应继续读取，不要把首屏当作全部工具。工具简介保持紧凑，复杂参数按需查看；切换列表或翻页不会改变工具权限。

创建、修改和调用 AI 应用

连接后先确认当前项目，按需搜索“AI 应用”或 canvas_app 并读取工具参数。内部 Agent 与 MCP 共用以下能力；普通使用步骤见15.5 · AI 应用节点。

无界面调用从最近保存的应用状态启动，不共享用户当前打开界面里的临时筛选条件或编辑内容。动作使用与可见界面相同的隔离环境，只能读取绑定材料，最多运行 10 秒，不自动重试。保持主应用和目标项目打开；切换项目、改变相关内容或取消后，旧结果可能被拒绝。MCP 客户端断开不影响已经保存的节点，下次连接后先查询实际版本与结果再继续。

让 MCP 导入图片、媒体或界面截图

上传绑定当前项目和 MCP 会话，空闲 10 分钟会失效；完成的 uploadId 在成功导入后消费一次。可以查询上传状态或取消，再根据实际返回继续。未授权目录需要先完成授权；上传或导入期间切换项目、修改相关画布或取消，可能使本次回填失效。

用 MCP 组装、导出和检查视频

1. 先用 video_media_probe 核对当前项目素材节点的真实参数，再用 video_editor_list / video_editor_get 查看已有工程，避免重复创建。
2. 需要新工程时，使用 video_editor_create 从有结果的图片/视频节点或分镜表建立时间轴。创建工程不打开窗口，也不代表已经导出成片。
3. 用 video_editor_update 编辑，携带读取到的 expectedVersion。提交 tracks 时是完整替换轨道清单，不能把局部片段误当成完整清单。修改前先读最新工程。
4. 关闭人工剪辑窗口后，用 video_editor_export 后台合成 MP4。每次新导出使用唯一 requestKey；收到 jobId 后，用 video_editor_export_status 查询直到成功、失败或取消。导出期间保持当前项目与工程稳定。
5. 成功后核对返回的视频节点。需要停止时用 video_editor_export_cancel 并继续查询状态；需验片时，用 video_media_extract_frames 按 1–6 个递增时间点读取实际画面。

上述剪辑控制入口目前供MCP 会话使用，支持最多 300 秒、8 轨、120 片段、1080p 等像素面积和 60 fps；它不是人工编辑器全部功能的等价控制接口。导出任务状态仅在当前应用会话内保留，重启后先查看实际工程和成片节点，不把未知状态当成已完成。抽帧可以检查画面，不能代替听取配音、音乐与最终成片审阅。

用 MCP 读写 AI 镜头预演

让客户端先取得 director_get_previs_schema 的场景合同与示例，再创建或查询导演节点、选择 AI 镜头预演运行时，通过 director_set_previs_scene 写入场景 JSON；用 director_get_previs_scene 读回核对。这里只接收受限的结构化场景，不接收或执行外部 JavaScript。直接写入场景不会额外调用应用内文本模型，截图和参考视频仍需核对实际成果。

连线按上游在左、下游在右整理：素材输出连接生成节点输入；分镜制作使用“分镜表 → 导演台”和“镜头说明 → 导演台”。工具返回的布局提醒用于检查，不会自动移动节点。多图视频的参考顺序应在提示词中明确引用，仅连线不能指定 Picture 顺序。

18 · 保存、备份与迁移

自动保存与手动保存

画布修改会自动保存，也可按 Ctrl + S 手动保存。剧本创作工作台中的编辑请使用保存本集或在工作台内按 Ctrl + S；全剧剧本编辑弹窗也需单独点击保存。出现保存失败提示时，检查磁盘空间和存储状态，尽快手动保存或导出备份。自动保存不能替代长期备份。

导出和导入项目包

1. 在桌面版项目库打开项目卡片菜单，选择导出项目包，保存为 .aicanvas 文件。取消选择保存位置会直接结束；后台整理失败或繁忙时，按提示稍后重试。
2. 普通项目包包含项目记录、对话、项目记忆和本地素材目录；剧集或分集入口会导出所属剧集及全部分集、各自对话与记忆，以及共享素材。运行中的 Agent 任务不作为可继续运行的任务一起迁移。
3. 在目标桌面应用的项目库点击导入，选择项目包。导入会生成独立项目副本，不覆盖原项目。
4. 打开导入项目，逐集抽查图片、视频、音频和对话；重新配置目标电脑的 API Key、ComfyUI 地址及外部软件路径。

项目包之外还需要备份什么

全局资产和外部文件夹不等于当前项目素材目录。项目包不要当作整个资源库的备份；“最近使用”也只是一组入口。人物、场景和道具可另存为.aicassets 创作资产包，包含选中卡片及其绑定媒体；普通全局文件、外部目录和应用配置仍需另外备份。更换电脑后重新添加外部文件夹，并检查图片信息、角色参考与实际画布引用。单纯取消文件夹登记不会搬走原文件。

0.10.15 升级：先备份，再升级数据库

0.10.15 将本地数据库从 v22 升至 v23，新增全局场景 / 道具资料存储，人物继续使用原全局角色记录。升级前导出重要项目包，另外备份全局创作资料、受管素材、外部目录和需要保留的配置；项目包不包含整个全局资源库。

已升级的数据库不能直接交给 schema v22 的旧安装包打开。需要回退时使用升级前备份和兼容的恢复方案，不降低数据库版本、不清库。升级后先检查旧项目、全局人物、新场景 / 道具及素材引用，再继续制作。

文件目录、外部软件与存储健康

在设置 → 文件与应用配置文件根目录，以及 Photoshop、剪映专业版、Premiere Pro 等外部应用；配置后，本地媒体节点右键会提供适用入口。移动电脑或更换安装位置后，需要重新核对这些路径。

进入设置 → 存储健康，先查看扫描时间及结果。项目文件占用包含素材与回收站；应用数据配额是浏览器内核管理的数据额度，不是磁盘总容量，清理素材文件不会直接释放这部分配额。

1. 点击重新扫描，按概览、回收站、未引用文件、重复文件与不可用目录核对；扫描未完成时，只显示已读取范围，暂不提供清理。
2. 在未引用文件中先点打开所在位置检查文件。没有应用内引用不代表没有其他用途，不要只凭分类就删除。
3. 清理前审阅确认窗口中的项目、文件和预计空间；执行前会重新核对引用，仍被引用或无法确认的文件保留，完成后查看实际清理结果与未清理项。

切换界面语言，保留用户内容

1. 进入设置 → 常规，选择简体中文、English、日本語或한국어，检查设置、项目栏、素材库与助手中的菜单和筛选标签更新；等待设置保存完成。
2. 有编辑草稿时切换语言，界面标签随之更新，项目、文件、角色名称，提示词、对白、消息正文和已有草稿保持原内容。重新打开应用后核对保存的语言选择。
3. 外部插件自行绘制的界面、模型或原生运行时的详细诊断及终端输出可能保留来源语言；切换语言不会重命名已有资料，也不代表这些原始文本已被翻译。

设置未保存、冲突或凭据读取失败

正常加载完成、没有未保存内容或错误时，设置页不常驻“已加载 / 已保存”提示条。修改后出现有未保存的设置或正在保存设置…时，等待保存结束；出现错误按下表处理。

自定义工具栏也有独立的加载和保存保护：加载失败时先重试读取，保存冲突时按提示重新加载该类型。项目备份和凭据存储分开，项目包不能代替 API Key 迁移。项目中的 .thumbnail 是可重建的显示缓存，不作为媒体源文件或项目归档内容。

19 · 快捷键速查

19.1 · 节点提示词与模型选择

在设置 → 快捷键选择节点提示词的发送方式：Enter、Shift+Enter、Ctrl+Enter或Alt+Enter；也可右键发送按钮修改。使用 Enter 发送时，Shift+Enter 换行；使用组合键发送时，Enter 换行。输入框底部会显示当前提示。

点击模型名称重新选择模型，点击右侧×清除当前节点选择；清除后生成前需重新选择。输入 @ 可按人物、场景、道具等分类查看完整素材列表，缩略图随滚动按需加载。音频、视频和文本引用使用对应图标。

按住引用胶囊拖动，可调整它在提示词中的位置，也可插入文字之间或移到其他行。按住 Ctrl 或 Alt 拖动并松开鼠标，会在目标位置复制一份，原胶囊保留；拖动时显示插入线。按 Esc、移出输入框后松开或窗口失焦会取消操作。工作流值区仍支持正常选择文字，拖动其前缀可移动整枚胶囊。

在 Mac 中，引用胶囊后继续输入或恢复光标时，插入点保持在可编辑的正文区域；工作流胶囊内部的值区仍可独立编辑。此修复不改变引用内容、拖动与复制的规则。

AI 润色：单独选择文本模型与参考要求

放大节点编辑器后，点击发送按钮旁的AI 润色。面板默认带入助手文本模型，也可独立选择另一个已配置文本模型；这次选择不改节点生成模型或助手默认模型。润色要求可用 @ 引用节点与资产，先核对素材，再开始润色。

引用候选中 Enter 用于选择，Ctrl + Enter 开始润色。先查看完整预览，再点击应用；原文、项目或画布已变化时应重新核对，不能把旧结果覆盖回去。关闭会停止本地等待并保留原文，应用后的撤销仍受后续编辑状态保护。

双击引用胶囊查看完整内容

在节点提示词、分镜字段、角色库、资源详情或助手中，双击引用胶囊打开完整内容；只读区域聚焦胶囊后也可按 Enter。预览可显示文本、Markdown、图片、多图、对应宫格裁片、视频、音频和指定镜头，右侧按实际来源展示节点编号、镜头、模型参数或素材尺寸。打开预览不会生成媒体，也不修改节点内容。

预览正文中的引用可以继续打开，用返回按钮或 Esc 回到上一项，点击关闭按钮退出整个预览。失效或已删除的引用会说明原因，不会改为其他素材；切换项目会取消旧读取。悬浮小卡片仍用于快速查看，胶囊拖动和单击定位沿用原有操作。

在 Win10 上，如果 WebView 无法复制图片，会改用系统文件剪贴板；目标应用需要支持粘贴文件，具体粘贴形式由目标应用决定。

以下为 Windows 常用快捷键。创建节点的数字键在画布操作状态使用；输入提示词时正常输入文字。分镜表快捷键为 Alt + 6；其他快捷键也可在设置 → 快捷键查看。

20 · 常见问题

自定义接口的 401、404、轮询不结束和结果提取失败，请查看第 12 章排错表。

21 · 使用前检查单

勾选框用于本次阅读自查，不会修改应用配置或保存到软件。

整理或迁移素材前

首次生成前

工作流执行与分镜装配前

自定义接口保存前

视频批次与预演输出前

22 · 外观主题与预设

外观背景支持本地图片及 SVG，可随完整主题预设导入导出，并同步到应用其他窗口。背景资源使用应用管理的本地副本；导入后仍需核对大图显示、深浅主题及独立窗口，保存前先确认目标预设。

打开设置 → 外观，统一调整软件配色、画布、节点、连接线、连接手柄和动效。旧的“常规 → 画布背景”入口已由外观页接管；本说明书的明暗切换只改变阅读页面，不修改软件设置。

1. 先选深色、浅色或跟随系统，也可选太阳系、磨砂暖光等内置完整预设。跟随系统会随系统明暗偏好调整。
2. 按需修改主题色、页面 / 窗口 / 卡片 / 悬浮层配色，或选择纯色、图片等画布背景。节点圆角、边框、连线及手柄各有独立控件。
3. 等待设置保存完成，实际打开画布和常用窗口检查文字、连线与控件是否清晰。遇到保存失败或冲突，按设置保存说明处理。
4. 需要反复使用时，填写名称并点击保存预设。已保存的自定义预设名称可双击，或聚焦后按 Enter / F2 改名。
5. 需要把当前调整写回原自定义预设时，点击覆盖当前预设并核对确认提示；内置预设不可覆盖。普通调整不会自动改写已保存预设。

调整界面布局、底色与毛玻璃

1. 进入设置 → 外观 → 界面布局与底色，在预览中选择项目栏、左侧工具栏、绘图工具栏或画布控制区域。
2. 按需调整区域布局与背景关联；关联时沿用所属层的底色，取消关联后可单独调整。返回画布核对常用入口的位置。
3. 调整背景透明度和毛玻璃模糊，模糊设为 0 可关闭毛玻璃。透明度只影响背景，文字和图标保持清晰。
4. 分别检查深色、浅色背景下的可读性及独立窗口。需要复用时保存外观预设；要恢复原样，可重新选择内置预设或导入此前导出的主题。

背景图片调整与内部组件配色

在设置 → 外观 → 画布背景 → 图片上传图片后，可调整透明度、模糊、亮度、对比度、饱和度、九种定位、底色及蒙版颜色 / 强度。恢复图片调整恢复这些效果，保留原图与铺放方式；图片层的效果不会模糊节点、网格与连线。

在内部组件配色调整组件底色、悬浮、输入框和边框。输入框可跟随默认配色、使用自定义色或透明；分别检查深色、浅色和跟随系统模式的文字与选中状态。参数随完整外观保存、复制和导入导出，旧预设补齐中性默认。

导入、导出与恢复外观

点击导出保存当前完整外观为 .aicanvas-theme 文件，在另一份应用中使用导入并核对主题。它包含外观快照，不是项目包或 API 配置；需要恢复配色时可以重新选择内置深色 / 浅色预设。删除自定义预设前可先导出留档，删除需确认。

主窗口、独立聊天、素材搜索、视频编辑器和样式预览窗口沿用统一外观。项目的创作画风管理模型生成要求，软件的外观主题管理界面显示，两者分别配置。图片背景和手柄调整后，尤其要检查浅色主题中的文字、边框和连线对比度。

项目资产云同步与云端清理

在设置 → 存储健康 → 项目云同步 · S3 连接配置 HTTPS Endpoint、Region、Bucket 和访问凭据，再到资源库 → 项目文件／创作资产 → 项目共享创建或加入共享项目并完成能力校验。凭据保存在本机专用存储，不随项目导出。

1. 各成员配置自己的连接与凭据，使用同一共享码加入共享项目。
2. 点击立即同步，先核对上传、下载、更新及冲突预览，再确认应用。同步包括项目图片、视频、音频、标签、已保存图片提示词，以及人物、场景、道具及关联媒体。
3. 另一成员在自己的项目中预览并下载。当前仅支持手动同步，不共享全局资产，不包含画布正文实时协作、自动监听或删除传播。

清空与删除只处理云端

项目共享设置底部提供清空共享资产库和删除共享资产库。先让所有成员停止同步，预览当前共享项目的对象数量和大小，再输入项目名称确认。清空保留云端项目描述；删除共享库最后移除该描述。本地文件、资料、索引、待办和绑定都保留，不会自动重新上传。

执行显示已确认删除数；取消、失败或网络回执不明确后，应重新预览剩余对象。已删除内容不能自动回滚；开启版本控制的 Bucket 可能继续保留历史版本，本操作不清除这些历史版本或未知未完成分片。后续同步仍由成员手动发起并核对。

万象 API 分组连接

在厂商连接中按万象 API 分组分别保存连接与密钥，并选择已适配的文本、图片或视频模型。旧连接和已提交任务继续保留原身份；内置目录不表示账号权限、额度或真实调用已验证。

说明书范围与版本

本说明书面向 0.10.18「项目资产云同步与万象分组」，2026-10-27 按源码增量核对项目资产手动共享、仅云端清空与删除、万象 API 分组及桌面媒体修复。此前能力、旧锚点和截图继续保留。当前版本正在发布准备中，安装包是否已公开，以对应 GitHub Release为准；截图用于辨认位置，不代表所有按钮与最新界面完全一致。

发版门禁及实际结果记录在0.10.18 发布计划，旧版本门禁不作为本轮通过证据。当前数据库为 v26；升级前备份项目与应用数据，安装旧程序不能直接回退已升级的数据。真实 S3 读写与清理、模型调用、各平台安装升级和双客户端交互仍需按发布计划验收。

0.10.18「项目资产云同步与万象分组」范围与兼容提示

• 项目云同步为手动双向，按已绑定的共享项目范围操作；全局资产、自动同步和删除传播暂未启用。
• 云端清理只处理当前共享项目的 RustFS／S3 对象，本地素材和资料保留；操作前所有成员须暂停同步，先查看数量与大小并确认名称。
• 万象 API 分组具有独立连接和密钥；模型是否可用取决于账号权限、额度及接口实际能力。
• 资源库提前加载附近图片并保留滚回时的内容高度；ComfyUI 统一桌面原生媒体取件；参考角色复用项目与全局角色选择框，MCP 可分块读取节点媒体原文件。
• 修复引用胶囊前退格带来的换行问题，以及 Windows 软件内更新前本地推理进程残留占用主程序的问题。
• 数据库为 v26。升级前导出重要项目并备份应用数据；不清库、不强降版本，兼容说明继续沿用备份与回退限制。

0.10.17「图片无损压缩与画布修复」范围与兼容提示

• 图片无损压缩仅为确实变小的 PNG / JPEG 创建独立副本，保留原图，不保证每张图片都能进一步减小。
• 存储健康的文件清理会永久删除磁盘文件；失效记录清理则保留文件。两类操作都应先审阅影响，不能混用。
• 分镜画面与生成视频列固定同宽，旧媒体列宽不再生效；其他列的比例设置与素材绑定继续保留。
• Mac 引用输入与项目缩略图修复不扩大系统解码、素材访问或模型权限；缩略图失败时保留旧预览。
• 数据库仍为 v23，从更早版本升级继续遵守备份与回退限制。包是否已公开及完整门禁结果以发布计划和 Release 为准。

0.10.16「素材复用与多厂商生成」范围与兼容提示

• 创作资产包与项目包分别管理；资产包只迁移所选条目及关联媒体，不覆盖同名卡片，也不搬迁模型凭据或原项目节点链接。
• 场景与道具的旧单主图保持兼容。精确引用按单图身份解析，删除该图后必须重新选择，不能用另一张主图冒充原引用。
• 使用位置读取失败不等于未使用；失效重连需明确核对文件或目录。失效记录清理不可撤销，会删除关联信息和对应输出历史，但不删除磁盘文件、画布节点或对话正文。
• LibAPI 预置 67 种已适配型号，不自动启用，不证明账号权限或余额有效；可选拉取以当前真实目录更新。普通 TTS / 音乐不支持即传素材克隆，MiniMax / 豆包需填写已有音色 ID。
• 视频切换型号保留已有比例和兼容参数；输入模式及所选渠道的能力仍须核对。快捷指令导入只新增独立配置，不搬迁模型凭据或引用文件，也不会自行运行。
• 界面支持简体中文、English、日本語和한국어；用户内容和外部来源原文保留原值。MCP 工具目录分页不改变调用权限与确认策略。
• 数据库继续使用 v23，未因本版素材管理功能新增 schema 升级；从更早版本升级仍须遵守0.10.15 的备份与旧版回退限制。

0.10.15 增量范围与兼容提示

• 数据库新增全局场景 / 道具存储并升级到 v23。升级前备份项目和全局资料；已升级数据库不能直接由 v22 旧版打开，不清库或强降版本。
• 图片质量与背景按准确厂商及型号提供，未声明时不发送；透明输出受格式约束，切模型保留比例后仍需核对支持范围。
• 有真实任务身份的异步图片、视频和音频可继续查询 / 保存；未知提交先核对平台，恢复不等于重新生成。
• 分镜“画面”与“生成视频”分别管理。旧参考画面不会自动迁为成片；时间轴只用成片列的就绪视频，跳过缺片，全部缺片时不覆盖工程。
• 即梦新增目录兜底不自动勾选模型，OAuth 登录也不改变已有选择。样片和样片转高清未接入，普通 480p 任务不是样片模式。
• 已有 RefMod、文件引用、自定义协议试跑及 ComfyUI 恢复边界继续适用。视频复刻插件 0.2.1 的最低宿主仍为 0.10.13，无需随宿主强制升版；Windows Legacy 不含本地 ONNX 和自动更新，Mac 仅构建 Apple Silicon，历史 Intel 文件保留。

AI 应用节点当前为首版，只读绑定材料并保存自身状态；画布写入、结果节点及模型 / 文件编排仍待后续实现。已有 macOS 桌面核心验收记录，Windows / Linux 原生界面和真实外部 MCP 客户端联调仍待补充；本次说明书更新不扩大功能验收范围。

共十一张内嵌截图，均沿用此前构建，其中包含自定义视频协议 JSON 编辑器和批量反推窗口。相关截图只展示未保存的示例草稿与待执行队列，当时没有启动模型调用。截图用于位置与空状态示意；按钮可用性仍取决于资料、分集和模型配置。

内容依据当前版本的启动页、资源库、设置界面、应用帮助与相关操作实现核对。接口示例用于本地配置校验，未调用真实厂商接口；所有 example.com 地址与示例模型 ID 均为占位内容。按钮准备草稿、创建节点、实际模型生成和媒体保存是不同步骤，请按各章检查实际结果。

页面所需样式、脚本和十一张截图均在当前 HTML 内，无外部字体或 CDN 依赖。可直接双击离线打开；点击“返回软件首页”需同时保留 site 目录中的首页。打印按钮使用浏览器打印功能，可选择保存为 PDF。