# Goohaitools-comfyui **Repository Path**: htqs_admin/Goohaitools-comfyui ## Basic Information - **Project Name**: Goohaitools-comfyui - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-10 - **Last Updated**: 2026-08-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Goohaitools-ComfyUI 孤海工具箱 [![GitHub](https://img.shields.io/badge/GitHub-Goohaitools--comfyui-1E90FF?style=flat-square)](https://github.com/goohai/Goohaitools-comfyui) [![B站](https://img.shields.io/badge/B站-孤海FOTO-FF69B4?style=flat-square&logo=bilibili)](https://space.bilibili.com/1194488958) ## 🎬 视频教程 ### 👉 [点击前往 B 站主页观看全部教程](https://space.bilibili.com/1194488958) [![B站视频教程](https://img.shields.io/badge/B站-视频教程-FF69B4?style=for-the-badge&logo=bilibili)](https://space.bilibili.com/1194488958) --- ## 🧩 RunningHub 工作流 ### 👉 [点击访问我的 RunningHub 个人主页](https://www.runninghub.cn/user-center/1959241033525714946/webapp?inviteCode=rh-v1557) 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 克隆（推荐，便于后续更新） ```bash 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 ⭐。