ComfyUI-MixLab-Nodes 中 SaveImageAndMetadata 节点文件名格式化功能解析

在 ComfyUI 工作流中，图像保存是一个常见且重要的操作。ComfyUI 原生提供的 SaveImage 节点已经支持了文件名格式化功能，允许用户使用类似 %date:yyyy-MM-dd% 这样的格式字符串来自定义输出文件名。这一功能极大地提升了工作流的灵活性和自动化程度。

功能实现原理

ComfyUI 通过核心扩展 SaveImageExtraOutput 实现了这一功能。该扩展主要做了两件事：

1. 对于 SaveImage 节点，重写了 filename_prefix 控件的 serializeValue 方法，使其在序列化时应用文本替换规则
2. 对于其他所有节点，添加了一个"Node name for S&R"属性，用于在文本替换中引用节点名称

核心的文本替换逻辑由 applyTextReplacements 函数实现，它能够解析各种格式字符串并将其转换为实际值。例如日期格式化、计数器、节点名称引用等。

MixLab-Nodes 的改进

在 comfyui-mixlab-nodes 项目中，开发者 dev007 为 SaveImageAndMetadata 节点添加了相同的文件名格式化支持。这一改进使得：

1. 用户可以在 SaveImageAndMetadata 节点中使用与原生 SaveImage 节点相同的文件名格式语法
2. 保持了工作流中不同保存节点行为的一致性
3. 扩展了元数据保存功能的同时不牺牲文件命名的灵活性

技术意义

这种功能扩展体现了良好的 API 设计思想：

1. 一致性原则：保持与原生功能相同的使用方式，降低用户学习成本
2. 可扩展性：通过重写控件序列化方法而非直接修改核心代码，实现了功能的非侵入式扩展
3. 模块化设计：将文本替换功能作为独立模块，可在不同节点间复用

对于工作流开发者而言，这意味着可以更灵活地组织输出文件结构，例如按日期分文件夹、包含特定节点信息等，大大提升了工作流输出的可管理性。