为每一次生成保留完整工作流！SmartGallery for ComfyUI：专注于“输出可追溯、管理可组织”的视觉资产管理系统

你是否经历过这样的时刻？

• 花了数小时调参，终于生成了一张理想图像或一段完美视频
• 几天后想复现效果，却发现工作流已丢失，参数记不清
• 输出是 JPG 或 MP4，而 ComfyUI 默认只在 PNG 中嵌入工作流
• 即便用了自定义保存节点，也需手动配置，容易遗漏

这些问题的本质，不是操作失误，而是缺乏系统性的生成追溯机制。

为此，开发者biagiomaf打造了SmartGallery for ComfyUI 应运而生——一个专注于“输出可追溯、管理可组织”的视觉资产管理系统。它不改变你的创作方式，而是默默记录每一次生成，并提供一个独立、高效、可搜索的画廊界面。

• GitHub：https://github.com/biagiomaf/smart-comfyui-gallery

真正实现：你生成的每一张图、每一段视频，都能找回它的“配方”。

核心价值：不只是画廊，更是工作流档案库

SmartGallery 的目标很明确：

✅ 无论你用什么格式输出（PNG/JPG/MP4/WebP），无论你用哪个保存节点，都能自动保存并关联完整工作流。

这解决了 ComfyUI 原生机制的三大局限：

双组件架构：自动记录 + 独立管理

SmartGallery 由两个轻量组件协同工作，互不干扰，部署简单。

1. 日志记录器：auto_log_workflows.py

• 定位：ComfyUI 自定义节点（执行钩子）
• 作用：在后台自动捕获每次执行的工作流 JSON
• 特点：
  • 不占用画布，无需连接节点
  • 支持所有输出格式（PNG、JPG、MP4、WebP 等）
  • 自动生成与输出文件同名的 .json 文件，存于 workflow_logs_success/ 目录
  • 基于 ComfyUI 执行钩子系统，兼容主流版本

⚙️ 技术说明：该节点利用 ComfyUI 的 on_execution_* 回调机制，在任务完成时自动记录工作流，完全透明。

2. 画廊应用：smartgallery.py

• 定位：独立运行的 Web 应用
• 作用：提供可视化界面，用于浏览、组织、检索生成内容
• 特点：
  • 运行在独立端口（默认 8189），即使 ComfyUI 未启动也可访问
  • 使用 SQLite 存储元数据，轻量高效
  • 缓存缩略图，支持数千文件快速加载
  • 支持文件夹管理、标签标记、全文搜索

🌐 访问地址：http://127.0.0.1:8189/galleryout

主要功能一览

🛠️ 安装与配置指南

步骤 1：安装日志记录器

1. 将 auto_log_workflows.py 文件复制到：

   Your_ComfyUI_Folder/custom_nodes/auto_log_workflows.py
   

   ⚠️ 注意：不是创建子文件夹，而是将 .py 文件直接放入 custom_nodes 目录

2. 重启 ComfyUI
   → 系统将自动为后续所有任务生成工作流日志，保存至：

   Your_ComfyUI_Folder/input/workflow_logs_success/
   

💡 重要提示：

• 此机制仅对安装后生成的内容生效
• 对于已有 PNG 文件（含嵌入工作流），画廊可提取并显示
• 对于已有 JPG/MP4 等文件，画廊可显示，但无法提供工作流

步骤 2：运行画廊应用

1. 配置路径（关键步骤）
   打开 smartgallery.py，修改以下变量为你的实际路径：

   # --- USER CONFIGURATION ---
   BASE_OUTPUT_PATH = 'C:/your/path/ComfyUI/output'  # 输出目录
   BASE_INPUT_PATH = 'C:/your/path/ComfyUI/input'    # 输入目录（含 workflow_logs）
   SERVER_PORT = 8189                                # 避免与 ComfyUI 端口冲突
   

2. 推荐：创建虚拟环境

   python -m venv venv
   # Windows
   venv\Scripts\activate
   # macOS/Linux
   source venv/bin/activate
   

3. 安装依赖

   pip install -r requirements.txt
   

4. 启动画廊

   python smartgallery.py
   

5. 访问：http://127.0.0.1:8189/galleryout

⏳ 首次运行提示：首次启动可能需要数分钟，系统正在扫描所有文件并生成缩略图。完成后，后续启动将极快。

高级配置：反向代理支持

如需通过 Nginx 或 Apache 暴露画廊服务，请确保代理指向正确端点：

location /galleryout {
    proxy_pass http://127.0.0.1:8189/galleryout;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

✅ 支持局域网共享、远程访问、与主站统一域名

使用场景