%20(1).png)
ComfyUI-fofr-toolkit 插件完全使用教程
1. 插件简介
ComfyUI-fofr-toolkit 是一个简单而实用的工具节点合集，专门为 ComfyUI 设计。这个插件就像一个多功能的工具箱，里面装着几个非常实用的小工具。插件的 GitHub 原地址是：https://github.com/fofr/comfyui-fofr-toolkit
这个插件能给我们带来三个核心功能：一个是简单的计数器（就像手机里的计步器），一个是根据画面比例自动算出图片宽高的计算器，还有一个是帮我们把图片放大缩小时保持原来形状不变形的智能助手。
无论你是想批量生成图片、需要精确控制图片尺寸，还是想让图片缩放时不变形，这个插件都能帮到你。就像有了一个贴心的数学小助手，帮你算好各种尺寸问题。
2. 如何安装
有几种方法可以安装这个插件：
方法一：通过 ComfyUI Manager 安装（推荐）
- 在 ComfyUI 界面中，点击右侧的"Manager"按钮
- 选择"Install Custom Nodes"
- 在搜索框中输入"comfyui-fofr-toolkit"
- 找到对应插件后点击"Install"
- 重启 ComfyUI
方法二：手动下载安装
- 打开 ComfyUI 安装目录下的
custom_nodes文件夹 - 在命令行中执行：
git clone https://github.com/fofr/comfyui-fofr-toolkit.git - 重启 ComfyUI
方法三：手动下载解压
- 访问 https://github.com/fofr/comfyui-fofr-toolkit
- 点击绿色的"Code"按钮，选择"Download ZIP"
- 解压到 ComfyUI 的
custom_nodes文件夹中 - 重启 ComfyUI
安装完成后，在添加节点时，你会在节点列表中找到这些新增的工具节点。
3. 节点逐一解析
3.1 Incrementer 节点（计数器）
这个节点就像一个简单的计数器，比如你家里用的那种计步器。它会从一个数字开始，每次运行就往上加1，到了设定的最大值就重新从0开始计数。
用途举例：
- 批量生成图片时给每张图片编号
- 在循环工作流程中控制步骤
- 作为其他节点的计数输入
3.2 Incrementer 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| current_index | current_index | 整数，默认 0 | 0 | 就像计数器的起始数字，从这里开始数 | 当前计数器的索引值，表示计数的起始位置 | 如果设置为5，计数器就从5开始：5, 6, 7, 8... |
| max | max | 整数，默认 10 | 10 | 就像计数器的最大值，数到这里就重新开始 | 计数器的最大值，达到后会重置为0 | 设置为10时，计数器会：0,1,2...9,0,1,2... |
输出： 返回当前的计数值（整数）
3.3 Width and height from aspect ratio 节点（根据长宽比计算尺寸）
这个节点就像一个智能的尺寸计算器。你告诉它想要什么样的画面比例（比如方形、宽屏、超宽屏），再告诉它你想要多大的图片，它就会自动算出具体的宽度和高度数值。
用途举例：
- 根据不同的显示设备计算合适的图片尺寸
- 确保生成的图片符合特定的长宽比要求
- 快速设置标准的图片格式尺寸
3.4 Width and height from aspect ratio 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| aspect_ratio | aspect_ratio | 预设比例选项（如"1:1", "16:9", "21:9"） | "1:1" | 就像选择照片是方形、宽屏还是超宽屏的形状 | 定义图像的宽高比例关系 | "1:1"是正方形，"16:9"是宽屏电视的比例，"21:9"是超宽屏 |
| target_size | target_size | 整数，表示目标尺寸 | 1024 | 就像告诉计算器你想要多大的图片 | 目标分辨率的参考值，用于计算具体的宽高像素 | 设置1024时，会根据比例计算出接近这个大小的尺寸 |
| multiple_of | multiple_of | 整数，范围1-1024，默认8 | 8 | 就像要求尺寸必须是某个数字的倍数，让图片更标准 | 确保输出的宽高都是指定数值的倍数 | 设置为8时，输出的宽高都是8的倍数，如512、520、528等 |
输出： 返回计算好的宽度值和高度值（两个整数）
3.5 Width and height for scaling image to ideal resolution 节点（图片缩放尺寸计算）
这个节点就像一个聪明的图片尺寸顾问。当你有一张图片想要放大或缩小到某个目标尺寸时，它会自动计算出最合适的新尺寸，确保图片不会被拉伸变形，保持原来的形状比例。
用途举例：
- 把不同尺寸的图片统一调整到相似大小
- 在保持图片不变形的前提下调整尺寸
- 为后续的图片处理步骤准备合适的输入尺寸
3.6 Width and height for scaling image to ideal resolution 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | 必须连接 | 就像把你要调整尺寸的照片放进这个计算器 | 需要缩放的输入图像数据 | 连接任何图片节点的输出，比如加载图片节点的输出 |
| target_size | target_size | 整数，范围64-8192，默认1024 | 1024 | 就像告诉计算器你希望图片变成多大 | 目标分辨率大小，作为缩放的参考标准 | 设置1024时，图片会被缩放到接近1024x1024的大小 |
| multiple_of | multiple_of | 整数，范围1-1024，默认8 | 8 | 就像要求新尺寸必须是某个数字的倍数，让结果更规整 | 确保输出的宽高都是指定数值的倍数 | 设置为8时，确保输出尺寸是8的倍数，兼容更多AI模型 |
输出： 返回计算好的新宽度值和新高度值（两个整数）
举个例子：一张3:2比例的图片，如果目标是1024x1024像素，这个节点会计算出1256x840的尺寸（而不是不理想的1024x682），这样既接近目标大小，又保持了原图的比例不变形。
4. 使用技巧和建议
技巧1：批量生成时的编号管理
使用 Incrementer 节点可以为批量生成的图片自动编号。将计数器的输出连接到文件名或种子值，每次生成都会得到不同的结果。
技巧2：标准尺寸快速设置
使用 Width and height from aspect ratio 节点可以快速设置常见的图片尺寸：
- "1:1" 适合社交媒体头像
- "16:9" 适合视频缩略图和横屏壁纸
- "9:16" 适合手机竖屏壁纸
- "21:9" 适合超宽屏显示器
技巧3：multiple_of 参数的重要性
建议保持 multiple_of 为 8 或 16，因为：
- 大多数 AI 模型对 8 的倍数尺寸处理更好
- 可以避免某些模型出现错误
- 计算效率更高
技巧4：图片缩放的最佳实践
使用图片缩放节点时：
- target_size 建议设置为 512、768、1024 等常用尺寸
- 对于高质量图片生成，推荐 1024 或更高
- 对于快速预览，可以使用 512
5. 常见问题解答
Q1：为什么我的计数器不能重置？
A：检查 max 参数是否设置正确。计数器只有达到 max 值时才会重置为 0。
Q2：aspect_ratio 有哪些可选项？
A：常见的比例包括 "1:1"（正方形）、"16:9"（宽屏）、"21:9"（超宽屏）等预设选项。具体可选项会在节点的下拉菜单中显示。
Q3：为什么图片缩放后尺寸和我设置的 target_size 不完全一样？
A：这是正常的。节点会在保持原图比例的前提下，计算出最接近目标尺寸的合适大小，同时确保尺寸是 multiple_of 的倍数。
Q4：multiple_of 设置为多少比较好？
A：建议设置为 8 或 16。这样可以确保生成的图片尺寸与大多数 AI 模型兼容，避免出现错误。
Q5：这些节点能连接其他插件的节点吗？
A：可以。这些节点输出的都是标准的数值类型，可以连接到任何需要宽度、高度或整数输入的节点。
6. 实际应用场景
场景1：批量生成不同尺寸的图片
- 使用 Incrementer 节点控制循环次数
- 使用 Width and height from aspect ratio 节点设置不同的尺寸
- 将输出连接到图片生成节点的宽高输入
场景2：图片预处理工作流
- 加载原图片
- 使用 Width and height for scaling image 节点计算合适的缩放尺寸
- 将计算结果用于后续的图片调整节点
场景3：标准化图片输出
使用这些工具节点可以确保所有生成的图片都符合特定的尺寸标准，便于后续的批量处理或展示。
这个插件虽然节点不多，但每个都非常实用，就像工具箱里的基础工具一样，虽然简单却不可缺少。掌握了这些基础工具，你就能更好地控制 ComfyUI 的工作流程，让图片生成更加精确和高效。