用途:介绍 ComfyUI 自定义节点的 V3 API 基础,用于创建新节点、定义节点类与注册扩展。
主要能力:说明 V3 节点需继承 io.ComfyNode,并实现 define_schema(cls) 与 execute(cls, ...) 两个 classmethod;Schema 字段包括 node_id、display_name、category、description、inputs、outputs、hidden、is_output_node、is_experimental、is_deprecated、is_dev_only、is_api_node、is_input_list、not_idempotent、accept_all_inputs、enable_expand、search_aliases、essentials_category、price_badge、has_intermediate_output 等。输入输出使用 io.Image.Input、io.Float.Input、io.String.Input、io.Image.Output、io.String.Output 等类型,返回 io.NodeOutput(...)。
使用方式:通过 ComfyExtension 与模块级 comfy_entrypoint() 注册,get_node_list 返回节点类列表。示例导入:from comfy_api.latest import ComfyExtension, io。
V1 对照:V1 使用普通类、INPUT_TYPES()、RETURN_TYPES、NODE_CLASS_MAPPINGS 与 NODE_DISPLAY_NAME_MAPPINGS,execute 为实例方法。
规则与限制:node_id 全局唯一;execute 参数须与输入 ID 完全一致;V3 全为 classmethod,无实例状态;返回值数量须匹配输出;category 用 / 表示层级,前缀 _ 可隐藏菜单。
适用场景:编写 ComfyUI 自定义节点、定义节点类、配置输入输出与注册扩展。相关主题包括数据类型、输入、输出、打包与生命周期。具体安装命令与版本要求暂未提供。