SuperAPI AI 工具集

comfyui-node-outputs

设计与创作

查看项目

更新于 10-15 23:43

技能介绍

用途:面向 ComfyUI 自定义节点开发,说明节点如何通过 io.NodeOutput 返回数据,以及 V3 提供的 UI 预览与文件保存助手。

主要能力:

  1. 基本输出:在 define_schema 中声明 outputs,execute 返回 io.NodeOutput(a+b, a*b),值需与输出顺序一致;输出可设 display_name、tooltip、is_output_list。
  2. NodeOutput 变体:仅数据、仅 UI(ui=ui.PreviewImage(...))、数据加 UI、无输出、block_execution 阻断执行、expand 节点展开。
  3. UI 预览助手:PreviewImage(自动存临时目录)、PreviewMask(自动转三通道灰度)、PreviewAudio(存为 FLAC)、PreviewVideo、PreviewText、PreviewUI3D、PreviewUI3DAdvanced。
  4. 保存助手:ui.ImageSaveHelper 支持 save_images、get_save_images_ui、save_animated_png、save_animated_webp 等;ui.AudioSaveHelper 支持 flac、mp3、opus 格式。
  5. 手动保存:可用 folder_paths、PIL、PngInfo 自行写文件并返回 ui.SavedImages。

使用方式:从 comfy_api.latest 导入 io 与 ui;节点类继承 io.ComfyNode,定义 define_schema 与 execute;输出节点设 is_output_node=True,并按需声明 hidden=[io.Hidden.prompt, io.Hidden.extra_pnginfo]。

适用场景:需要向用户展示图像、遮罩、音频、视频、文本或 3D 预览,或将结果永久保存到输出目录的 ComfyUI 节点。

限制:预览写入临时目录、属临时内容;保存写入输出目录为永久文件。资料未提供版本兼容范围、性能数据与收费信息。