用途:帮助开发者把现有的 ComfyUI V1 自定义节点迁移到 V3 API。资料称 V3 使用 classmethods、带类型注解的输入输出,以及 ComfyExtension 注册机制。
主要能力:一是迁移清单,包括将基类改为 io.ComfyNode、用 define_schema() 返回 io.Schema 替代 INPUT_TYPES()、把执行函数改名为 execute 并设为 @classmethod、用 io.NodeOutput(...) 替代返回元组、以 fingerprint_inputs 替代 IS_CHANGED、以 validate_inputs 替代 VALIDATE_INPUTS、把 check_lazy_status 转为 @classmethod、用 ComfyExtension + comfy_entrypoint() 替代 NODE_CLASS_MAPPINGS、通过 cls.hidden 访问隐藏输入、移除 init 方法。二是并排对比,给出同一图像反色节点的 V1 与 V3 完整写法。三是映射表,覆盖 CATEGORY、RETURN_TYPES、OUTPUT_NODE、DESCRIPTION 等 V1 属性到 io.Schema 字段的对应关系,以及 IMAGE、MASK、LATENT、MODEL、INT、FLOAT、STRING、BOOLEAN、Combo、AnyType 等输入类型到 io.X.Input 的写法。四是方法迁移,说明执行方法、IS_CHANGED、VALIDATE_INPUTS、check_lazy_status 与隐藏输入的差异。五是注册迁移与输出节点迁移示例。
使用方式:按清单逐项改写节点代码,参照属性与输入类型映射表调整 schema,并按 V3 注册方式在 comfy_entrypoint() 中返回扩展。
注意事项:execute 方法名固定;V3 无实例状态,不要用 self 存状态;隐藏输入改为 cls.hidden 访问;返回 io.NodeOutput;可选输入用 =None,而非单独的 optional 字典;V3 的 execute 可为 async def。JS 扩展的 WEB_DIRECTORY 用法不变。资料未提供安装命令、版本要求与价格信息。