Goohaitools-ComfyUI 孤海工具箱

🎬 视频教程

🧩 RunningHub 工作流

👉 点击访问我的 RunningHub 个人主页

孤海（Goohai）ComfyUI 实用工具集，合集包含 70+ 个实用节点，覆盖：文件夹批处理快速读图、指定 DPI 自动保存、多功能遮罩分析与运算、人脸自动矫正/对齐、证件照 & 身份证自动扶正拼版、图像自动排版、实用前端JS、取色器、数字混合运算、证件照可视化服装发型选择等。适合证件照/写真/批处理生产等场景。

📦 节点总览

所有节点默认位于 🔵孤海/（即 孤海工具箱）分类下，少量节点按功能归入子分类：孤海/结婚登记照、孤海定制、image 等。

📂 加载 & 文件夹 & 批处理

节点名称	说明
加载图像	增强版单图加载
加载批次图像	从文件夹批量加载图像，支持批处理工作流
📁文件夹图片统计	统计文件夹内图片数量
文件夹数量统计	统计子文件夹数量
文件夹索引	按序号读取文件夹内指定图片
根据文件名识别尺寸	从文件名自动解析图像宽高
批处理开关	批处理流中用于切换/汇总参数
批处理进度条 🐋	批处理任务实时进度可视化
自动新建文件夹	自动按规则创建输出目录
自动切换正反斜杠	Windows / Mac / Linux 路径斜杠自动兼容
忽略多组	工作流中忽略多余分支输出
字符串按类型分隔	按类型拆分混合字符串

💾 保存 & 输出

节点名称	说明
保存图像JPG	轻量化JPG 格式保存，减少等待时间
图像保存	高级图像保存（高级参数）为批处理而生

📐 尺寸 & 缩放 & 裁剪

节点名称	说明
预设尺寸	常用尺寸快捷选项（证件照/社媒/打印等）
图像缩放V2	图像缩放 V2 增强版
图像缩放按像素	按目标像素总数缩放
图像缩放（范围）	在指定宽高范围内自适应缩放
图像裁剪按比例	按宽高比裁剪
图像裁剪（主体保护）	基于遮罩保护主体的智能裁剪
图像旋转	图像旋转（常用角度选择）
外补画板（按目标宽高）	三合一外补画板 —— 按目标宽高
外补画板（按比例）	三合一外补画板 —— 按比例
外补画板（按方向）	三合一外补画板 —— 按方向

🎨 排版 & 拼版

节点名称	说明
单尺寸排版	单尺寸网格/证件照排版
多尺寸混合排版	不同尺寸图片混合排版
批量自动排版	批量自动排版到指定纸型/DPI
身份证自动扶正拼版	身份证自动旋转扶正并拼版
图像嵌入	将图像嵌入PNG模板指定位置（水印/相框场景）

🎭 遮罩（Mask）处理

节点名称	说明
遮罩检测	自动检测图像生成遮罩
遮罩分析	输出遮罩包围盒、面积、中心等信息
遮罩比例计算	计算遮罩占图像比例
遮罩对齐v2	遮罩与目标位置对齐 V2
遮罩中心对齐	按遮罩中心对齐
遮罩裁剪	根据遮罩裁剪图像
遮罩裁剪V2	通过遮罩裁剪再贴回，解决采样像素偏移问题
裁剪恢复	将裁剪后的图像恢复到原坐标
遮罩模糊生长按比例	遮罩按比例模糊扩张/收缩
遮罩混合运算	遮罩加减乘/交并补等运算
头顶遮罩	自动生成头顶扩展遮罩（证件照换装/发型场景）
遮罩圆角消除	消除遮罩圆角带来的黑边
Seg次序过滤	Seg 分割次序过滤
图像与遮罩预览	图像 + 遮罩实时预览
图像与遮罩描边	沿遮罩边缘绘制描边

🖼️ 图像处理

节点名称	说明
图像对比视频对比 GH	图像/视频滑动对比、自动双拼、左右双拼、上下双拼，支持批次选择
保留遮罩区域移除图像背景	保留遮罩内区域，外部背景移除
移除纯色背景 v2	自动识别并移除纯色背景
图像合并（遮罩）	基于遮罩合成两张图像
图像差异到遮罩	两张图像差异生成遮罩
图像添加水印	批量添加文字/图片水印
图像组合批次	多批次图像合并
自动分割图像	根据主体/空白自动切图
图像亮度比较	比较图像亮度，输出更亮/更暗分支
肤色差值	计算图像肤色差异，可用于肤色一致性判断
主色提取（多版本兼容）	提取图像主色调
颜色转换	HSV/RGB/LAB 等颜色空间互转
常用颜色🔵孤海	常用颜色快捷选取
🎨 取色器 / 孤海取色器（双）	图像拾色器（单色/双色）
自定义颜色	自定义颜色输出

