一个以可视化界面、方便交互为主要方向的 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
📐 图像生成与采样控制
🔧 数值与文本小工具
- 现在鼠标指针在可视化交互节点上时可以正常拖动和缩放 comfyUI 画布，loadimage_preview节点的缩略图预览界面 和 Element Load and Edit Video 节点在选中状态下的时间线窗口除外。
v1.5.7 新增 · v1.6.1优化
为 MiniMax-H3、LTXV、Wan、Klein、Qwen 等需要多路参考输入的视频/图像模型设计的素材及提示词管理方案：
- 21 个类型化槽位：参考图 ×9、参考视频 ×3，以及首尾帧、各类音频和 Prompt 卡片；
- 每个卡片配有独立的简易图像编辑器（裁剪、笔刷标注）和音视频时间线编辑器（按 17n+5、8n+1 等规则量化对齐）；
- 面板底栏左下角有 4 个区域开关图标（参考图、首尾帧、音视频、Prompt），可自由组合面板以应对不同需求，甚至可以当作提示词预设节点使用；
- 支持多个预设的存储、调用、载入、导出，以及收集归类所有参考和提示词；
run_preset_NUM参数对应预设列表中的序号，接收随提示词队列变化的输入时，配合采样推理节点可实现连续生成或编辑多张图像/视频；⚠️ 注意：若加载了预设，run_preset_NUM参数会自动变为预设的序号，此时若修改了参考区域的内容，必须将run_preset_NUM参数设置为 0 （输出当前界面），或存储/另存预设，否则输出的结果将是没有修改之前的，这是正常行为。
辅助节点 Element ref convert 用于参考数据的格式转换。
🎬 核心场景：分镜脚本批量处理
一个剧本可能有几十上百个镜头。每个镜头的提示词、参考图、参考视频、首尾帧，全部存成预设。
配合采样节点，一键跑完所有片段。想改就改，满意了再存预设——不用来回加载工作流，也不用在一个个节点里手动换素材 和 提示词。
- 以前：改一个镜头 → 换图 → 改提示词 → 跑 → 再改下一个 → 循环几十次。参考图或音视频要微调，还得开 PS 或剪辑软件。
- 现在：预设里全部排好 → 一键跑完 → 不满意改预设 → 再跑。参考图或音视频的微调，直接在节点上完成，不用切换软件。
v1.5.4 新增 · v1.6.2 优化
可视化的单轨视频剪辑器节点：
- PySceneDetect 自动检测镜头切换点， 也可在交互式时间线上手动切分、修剪、重排片段；
- 画面与音频同步预览；
- 直接输出片段帧序列与精确对应的音频，支持导出带音频的 mp4（需要 ffmpeg）。
- 快捷键：空格键 = 播放/停止 所有片段；鼠标滚轮 = 缩放时间线；shift+鼠标滚轮 = 左右滑动时间线显示范围；分段选择：Ctrl+点击 = 加选，Shift+点击 = 范围连选；修剪片段：按住 Alt/Ctrl 拖动 = 联动修剪；delete/Backspace 删除选择的分段。
辅助节点 Element Video Clip、Element Video Info 配合使用。
v1.5.0 新增 · Adv 版本同期添加
只缩放视频潜空间的专用节点，不处理音频，输出端口为 Minimax H3 latent。
Adv 版本带校验，引入三种条件缩放模式：
| 模式 | 行为 |
|---|---|
| pass_through | 忽略校验直接通过 |
| NO_refs | 只对齐，不缩放 |
| refs | 缩放（质量最好） |
v1.2.7 ~ v1.3.1 陆续添加 · v1.6.1 优化
四个节点都是同一种交互方式：曲线直接画在图像上实时预览，单击加点、右键减点，支持单张和序列帧图像。
| 节点 | 曲线类型 |
|---|---|
| Element ImageCurve | RGB / R / G / B 通道曲线 |
| Element HueSat | 色相 → 饱和度 |
| Element HueBright | 色相 → 亮度 |
| Element HueHue | 色相 → 色相 |
⚠️ 除了Element ImageCurve以外，不要在曲线两端同时加点：两端的曲线是闭环的，同时加点会使其中一个点无效，实际上一个端点就足够完成调色。
v1.3.5 新增 · v1.6.1 优化
浏览指定路径下的图像文件，选中后进入编辑面板进行简单编辑：自由绘制线条、mask、方框、圆，以及裁剪图像。
Shift + 左键：画直线、正方形或正圆L-alpha：载入图像 alpha 通道到画布Return：在缩放面板和编辑面板之间切换- 编辑模式下支持
Ctrl+V粘贴图像，支持从网页或资源管理器直接拖入 - ComfyUI 的 input 目录常驻节点中，folder path 指定的目录作为额外增加的目录
v1.4.3 新增 · v1.4.8 优化
🎬 核心场景：消除图像经过生图模型分块放大后产生的变形和色差
把图分块丢给生图模型放大，再拼回去时，接缝处经常有色差、有变形，直接拼很难看。 这个节点利用两张图的共同特征做智能对齐，把分块放大后的结果平滑拼回原图。
怎么用（最优输入方案）：
- original_image：原图
- edited_crop_B：经过编辑或重绘的块
- original_crop_A：从原图剪切的、没有修改或变形的块 三个端口配合，节点会自动找到对齐关系，把编辑过的部分拼回原图。
支持分块合并：edited_crop_B 端口输入多张图像时，输出为最终合并后的单张图像。
v1.1.3 新增
黑白分区的风格转换节点，用于在 qwenEdit 风格转换时抑制转换后的像素偏移问题：先转换 mask 区域风格，再转换 invert mask 区域；尽量使黑白区域面积平均，以减少色调不一致的问题。
输入端口的 mask 会与节点生成的 mask 做 ADD 运算。
v0.0.8 新增（Image Noise Using Mask）
方便在图像的 mask 区域添加随机噪点。
v0.0.7 新增
mask 描边：内外描边宽度和模糊度单独控制，支持非描边区域整体添加权重（使输出的 mask 没有权重为 0 的区域）。
v0.0.8 新增 · v1.6.0 重构 · v1.6.1 优化
🎬 核心场景：给图像编辑模型做扩图，可视化拖拽，几乎满足任何扩图要求
用图像编辑模型（klein、QwenImage2.1、Qwen-Edit、Flux-Fill、sdxl 等）扩图时，老节点要输一堆参数、反复跑测试、有些扩图要求还达不到。 这个节点把扩图变成画布上的直接操作：拖拽、缩放、对齐，所见即所得，同时输出对应的 mask。
- 扩图不用猜参数：画布内直接拖拽原图位置、等比例缩放，九宫格按钮一键对齐（中心、四角、四边）
- 边缘不穿帮：原图边缘可单独指定是否羽化，让原图和扩展区域平滑过渡
- 补的内容可控：背景可自定义颜色，pad 模式支持 constant / reflect / edge / stretch
- 尺寸自动合法：保留 target_width / target_height，新增 div 参数辅助对齐到合法分辨率
- 直接出 mask：扩图后自动生成 mask，标出哪块是原图、哪块是补出来的，方便后续编辑模型局部重绘
v1.2.4 新增 · v1.5.3 增加 P 按钮 · v1.6.1 优化
在节点上直接绘制自定义 sigma 曲线：单击加点、右键删点。
P 按钮：重排控制点的 x 坐标——当点数少于 steps+1 时，前 n-1 个点的 x 重排为 0, 1/steps, ..., (n-2)/steps，y 不变，最后一个点原样保留；当点数不少于 steps+1 时，取前 steps+1 个点均匀分布。简单说：在不改变前面步数步幅的前提下，为后段增加采样步数（增加细节）。
v0.0.9 新增（ChessboardPattern）
创建黑白棋盘格图像。
v0.0.6 新增 · v1.6.1 优化
创建单色图像，色彩从色轮上选择，明度滑条控制亮度；吸管可在屏幕任意位置取色，如果浏览器非 Chrome / Edge 96+，吸管可能不可用，可改用旁边的调色板按钮中的吸管。
v1.2.2 新增，v1.5.9优化
帧数计算节点，提供minimax H3、ltx2、wan合法预设，可通过div_by和offset自定义。
v1.2.3 新增
尺寸对齐计算。
v0.0.6（Random Chars Append）
为输入的文本追加无效的特殊字符（可以自定义字符和个数）。
v0.0.6，v1.5.9优化
将输入的文本按字符数量换行，支持标点符号避首尾，标点挤压、悬挂。最终效果取决于输出载体。
在 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。Windows 用户从 ffmpeg 下载，解压后将 bin 目录加入 PATH。
未安装 ffmpeg 时其余功能均正常，仅视频导出为无声视频。