Goohaitools-ComfyUI 孤海工具箱
🎬 视频教程
👉 点击前往 B 站主页观看全部教程
🧩 RunningHub 工作流
👉 点击访问我的 RunningHub 个人主页
RH Vibex主页 · 在线运行AI应用
孤海（Goohai）ComfyUI 实用工具集，合集包含 70+ 个实用节点，覆盖：文件夹批处理快速读图、指定 DPI 自动保存、多功能遮罩分析与运算、人脸自动矫正/对齐、证件照 & 身份证自动扶正拼版、图像自动排版、实用前端JS、取色器、数字混合运算、证件照可视化服装发型选择等。适合证件照/写真/批处理生产等场景。
📦 节点总览
所有节点默认位于 🔵孤海/（即 孤海工具箱）分类下，少量节点按功能归入子分类：孤海/结婚登记照、孤海定制、image 等。
📂 加载 & 文件夹 & 批处理
| 节点名称 | 说明 |
|---|---|
| 加载图像 | 增强版单图加载 |
| 加载批次图像 | 从文件夹批量加载图像，支持批处理工作流 |
| 📁文件夹图片统计 | 统计文件夹内图片数量 |
| 文件夹数量统计 | 统计子文件夹数量 |
| 文件夹索引 | 按序号读取文件夹内指定图片 |
| 根据文件名识别尺寸 | 从文件名自动解析图像宽高 |
| 批处理开关 | 批处理流中用于切换/汇总参数 |
| 批处理进度条 🐋 | 批处理任务实时进度可视化 |
| 自动新建文件夹 | 自动按规则创建输出目录 |
| 自动切换正反斜杠 | Windows / Mac / Linux 路径斜杠自动兼容 |
| 忽略多组 | 工作流中忽略多余分支输出 |
| 字符串按类型分隔 | 按类型拆分混合字符串 |
💾 保存 & 输出
| 节点名称 | 说明 |
|---|---|
| 保存图像JPG | 轻量化JPG 格式保存，减少等待时间 |
| 图像保存 | 高级图像保存（高级参数）为批处理而生 |
📐 尺寸 & 缩放 & 裁剪
| 节点名称 | 说明 |
|---|---|
| 预设尺寸 | 常用尺寸快捷选项（证件照/社媒/打印等） |
| 图像缩放V2 | 图像缩放 V2 增强版 |
| 图像缩放按像素 | 按目标像素总数缩放 |
| 图像缩放（范围） | 在指定宽高范围内自适应缩放 |
| 图像裁剪按比例 | 按宽高比裁剪 |
| 图像裁剪（主体保护） | 基于遮罩保护主体的智能裁剪 |
| 图像旋转 | 图像旋转（常用角度选择） |
| 外补画板（按目标宽高） | 三合一外补画板 —— 按目标宽高 |
| 外补画板（按比例） | 三合一外补画板 —— 按比例 |
| 外补画板（按方向） | 三合一外补画板 —— 按方向 |
🎨 排版 & 拼版
| 节点名称 | 说明 |
|---|---|
| 单尺寸排版 | 单尺寸网格/证件照排版 |
| 多尺寸混合排版 | 不同尺寸图片混合排版 |
| 批量自动排版 | 批量自动排版到指定纸型/DPI |
| 身份证自动扶正拼版 | 身份证自动旋转扶正并拼版 |
| 图像嵌入 | 将图像嵌入PNG模板指定位置（水印/相框场景） |
🎭 遮罩（Mask）处理
| 节点名称 | 说明 |
|---|---|
| 遮罩检测 | 自动检测图像生成遮罩 |
| 遮罩分析 | 输出遮罩包围盒、面积、中心等信息 |
| 遮罩比例计算 | 计算遮罩占图像比例 |
| 遮罩对齐v2 | 遮罩与目标位置对齐 V2 |
| 遮罩中心对齐 | 按遮罩中心对齐 |
| 遮罩裁剪 | 根据遮罩裁剪图像 |
| 遮罩裁剪V2 | 通过遮罩裁剪再贴回，解决采样像素偏移问题 |
| 裁剪恢复 | 将裁剪后的图像恢复到原坐标 |
| 遮罩模糊生长按比例 | 遮罩按比例模糊扩张/收缩 |
| 遮罩混合运算 | 遮罩加减乘/交并补等运算 |
| 头顶遮罩 | 自动生成头顶扩展遮罩（证件照换装/发型场景） |
| 遮罩圆角消除 | 消除遮罩圆角带来的黑边 |
| Seg次序过滤 | Seg 分割次序过滤 |
| 图像与遮罩预览 | 图像 + 遮罩实时预览 |
| 图像与遮罩描边 | 沿遮罩边缘绘制描边 |
🖼️ 图像处理
| 节点名称 | 说明 |
|---|---|
| 保留遮罩区域移除图像背景 | 保留遮罩内区域，外部背景移除 |
| 移除纯色背景 v2 | 自动识别并移除纯色背景 |
| 图像合并（遮罩） | 基于遮罩合成两张图像 |
| 图像差异到遮罩 | 两张图像差异生成遮罩 |
| 图像添加水印 | 批量添加文字/图片水印 |
| 图像组合批次 | 多批次图像合并 |
| 自动分割图像 | 根据主体/空白自动切图 |
| 图像亮度比较 | 比较图像亮度，输出更亮/更暗分支 |
| 肤色差值 | 计算图像肤色差异，可用于肤色一致性判断 |
| 主色提取（多版本兼容） | 提取图像主色调 |
| 颜色转换 | HSV/RGB/LAB 等颜色空间互转 |
| 常用颜色🔵孤海 | 常用颜色快捷选取 |
| 🎨 取色器 / 孤海 取色器（双） | 图像拾色器（单色/双色） |
| 自定义颜色 | 自定义颜色输出 |
👤 人脸 & 证件照
| 节点名称 | 说明 |
|---|---|
| 👤 人脸自动矫正 | 基于关键点自动矫正人脸角度 |
| 面部对齐 | 双眼水平对齐，标准脸对齐 |
| 证件照裁剪 | 按证件照规范（头肩比/位置）自动裁剪 |
| 证件照服装发型 | 证件照服装/发型切换（内置男女士西装、马甲、衬衫、减龄上衣等几十套模板） |
| 结婚登记照服装 | 结婚登记照服装切换模板 |
| 证件照简易提示词 | 一键生成证件照常用提示词 |
| ID信息 | 身份证文字信息节点 |
| ID证生成器 | 身份证图片生成/排版节点 |
🧰 通用小工具
| 节点名称 | 说明 |
|---|---|
| 孤海万能滑条 | 通用整数/浮点滑条，动态范围 |
| 孤海-浮点滑条 / 孤海-浮点滑条 0-2 | 浮点滑条（0–1 / 0–2） |
| 布尔 孤海 | 布尔开关 |
| 孤海-效果切换 | 多效果分支切换（N 选 1） |
| 数学运算 孤海 | 加减乘除/混合数学运算/支持三元表达式 |
✨ 特色能力速览
📁 文件夹批处理
- 快速加载整个文件夹图片、自动索引、自动统计
- 配合 批处理进度条 🐋 直观显示当前处理进度
- 自动新建输出目录，跨平台路径斜杠自动修正
💾 智能保存
- 支持 JPG 指定 DPI（打印/证件照常用 300dpi）
- 高级保存支持自定义压缩、元数据、命名规则
🎨 自动排版
- 单尺寸 / 多尺寸混合 / 批量自动 三种排版模式
- 适配 A4/A5/6 寸等纸型，自动拼版到打印规格
- 身份证自动扶正并排版到标准身份证模板
👤 人脸 & 证件照生产流
- 人脸检测 → 面部对齐 → 证件照裁剪 → 服装/发型替换 → 自动排版一条龙
- 内置女士西装/马甲/衬衫/减龄上衣、结婚登记照等 几十套服装模板（见
image/ID_Photo/目录） - 人脸自动矫正 + 肤色差值 + 头顶遮罩扩展，保证换装/换发型自然
🎭 遮罩全家桶
- 检测 → 分析 → 生长 → 模糊 → 对齐 → 裁剪 → 恢复 → 混合运算，覆盖绝大部分遮罩场景
- 主体保护裁剪、保留遮罩区域抠背景、图像差异生成遮罩等进阶能力
🌈 颜色 & 取色
- 取色器、常用色板、颜色空间转换、主色提取，配色/色偏校正场景常用
⚙️ 安装
方法一：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 万能滑条前端交互 id_photo_clothing.js / marry.js 证件照、结婚登记照服装选择前端组件 启用后部分节点（取色器、万能滑条、服装切换等）会有更友好的交互 UI。
📝 许可证
本项目采用开源协议发布，欢迎 Star、Fork、PR。
💬 反馈 & 交流 📺 B 站（视频教程 / 工作流演示）：孤海B 🐛 GitHub Issues：提 Bug & 需求 💡 如有问题、想要新增的功能或节点建议，欢迎在 GitHub 提 Issue 或 B 站私信；觉得好用的话，欢迎给仓库点个 Star ⭐。