一个用于 ComfyUI 的综合工具箱，包含“节点收藏”、“工作流管理”以及多种实用的辅助节点。
BUG 修复批次
- 🔒 安全修复：素材库
save_media接口的subfolder参数增加真实路径 containment 校验，封堵../路径穿越（任意文件读取）漏洞。 - 🐛 Qwen-VL 反推：
temperature / top_p / max_tokens / api_host / frame_count变化现在会正确触发重新执行，不再被种子缓存吞掉；反推缓存增加 64 条上限防内存无限增长；网关拉起脚本路径移出源码，改从data/gateway_config.json读取。 - 🐛 空Latent+/空Latent+Qwen：空 latent 改为 CPU 分配（不再白白占用显存）；
orientation（横屏/竖屏）现在真正参与尺寸计算。 - 🐛 简易运算：修复链式比较（
1 < a < 5）中间操作数不更新的错误。 - 🔤 名称修复：修正历史遗留乱码节点名——
jdsc显示为「收藏+」、工作流管理节点显示为「工作流+」、「显示文本」新增规范名（保留旧键兼容既有工作流）。
精简：移除四个节点模块
- 移除节点：提示词随机生成器+ (WuhuoPromptRandomizer)、Z-Image 角色连续性套件（5 节点）、长文本分割转列表套件、LoRA 合并 (WuhuoLoraMerge / WuhuoLoraSimpleMerge)。
- 随之移除配套的前端脚本 (
web/prompt_randomizer.js、web/lora_merge_tooltips.js)、默认词库 (prompt_randomizer_pools/) 与第三方声明文件。 - 依赖这些节点的历史工作流加载时会提示缺失节点，删除对应节点即可正常使用；其余功能不受影响。
重磅更新：提示词随机生成器+、Z-Image 角色连续性套件与 Qwen-VL 本地极速反推首发
- 🆕 首发节点 —— 提示词随机生成器+ (WuhuoPromptRandomizer):
- 11 维正交词库引擎：内置「拍摄角度 / 光影色调 / 人物维度 / 发型 / 妆容 / 表情 / 服装 / 姿态 / 背景 / 构图 / 年龄」11 大维度默认词库（
prompt_randomizer_pools/），按正交拆分原则组织，每条组合词库维持独立职责与有效风格标签（_styles.txt）。 - 第⑪项「年龄」纯开关：开关开启 → 随机抽 26 岁以内，且放在提示词最前边；开关关闭 → 节点完全不输出年龄（无手动输入框）。
- 第③项改为纯人物属性：顺序为「人种肤色 → 体型身材 → 身份职业 → 气质印象」，已移除原
年纪身份.txt，避免年龄和职业/身份随机冲突。 - 词库热更新与路径解析：词库按文件 mtime 缓存、编辑保存即生效；支持
WHTOOLS_PROMPT_POOL_DIR环境变量重定向，并自动兼容历史词库目录，绝不分裂既有词库。保留PromptRandomizer兼容别名，旧工作流可无缝加载。
- 11 维正交词库引擎：内置「拍摄角度 / 光影色调 / 人物维度 / 发型 / 妆容 / 表情 / 服装 / 姿态 / 背景 / 构图 / 年龄」11 大维度默认词库（
- 🆕 首发节点组 —— Z-Image 角色连续性套件（5 节点）:
- 角色固定档案 (ZImageCharacterFeatureLock)：以「视角感知」方式存储可复用的角色+场景档案，按常驻 / 正面 / 3/4 侧 / 侧面 / 背面 / 特写 / 全身与固定场景 / 局部场景分层描述，外加成像风格锁定，实现跨镜头锁人设。
- 镜头条件编译 (ZImageShotCompiler)：在不改动固定档案的前提下，按角度、景别、机位高度、动作、表情、视线与镜头细节编译出视角一致的提示词，并自动附加角色年龄一致性约束。
- 故事包导入 (ZImageStoryboard) / 故事文件导入 (ZImageStoryboardFile) / 故事来源导入·可批量 (ZImageStoryboardSource)：三种粒度接入分镜故事数据——直接粘贴故事包、从磁盘读取（外部工具改完文件即生效）、或默认解析粘贴的 AI 输出并支持批量多源编译。
- 🆕 首发节点组 —— Qwen-VL 本地极速反推（3 节点，5070Ti 优化）:
- 本地 / 单图 / 视频三模式：
WuhuoQwenVLLocalFast、WuhuoQwenVLImageFast、WuhuoQwenVLVideoFast，经本地网关调用 Qwen-VL，网关未启动时自动拉起。 - 指纹级反推缓存：对输入张量采样计算指纹，种子固定或相同输入时秒级复用上一次反推结果。
- 通道安全转换：RGBA / 调色板图片自动转纯白底 RGB 后编码，杜绝 JPEG 编码报错。
- 本地 / 单图 / 视频三模式：
- 🆕 首发节点组 —— 长文本分割转列表套件（移植自 ComfyUI_Lam，GPL-3.0）:
- 长文本分割转列表+ (WuhuoLongTextToList)：按自定义分隔符（默认换行）切分长文本，同时输出「下标 i 文本 / 数组 / 数组长度」，兼容
\n\r\t转义分隔符。 - 文本列表选择+ (WuhuoTextListSelect) / 字符串原语+ (WuhuoPrimitiveString) / 种子列表 (WuhuoSeedList)：配套列表取值与字符串原语节点，并完整保留
LongTextToList、TextListSelect等 Lam 原节点名兼容映射，旧工作流直接可用。
- 长文本分割转列表+ (WuhuoLongTextToList)：按自定义分隔符（默认换行）切分长文本，同时输出「下标 i 文本 / 数组 / 数组长度」，兼容
- ⚙️ 工作流管理引擎底层重构（暂存区 + 修订号）:
- 可测试的纯函数存储层 (workflow_storage.py)：工作流 JSON 统一走「暂存区 (staging) → 原子落盘」两段式写入，内置修订号 (revision) 冲突检测、创建防重与暂存路径越权防线。
- 内容寻址的导入路由 (workflow_resolution.py)：对浏览器原生导入的工作流计算规范化语义哈希（剔除会话级元数据），自动识别同一份工作流并路由到既有文件，杜绝重复归档。
- 前端共享内核 (web/workflow_core.mjs)：抽出工作流语义等价比较、外部图谱消毒、历史条目管理（上限 200 条、收藏/暂存分类）等纯逻辑，供多个前端面板复用。
- 自动保存修订对账：检测到磁盘修订号变化后按语义等价静默对账，避免覆盖用户改动；托管工作流期间自动抑制 ComfyUI 原生自动保存误写。
- ⚙️ LoRA 合并烘焙引擎多架构增强:
- 模型家族自动探测：基于 adapter targets（而非文件名）推断目标架构，分层权重按目标架构解释（含 Krea2 Diffusers/PEFT 键位适配），合并数学内核保持共享。
- 合并前兼容性校验：两个 LoRA 进入经典合并引擎前先校验键位与适配器类型，提前拦截不兼容组合。
- 加性补丁保全：
.diff/.diff_b与 norm 张量按 ComfyUI 语义作为加性补丁保留，蒸馏与 text-side 补丁合并后不再失效。
- 📄 第三方合规：新增
THIRD_PARTY_NOTICES.md与 ComfyUI-PromptRandomizer (Apache-2.0) 许可文本归档。
重磅更新：LoRA 合并烘焙引擎、图像对比与智能数学计算节点首发
- 🆕 首发硬核功能 —— LoRA 混合保存 (WuhuoLoraMerge) & 简单合并 (WuhuoLoraSimpleMerge):
- 矩阵级合并与烘焙：彻底解决中大型工作流中多个 LoRA 串联导致加载缓慢的痛点。支持在 ComfyUI 内直接将 2-3 个 LoRA 文件直接合并并烘焙为一个全新的
.safetensors文件。 - 低秩拼接策略 (Rank Concat)：低秩矩阵拼接技术，自动缩放并合并 alpha 权重，实现接近于运行时同时挂载多个 LoRA 的效果，不损失细节。
- 超精细分层与调制权重：支持单独调整 Model/CLIP 权重，支持配置 Attention（注意力层）、FF（前馈层）、AdaLN（调制归一化层）以及自定义分层权重（Block Weights），极大提升合脸、融合画风的成功率。
- 形状自适应与安全防御：支持对不同 rank 或不匹配维度的张量进行
pad_to_larger（零填充对齐）智能对齐；内置 4GB 文件防溢出熔断保护和重名防覆盖安全防线。
- 矩阵级合并与烘焙：彻底解决中大型工作流中多个 LoRA 串联导致加载缓慢的痛点。支持在 ComfyUI 内直接将 2-3 个 LoRA 文件直接合并并烘焙为一个全新的
- 🆕 新增节点 —— 图像对比+ (WuhuoImageComparer):
- 在画布内以悬浮滑块形式实现两张图片（如 A/B 组、重绘前后）的高清无极滑移对比。支持在 ComfyUI 界面直接滑动进行精细视觉差异对比。
- 🆕 新增节点 —— 简易数学计算 (WuhuoSimpleMath):
- 多源输入自适应：支持读取
a、b、c、d任意类型的变量，可自动感知并读取 Tensor/Image shape 的宽高。 - 安全沙箱求值：基于 ast 安全语法树解析表达式，支持
min、max,round,sum,len等函数与基础算术、比较逻辑运算。 - 极佳防御性机制：内置严格的非有限数值归零与类型安全强制转换，即使表达式非法或除零也绝不导致工作流崩溃。
- 多源输入自适应：支持读取
- ⚙️ 交互细节与稳定性优化:
- 对上述新节点的前端交互（如菜单、提示词收藏与自动映射）进行完美适配，升级了前端菜单管理逻辑。
工业级工作流与素材交互引擎重构
- 工作流+ (Workflow+) 智能化升级:
- 逆向图谱提取与强制落盘：彻底解决非原生加载（如拖拽图片或点 Load 加载）的工作流无法被收藏的痛点。当用户对无物理路径的临时画布点击“收藏当前工作流”时，系统会在底层自动提取全套 Graph 节点数据，原地瞬间生成物理
.json文件归档至默认目录，并强制反向烙印路径身份，实现“先上车后补票”的极客体验。 - 挂载防御引擎：“添加文件夹”机制引入严密的路径洗脱防线，强制统一跨平台斜杠路径规范，内置防呆防重名拦截器，彻底根除脏路径导致的文件树崩溃死锁。
- 逆向图谱提取与强制落盘：彻底解决非原生加载（如拖拽图片或点 Load 加载）的工作流无法被收藏的痛点。当用户对无物理路径的临时画布点击“收藏当前工作流”时，系统会在底层自动提取全套 Graph 节点数据，原地瞬间生成物理
- 全能资产素材库 (Asset Library) 沉浸式视觉交互:
- 沉浸式幻灯片模式 (Slideshow Engine)：在图片 Lightbox 中全新引入高解像度自动轮播模式。
- 事件驱动安全防线：摒弃传统的不安全死循环定时器，采用
onload事件与计时器强挂钩。每一张图片必定在显存渲染完成后，才开始严格的读秒，杜绝网络高延迟下的界面闪烁卡死。 - 玻璃拟态悬浮控制台 (Glassmorphism UI)：屏幕底端悬浮控制中心，支持 1s 到 10s 动态变速切换，内置防点击穿透护盾保护原生
<select>控件。 - 硬核物理打断：深度融合键盘、滚轮、UI按钮的交互链路，一切用户主动操作（如点击、翻页、滚动或按 ESC）都会强制抢夺控制权并物理销毁异步倒计时，绝不残留幽灵进程。
- 事件驱动安全防线：摒弃传统的不安全死循环定时器，采用
- 物理二进制极速提取 (Binary Clipboard Bridge)：
- 对图片右键菜单新增“📋 复制图片 (供节点加载)”指令。底层调用原生 Fetch 强行提取图片的纯二进制流 (Blob)，贯穿操作系统的隔离沙盒直接注入剪贴板，彻底打通外部面板与 ComfyUI 原生 Load Image 节点之间的无缝
Ctrl+V通道。
- 对图片右键菜单新增“📋 复制图片 (供节点加载)”指令。底层调用原生 Fetch 强行提取图片的纯二进制流 (Blob)，贯穿操作系统的隔离沙盒直接注入剪贴板，彻底打通外部面板与 ComfyUI 原生 Load Image 节点之间的无缝
- 空间感知型智能鼠标滚轮 (Context-Aware Zoom & Scroll)：
- 射线物理判定：在放大镜模式中，当鼠标悬停于“实体图片”上时，滚轮激活丝滑的无极缩放（支持 0.1x 到 10x 硬件加速缩放）。
- 虚空翻页与物理冷却锁：当鼠标移至“背景虚空”时，滚轮自动切换为全局翻页控制器。同时注入严格的 300 毫秒物理冷却锁，从根本上免疫高精度无极滚轮带来的“老虎机式多重并发切图”灾难。
- 防误触 UI 外科手术：全面重构分类列表的“删除 (✖)”交互。将其物理隔离迁移至最右侧，摒弃引发视觉跳跃的
display突变切换，采用无损透明度 (opacity) 过渡，辅以危险感知高亮反馈，彻底消灭左侧悬停误触痛点。
- 沉浸式幻灯片模式 (Slideshow Engine)：在图片 Lightbox 中全新引入高解像度自动轮播模式。
体验与数据管理重构
- 🆕 核心节点首发：文本传递++ (WuhuoTextGatePro):
- 极客 HUD 工具控制台：节点内置流式自适应工具栏，支持图标像素随动布局与 260px 宽度物理保护。
- 🔴🟡🟢 实体交通灯流控：在节点前端提供清晰的状态指示灯，点击可极速循环切换 直通 (🟢)、拦截 (🔴)、手动 (🟡) 三种状态，免去繁琐的参数属性编辑。
- 前端物理防遮蔽与空间优化：隐藏或精简冗余的 Widget 控件，优化 LiteGraph 排版，腾出纯净输入区，全面拦截 LiteGraph 点击穿透与交互冲突。
- 高频动作集成：工具栏一键支持 📁 弹窗收藏、📋 一键粘贴、🗑️ 快速清空、⭐ 极速收藏到库、🚀 多选强化词预设、🔑 动态 Keyword 前缀设定、🎲 随机 SFW 抽取等七大动作。
- 文本收藏夹 (Text Favorites) 全面增强:
- 全局搜索：新增搜索栏，支持按词条名称或提示词内容进行快速过滤搜索。
- 完整分类管理：支持在左侧边栏直接新建、重命名和删除自定义分类。
- 安全降级策略：删除分类时，分类下的提示词将安全回退至默认的 "SFW" 分类，确保资产永不丢失。
- 素材库与历史记录底层优化:
- 物理级防爆满与 FIFO 瘦身：引入全局安全阈值，将历史图片的物理文件数硬上限锁定为 1000 张。每次生成新图时自动在后台执行先进先出（FIFO）滚动清理，杜绝长尾存储导致硬盘溢出。
- 硬链接技术 (Hard Link)：升级历史管理机制，底层采用硬链接进行文件映射，即使清除缓存中的历史队列，底层数据依然受到保护不会完全丢失。
- 交互细节抛光:
- 新增 D 快捷键：鼠标悬停在预览历史图片上时按下 D 键 可直接物理删除该图片（等同于右键菜单删除，带二次确认），操作更高效。
- Multi-Preview 右键菜单：新增醒目的“🗑️ 删除”选项，并统一了右键菜单的 UI 风格。
💥 史诗级重磅更新：全能资产素材库首发与全局多媒体极速收割中心
- 🆕 核心功能首发 —— 全能资产素材库 (Asset Library Panel):
- 打破节点目录隔离限制: 突破传统自定义节点的存储边界。现在，您可以通过素材库，将您电脑上的任意文件夹、任意物理路径一键映射加入到素材库中。彻底打通整个操作系统的本地素材资产，实现跨盘符无缝集中管理。
- 一键外置文件夹映射与默认主页: 独创“添加目录”和“添加默认目录”接口，支持在 UI 界面自由绑定外部高频资产，并且可以指定某个常用分类为“默认主页”，实现一打开图库即可立即享用特定工作集。
- 拖拽式极速工作流: 精心设计的全网格自适应图库视图，支持从素材库面板直接拖拽图片或视频到 ComfyUI 画布，自动触发 ComfyUI 底层节点完成极速加载，极大提升工作流的构建效率。
- 资产素材库交互与隐私全面重构:
- 位置持久化记忆: 全面记忆悬浮球与主面板在屏幕上的拖拽位置。即使刷新浏览器，面板也会牢牢固定在您指定的坐标，免去重复调整的烦恼。
- 折叠式隐私锁定屏障:
- 对“预览+历史记录”分类实现本地文件夹独立密码锁。通过自定义的异步遮罩弹窗输入密码解锁，且密码输入在任何时候均以星号 (
***) 进行安全遮蔽。 - “全部 (All)” 大分类中过滤并屏蔽了隐私的历史记录图片，保证日常公开展示的安全性。
- “全部”大分类位置进行视觉沉底调整，确保自定义分类的层级更有条理。
- 对“预览+历史记录”分类实现本地文件夹独立密码锁。通过自定义的异步遮罩弹窗输入密码解锁，且密码输入在任何时候均以星号 (
- 专业 Lightbox 画廊预览:
- 彻底重构画廊组件，支持无极滚轮缩放与鼠标左键按住自由画布平移（Zoom & Pan），完美查看高分辨率大图。
- 新增点击背景空白处快速退出功能，极速返回素材格。
- 支持在资产库标题栏上点击右键快速关闭面板（功能等同于点击右上角 X）。
- 全局多媒体极速收割 (Global Node Collection):
- 右键全局智能嗅探:
- 完美劫持 ComfyUI 底层
nodeType.prototype.getExtraMenuOptions注册链，实现对整个画布所有节点的菜单注入。 - 三重嗅探算法：自动识别常规图片节点（如
SaveImage嗅探node.imgs）、视频合成节点（如VHS_VideoCombine嗅探node.animatedImages视频帧及其内置 Video 元素）以及带图像/视频 Widget 的加载节点（如LoadImage,LoadVideo的 widget 真实值）。 - 在任何含媒体的节点上右键，均会自动召唤
⭐ 收藏媒体到素材库菜单。
- 完美劫持 ComfyUI 底层
- 随鼠弹出二级菜单: 移除 LiteGraph 原生多级菜单的级联限制，目录选择小菜单直接根据鼠标坐标（
clientX/clientY）贴脸跟随弹出。在弹出前自动清空并关闭其他 LiteGraph 菜单，交互极其清爽。 - Shift + 左键闪电收藏:
- 在“预览+ (WuhuoMultiPreview)”节点中，将原有的
Shift + 左键物理下载图片功能升级为闪电收藏，直接在鼠标指针位置召出分类选择菜单，一键瞬间归类。
- 在“预览+ (WuhuoMultiPreview)”节点中，将原有的
- 物理级直接传输引擎: 后端
/jdsc/assets/save_media路由会自动剥离 HTTP URL。针对 ComfyUI 内部资源利用folder_paths还原物理路径，针对本地历史图直接定位内部私有目录，在硬盘层面使用超高速复制/移动操作，而非拉取网页低分辨率预览图。
- 右键全局智能嗅探:
- 历史目录安全瘦身与零冗余 (History Safe Cleanup):
- 收藏即剪切（物理移动）: 在“预览+”历史中收藏图片或视频时，底层传输机制由“复制”升级为“剪切（
shutil.move）”。在移入素材库的同时，图片将自动从历史记录文件夹中抹去，彻底解决同一份数据双份占用的硬盘冗余。 - 全局 FIFO 滚动瘦身:
- 引入全局容量安全阈值，将历史记录物理文件总数上限强制锁死在 1000张/个。
- 每次有新图跑出，自动在后台根据修改时间（
mtime）进行先进先出（FIFO）滚动清理，让历史文件夹永远处于安全硬盘水位之下。 - 在全局右键及 Shift + 左键的收藏选项中彻底过滤“预览+历史记录”，杜绝重复收割套娃。
- 收藏即剪切（物理移动）: 在“预览+”历史中收藏图片或视频时，底层传输机制由“复制”升级为“剪切（
交互革命与流程效率提升
- 全局快捷键支持:
- Z 键: 鼠标悬停在“多图预览”或“文本+”节点上时按下，即可单点触发运行该节点及其上游。
- X 键: 在“多图预览”无图时快速加载历史；有图时快速放大/缩小鼠标下的图片。
- C 键: 快速切换“多图预览”的 对比模式。
- 多图预览 (Multi-Preview):
- 新增 对比模式 (AB Comparison)：支持拖拽分割线实时对比新旧图片差异。
- 布局算法优化：动态网格现在能更聪明地利用空间，格子显示更大。
- 右上角新增微型“清空”按钮，快速重置历史。
- 文本传递 (TextGate):
- 新增 “抽个 SFW” 随机功能：可从收藏夹中随机抽取 SFW 提示词。
- 交互鲁棒性增强，解决了在部分极端工作流下状态不同步的问题。
- 基础性能:
- 优化了 data/ 存储机制，提升了大型收藏夹的读写速度与安全性。
功能增强与体验优化
- 多图预览 (Multi-Preview):
- 支持 双击节点 快速运行选中的输出节点。
- 增强了历史图片保存与回溯功能。
- 优化了在不同缩放比例下的动态布局适配。
- 界面视觉 (Aesthetics):
- 进一步优化了节点样式，提供更加 premium 的视觉感受。
- 改进了深色模式下的对比度与交互反馈。
- 工作流管理:
- 提升了收藏夹和工作流片段加载的稳定性。
- 修复了部分环境下节点大小无法持久化存储的问题。
- 版本管理: 正式引入 Git 标签管理，支持保留旧版本下载地址。
初始版本发布
- 核心功能上线：节点收藏夹、工作流片段管、智能搜索。
- 基础增强节点：文本传递 (TextGate)、空 Latent+ 等。
- 将本项目目录
jdsc放入ComfyUI/custom_nodes/下 (例如ComfyUI\custom_nodes\jdsc) - 启动 ComfyUI，前端会自动加载相关扩展。
- 节点会以展示名 whtools 或具体功能名出现在分类
wuhuo下。
本插件的核心在于强大的前端辅助功能，旨在提升工作流搭建效率。
- 功能: 将常用的节点添加到收藏夹，支持拖拽排序。
- 使用:
- 在任意节点上右键 -> 选择
收藏节点。 - 点击页面右下角的 悬浮球 展开收藏面板。
- 从面板中直接拖拽节点到画布即可使用。
- 支持双列显示，容纳更多常用节点。
- 在任意节点上右键 -> 选择
- 功能: 将一组连接好的节点保存为“片段”，方便在不同工作流中复用模块。
- 使用:
- 按住
Ctrl(或Shift) 框选多个节点。 - 在选区内右键 -> 选择
保存为片段。 - 在收藏面板的“片段”标签页中找到并拖拽使用。
- 按住
- 功能: 提供基于文件夹的工作流文件管理，替代原生的加载/保存按钮。
- 使用:
- 在收藏面板中切换到“工作流”标签。
- 支持读取服务器端的工作流文件，支持文件夹层级浏览。
- 支持直接保存当前工作流到指定分类。
- 功能: 增强原本的搜索框，支持 中文拼音 搜索节点名称。
- 快捷键: 可在设置中配置组合快捷键快速呼出搜索。
核心节点。一个带有逻辑控制的文本处理节点，常用于 Prompt 的管理和工作流的调试。它有三种工作模式，通过 enable_edit 和 free_pass 开关组合控制。
enable_edit(Boolean): 开启编辑模式（红灯）。free_pass(Boolean): 开启直通模式（绿灯）。in_text(String): 上游输入的文本。edit_text(String): 节点内手动输入的文本。key_word(String): 固定前缀关键词。enhance_mode(List): 预设的强化提示词（如“画质增强”），会自动添加到文本最前方。
-
🟢 直通模式 (Free Pass = True)
- 场景: 正常运行工作流，优先使用上游输入。
- 逻辑:
- 如果上游有输入 (
in_text)，输出 =前缀+上游文本。 - 如果上游无输入，输出 =
前缀+节点内编辑文本。
- 如果上游有输入 (
-
🔴 编辑/截断模式 (Enable Edit = True)
- 场景: 调试时暂停工作流，或者修改上游传来的 Prompt。
- 逻辑:
- 工作流运行到此节点时会自动暂停 (Interrupt)。
- 节点会捕获上游传来的文本，并显示在节点上（需刷新或查看状态）。
- 此时你可以修改
edit_text，准备进行下一次手动发送。
-
🟡 手动/混合模式 (Free Pass = False & Enable Edit = False)
- 场景: 忽略上游输入，强制使用节点内的文本；或者使用之前捕获的文本。
- 逻辑:
- 最高优先级: 如果
edit_text有内容，直接输出前缀+edit_text(忽略上游)。 - 次级: 如果
edit_text为空，但上游有新输入，输出前缀+上游文本。 - 再次级: 如果都为空，但之前在“红灯模式”下捕获过文本，输出
前缀+捕获文本。
- 最高优先级: 如果
文本传递的终极威力加强版。保留了 WuhuoTextGate 所有的核心逻辑流控，但针对深度交互进行了革命性的前端 UI 重构。极力推荐在中大型复杂工作流中使用。
- 物理极客 HUD 控制台：节点内置了一个完全响应式的交互式工具栏，不需要展开冗长的参数菜单即可完成高频操作。
- 🔴🟡🟢 实体交通灯：直观展示当前节点的逻辑控制状态（🟢 直通 / 🔴 拦截 / 🟡 手动），单击即可直接循环切换状态。
- 流式自适应排版：工具栏图标采用现代响应式设计，拉大或缩窄节点时，图标会自动调整间距（最小 1 像素间距，并配有 260px 宽度物理保护），点击判定区像素级随动。
- 隐藏式输入端口优化：移除了多余的输入文本描述，大幅节省节点内部排版空间，带来极致纯净的视觉感受。
- 📁 选择收藏 (📁)：点击调出文本收藏夹分类弹窗，一键将历史收藏提示词直接灌入当前文本框。
- 📋 一键粘贴 (📋)：极速读取系统剪贴板文本并写入当前节点。
- 🗑️ 快速清空 (🗑️)：一键将节点内的全部文本归零。
- ⭐ 极速收藏 (⭐)：直接获取当前文本框的实时输入，唤起命名和分类选择弹窗，极速同步保存到系统的“文本收藏夹”统一数据库。
- 🚀 多选强化词 (🚀)：不用在属性框内打字，点击直观展示多选强化词 preset 预设，勾选即时追加。
- 🔑 设定前缀 (🔑)：快捷输入/修改固定前缀（Keyword）。
- 🎲 随机 SFW 模式 (🎲)：快捷开关，一键开启或关闭收藏库的 SFW 提示词随机抽取模式。
一个增强版的预览节点，支持对比、历史回溯及快捷操作。
- 双路输入:
images: 主图输入。images_opt: 对比图输入（可选），方便同时查看两组效果（如生图 vs 重绘）。
- 交互操作 (高级):
- 双击节点: 触发 Queue Selected Output Nodes（仅运行此节点及其上游）。
- 注: 如果安装了 rgthree 插件，会自动调用 rgthree 的优化执行逻辑；否则使用内置的递归执行逻辑。
- 单击图片: 进入大图预览模式。
- ESC 键: 在预览模式下退出预览。
- D 键: 鼠标悬浮在预览历史图片上时，按下 D 键即可直接在物理磁盘层面删除该张图片（带二次确认）。
- 双击节点: 触发 Queue Selected Output Nodes（仅运行此节点及其上游）。
- 历史记录:
- 自动保存经过该节点的图片到
custom_nodes/jdsc/data/history_images。 - 节点下方提供历史缩略图，点击即可在主视图回看旧图。
- 右键菜单: 支持“打开保存目录”、“清空历史”等操作。
- 自动保存经过该节点的图片到
- 动态布局:
- 根据图片数量自动调整网格（1x1, 1x2, 2x2 等）。
- 拖拽改变节点大小时，图片会自动适应布局。
专为视频生成 (AnimateDiff, HunyuanVideo 等) 设计的 Empty Latent。
- 核心优势: 自动计算帧数。你只需要输入视频时长（秒），节点会根据公式自动算出需要的 latent 帧数。
- 参数:
size_mode: 预设比例 (16:9, 4:3, 9:16 等) 或自定义。orientation: 横屏/竖屏一键切换。seconds: 视频时长（秒）。width/height: 基础分辨率。
- 输出: 包含 Batch 维度 (T) 的 Latent，且宽高自动对齐到 8 的倍数。
通用的 Empty Latent 增强版，适用于 FLUX, SDXL, Qwen 等文生图模型。
- 参数:
batch_size: 生成数量。size_mode: 常用画幅比例预设。width/height: 分辨率（默认 1024x1024）。
- 输出: 标准 Latent Tensor
[B, C, H, W]。
这是一个用于控制组 (Group) 状态的辅助节点，支持与 文本传递 (TextGate) 节点联动。
-
基本功能:
target_group: 选择一个画布上的组 (Group)。enable: 开关。- ON (开启): 目标组内的所有节点设为 Always (运行)，组展开。
- OFF (关闭): 目标组内的所有节点设为 Never (静音/跳过)，组折叠。
-
🔗 自动化联动 (核心玩法):
- 当画布上存在 TextGate 节点时，IgnoreGroup 会自动跟随 TextGate 的状态：
- TextGate 🟢绿灯 / 🔴红灯: 自动 开启 IgnoreGroup (组运行)。
- TextGate 🟡黄灯: 自动 关闭 IgnoreGroup (组静音)。
- 应用场景:
- 将耗时的“放大/重绘/人脸修复”模块放入一个组，并用 IgnoreGroup 控制。
- 当你调试 Prompt (黄灯) 时，这些耗时模块会自动跳过，实现秒级出图。
- 当你准备正式出图 (绿灯) 时，这些模块会自动恢复运行。
- 当画布上存在 TextGate 节点时，IgnoreGroup 会自动跟随 TextGate 的状态：
- Q: 安装后找不到节点？
- A: 请检查是否放入了
custom_nodes根目录，文件夹名建议为jdsc。重启 ComfyUI 并刷新浏览器。
- A: 请检查是否放入了
- Q: 搜索不到中文？
- A: 确保前端扩展已加载（控制台无报错），尝试清除浏览器缓存。
本项目采用 GNU General Public License v3.0 (GPL-3.0) 许可证开源。
Copyright (c) 2024-2026 icefox21
- 开源强制性：如果您修改了本项目并分发，您的整个分发项目也必须以 GPL-3.0 协议开源。
- 版权声明：必须在分发的代码中保留原作者的版权声明。
- 禁止闭源商用：不允许将本项目或其衍生作品用于不对外提供源代码的商业软件中。
详情请参阅项目根目录下的 LICENSE 文件。