comfyui-image_psss

ComfyUI Image PSSS v2.1（黑图修复版）

批量图片加载器，全面兼容 ComfyUI v0.19.x+ / Frontend 1.42+ / Nodes 2.0

节点

| 节点 | 说明 | |------|------| | 📂 Load Image (Multi 5) | 5 输出，支持文件 + URL | | 📂 Load Image (Multi 10) | 10 输出扩展版 | | 🔗 Load Image from URLs | 纯 URL 输入（10 输出） |

v2.1 黑图修复

之前版本在 URL 加载失败（链接过期、404、超时、防盗链等）时会静默输出一张黑图，难以排查。v2.1 彻底修复：

• 🚨 失败不再静默黑图：新增 on_error 选项，默认「报错提示」——加载失败时节点变红并显示具体原因（如 HTTP 404（文件可能已过期或被删除））；也可切换为「输出占位图」（品红色，与空槽黑图明显区分）
• 🔁 URL 加载更健壮：HTTP 状态码 / Content-Type 校验、HTML 错误页检测、失败自动重试、超时延长至 60 秒
• 🖼️ 修复 16-bit 灰度 PNG（mode I / I;16）转换后全黑/全白的问题
• 🔄 EXIF 方向自动校正，手机拍摄图片不再旋转 90°
• 📎 Load Image from URLs 支持直接填 input 目录文件名：修复拖拽/粘贴上传后输出黑图的问题
• 空槽位（未填写任何内容）行为不变：输出 64×64 黑图（ComfyUI 惯例）

旧工作流无需修改：on_error 为可选输入，旧存档自动使用默认值。

v2 兼容性改进

后端

• ✅ 添加 has_intermediate_output = True 标志，适配 Nodes 2.0 交互式节点
• ✅ 使用 folder_paths.get_folder_paths("input") 优先，回退旧版 API
• ✅ 改进 IS_CHANGED 哈希生成，避免 ComfyUI 缓存问题
• ✅ 增强 VALIDATE_INPUTS 文件存在性验证
• ✅ 支持 NumPy 2.0+ 环境
• ✅ 透明图自动转 RGB（白色背景）

前端

• ✅ 兼容 Nodes 2.0 新渲染引擎（更大的节点、新的 DOM 结构）
• ✅ 使用 CSS 变量适配 ComfyUI 主题系统
• ✅ 使用 app.extensionManager.toast.add 替代 alert（新版 API）
• ✅ 向后兼容旧版 ComfyUI（v0.3.x）
• ✅ 延迟构建策略，确保 widget DOM 就绪

UI 功能

• 🖱️ 拖拽上传：直接拖文件到任意 slot
• 🔀 拖拽排序：拖拽 ⋮⋮ 调整 slot 顺序
• 📋 粘贴支持：Ctrl+V 粘贴剪贴板图片
• 🗑️ 清空按钮：每个 slot 一键清空
• 📁 批量上传：自动填充空位，带进度提示
• 👁️ 实时预览：文件/URL 预览缩略图

安装

将本文件夹放入 ComfyUI/custom_nodes/ 目录，重启 ComfyUI 即可。

cd ComfyUI/custom_nodes
git clone https://github.com/heyzne/comfyui-image_psss.git

注意事项

• Nodes 2.0 为 beta 功能，如遇到渲染问题可暂时关闭 Nodes 2.0
• 本插件同时兼容旧版 ComfyUI，无需担心升级后失效