👤 人脸 & 证件照

节点名称	说明
👤 人脸自动矫正	基于关键点自动矫正人脸角度
面部对齐	双眼水平对齐，标准脸对齐
证件照裁剪	按证件照规范（头肩比/位置）自动裁剪
证件照服装发型	证件照服装/发型切换（内置男女士西装、马甲、衬衫、减龄上衣等几十套模板）
结婚登记照服装	结婚登记照服装切换模板
证件照简易提示词	一键生成证件照常用提示词
ID信息	身份证文字信息节点
ID证生成器	身份证图片生成/排版节点

🧰 通用小工具

节点名称	说明
孤海万能滑条	通用整数/浮点滑条，动态范围
孤海-浮点滑条 / 孤海-浮点滑条 0-2	浮点滑条（0–1 / 0–2）
布尔孤海	布尔开关
孤海-效果切换	多效果分支切换（N 选 1）
数学运算孤海	加减乘除/混合数学运算/支持三元表达式

✨ 特色能力速览

📁 文件夹批处理

快速加载整个文件夹图片、自动索引、自动统计
配合 批处理进度条 🐋 直观显示当前处理进度
自动新建输出目录，跨平台路径斜杠自动修正

💾 智能保存

支持 JPG 指定 DPI（打印/证件照常用 300dpi）
高级保存支持自定义压缩、元数据、命名规则

🎨 自动排版

单尺寸 / 多尺寸混合 / 批量自动 三种排版模式
适配 A4/A5/6 寸等纸型，自动拼版到打印规格
身份证自动扶正并排版到标准身份证模板

👤 人脸 & 证件照生产流

人脸检测 → 面部对齐 → 证件照裁剪 → 服装/发型替换 → 自动排版一条龙
内置女士西装/马甲/衬衫/减龄上衣、结婚登记照等 几十套服装模板（见 image/ID_Photo/ 目录）
人脸自动矫正 + 肤色差值 + 头顶遮罩扩展，保证换装/换发型自然

🎭 遮罩全家桶

检测 → 分析 → 生长 → 模糊 → 对齐 → 裁剪 → 恢复 → 混合运算，覆盖绝大部分遮罩场景
主体保护裁剪、保留遮罩区域抠背景、图像差异生成遮罩等进阶能力

🌈 颜色 & 取色

取色器、常用色板、颜色空间转换、主色提取，配色/色偏校正场景常用

🖼️ 图像/视频对比

支持滑动对比、自动双拼、左右双拼、上下双拼
支持图像和视频预览、视频播放/暂停及进度控制
双拼模式支持 Alt+滚轮缩放、Alt+左键框内平移，视频支持全屏对比
批次输入可选择前 10 张图像分别对比
自动调用输入文件进行预览，无需在 temp 目录新增文件

⚙️ 安装

方法一：Git 克隆（推荐，便于后续更新）

cd ComfyUI/custom_nodes/
git clone https://github.com/goohai/Goohaitools-comfyui.git
cd Goohaitools-comfyui
pip install -r requirements.txt

重启 ComfyUI 即可。

方法二：手动下载

下载 Goohaitools-comfyui ZIP 包解压到 ComfyUI/custom_nodes/ 目录，确保目录名为 Goohaitools-comfyui 进入该目录执行 pip install -r requirements.txt 重启 ComfyUI

requirements.txt 主要依赖：

opencv-python / scipy / scikit-image / matplotlib：图像处理核心 mediapipe>=0.10.20：人脸/关键点检测 dlib-bin>=19.24.6：人脸 5 点关键点模型（仓库已内置 shape_predictor_5_face_landmarks.dat）若使用国内网络 pip 安装慢，requirements 已默认配置清华镜像源（-i https://pypi.tuna.tsinghua.edu.cn/simple）。

🔧 前端扩展组件

本插件在 web/js/ 下提供多个前端 Widget 增强：

BOOLEAN.js 布尔开关组件 GoohaiNote.js 节点备注/便签 colorWidget.js 颜色取色器 Widget goohai_universal_slider.js 万能滑条前端交互 gh_image_video_comparer.js 图像/视频对比预览 id_photo_clothing.js / marry.js 证件照、结婚登记照服装选择前端组件启用后部分节点（取色器、万能滑条、服装切换等）会有更友好的交互 UI。

📝 许可证

本项目采用开源协议发布，欢迎 Star、Fork、PR。

💬 反馈 & 交流 📺 B 站（视频教程 / 工作流演示）：孤海B 🐛 GitHub Issues：提 Bug & 需求 💡 如有问题、想要新增的功能或节点建议，欢迎在 GitHub 提 Issue 或 B 站私信；觉得好用的话，欢迎给仓库点个 Star ⭐。