ComfyUI 魔法书 Logo
🏠 首页
👥 加群
🔥 报错不求人
😎 大帅比
登录 →
ComfyUI 魔法书 Logo
🏠 首页 👥 加群 🔥 报错不求人 😎 大帅比
登录
  1. 首页
  2. 🧩 插件工坊 (Plugin Workshop)
  3. ComfyUI MaraScott插件超详细使用教程 手把手教你玩转节点功能

ComfyUI MaraScott插件超详细使用教程 手把手教你玩转节点功能

0
  • 🧩 插件工坊 (Plugin Workshop)
  • 发布于 2025-06-30
  • 10 次阅读
编程界的小学生
编程界的小学生

ComfyUI MaraScott Nodes 插件保姆级教程

1. 插件简介

插件地址: https://github.com/MaraScott/ComfyUI_MaraScott_Nodes

这个插件就像是给你的 ComfyUI 装了一个"超级工具箱"!它包含了很多实用的小工具,让你的工作流程变得更加简单和高效。

能给我们带来什么效果:

  • 万能总线(AnyBus):就像电脑主板上的总线一样,可以把很多连线整理得干干净净
  • 图片放大精修器(McBoaty):专门用来放大图片并让细节更清晰,就像给照片做美容
  • 循环工具:可以让同样的操作重复很多次,不用手动复制粘贴
  • 文字处理工具:帮你合并文字、转换格式等
  • 条件判断工具:可以根据不同情况做不同的处理

2. 如何安装

方法一:通过 ComfyUI Manager 安装(推荐)

  1. 打开 ComfyUI,点击主菜单的"Manager"按钮
  2. 点击"Custom Nodes Manager"
  3. 搜索"MaraScott"
  4. 点击"install"按钮
  5. 重启 ComfyUI

方法二:手动下载安装

  1. 打开你的 ComfyUI 文件夹
  2. 找到 custom_nodes 文件夹
  3. 在这个文件夹里新建一个叫 ComfyUI_MaraScott_Nodes 的文件夹
  4. 去插件地址下载所有文件
  5. 把下载的文件都放到刚才新建的文件夹里
  6. 重启 ComfyUI

3. 节点详细解析

3.1 AnyBus_v2 节点(万能总线)

这个节点就像是一个"电线整理器",可以把很多乱七八糟的连线整理成一根整齐的"总线",让你的工作流程看起来更清爽。

3.2 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
busbusBUS连接连接其他总线把其他总线的内容传过来输入总线数据用于合并或传递连接另一个AnyBus节点的输出
各种输入槽位动态生成任意类型根据需要连接可以连接任何类型的数据支持所有ComfyUI数据类型的通用接口连接模型、图片、文字等任何数据

输出:

  • bus:整理好的总线,可以连接到其他需要这些数据的节点

3.3 LoadImage_v1 节点(加载图片增强版)

这个节点就像是一个"智能相册管理器",不仅能加载图片,还能告诉你图片的文件名。

3.4 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
imageimage下拉选择框选择你要的图片从文件夹里选择要处理的图片从输入目录选择图像文件点击下拉菜单选择图片文件
filename_with_extfilename_with_ext布尔值False是否在文件名里包含扩展名(如.jpg)控制输出文件名是否包含文件扩展名勾选后输出"图片.jpg",不勾选输出"图片"

输出:

  • IMAGE:加载的图片
  • MASK:图片的遮罩(如果有的话)
  • File Name:图片的文件名

3.5 DisplayInfo_v2 节点(信息显示器)

这个节点就像是一个"万能显示屏",可以显示任何类型的信息,帮你调试和查看数据。

3.6 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
anyany任意类型连接你想查看的数据可以显示任何类型的数据内容通用数据显示接口,支持所有数据类型连接模型、文字、数字等任何数据来查看内容

输出:

  • any:原样输出输入的数据,方便继续使用

3.7 McBoaty_Upscaler_v5 节点(图片放大器)

这个节点就像是一个"照片放大镜",可以把小图片放大成大图片,并且保持清晰度。

