拓冰网站定制 
ComfyUI 自定义节点开发六步通关从最小可运行节点到性能调优【免费下载链接】ComfyUIThe most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI每张图生成完你还要手动拖五个节点去做水印、裁切、色彩空间转换ComfyUI 自带的节点库覆盖了主路径但覆盖不了每个细碎需求。而 ComfyUI 自定义节点开发的机制是开放的你按约定写好几十行 Python节点就会自动出现在画布里能接线、能跑通、还能参与工作流缓存。这篇 ComfyUI 插件开发教程以仓库自带的示例节点为参照按一条主线走完先搞懂机制再跑通、做对、做快、做好最后是排错顺序。节点在 ComfyUI 里的四步生命周期加载、注册、调用、缓存写代码之前先搞清楚节点在 ComfyUI 里是怎么被用起来的。否则改代码全凭感觉出问题也定位不到位置。加载。ComfyUI 启动时会扫描custom_nodes/目录找到每个.py文件并调用其中的comfy_entrypoint()函数。整个插件就是通过这一个函数交接出去的——文件里没有这个函数或导入阶段报错节点就根本不存在。注册。扩展类通过get_node_list交出节点类列表ComfyUI 再读取每个节点的define_schema类方法拿到节点唯一 ID、显示名、分类和输入输出定义登记进节点库。define_schema相当于节点的名片只负责描述不负责干活。调用。用户把节点拖进画布、接好线后执行引擎按 schema 声明的顺序取好各输入值调用节点的execute方法。execute的参数列表和 schema 的inputs必须一一对应。缓存。输入没变化时 ComfyUI 不会重新执行节点直接复用上次结果。如果某个节点在输入不变时也要重跑比如磁盘文件变了但路径没变可以覆写fingerprint_inputs返回一个指纹指纹和上次不同就强制重跑。为什么这样设计因为 schema 是给前端渲染控件用的execute 是给后端执行用的接口和实现分离改控件不用碰执行代码改执行逻辑也不影响画布布局。后面参数不生效这类问题几乎都出在这两者的交界处。上图是一条典型的节点工作流加载主模型、LoRA、VAE再采样、解码出图。每个方框是一个节点箭头是节点之间传递的数据。你开发的节点最终就是插进这样一条链路里。跑通第一个节点的最小改动仓库里自带了一份现成的起点custom_nodes/example_node.py.example。把它复制出来、扩展名改成.py改动集中在三处。第一处让define_schema声明你自己的 ID 和输入输出classmethod def define_schema(cls) - io.Schema: return io.Schema( node_idMyNode, display_nameMy Node, categoryMyPlugin, inputs[io.Image.Input(image)], outputs[io.Image.Output()])第二处把真正的逻辑写进execute。官方示例做的是反色把这一行换成你自己的处理即可classmethod def execute(cls, image) - io.NodeOutput: image 1.0 - image # 示例逻辑反色替换为你的处理 return io.NodeOutput(image)第三处注册入口保持默认确认节点类在返回列表里即可class MyExtension(ComfyExtension): async def get_node_list(self): return [Example]重启 ComfyUI在画布上点加号搜索你声明的category。能找到节点、拖出来、接上上游图像、运行后看到输出变化这条链路就算通了。schema 加 execute 加入口这三样就是任何插件的骨架。节点参数控件怎么定义整数范围、下拉、文本schema 里的inputs决定了用户看到什么。常用类型对应的前端形态如下输入类型前端控件形态典型用途io.Int.Input数字框或滑块步数、宽高、迭代次数io.Float.Input数字框或滑块强度、权重、舍入精度io.Combo.Input下拉框算法选择、开关闭合io.String.Input单行或多行文本框提示词、文件名io.Image.Input、io.Model.Input 等连线端口只接受同类型上游连线以整数为例min、max、step限定取值范围和步进display_mode决定前端显示成数字还是滑块。下拉框写起来最简单给options列表就行。文本框设multilineTrue会变成多行形态。比起选哪种控件有两件事更要命类型匹配是连线的前提。输出和输入类型相同或兼容端口才会亮。你声明Int下游端口却是Float字段线根本接不上。排查参数不生效时先看两端类型对不对。lazy 是默认姿势。参数标上lazyTrue后它的值不会被提前求值节点通过check_lazy_status告诉引擎这次需要哪些输入。官方示例正是这么做的只有下拉框选中enable才请求三个字段否则返回空列表三个参数就不会被求值。新手阶段把数值和文本参数都写lazyTrue最省事。上图是官方源码仓库中的示例展示了输入字段上可以配置的控件属性min、max、step、multiline、lazy 等。把节点做快节点性能优化的四个抓手节点能用之后性能优化是实打实的功夫重点只有四处全是执行引擎配合你完成的。延迟求值。前面说过这是第一道。节点不需要的参数值不会被计算省下的就是实打实的开销。关键在check_lazy_status写诚实这一次只申请真正要用的字段。批量处理。ComfyUI 传进来的图像是四维张量第一个维度是批次数。别写循环逐张处理PyTorch、NumPy 的大部分运算可以整批一次算完比循环快得多内存访问也更连续。内存释放。中间结果用完就删大张量不要挂在实例属性上长期持有。节点里如果必须加载大模型按官方写法交给模型管理模块做加载和卸载而不是自己攥着不放。智能缓存。默认缓存按输入没变就不重跑工作。如果你的节点会读文件或依赖随机数相同参数下结果会变就要写fingerprint_inputs返回一个会变动的值比如文件哈希缓存才不会把旧结果端上来。前三条省的是计算缓存省的是重算指纹防止的是拿旧结果方向不同但互相配合。把插件做好目录规范、报错、说明与版本兼容一个只能自己用的节点是脚本别人能用的才是插件。差距在四处。目录规范。插件文件必须放在custom_nodes/下、.py扩展名。插件体量大时可以建子目录拆模块但入口文件仍需提供comfy_entrypoint。想自定义节点外观可以声明WEB_DIRECTORY前端会自动加载该目录下的 js 文件。错误提示。参数越界、文件读不到时抛出带具体原因和解决建议的错误。光说出错了对用户没有价值图像文件 xxx 不存在请检查路径才是有用的报错。使用说明。节点类的 docstring 用平实的话写清它做什么、每个参数含义、输出是什么。这段说明会出现在画布的节点详情面板里是用户实际会读的文档。版本兼容。节点按comfy_api.latest接口编写升级插件时先确认用到的 schema 字段仍然存在并保持node_id含义稳定——那是用户工作流里定位节点的锚点。节点不显示、参数不生效、执行慢的排查顺序出了问题别乱改代码按固定顺序查先环境再定义后执行。节点不显示。三步走一看文件是否在custom_nodes/下且为.py扩展名文件顶层有没有语法错误导入阶段最容易翻车二看服务器启动日志ComfyUI 会打印每个成功加载的扩展缺了哪行就是哪里的问题三确认comfy_entrypoint返回了扩展类、节点类在列表里、node_id没和别的节点撞车。参数不生效。排查顺序先查连线两端类型类型不匹配端口接不上值进不到函数再查lazy参数——如果check_lazy_status从未申请它它的值会是空这是最常见的坑最后看execute的执行顺序你用的那个变量是不是真的被传进来了。执行慢。按相反顺序看缓存是否命中改了参数却整条重跑多半是指纹返回了变动值延迟求值是否生效没用的参数是否仍被求值批量是否被串行化循环逐张处理了批次的第一个维度内存是否打满视频和大图导致频繁换页时是内存问题而不是计算问题。下一步两份值得读的源码索引跑通最小节点后读官方源码是最高效的学法comfy_extras/官方随版提供的 80 多个节点实现覆盖图像处理、模型操作、视频、数学运算。建议从nodes_color.py、nodes_math.py这类文件入手代码短、结构标准读两三个就能体会什么叫规范的节点写法。comfy_api_nodes/对接第三方 AI 服务的官方示例集。如果你的节点需要调用外部接口请求、重试、错误处理怎么写这里都有现成参照。接下来的行动可以拆成四步基于示例节点改掉execute的逻辑解决一个真实的小需求水印、重命名、统计都可以。给它加两个参数控件一个下拉一个整数范围练熟 schema 的写法。给参数加上lazyTrue并实现check_lazy_status确认未使用的参数不会被求值。精读comfy_extras/里的一个节点对比自己的写法和官方差在哪里。这四步走完ComfyUI 节点开发的完整技能就齐了。后面就是拿真实需求继续练。【免费下载链接】ComfyUIThe most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ComfyUI 自定义节点开发六步通关：从最小可运行节点到性能调优
ComfyUI 自定义节点开发六步通关从最小可运行节点到性能调优【免费下载链接】ComfyUIThe most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI每张图生成完你还要手动拖五个节点去做水印、裁切、色彩空间转换ComfyUI 自带的节点库覆盖了主路径但覆盖不了每个细碎需求。而 ComfyUI 自定义节点开发的机制是开放的你按约定写好几十行 Python节点就会自动出现在画布里能接线、能跑通、还能参与工作流缓存。这篇 ComfyUI 插件开发教程以仓库自带的示例节点为参照按一条主线走完先搞懂机制再跑通、做对、做快、做好最后是排错顺序。节点在 ComfyUI 里的四步生命周期加载、注册、调用、缓存写代码之前先搞清楚节点在 ComfyUI 里是怎么被用起来的。否则改代码全凭感觉出问题也定位不到位置。加载。ComfyUI 启动时会扫描custom_nodes/目录找到每个.py文件并调用其中的comfy_entrypoint()函数。整个插件就是通过这一个函数交接出去的——文件里没有这个函数或导入阶段报错节点就根本不存在。注册。扩展类通过get_node_list交出节点类列表ComfyUI 再读取每个节点的define_schema类方法拿到节点唯一 ID、显示名、分类和输入输出定义登记进节点库。define_schema相当于节点的名片只负责描述不负责干活。调用。用户把节点拖进画布、接好线后执行引擎按 schema 声明的顺序取好各输入值调用节点的execute方法。execute的参数列表和 schema 的inputs必须一一对应。缓存。输入没变化时 ComfyUI 不会重新执行节点直接复用上次结果。如果某个节点在输入不变时也要重跑比如磁盘文件变了但路径没变可以覆写fingerprint_inputs返回一个指纹指纹和上次不同就强制重跑。为什么这样设计因为 schema 是给前端渲染控件用的execute 是给后端执行用的接口和实现分离改控件不用碰执行代码改执行逻辑也不影响画布布局。后面参数不生效这类问题几乎都出在这两者的交界处。上图是一条典型的节点工作流加载主模型、LoRA、VAE再采样、解码出图。每个方框是一个节点箭头是节点之间传递的数据。你开发的节点最终就是插进这样一条链路里。跑通第一个节点的最小改动仓库里自带了一份现成的起点custom_nodes/example_node.py.example。把它复制出来、扩展名改成.py改动集中在三处。第一处让define_schema声明你自己的 ID 和输入输出classmethod def define_schema(cls) - io.Schema: return io.Schema( node_idMyNode, display_nameMy Node, categoryMyPlugin, inputs[io.Image.Input(image)], outputs[io.Image.Output()])第二处把真正的逻辑写进execute。官方示例做的是反色把这一行换成你自己的处理即可classmethod def execute(cls, image) - io.NodeOutput: image 1.0 - image # 示例逻辑反色替换为你的处理 return io.NodeOutput(image)第三处注册入口保持默认确认节点类在返回列表里即可class MyExtension(ComfyExtension): async def get_node_list(self): return [Example]重启 ComfyUI在画布上点加号搜索你声明的category。能找到节点、拖出来、接上上游图像、运行后看到输出变化这条链路就算通了。schema 加 execute 加入口这三样就是任何插件的骨架。节点参数控件怎么定义整数范围、下拉、文本schema 里的inputs决定了用户看到什么。常用类型对应的前端形态如下输入类型前端控件形态典型用途io.Int.Input数字框或滑块步数、宽高、迭代次数io.Float.Input数字框或滑块强度、权重、舍入精度io.Combo.Input下拉框算法选择、开关闭合io.String.Input单行或多行文本框提示词、文件名io.Image.Input、io.Model.Input 等连线端口只接受同类型上游连线以整数为例min、max、step限定取值范围和步进display_mode决定前端显示成数字还是滑块。下拉框写起来最简单给options列表就行。文本框设multilineTrue会变成多行形态。比起选哪种控件有两件事更要命类型匹配是连线的前提。输出和输入类型相同或兼容端口才会亮。你声明Int下游端口却是Float字段线根本接不上。排查参数不生效时先看两端类型对不对。lazy 是默认姿势。参数标上lazyTrue后它的值不会被提前求值节点通过check_lazy_status告诉引擎这次需要哪些输入。官方示例正是这么做的只有下拉框选中enable才请求三个字段否则返回空列表三个参数就不会被求值。新手阶段把数值和文本参数都写lazyTrue最省事。上图是官方源码仓库中的示例展示了输入字段上可以配置的控件属性min、max、step、multiline、lazy 等。把节点做快节点性能优化的四个抓手节点能用之后性能优化是实打实的功夫重点只有四处全是执行引擎配合你完成的。延迟求值。前面说过这是第一道。节点不需要的参数值不会被计算省下的就是实打实的开销。关键在check_lazy_status写诚实这一次只申请真正要用的字段。批量处理。ComfyUI 传进来的图像是四维张量第一个维度是批次数。别写循环逐张处理PyTorch、NumPy 的大部分运算可以整批一次算完比循环快得多内存访问也更连续。内存释放。中间结果用完就删大张量不要挂在实例属性上长期持有。节点里如果必须加载大模型按官方写法交给模型管理模块做加载和卸载而不是自己攥着不放。智能缓存。默认缓存按输入没变就不重跑工作。如果你的节点会读文件或依赖随机数相同参数下结果会变就要写fingerprint_inputs返回一个会变动的值比如文件哈希缓存才不会把旧结果端上来。前三条省的是计算缓存省的是重算指纹防止的是拿旧结果方向不同但互相配合。把插件做好目录规范、报错、说明与版本兼容一个只能自己用的节点是脚本别人能用的才是插件。差距在四处。目录规范。插件文件必须放在custom_nodes/下、.py扩展名。插件体量大时可以建子目录拆模块但入口文件仍需提供comfy_entrypoint。想自定义节点外观可以声明WEB_DIRECTORY前端会自动加载该目录下的 js 文件。错误提示。参数越界、文件读不到时抛出带具体原因和解决建议的错误。光说出错了对用户没有价值图像文件 xxx 不存在请检查路径才是有用的报错。使用说明。节点类的 docstring 用平实的话写清它做什么、每个参数含义、输出是什么。这段说明会出现在画布的节点详情面板里是用户实际会读的文档。版本兼容。节点按comfy_api.latest接口编写升级插件时先确认用到的 schema 字段仍然存在并保持node_id含义稳定——那是用户工作流里定位节点的锚点。节点不显示、参数不生效、执行慢的排查顺序出了问题别乱改代码按固定顺序查先环境再定义后执行。节点不显示。三步走一看文件是否在custom_nodes/下且为.py扩展名文件顶层有没有语法错误导入阶段最容易翻车二看服务器启动日志ComfyUI 会打印每个成功加载的扩展缺了哪行就是哪里的问题三确认comfy_entrypoint返回了扩展类、节点类在列表里、node_id没和别的节点撞车。参数不生效。排查顺序先查连线两端类型类型不匹配端口接不上值进不到函数再查lazy参数——如果check_lazy_status从未申请它它的值会是空这是最常见的坑最后看execute的执行顺序你用的那个变量是不是真的被传进来了。执行慢。按相反顺序看缓存是否命中改了参数却整条重跑多半是指纹返回了变动值延迟求值是否生效没用的参数是否仍被求值批量是否被串行化循环逐张处理了批次的第一个维度内存是否打满视频和大图导致频繁换页时是内存问题而不是计算问题。下一步两份值得读的源码索引跑通最小节点后读官方源码是最高效的学法comfy_extras/官方随版提供的 80 多个节点实现覆盖图像处理、模型操作、视频、数学运算。建议从nodes_color.py、nodes_math.py这类文件入手代码短、结构标准读两三个就能体会什么叫规范的节点写法。comfy_api_nodes/对接第三方 AI 服务的官方示例集。如果你的节点需要调用外部接口请求、重试、错误处理怎么写这里都有现成参照。接下来的行动可以拆成四步基于示例节点改掉execute的逻辑解决一个真实的小需求水印、重命名、统计都可以。给它加两个参数控件一个下拉一个整数范围练熟 schema 的写法。给参数加上lazyTrue并实现check_lazy_status确认未使用的参数不会被求值。精读comfy_extras/里的一个节点对比自己的写法和官方差在哪里。这四步走完ComfyUI 节点开发的完整技能就齐了。后面就是拿真实需求继续练。【免费下载链接】ComfyUIThe most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考