SuperAPI AI 工具集

comfyui-node-advanced

通用与其它

查看项目

更新于 10-15 23:42

技能介绍

用途:面向 ComfyUI V3 自定义节点开发,提供动态、类型安全且灵活的输入输出模式,用于构建复杂节点。

主要能力:MatchType 让共享模板的输入输出在连接时保持同一类型,类似泛型,可实现 PassThrough 与 Switch 等节点;MultiType 允许单个输入接受多种类型;Autogrow 支持随连接自动增长的输入槽,含 TemplatePrefix(编号槽,min/max 限制,硬上限 100)与 TemplateNames(命名槽)两种模式,模板中的 widget 输入被强制为仅连接;DynamicCombo 提供下拉选项切换不同子输入,支持嵌套;DynamicSlot 在槽被连接时显示子输入,资料注明其已注册但尚无核心节点使用,属实验性。

其他能力:节点展开(enable_expand=True 配合 GraphBuilder 返回子图,子节点 ID 需确定且唯一,各自独立缓存);accept_all_inputs 接受 schema 外任意输入;block_execution 条件阻断下游执行;原生 async execute;通过 ComfyAPISync/ComfyAPI 的 execution.set_progress 上报进度;NodeReplace 注册新旧节点替换,含 old_widget_ids、input_mapping(InputMapOldId、InputMapSetValue,autogrow 用点号表示法)与基于索引的 output_mapping,实现工作流自动迁移。

使用方式:在 define_schema 中声明 io.Schema 与相应输入输出类型,在 execute 中实现逻辑;同步用 ComfyAPISync,异步用 ComfyAPI 并 await;迁移注册在异步 on_load 中完成。

限制:DynamicSlot 为实验性;Autogrow 最多 100 个名称;output_mapping 基于索引而非名称;old_widget_ids 因工作流 JSON 按位置存储 widget 值而必需。具体安装命令与版本要求资料未提供。