3.8 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
imageimageIMAGE连接连接要放大的图片输入需要放大的图片输入图像数据用于放大处理连接LoadImage节点的图片输出
modelmodelMODEL连接连接AI模型用来生成图片的AI大脑Stable Diffusion模型用于图像生成连接CheckpointLoader的模型输出
clipclipCLIP连接连接文字理解器用来理解文字描述的工具CLIP模型用于文本编码连接CheckpointLoader的CLIP输出
vaevaeVAE连接连接图片编解码器用来处理图片格式转换的工具VAE模型用于图像编解码连接CheckpointLoader的VAE输出
positivepositiveCONDITIONING连接连接正面提示词告诉AI你想要什么效果正向条件编码用于指导生成连接CLIPTextEncode的正面提示词
negativenegativeCONDITIONING连接连接负面提示词告诉AI你不想要什么效果负向条件编码用于避免不良生成连接CLIPTextEncode的负面提示词
seedseed整数42随机数种子,控制生成的随机性控制随机数生成器的种子值设置固定数字可以重复生成相同结果
upscale_modelupscale_model下拉选择选择放大模型选择用什么方法来放大图片选择图像超分辨率模型选择"4x-UltraSharp.pth"等放大模型
output_upscale_methodoutput_upscale_method下拉选择bicubic最终输出时的缩放方法图像缩放算法选择选择"bicubic"获得较好的缩放质量
tile_sizetile_size整数512切片大小,把大图切成小块处理图像分块处理的块大小512适合大多数情况,显存不够可以调小
feather_maskfeather_mask整数64切片边缘羽化大小,让拼接更自然图像块边缘羽化处理的像素数64可以让拼接痕迹不明显
vae_encodevae_encode布尔值True是否使用分块编码方式选择VAE编码方式勾选可以节省显存,不勾选速度更快
tile_size_vaetile_size_vae整数512VAE处理时的分块大小VAE分块处理的块大小512适合大多数情况
color_match_methodcolor_match_method下拉选择none颜色匹配方法,让输出颜色更接近原图颜色匹配算法选择选择"mkl"可以保持原图色调
tile_prompting_activetile_prompting_active布尔值False是否为每个切片生成专门的提示词启用基于图像内容的动态提示词生成勾选可以让每个区域的描述更准确
vision_llm_modelvision_llm_model下拉选择microsoft/Florence-2-large用来分析图片内容的AI模型视觉语言模型用于图像理解选择Florence-2模型分析图片内容
llm_modelllm_model下拉选择llama3-70b-8192用来生成文字描述的AI模型大语言模型用于文本生成选择llama3模型生成描述文字

输出:

  • McBoaty Pipe:传递给精修器的数据包
  • McPrompty Pipe:传递给提示词编辑器的数据包
  • info:处理信息和统计数据

3.9 McBoaty_Refiner_v5 节点(图片精修器)

这个节点就像是一个"照片修图师",可以对放大后的图片进行精细修饰,让细节更完美。

3.10 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
pipepipeMC_BOATY_PIPE连接连接放大器输出接收放大器传来的数据包McBoaty管道数据用于精修处理连接McBoaty_Upscaler的管道输出
tiles_to_processtiles_to_process字符串空字符串指定要处理的切片编号指定需要精修的图像块索引输入"1,3,5"只处理第1、3、5块
output_size_typeoutput_size_type布尔值True输出尺寸类型选择选择输出图像尺寸计算方式勾选使用放大模型尺寸,不勾选使用自定义
output_sizeoutput_size浮点数1.00自定义输出尺寸倍数相对于输入图像的缩放倍数2.0表示输出图像是输入的2倍大
sigmas_typesigmas_type下拉选择BasicScheduler噪声调度器类型扩散模型的噪声调度算法BasicScheduler适合大多数情况
model_typemodel_type下拉选择SDXL模型类型,影响处理参数指定使用的模型架构类型根据你的模型选择SD1、SDXL或SD3
sampler_namesampler_name下拉选择euler采样器名称扩散模型采样算法euler采样器速度快质量好
basic_schedulerbasic_scheduler下拉选择normal基础调度器噪声调度的具体实现normal适合大多数情况
stepssteps整数10采样步数,影响质量和速度扩散模型的迭代步数10步速度快,20步质量更好
cfgcfg浮点数2.5提示词引导强度分类器自由引导强度2.5-7.5之间,越高越严格按提示词生成
denoisedenoise浮点数0.27去噪强度,控制修改程度扩散过程的去噪强度0.27保持原图,0.8大幅修改
control_net_namecontrol_net_name下拉选择None控制网络模型选择ControlNet模型用于结构控制选择canny模型保持边缘结构
low_thresholdlow_threshold浮点数0.6Canny边缘检测低阈值Canny算法的低阈值参数0.6可以检测到较多边缘
high_thresholdhigh_threshold浮点数0.6Canny边缘检测高阈值Canny算法的高阈值参数0.6与低阈值配合使用
strengthstrength浮点数0.4控制网络影响强度ControlNet的控制强度0.4有一定控制但不过强
start_percentstart_percent浮点数0.0控制网络开始生效的时机ControlNet开始作用的步数百分比0.0从一开始就生效
end_percentend_percent浮点数1.0控制网络结束生效的时机ControlNet结束作用的步数百分比1.0一直生效到最后

