comfyui-lucid-vrp：LuCiD VRP 可视化区域绘画节点，内置图层画布，支持 Anima/MOSS-Image 区域提示

LuCiD VRP（Visual Regional Painter）是一套专为 ComfyUI 设计的自定义节点集。它主要面向图生图（img2img）工作流，将图像加载、图层编辑、Anima 区域提示词以及 MOSS-Image 布局提示词整合到单一环境中。这一设计消除了用户在 ComfyUI 与外部图像编辑器之间频繁切换的繁琐步骤，提升了构图调整与提示词设置的连贯性。

核心功能解析

一体化图像加载节点：专为图生图设计，支持从空白 Latent（潜变量）开始，或直接载入现有图像。画布尺寸调整、蒙版编辑、撤销与重做，以及 Latent 编码，均可在同一个节点内完成。
LuCiD Canvas 轻量级编辑器：内置于 ComfyUI 的画布工具。支持导入现有图像或从空白画布起步，提供图层组合、绘画、擦除功能。其对象变换、扭曲和可还原的裁剪功能，允许用户在保留原始素材的前提下精细调整构图，并将结果直接应用到图像加载节点中。
可视化区域提示词工具：支持 Anima 区域提示词与 MOSS-Image 布局提示词。用户可直接在画布上绘制边界框（bbox）、拖动位置或调整大小，并为各个区域独立设置提示词。区域配置既可在单一节点内集中管理，也可拆分至独立的 VRP Region 节点中。修改布局后无需运行完整工作流即可即时预览效果。

模型兼容性说明：图像加载节点和 LuCiD Canvas 本身不依赖 Anima 或 MOSS-Image，可搭配其他图像模型使用。但 Latent 编码的兼容性仍取决于工作流中接入的 VAE（变分自编码器）。Anima 支持按区域设置条件；MOSS-Image 的支持目前处于试验阶段，依赖模型原生的 bbox 布局提示词。

安装与环境配置

正确的环境配置是工作流正常运行的前提，请严格按照以下步骤执行。

1. 前置要求

ComfyUI 版本：需使用经典（classic）节点界面。测试环境为 ComfyUI 0.42.0 + 前端 1.57.1。目前暂不支持 Nodes 2.0 界面。
Python 环境：Python 3.11 或更新版本。
模型依赖：
- 图生图 Latent 编码：需要与目标生成模型兼容的 VAE。
- Anima 区域提示词：需要 Anima 系列模型及兼容的文本编码器和 VAE（基础模型、微调版本、2.9B 微调版本均已测试）。若已有正常运行的 Anima 工作流，则无需额外准备。
- MOSS-Image 布局提示词：需要原生支持 MOSS-Image 的 ComfyUI 版本、MOSS-Image 模型权重、兼容的 Qwen 3.5 文本编码器，以及 Flux.2 VAE。（注：非官方 MOSS-Image 工作流和自定义节点尚未测试）。
早期版本兼容性：Anima 区域提示词、图像加载节点和 LuCiD Canvas 在 ComfyUI 0.32.0 + 前端 1.48.7，以及 0.37.0 + 前端 1.53.6 中测试通过，但这些旧版本不具备 MOSS-Image 原生支持。若需使用 MOSS 生成工作流，请务必更新 ComfyUI。

2. 安装步骤

图像加载节点和 LuCiD Canvas 不依赖额外的 Python 库。仅进行图像编辑而不做 Latent 编码时，也无需加载模型或 VAE。

方式 A：通过 ComfyUI Manager 安装（推荐）
打开 ComfyUI Manager，搜索 LuCiD Visual Regional Painter (或 lucid-vrp) 并点击安装。随后重启 ComfyUI 服务，并刷新浏览器页面。
方式 B：通过 Comfy CLI 安装
若已配置 Comfy CLI，可在终端运行：
```
comfy node install lucid-vrp
```
方式 C：源码安装（Git 或 ZIP）
将仓库克隆或解压至 ComfyUI 的 custom_nodes 目录。以 Windows PowerShell 为例：
```
cd "C:\path\to\ComfyUI\custom_nodes"
git clone https://github.com/EBEBEEBE/comfyui-lucid-vrp.git
```
目录结构校验：确保解压后 __init__.py 直接位于该文件夹根目录下。文件夹名称（如 comfyui-lucid-vrp-main）不影响使用，但层级必须正确。
注意：Windows 便携版（Portable）的 custom_nodes 目录通常位于内层的 ComfyUI 文件夹中，请确认路径无误。

