ComfyUI_Element_easy
Three custom ComfyUI nodes: Empty Image RGB, Text Line Break, and Random Chars (Append) for convenient utilities. (Description by CC)
Nodes (26)
Split an image into black-and-white regions without wrecking object recognition
A checkerboard mask generator with a cautionary tale attached
The five-second resolution helper that saves you from doing the math
Brighten or darken specific colors, not the whole image
Remapping color by hue, with a live curve
Boost, kill, or remap saturation by exact hue — with a curve you can see
Photoshop-style RGB curves, in ComfyUI, with a live preview
Draw your per-step strength curve instead
One panel for every reference your video model keeps asking for
Element ref convert is the adapter that turns your reference panel into wires
The 'scene detection' node that's secretly a video editor
The sigma curve editor
Where the pixels actually come out
The tiny node that unpacks the video bundle
A solid-color image generator that doesn't make you fight color formats
Stop guessing frame counts for your video model
Pad an image to any size with blurred edges that actually look intentional
Browse, load, and mask your image without leaving ComfyUI
Add noise only where the mask says so — the surgical img2img trick
Feather, expand, and soften masks until your seams disappear
The latent upscaler that knows MiniMax H3 speaks 16x, not 8x
This is the one to reach for
A very honest hack for prompt variation
The node that fixes pixel drift when Qwen-Edit or Klein edits your image
Wrap your prompt text into lines so you can stamp it on your image
ComfyUI_Element_easy
一个以可视化界面、方便交互为主要方向的 ComfyUI 扩展。这个包里的节点不太一样:不是一个滑杆配一个数字,而是把完整的小工具直接搬进了节点里。
你能得到什么
🎬 视频剪辑(Element Load and Edit Video) 不用离开 ComfyUI 就能在节点上剪视频:自动检测镜头切换点,也可以手动切、剪短、调顺序,边剪边看,剪完直接输出画面和声音。
🗂 多参考素材面板(Element Multi REF) 给需要"参考图 + 首尾帧 + 参考视频 + 音频"一起输入的视频模型(MiniMax-H3、LTXV、Wan 等)用的素材台。每个素材都能裁剪、涂刷标注、掐时间段,还能存成预设——配合队列可以一次跑完多套素材和提示词,不用来回换图。
🎛 曲线调色(HueSat / HueBright / HueHue / ImageCurve) 像修图软件里的曲线一样调色,曲线直接画在图像上,拖一下立刻看到效果,视频也一样实时预览。
📐 自定义采样曲线(Element_SigmaGraph) 手动画采样器的 sigma 曲线,想在前段少花步数、后段多加细节时特别方便。
🧩 还有 20 多个实用小节点 图像智能合并、遮罩描边、图像加边模糊、帧数计算等等。
需要说明的劣势
- 上手需要一点时间:面板式节点功能多,第一次打开会有"这按钮是干嘛的"的时刻,建议配合各节点的详细说明文档使用;
- 部分功能依赖外部程序:视频导出带声音需要系统装 ffmpeg,自动分镜建议装 scenedetect,不装也能用,只是相应功能受限;
- 兼容性依赖较新的 ComfyUI 版本(Multi REF 用了新版节点 API),老版本 ComfyUI 可能装不上;
- 节点多但彼此独立:如果你只需要一两个功能,这个包对你来说可能偏大。
📦 节点导航
🎬 视频与素材管理
- Element Multi REF(含辅助节点 Element ref convert)
- Element Load and Edit Video(含辅助节点 Element Video Clip / Element Video Info)
- Minimax_H3-LatentUpscaler(含 Adv 版本)
🎛 曲线调色
🖌 图像编辑与遮罩
- LoadImage_Preview · Smart merge images · black_white_color · mask_noise_element · mask_stroke · image_pad_blur
📐 图像生成与采样控制
🔧 数值与文本小工具
- Element_ListGraph · Frame Calculator · ImageSize Div · Element_Prompt_Presets · Element_random_value_remap · random_chars · text_line_break
bug修复与优化
- 现在鼠标指针在可视化交互节点上时可以正常拖动和缩放 comfyUI 画布,loadimage_preview节点的缩略图预览界面 和 Element Load and Edit Video 节点在选中状态下的时间线窗口除外。
<a id="element-multi-ref"></a>
Element Multi REF
<sub>v1.5.7 新增 · v1.6.1优化 · v1.6.9增强 </sub>
为 MiniMax-H3、LTXV、Wan、Klein、Qwen 等需要多路参考输入的视频/图像模型设计的素材及提示词管理方案:
- 21 个类型化槽位:参考图 ×9、参考视频 ×3,以及首尾帧、各类音频和 Prompt 卡片;
- 每个卡片配有独立的简易图像编辑器(裁剪、笔刷标注)和音视频时间线编辑器(按 17n+5、8n+1 等规则量化对齐);
- 面板底栏左下角有 4 个区域开关图标(参考图、首尾帧、音视频、Prompt),可自由组合面板以应对不同需求,甚至可以当作提示词预设节点使用;
- 支持多个预设的存储、调用、载入、导出,以及收集归类所有参考和提示词;
run_preset_NUM参数对应预设列表中的序号,接收随提示词队列变化的输入时,配合采样推理节点可实现连续生成或编辑多张图像/视频; ⚠️ 注意:若加载了预设,run_preset_NUM参数会自动变为预设的序号,此时若修改了参考区域的内容,但没有存储/另存预设,输出的结果将是没有修改之前的,这是正常行为;若不想存储预设,想输出当前界面修改的内容,现在可以点击一次reset按钮(将run_preset_NUM参数设置为0)。- 若删除了预设中使用的参考素材,现在可以通过relink按钮指定目录重新连接(目录中要包含文件名相同的文件)。
- 辅助节点 Element ref convert 用于参考数据的格式转换。
🎬 核心场景:分镜脚本批量处理
一个剧本可能有几十上百个镜头。每个镜头的提示词、参考图、参考视频、首尾帧,全部存成预设。
配合采样节点,一键跑完所有片段。想改就改,满意了再存预设——不用来回加载工作流,也不用在一个个节点里手动换素材 和 提示词。
- 以前:改一个镜头 → 换图 → 改提示词 → 跑 → 再改下一个 → 循环几十次。参考图或音视频要微调,还得开 PS 或剪辑软件。
- 现在:预设里全部排好 → 一键跑完 → 不满意改预设 → 再跑。参考图或音视频的微调,直接在节点上完成,不用切换软件。
<a id="element-load-and-edit-video"></a>
Element Load and Edit Video
<sub>v1.5.4 新增 · v1.6.2 优化</sub>
可视化的单轨视频剪辑器节点:
- PySceneDetect 自动检测镜头切换点, 也可在交互式时间线上手动切分、修剪、重排片段;
- 画面与音频同步预览;
- 直接输出片段帧序列与精确对应的音频,支持导出带音频的 mp4(需要 ffmpeg)。
- 快捷键:空格键 = 播放/停止 所有片段;鼠标滚轮 = 缩放时间线;shift+鼠标滚轮 = 左右滑动时间线显示范围;分段选择:Ctrl+点击 = 加选,Shift+点击 = 范围连选;修剪片段:按住 Alt/Ctrl 拖动 = 联动修剪;delete/Backspace 删除选择的分段。
⚠️ 节点在选择状态下,才能操作节点界面上的图标、按钮或快捷键。
辅助节点 Element Video Clip、Element Video Info 配合使用。
<img width="2147" height="1104" alt="Element Load and Edit Video" src="https://github.com/user-attachments/assets/5ba547a7-31c8-4323-bf40-7ec58f1b548e" /><a id="minimax_h3-latentupscaler"></a>
Minimax_H3-LatentUpscaler
<sub>v1.5.0 新增 · Adv 版本同期添加</sub>
只缩放视频潜空间的专用节点,不处理音频,输出端口为 Minimax H3 latent。
Adv 版本带校验,引入三种条件缩放模式:
| 模式 | 行为 | |---|---| | pass_through | 忽略校验直接通过 | | NO_refs | 只对齐,不缩放 | | refs | 缩放(质量最好) |
<a id="element-imagecurve"></a> <a id="element-huesat"></a> <a id="element-huebright"></a> <a id="element-huehue"></a>
曲线调色系列
<sub>v1.2.7 ~ v1.3.1 陆续添加 · v1.6.1 优化</sub>
四个节点都是同一种交互方式:曲线直接画在图像上实时预览,单击加点、右键减点,支持单张和序列帧图像。
| 节点 | 曲线类型 | |---|---| | Element ImageCurve | RGB / R / G / B 通道曲线 | | Element HueSat | 色相 → 饱和度 | | Element HueBright | 色相 → 亮度 | | Element HueHue | 色相 → 色相 |
<img width="1695" height="891" alt="Element HueSat" src="https://github.com/user-attachments/assets/627e1951-244b-4b13-937c-23c8d98748e8" /> <img width="1767" height="1008" alt="Element ImageCurve" src="https://github.com/user-attachments/assets/f3bcfd71-eaba-4933-aa97-01ee6eefad62" />⚠️ 除了Element ImageCurve以外,不要在曲线两端同时加点:两端的曲线是闭环的,同时加点会使其中一个点无效,实际上一个端点就足够完成调色。
<a id="loadimage_preview"></a>
LoadImage_Preview
<sub>v1.3.5 新增 · v1.6.1 优化 · v1.6.7 修改输出端口</sub>
浏览指定路径下的图像文件,选中后进入编辑面板进行简单编辑:自由绘制线条、mask、方框、圆,以及裁剪图像。
Shift + 左键:画直线、正方形或正圆L-alpha:载入图像 alpha 通道到画布Return:在缩放面板和编辑面板之间切换- 编辑模式下支持
Ctrl+V粘贴图像,支持从网页或资源管理器直接拖入 - ComfyUI 的 input 目录常驻节点中,folder path 指定的目录作为额外增加的目录
<a id="smart-merge-images"></a>
Smart merge images
<sub>v1.4.3 新增 · v1.8.2 修复:首次运行时设置 torch.hub 目录 </sub>
🎬 核心场景:消除图像经过生图模型分块放大后产生的变形和色差
把图像分多块,或将图像中的部分区域丢给生图模型重新采样/编辑/放大后,再拼回去时,接缝处经常有色差、有变形,直接拼效果可能比较差。 这个节点利用两张图的共同特征做智能对齐,把分块放大后的结果平滑拼回原图。
需要下载 模型文件 ,默认自动下载。
Manual download:depth-save.pth / disk_lightglue_v0-1_arxiv-pth / loftr_outdoor.ckpt To \ComfyUI\models\elementEasy\checkpoints
<img width="1949" height="1171" alt="68700067" src="https://github.com/user-attachments/assets/3682af85-9d8a-4936-9653-429e760907de" /><a id="black_white_color"></a>
black_white_color
<sub>v1.1.3 新增</sub>
黑白分区的风格转换节点,用于在 qwenEdit 风格转换时抑制转换后的像素偏移问题:先转换 mask 区域风格,再转换 invert mask 区域;尽量使黑白区域面积平均,以减少色调不一致的问题。
输入端口的 mask 会与节点生成的 mask 做 ADD 运算。
<img width="1596" height="1084" alt="black_white_color" src="https://github.com/user-attachments/assets/c715e5e6-1ff3-46ff-9d48-a0a87d2506df" /><a id="mask_noise_element"></a>
mask_noise_element
<sub>v0.0.8 新增(Image Noise Using Mask)</sub>
方便在图像的 mask 区域添加随机噪点。
<img width="1724" height="878" alt="屏幕截图 2026-01-17 134457" src="https://github.com/user-attachments/assets/17b9af6d-e8d2-4c35-9e13-6822e6bfa266" /><a id="mask_stroke"></a>
mask_stroke
<sub>v0.0.7 新增</sub>
mask 描边:内外描边宽度和模糊度单独控制,支持非描边区域整体添加权重(使输出的 mask 没有权重为 0 的区域)。
<img width="1295" height="731" alt="mask_stroke" src="https://github.com/user-attachments/assets/56b86fb6-758a-4d6c-8fa1-997b6bc9ee9d" /><a id="image_pad_blur"></a>
image_pad_blur
<sub>v0.0.8 新增 · v1.6.0 重构 · v1.6.1 优化</sub>
🎬 核心场景:给图像编辑模型做扩图,可视化拖拽,几乎满足任何扩图要求
用图像编辑模型(klein、QwenImage2.1、Qwen-Edit、Flux-Fill、sdxl 等)扩图时,老节点要输一堆参数、反复跑测试、有些扩图要求还达不到。 这个节点把扩图变成画布上的直接操作:拖拽、缩放、对齐,所见即所得,同时输出对应的 mask。
- 扩图不用猜参数:画布内直接拖拽原图位置、等比例缩放,九宫格按钮一键对齐(中心、四角、四边)
- 边缘不穿帮:原图边缘可单独指定是否羽化,让原图和扩展区域平滑过渡
- 补的内容可控:背景可自定义颜色,pad 模式支持 constant / reflect / edge / stretch
- 尺寸自动合法:保留 target_width / target_height,新增 div 参数辅助对齐到合法分辨率
- 直接出 mask:扩图后自动生成 mask,标出哪块是原图、哪块是补出来的,方便后续编辑模型局部重绘
<a id="element_sigmagraph"></a>
Element_SigmaGraph
<sub>v1.2.4 新增 · v1.5.3 增加 P 按钮 · v1.6.1 优化</sub>
在节点上直接绘制自定义 sigma 曲线:单击加点、右键删点。
P 按钮:重排控制点的 x 坐标——当点数少于 steps+1 时,前 n-1 个点的 x 重排为 0, 1/steps, ..., (n-2)/steps,y 不变,最后一个点原样保留;当点数不少于 steps+1 时,取前 steps+1 个点均匀分布。简单说:在不改变前面步数步幅的前提下,为后段增加采样步数(增加细节)。
<img width="1176" height="794" alt="Element_SigmaGraph" src="https://github.com/user-attachments/assets/a8741609-cbe7-4ec8-a88d-5cae79b031a8" /><a id="chessboard"></a>
chessboard
<sub>v0.0.9 新增(ChessboardPattern)</sub>
创建黑白棋盘格图像。
<img width="1714" height="608" alt="image" src="https://github.com/user-attachments/assets/466bc026-adc5-42cd-abe5-c28f323dd482" /><a id="empty_image_rgb"></a>
empty_image_rgb
<sub>v0.0.6 新增 · v1.6.1 优化</sub>
创建单色图像,色彩从色轮上选择,明度滑条控制亮度;吸管可在屏幕任意位置取色,如果浏览器非 Chrome / Edge 96+,吸管可能不可用,可改用旁边的调色板按钮中的吸管。
<img width="1329" height="904" alt="image" src="https://github.com/user-attachments/assets/9dd2957b-e261-40ce-8041-87a83df33880" /><a id="Element_ListGraph"></a>
Element_ListGraph
<sub>v1.6.6 新增 </sub>
与Element_SigmaGraph类似,曲线上点的 y 值不再限制为随 x 值降低,输出为 float 和 string 列表,列表中元素数量与 steps 值相同,而非 steps + 1。可以连接到 ComfyUI-Element_TileUpscale 的 reference_strength 参数,控制每步采样的图像参考强度。
<a id="frame-calculator"></a>
Frame Calculator
<sub>v1.2.2 新增,v1.5.9优化 </sub>
帧数计算节点,提供minimax H3、ltx2、wan合法预设,可通过div_by和offset自定义。
<img width="1154" height="655" alt="image" src="https://github.com/user-attachments/assets/9a99acc7-96b3-43e8-a3c7-1b4fd2ab93f4" /><a id="imagesize-div"></a>
ImageSize Div
<sub>v1.2.3 新增</sub>
尺寸对齐计算。
<img width="1317" height="596" alt="ImageSize Div" src="https://github.com/user-attachments/assets/6f53211f-f695-4db6-9483-9da984d193ef" /><a id="Element_Prompt_Presets"></a>
Element_Prompt_Presets
<sub>v1.7.9 新增 · v1.8.4 增强 </sub>
- 提示词管理节点:按「分类 → 词条」点选提示词,直接在节点上编辑、新建、删除,并可导出 JSON 备份,支持导入 json、xlsx、csv 格式文件。
- 支持在弹窗中多选词条:prompt_text 输出按 link 分隔符合并的单段文本,prompt_list 输出词条文本列表;选择状态随工作流保存,弹窗中也可直接删除词条 / 分类。
- 词条可标记为 tags 或 Natural language:entry 选项在 tags 词条名后显示实心圆点(仅显示,不进入输出);新建时勾选 tags,或用「修改标签」标记;多选弹窗可按两类过滤。
- 整段/单行两种输出;开启 single_line 后按 seed 从整段文本中抽取一行,配合固定/增量/减量/随机四种 seed 模式,可随队列自动轮换不同句子。例外:选中的词条全部为自然语言(无 tags)时,prompt_text 改为输出按 seed 抽中的完整词条(prompt_list 不变)。
- 预设存储位置 ComfyUI\user\element_easy\promptPresets\prompts.json。
<a id="Element_random_value_remap"></a>
Element_random_value_remap
<sub>v1.8.5 新增</sub>
把输入的数值(最常见的是seed)稳定映射到 [min, max] 区间,输出 float 和 int 两个端口。
- value 输入端口可选,同时接受 int 和 float,例如直接接 Seed 节点;不接输入时,每次执行也会在 min 和 max 之间随机输出;min 和 max 是浮点参数,可以为负数;
- 同一个输入值每次得到同一个结果;不同 seed 在区间内散开,配合 seed 的固定 / 增量 / 减量 / 随机模式可随队列变化;
<a id="random_chars"></a>
random_chars
<sub>v0.0.6(Random Chars Append)</sub>
为输入的文本追加无效的特殊字符(可以自定义字符和个数)。
<a id="text_line_break"></a>
text_line_break
<sub>v0.0.6,v1.5.9优化</sub>
将输入的文本按字符数量换行,支持标点符号避首尾,标点挤压、悬挂。最终效果取决于输出载体。
<img width="1693" height="981" alt="image" src="https://github.com/user-attachments/assets/62b3f66a-6cec-4d10-904a-5a33a102ba92" />Installation
Manager 安装
在 ComfyUI Manager 中搜索 ComfyUI_Element_easy,然后 Install。
手动安装
进入 ./ComfyUI/custom_nodes 目录,运行:
git clone https://github.com/supElement/ComfyUI_Element_easy.git
cd ComfyUI_Element_easy
pip install -r requirements.txt
可选依赖:ffmpeg
节点的**视频导出(带音频)**功能需要系统安装 ffmpeg。Windows 用户从 ffmpeg 下载,解压后将 bin 目录加入 PATH。
未安装 ffmpeg 时其余功能均正常,仅视频导出为无声视频。
⚠️ smart_merge 节点的模型文件已从本仓库的 Git 历史中永久移除(git pull / 重装插件均不会恢复),改为从 HuggingFace 下载。
📦 模型文件
✅ 首次运行 smart_merge 节点时,若检测到模型缺失会自动下载到: ComfyUI/models/elementEasy/checkpoints/
📥 手动下载(无法访问 HuggingFace 时)请将以下 3 个文件下载到上述目录: - depth-save.pth - disk_lightglue_v0-1_arxiv-pth - loftr_outdoor.ckpt
⚠️ 注意:disk_lightglue_v0-1_arxiv-pth 没有 .pth 后缀,这是 kornia 的命名约定,不是文件损坏,请勿手动改名。
关于赞助
⚠️ 说明:
无论您是否选择赞助,都不会对我的插件所提供的功能或使用体验产生任何影响。所有内容将始终保持免费且开源。
请仅在您确实觉得这些工具对您有所帮助,或者通过使用它们获得了收益的情况下,再考虑进行赞助。