ComfyUI-TOAPNG

ComfyUI-TOAPNG

2apng 是一个 ComfyUI 图像输出节点：将封面和内容图保存为 APNG 动图。

实现在QQ中点击查看原图才会显示真正图片，适用于直接发送生图。

不保证无风险。

输入与输出

• content：必填，作为 APNG 的内容图与播放后的停留画面。
• cover：可选，作为 PNG 默认图（封面）。未连接时自动使用插件自带的 default.png；连接图片后会覆盖默认封面。
• filename_prefix：输出文件名前缀，保存位置沿用 ComfyUI 的 output 目录。
• compression_ratio：输出宽高缩放比例，范围为 0.1 至 1.0，默认值为 0.5。0.5 表示宽、高各缩小一半，像素数约为原图的四分之一；1.0 保持内容图原始分辨率。
• image：输出压缩后的内容图，可预览或连接到下游图像节点。

节点会将 APNG 保存至 ComfyUI/output。动画实际播放内容图后，还会附加一张 视觉上完全相同的一像素透明覆盖帧。因此即使播放器忽略 APNG 的有限播放次数， 到达内容图后也不会在视觉上跳回封面。

安装

将整个 ComfyUI-TOAPNG 文件夹复制或解压到：

ComfyUI/custom_nodes/ComfyUI-TOAPNG

确认目录内至少包含：

__init__.py
nodes.py
default.png
README.md

重启 ComfyUI 后，在 image 分类中添加 2apng 节点。连接 content， 如需自定义封面再连接 cover，设置 filename_prefix 后运行即可。输出文件使用 .png 扩展名，因为 APNG 本身属于 PNG 容器格式。

使用说明

当 cover 与 content 的尺寸不一致时，节点会按比例缩放封面，在内容图画布上 居中并以白色填充空白区域，不会拉伸封面。

支持批处理：两个输入批次大小相同，或其中一个输入仅包含一张图片时，均可使用。

除 ComfyUI 已自带的 Pillow、NumPy 和 Torch 外，不需要安装其他 Python 依赖。 手动复制或打包时，请始终将 default.png 与 nodes.py 放在同一目录。

参考资料

• ComfyUI 图像数据与 PIL 转换
• ComfyUI 保存图像节点
• PNG/APNG 规范