输出:

  • McBoaty Pipe:可以继续传递的数据包
  • McPrompty Pipe:可以传递给提示词编辑器的数据包
  • image:精修后的最终图片
  • image (original):原始输入图片
  • tiles:所有切片的合集
  • prompts:所有使用的提示词
  • info:处理信息和统计数据

3.11 McBoaty_TilePrompter_v5 节点(切片提示词编辑器)

这个节点就像是一个"区域化描述编辑器",可以为图片的不同区域设置不同的描述词。

3.12 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
pipepipeMC_PROMPTY_PIPE_IN连接连接数据管道接收需要编辑提示词的数据McPrompty管道数据输入连接放大器或精修器的提示词管道
requeuerequeue整数0重新排队次数,用于刷新触发节点重新执行的计数器改变数字可以刷新提示词编辑界面

输出:

  • McPrompty Pipe:编辑后的提示词数据包

3.13 TextConcatenate_v1 节点(文字合并器)

这个节点就像是一个"文字拼接器",可以把多个文字片段合并成一个完整的句子。

3.14 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
delimiterdelimiter字符串", "分隔符,用来分开不同的文字片段字符串连接时使用的分隔符用", "可以用逗号分开,用" "用空格分开
string1-24动态生成字符串输入要合并的文字最多24个文字输入框支持最多24个字符串输入在不同框里输入"美丽的"、"风景"、"照片"

输出:

  • text:合并后的完整文字

3.15 ForLoopOpen_v1 节点(循环开始)

这个节点就像是一个"重复任务开关",可以让后面的操作重复执行指定次数。

3.16 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
remainingremaining整数1剩余循环次数循环执行的剩余次数设置5表示要重复5次
initial_value1-4initial_value1-4任意类型根据需要连接循环中要传递的初始值循环过程中传递的数据连接要在循环中处理的数据

输出:

  • flow_control:流程控制信号
  • remaining:剩余次数
  • value1-4:传递的数据值

3.17 ForLoopClose_v1 节点(循环结束)

这个节点就像是一个"重复任务结束器",标记循环的结束并输出最终结果。

3.18 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
flow_controlflow_controlFLOW_CONTROL连接连接循环开始节点接收循环控制信号流程控制数据连接连接ForLoopOpen的flow_control输出
initial_value1-4initial_value1-4任意类型连接循环中的数据循环中处理的数据循环过程中的数据流连接循环中最后处理的数据

输出:

  • value1-4:循环完成后的最终数据

3.19 IsEqual_v1 节点(相等判断)

这个节点就像是一个"比较器",可以判断两个东西是否相同。

3.20 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
any_1any_1任意类型连接要比较的第一个数据第一个比较对象第一个比较数据输入连接一个数字或文字
any_2any_2任意类型连接要比较的第二个数据第二个比较对象第二个比较数据输入连接另一个数字或文字

输出:

  • boolean:比较结果,相同为True,不同为False

3.21 IsNone_v1 节点(空值判断)

这个节点就像是一个"空值检测器",可以判断某个数据是否为空。

