closerAI-flux3-image-helper

套件负责编辑界面、提示词和位置数据组装、参考图编码与局部合成。实际生成仍使用 ComfyUI 的 FLUX3 图像模型、文本编码器、VAE 和采样节点。

1. 更新 ComfyUI

   使用包含 FLUX3、Flux3LayoutPrompt 和 ReferenceMultiLatent 支持的版本。套件不自动下载生成模型。

2. 放入套件文件夹

   解压后确保 __init__.py 直接位于下列目录中，避免多套一层同名文件夹。

ComfyUI/
└─ custom_nodes/
   └─ flux3-image-helper/
      ├─ __init__.py
      ├─ nodes.py
      ├─ prompt_enhancer.py
      ├─ reference_conditioning.py
      ├─ requirements.txt
      └─ web/

用 ComfyUI 实际使用的 Python 安装依赖。在便携版根目录执行以下命令；启动器整合包请使用其对应 Python 路径。

.python_embededpython.exe -m pip install -r .ComfyUIcustom_nodeslux3-image-helper
equirements.txt

重启 ComfyUI，再按 Ctrl + F5 刷新浏览器。节点搜索输入 flux3、closerAI 或 区域编辑。

需要准备的模型

模型来源：BFL 官方 ComfyUI 模型仓库 ↗。INT8 支持 8GB 级显卡不代表任意分辨率、多图和全组件同时驻显存都能运行。

1. 选择「文生图」模式

   使用空白画布，不上传主图。节点内部保留的白色占位图只供预览，不是生成参考图。

2. 设置画布尺寸

   手动填写宽高，或点击「显示输入」，将尺寸 / 分辨率节点的 INT 输出接到 canvas_width、canvas_height。外接值优先，也可只接一项。尺寸须为 64–4096 的 16 倍数；计算型节点运行后同步预览。

3. 拖动画框并填写主体

   在空白区域拖动创建框；拖动框体移动，右下角缩放。每个框都要填写描述。调整画布宽高会保留归一化布局。

4. 补充全局要求

   说明整张图的场景、背景、地面、光线与风格。可以使用「填入完整场景建议」；留空时后端采用场景补全建议，自定义内容优先保留。

5. 连接提示词和采样

   推荐通过 API 强化完整场景，或手写完整描述后接官方布局节点。画布宽高输出继续驱动空 latent；点击「检查区域」检查内容，再运行工作流。

1. 选择「图像编辑」，载入主图

   点击「上传原图」或选择已有图片。也可连接上游 source_image：先在没有区域时运行一次加载预览，再重新画框。上游图片需固定种子或可复现。

2. 为修改内容建立区域

   每个框填写明确要求，例如「将外套改为蓝色，保留原有版型和材质」。按需要为区域上传辅助参考图；全局要求说明人物身份、背景、光线等保留项。

3. 让参考图进入两条链路

   主图和辅助图送到视觉 LLM，供它理解修改；同时将主图、区域参考图集合送入「区域参考图自动编码」，让图像模型真正接收它们。

4. 连接 VAE、正负条件与采样

   自动编码节点输出 positive、negative 和 empty_latent，分别连接 KSampler 对应输入。Base 使用空字符串编码作负条件。

5. 检查并按需合成

   解码后检查区域修改和框外变化。如必须保留原始遮罩外像素，将原图、完整编辑结果、合并遮罩接入「区域结果合成」，再保存结果。

例如区域 2、5 各有一张辅助图，它们会对应 <ref_image_1>、<ref_image_2>。自动编码输出「参考图映射JSON」和「参考图总数」，可连接文本预览检查。

FLUX3 的框是语义引导，不是硬遮罩。当前编辑器主要生成替换 / 改色类条件，尚无独立源框到目标框的移动或移除操作；移动框体是在调整要求的位置。

FLUX3 需要主体、构图、背景、光线完整的场景 caption。强化节点采用 OpenAI 兼容的 /chat/completions 协议，把用户短要求扩写成模型输入；不是生成图片的 API。

「增强提示词」是纯场景描述；「FLUX完整提示词」包含描述、对象引用与本地框表，可直接接文本编码器。使用完整提示词后，不再经过第二个布局拼接节点。

框坐标使用 [上, 左, 下, 右]，范围 0–1000。框颜色只是编辑器标记，模型需要的实际物体颜色应写进描述。

界面小操作

• 「隐藏区域」只隐藏画框覆盖层，不删除数据。
• 「隐藏输入 / 输出」只改变展示，已有连线继续生效；需要接线时先显示端口。
• 「清空」清除区域；「重新开始」同时清除全局要求。修改自动保存到工作流。
• 上传新主图会清除旧区域并断开原有 source_image 连线，防止预览与实际输入不同。
• 迁移工作流时，也要复制 ComfyUI input 目录中的主图与辅助图。

以下文件可在套件的 examples/ 目录找到。将 JSON 拖入 ComfyUI，检查模型名称、图片与 API 设置后运行。

示例用于说明接线，实际效果取决于模型、输入和参数。公开工作流不应包含个人 API 密钥；这里不预设不存在的下载地址。