企业官网建设流程全解析

ComfyUI_VNCCS_Utils插件中的VNCCS UniCanvas，是 ComfyUI 里一个"无限画布"式的 AI 绘图与图像编辑工作台。它让你摆脱固定画框的限制：在画布的任意位置框选生成、对任意区域做局部重绘（inpaint）与扩图（outpaint），还能用图层自由组合画面。本文面向新手，带你从零理解并上手这套"任意位置生成、任意区域编辑"的工作流。

一、UniCanvas 是什么？无限画布 AI 绘图的新思路

传统 ComfyUI 出图流程是"定好宽高 → 整图生成"，想改一处往往要重新连线、重跑整张图。UniCanvas 把创作方式改成了"画布式"：

• 无限画布工作流：画布没有边界，把生成结果放到构图需要的任何位置；
• 区域即画布：选中一个区域（bbox），它就是本次生成的目标，支持文生图、图生图、局部重绘、扩图和全区域变换；
• 图层式编辑：由多个栅格图层和蒙版图层组成画面，可独立控制可见性、不透明度、位置与混合；
• 工具齐全：画笔、形状、SAM 智能选区、移动/缩放/旋转/透视变换、撤销重做、PSD 导入导出等，全部在节点内完成，不用来回连线。

简单说：你在哪里框，AI 就在哪里画；你涂了哪里，AI 就只改哪里。

📖 更完整的架构设计说明见 docs/UNICANVAS_DOCUMENTS.md

二、安装方法：两种最快配置路径

方式 1：ComfyUI Manager 一键安装（推荐）

1. 打开ComfyUI Manager；
2. 进入Custom Nodes Manager；
3. 搜索VNCCS Utils；
4. 点击Install；
5. 重启 ComfyUI。

方式 2：手动克隆安装

在终端中进入 ComfyUI 的custom_nodes目录执行：

cd ComfyUI/custom_nodes git clone https://gitcode.com/gh_mirrors/co/ComfyUI_VNCCS_Utils.git cd ComfyUI_VNCCS_Utils pip install -r requirements.txt

安装完成后重启 ComfyUI，即可在节点分类VNCCS下找到VNCCS UniCanvas节点。UniCanvas 的后端代码位于 nodes/unicanvas/，前端交互位于 web/vnccs_unicanvas.js。

三、核心概念：任意位置生成是如何实现的

理解 UniCanvas，只需要记住三个概念：

任意位置生成的本质：把 bbox 当作独立的小画布提交生成请求，结果按 bbox 位置落回画布，与画布其他内容互不干扰。任意区域编辑的本质：用蒙版精确圈定要改的像素，生成时只重绘蒙版区域，并自动把结果只贴回蒙版内（Crop-and-Stitch Inpaint）。

一次"任意位置生成"的完整步骤

1. 在画布空白处框选一个 bbox（位置、大小随意）；
2. 在模型面板选择生成引擎（内置预设或自定义模型）；
3. 在 Prompt 输入框写下画面描述；
4. 点击Generate，结果以新图层出现在 bbox 处；
5. 不满意？移动 bbox 换个位置再来一次，或接受结果继续叠加新图层。

💡 提示：生成期间画布处于锁定状态（进度与 Stop 按钮仍可用），这是为了避免并发编辑导致的状态错乱，详见 docs/UNICANVAS_DOCUMENTS.md 中的 Generation 锁定规则。

四、任意区域编辑：局部重绘、扩图与智能选区

1. 局部重绘（Inpaint）

想让画面"只改一处"，操作路径是：

• 用画笔工具在蒙版图层上涂抹要修改的区域（白色 = 修改区），或用SAM 对象选择一键圈出物体；
• 在 Prompt 中描述"把这里改成什么"；
• 生成后结果只贴回蒙版内，边缘自动融合，画布其余部分保持原样。

SAM 工具支持绿色"保留点"（Add）与红色"移除点"（Subtract），预览会精确描出蒙版边界，Apply 后还能一键撤销还原图层。

2. 向外扩图（Outpaint）

把 bbox 框得比原图更大、让边缘包含空白，即可让 AI 把画面自然延伸到画布之外——比如给半身像补全全身背景。扩图区域会以黑色作为编辑模型的上下文参考，并自动在提示词中追加扩图引导。

3. 画笔小工具：按住右键调参数

使用画笔时按住鼠标右键，会弹出四象限径向 HUD，拖动即可实时调整大小、不透明度、硬度、前景色，无需切回设置面板，非常适合新手快速上手。

五、图层编辑：把画面像拼图一样组装起来

UniCanvas 的图层能力让它不止是"生成器"，更是一个画布式合成台：