3.22 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
anyany任意类型连接要检查的数据要检查是否为空的数据输入数据用于空值检测连接任何可能为空的数据

输出:

  • boolean:检查结果,为空时True,有内容时False

3.23 IsEmpty_v1 节点(空字符串判断)

这个节点就像是一个"空白检测器",可以判断文字是否为空白。

3.24 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
anyany任意类型连接要检查的数据要检查是否为空字符串的数据输入数据用于空字符串检测连接文字数据检查是否为空

输出:

  • boolean:检查结果,为空字符串时True,有内容时False

3.25 IsEmptyOrNone_v1 节点(空值或空字符串判断)

这个节点就像是一个"全面空值检测器",可以同时判断数据是否为空或空白。

3.26 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
anyany任意类型连接要检查的数据要检查是否为空或空白的数据输入数据用于综合空值检测连接任何数据检查是否为空或空白

输出:

  • boolean:检查结果,为空或空白时True,有内容时False

3.27 Mara_Tiler_v1 节点(图片切片器)

这个节点就像是一个"图片切割器",可以把大图片切成小块,方便分别处理。

3.28 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
imageimageIMAGE连接连接要切片的图片输入需要切割的图片输入图像数据用于分块处理连接LoadImage节点的图片输出
upscale_modelupscale_model下拉选择None是否先放大再切片可选的图像放大模型选择放大模型可以先放大再切片
tile_sizetile_size整数512每个切片的大小图像分块的尺寸大小512适合大多数情况
control_net_namecontrol_net_name下拉选择None控制网络模型,用于边缘检测ControlNet模型选择选择canny模型可以检测边缘
low_thresholdlow_threshold浮点数0.6边缘检测低阈值Canny边缘检测的低阈值0.6可以检测较多边缘
high_thresholdhigh_threshold浮点数0.6边缘检测高阈值Canny边缘检测的高阈值0.6与低阈值配合使用

输出:

  • McBoayty Pipe:传递给其他节点的数据包
  • image:处理后的图片
  • tiles:所有切片的合集
  • tiles - canny:所有切片的边缘检测结果

3.29 Mara_Untiler_v1 节点(图片拼接器)

这个节点就像是一个"拼图器",可以把处理好的小块图片重新拼接成完整的大图。

3.30 参数详解

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
pipepipeMC_BOATY_PIPE连接连接切片器的输出接收切片数据包McBoaty管道数据输入连接Tiler节点的管道输出
output_upscale_methodoutput_upscale_method下拉选择bicubic最终缩放方法图像缩放算法选择bicubic质量较好
output_size_refoutput_size_ref下拉选择Output Image输出尺寸参考输出尺寸计算的参考基准选择以输出图像还是输入图像为基准
output_sizeoutput_size浮点数1.00输出尺寸倍数相对于参考图像的缩放倍数2.0表示输出是参考的2倍大
denoisedenoise浮点数0.10最终去噪强度最终处理的去噪强度0.1轻微处理,0.5中等处理
positivepositive字符串空字符串正面提示词最终处理使用的正向提示输入想要的效果描述
negativenegative字符串空字符串负面提示词最终处理使用的负向提示输入不想要的效果描述
refresh_promptsrefresh_prompts布尔值False刷新提示词是否刷新提示词设置勾选可以重新应用提示词
tilestilesIMAGE连接可选的切片输入可以直接输入处理好的切片可选的图像块输入连接处理好的切片图像

输出:

  • image:拼接完成的最终图片

4. 使用技巧和建议

4.1 AnyBus 使用技巧

  • 给不同的总线设置不同的名称,避免混乱
  • 一个总线最多支持25个输入输出
  • 可以连接多个总线形成更复杂的数据流

4.2 McBoaty 系列使用技巧

  • 放大倍数选择:2倍放大通常比4倍放大效果更好
  • 去噪强度:0.27是保持原图的甜蜜点,0.35可以稍微改善细节
  • 切片大小:显存不够时可以调小tile_size
  • 颜色匹配:使用mkl方法可以保持原图色调

4.3 循环节点使用技巧

  • 循环次数不要设置太大,避免卡死
  • 在循环中使用DisplayInfo节点可以监控进度
  • 循环结束后记得检查输出结果