安装完成后，重启 ComfyUI 并刷新浏览器。在节点添加菜单的 LuCiD VRP 分类下即可找到相关节点。

工作流配置指南

1. 基础图生图工作流配置

节点选择：若仅需通用的 IMAGE 和 MASK 输出，使用 VRP Standalone Image Loader；若需结合 Anima 或 MOSS-Image，请选择 VRP Canvas Image Loader。
图像导入与编辑：点击 Import 或拖拽文件载入现有图像/草图，或点击 Create blank 创建空白画布。点击 Edit canvas 打开 LuCiD Canvas 进行图层导入、绘制或变换调整，完成后点击 Apply 应用。
Latent 编码设置：连接与模型兼容的 VAE。将 Latent 模式设为 Auto、Encode 或 Encode (Tiled)。Auto 模式会对导入图像或已编辑的画布进行编码；对于未编辑的纯白空白画布，则直接输出 Empty Latent（空潜变量）。
采样器连接：将加载节点的 latent 输出连接至采样器的 latent_image 输入。根据需求调整 denoise（重绘幅度）：若使用空 Latent 或仅将导入图像作为构图参考，设为 1.0；若希望保留输入图像的原有特征，需设为小于 1.0 的数值。
注：仅使用图像和蒙版时，请将 Latent 模式设为 Off，无需连接 latent 输出。

2. MOSS-Image SFT 布局提示词工作流

准备一个可正常运行的 MOSS-Image SFT 生成工作流。
添加 VRP Canvas Image Loader（设为 Empty 模式创建空白画布）和 MOSS - Visual Regional Prompt 节点。
在画布上绘制边界框，或使用独立的 VRP Region 节点设置区域，将其连接至 MOSS 节点的 canvas 和 regions 输入。
为各区域填写正向提示词，并使用全局提示词描述整体场景。
连接兼容的 CLIP，将 MOSS 节点的 positive 和 negative 输出接至采样器，初始 Latent 使用 Canvas 加载节点的输出。

3. Anima 区域提示词工作流

Anima 的区域条件控制能引导构图，但无法保证 100% 的像素级精确控制，区域间特征可能存在相互影响。

图生图 + Anima 区域：在 VRP Canvas Image Loader 中载入或绘制草案，通过 LuCiD Canvas 调整构图并 Apply。连接兼容的 VAE（Latent 模式设为 Auto 或 Encode）。将加载节点的 canvas 和 latent 分别接入 Anima VRP 核心节点（Core）的对应输入。接入兼容的 CLIP 后，将 Core 输出的已打补丁模型、conditioning（条件）和 Latent 连接至采样器。保留初始图像影响需将 denoise 设为小于 1.0。
极简配置（仅内部区域）：使用空白画布，将 canvas 和 latent 连入 Core。直接在 Core 中绘制边界框，编辑名称、权重及正负面提示词。Core 将直接输出应用了区域补丁的模型、conditioning 和 Latent。
使用外部区域：为每个区域创建独立的 VRP Region 节点。可通过 bbox、原生 Mask Editor 或外部 MASK 输入指定区域。将 Region 节点串联（前一个节点的 regions 输出连接至下一个节点的 previous_regions 输入），末端节点的两路输出连接至 Core。外部区域可与 Core 内绘制的边界框叠加使用。

技术边界与已知限制

为保证客观评估与稳定使用，需明确当前版本的工程边界：

界面兼容性：仅支持 ComfyUI 的经典（classic）节点界面，目前不支持 Nodes 2.0。
区域控制精度：Anima 区域和 MOSS-Image 布局边界框可辅助控制构图，但不能保证元素 100% 出现在精确位置，指定像素也不一定会被原样保留。
MOSS-Image 实验性限制：输入蒙版会被转换为 bbox。不支持为各区域单独设置负向提示词（负向提示词仅全局生效），且区域权重目前仅支持整数。
功能缺失：当前版本暂不包含蒙版局部重绘（inpainting）、区域 LoRA 和内置 ControlNet 集成。如有此类需求，需配合其他专用节点或工作流使用。
注意力补丁冲突：Anima 的注意力补丁机制可能与修改相同注意力操作的其他 ComfyUI 扩展产生冲突。
素材保存机制：工作流文件（.json/.png）保存时，不会内嵌保存所有图像编辑素材。用户需自行保留工作流引用的原始图像、蒙版和 Canvas 图层文件，以便日后重新打开时恢复编辑内容和历史记录。