• 移动 / 缩放 / 旋转 / 自由变换：支持扭曲、透视、3D 倾斜、翻转，且不会提前"栅格化"破坏工作流；
• 混合模式与不透明度：各图层可独立调整合成方式；
• 自动图层命名：可为生成和导入的图层自动起描述性名字（可接本地文本/视觉模型生成更贴切的名称）；
• PSD 导入导出：Import PSD读取栅格图层（名称、可见性、不透明度、混合模式、叠放顺序）；Export Layers as PSD把当前图层栈写回 PSD 文件，方便在 Photoshop 中继续精修；
• 背景移除：支持编辑模型、BiRefNet、rembg、SAM 3 四种后端，一次可撤销操作即可完成抠图。

六、进阶玩法：在画布里直接摆 3D 姿势

UniCanvas 内置了实时 Pose Studio 图层：点击竖向工具栏上的小人图标，就能在当前生成框内插入一个 3D 人台（mannequin），进入姿势编辑会话，直接拖拽躯干、摆动手脚，再指定一个"角色参考图"，生成时模型会以姿势渲染图和场景参考图作为双参考，让生成的人物精确遵循你摆的姿势。

这是"任意位置生成"的强化版——你不光能决定生成在哪里，还能决定人物以什么姿势出现在那里。详细操作（编辑会话、角色参考、双图推理机制）见 docs/UNICANVAS_POSE_LAYERS.md。

七、常用模型与实用功能速查

UniCanvas 内置多种生成与编辑引擎，常见卡片包括：

• Qwen Edit 2.1：直连 ComfyUI 节点做生成与蒙版编辑，支持原生 LoRA 加载；
• Krea2 Identity Edit：基于 Qwen3-VL 的图内编辑，右上角Likeness滑块（0–10，默认 4）控制与参考图的相似度，改色、加物体、换属性都很顺手，详见 docs/UNICANVAS_KREA2_EDIT.md；
• 预设 + 自定义模型：可在引擎选择器中切换内置预设、自定义 Checkpoint 或 GGUF 文件，模型家族与推理模块的划分规则见 docs/UNICANVAS_MODEL_MODULES.md。

还有两个新手友好的小功能：

• ✨ 魔法棒提示词增强：Prompt 框右上角的魔法棒图标会用 Qwen3-VL 帮你把简短描述重写成完整提示词（Ctrl+Z 可还原），也可以开启"按 Generate 时自动增强"；
• 参考图：Steps 旁的叠卡图标可上传最多 4 张参考图，分别称为Picture 2、Picture 3……，提示词里可按名字引用它们（工作区域始终是Picture 1）。

八、360° 全景编辑与独立画布模式

全景模式（Panorama）

导入一张 360° 等距柱状全景图（宽长比约 2:1）后，画布会切换为"球面"模式：从一个方形透视窗口"环顾"全景，画笔、蒙版、SAM、生成等工具在窗口内正常操作，编辑会精确映射回球面坐标；导出时始终输出完整全景。详见 docs/UNICANVAS_PANORAMA.md。

独立侧边栏模式（Standalone）

在 ComfyUI 设置中开启VNCCS.UniCanvas.StandaloneSidebar后，Unicanvas侧边栏标签页可把 UniCanvas 当作一个独立图像应用使用——不建节点、不连工作流，进入时自动隐藏 ComfyUI 界面，作品保存在localStorage，刷新页面不丢失，Save to output可直接把合成结果写入output/目录。

九、新手常见问题（FAQ）

Q1：生成时为什么画布锁住了？生成请求的整个生命周期内（含请求准备阶段），画布编辑会被锁定，只有进度条和 Stop 可用。取消并等待请求结束后编辑才会恢复。

Q2：Krea2 Edit 报"空 bbox"错误怎么办？编辑类模型要求 bbox 内必须有内容。先把区域框在图像上，确保框内有像素再点生成。

Q3：想保留画面某部分不变，怎么做？用画笔/SAM 只把需要修改的部分涂成蒙版白色，未蒙版区域会自动锚定在原图上（编辑模型走 masked-latent 路径），结果也只贴回蒙版内。

Q4：作品会被存到哪里？每张画布有稳定的canvas_id，图层、蒙版、姿势、生成设置等持久化在服务端状态缓存中；未接受的生成结果只是临时暂存，不会被写入文档。

写在最后

VNCCS UniCanvas 把"AI 在任意位置生成、任意区域编辑"这件复杂的事，收敛成了三个直觉动作：框哪里、涂哪里、写什么。配合图层合成、3D 姿势层、全景模式和 PSD 往返能力，它很适合用来做自由创作与迭代式修图。下一步建议：先用画笔 + SAM 完成一次局部重绘，再试试在空白处框一个 bbox 直接生成——两分钟后，你就会明白"无限画布 AI 绘图"的爽点所在。