4.4 性能优化建议

  • 大图片处理时适当调小切片大小
  • 使用VAE分块编码可以节省显存
  • 合理设置采样步数,平衡质量和速度

5. 常见问题解答

Q1:安装后找不到节点怎么办?

A: 重启ComfyUI,如果还是找不到,检查是否正确安装在custom_nodes文件夹中。

Q2:McBoaty处理大图片时显存不够怎么办?

A:

  • 调小tile_size参数(比如从512调到320)
  • 开启VAE分块编码
  • 调小tile_size_vae参数

Q3:AnyBus连接时出现错误怎么办?

A:

  • 检查profile名称是否一致
  • 确保连接的数据类型匹配
  • 尝试重新连接节点

Q4:循环节点执行很慢怎么办?

A:

  • 减少循环次数
  • 检查循环内部是否有耗时操作
  • 使用DisplayInfo监控每次循环的结果

Q5:图片放大后质量不好怎么办?

A:

  • 尝试不同的放大模型
  • 调整去噪强度(通常0.27-0.35之间)
  • 使用颜色匹配功能
  • 考虑使用多次2倍放大而不是一次4倍放大

Q6:提示词编辑器不显示图片怎么办?

A:

  • 检查网络连接
  • 确保temp文件夹有写入权限
  • 尝试刷新浏览器页面

6. 工作流程示例

基础图片放大流程:

  1. LoadImage_v1 → 加载图片
  2. CheckpointLoader → 加载模型
  3. CLIPTextEncode → 编码提示词
  4. McBoaty_UpscalerRefiner_v5 → 一键放大精修
  5. SaveImage → 保存结果

高级分步处理流程:

  1. LoadImage_v1 → 加载图片
  2. Mara_Tiler_v1 → 切片处理
  3. Mara_McBoaty_Configurator_v6 → 配置参数
  4. Mara_McBoaty_TilePrompter_v6 → 编辑每个切片的提示词
  5. Mara_McBoaty_Refiner_v6 → 精修处理
  6. Mara_Untiler_v1 → 拼接输出

循环批处理流程:

  1. ForLoopOpen_v1 → 开始循环
  2. LoadImage_v1 → 加载图片(循环中)
  3. 处理节点 → 各种处理(循环中)
  4. SaveImage → 保存结果(循环中)
  5. ForLoopClose_v1 → 结束循环

7. 总结

MaraScott Nodes 插件就像给 ComfyUI 装了一个"超级工具箱",包含了从基础的数据管理到高级的图片处理等各种实用工具。特别是 McBoaty 系列节点,为图片放大和精修提供了专业级的解决方案。

主要优势:

  • AnyBus系列:让复杂的工作流程变得整洁有序
  • McBoaty系列:专业的图片放大和精修工具
  • 循环工具:自动化重复任务,提高效率
  • 实用工具:各种小工具让工作更便捷

记住:好的工具需要配合正确的使用方法才能发挥最大效果。多尝试不同的参数组合,你会发现这个插件的强大之处!

特别提醒: 这个插件的作者提到项目不再维护,部分功能可能存在问题。建议在使用前先测试基本功能是否正常。

标签: #插件 2338
相关文章

ComfyUI错误修复插件详解:轻松解决常见问题 2025-07-10 18:25

ComfyUI-CustomMenu插件使用教程:高效自定义工作流指南 2025-07-10 17:50

ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44

ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件,就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址:https://github.com/LingSss9/com

ComfyUI WAN 2.2视频插件教程:万相AI提示词全攻略 2025-07-31 11:47

ComfyUI WAN 2.2视频插件教程:万相AI提示词实战指南 2025-07-29 20:10

ComfyUI HeyGem数字人插件教程:零基础快速精通指南 2025-07-22 14:10

目录

从节点基础到高阶工作流,我们为你绘制最清晰的 ComfyUI 学习路径。告别困惑,让每一次连接都充满创造的魔力,轻松驾驭 AI 艺术的无限可能。

  • 微信
  • B站
  • GitHub
Copyright © 2025 AIX All Rights Reserved. Powered by AIX.
隐私政策
津ICP备2024019312号