comfyui-crystools

🪛 在使用 ComfyUI 时，您工具箱中的强大工具集 🪛

借助这套工具，您可以查看资源监控、进度条与已用时间、元数据，并比较两张图片或两个 JSON 文件；还可以将任意值输出到控制台或显示界面上，实现管道功能等更多操作！它提供了更优秀的节点来加载/保存图像、预览等，并能在不重新加载工作流的情况下查看“隐藏”的数据。

目录

• 概述
• 元数据
• 调试器
• 图像
• 管道
• 实用工具
• 基础节点
• 列表
• 开关
• 其他：关于、待办事项、更新日志、安装、使用

---

概述

资源监控

🎉 终于可以在菜单中实时查看 ComfyUI 使用的资源（CPU、GPU、内存、显存、GPU 温度和存储空间）了！

水平布局：

垂直布局：

现在您可以识别工作流中的瓶颈，判断何时需要重启服务器、卸载模型甚至关闭某些标签页！

您还可以配置刷新频率以及要显示的资源：

注意事项：

• GPU 数据仅在使用 CUDA 时可用（仅限 NVIDIA 显卡，AMD 用户抱歉）。
• 此扩展需要 ComfyUI 1915 或更高版本。
• 监控功能的开销很低（占用率仅为 0.1% 至 0.5%），您可以通过设置将其关闭（将“刷新频率”设为 0）。
• 数据来源于以下库：
  • psutil
  • torch
  • pynvml（NVIDIA 官方库）

进度条

您现在可以在菜单中看到工作流的进度条！

此外，它还会在工作流结束时显示已用时间，您还可以点击它来查看当前正在运行的节点。

注意事项：

• 如果不想显示进度条，可以在设置中将其关闭（“在菜单中显示进度条”）。

元数据

节点：元数据提取器

此节点用于从图像中提取元数据，并将其作为 JSON 数据源供其他节点使用。您可以查看所有信息，甚至包括来自其他来源的元数据（如 Photoshop，见示例）。

输入可以来自【带元数据的图像加载】节点或【图像预览】节点（未来还将支持更多输入来源）。

示例： metadata-extractor.json

其他元数据示例（Photoshop）

包含 Photoshop 元数据

参数说明

• 输入：
  • metadata_raw：来自图像或预览节点的原始元数据
• 输出：
  • prompt：生成该图像时使用的提示词。
  • workflow：生成该图像的工作流（包含所有节点、数值等详细信息）。
  • file info：图像/元数据的文件信息（分辨率、大小等），以人类可读格式呈现。
  • raw to JSON：完整的原始元数据被格式化为可读的 JSON。
  • raw to property：完整的原始元数据被转换成“属性”格式。
  • raw to csv：完整的原始元数据被转换成 CSV 格式。

节点：元数据比较器

这个节点非常实用，可用于比较两份元数据并找出差异（这正是我开发此扩展的主要原因！）

您可以比较三个输入：“Prompt”、“Workflow”和“Fileinfo”。

有三种可能的输出：values_changed、dictionary_item_added 和 dictionary_item_removed（按优先级排列）。

示例： metadata-comparator.json

注意事项：

• 我们使用了 DeepDiff 库来实现这一功能。更多信息请参阅链接。
• 如果您想比较两个 JSON 文件，可以使用【JSON 比较器】节点。

参数说明

• 选项：
  • what：选择要比较的内容，可选“Prompt”、“Workflow”或“Fileinfo”
• 输入：
  • metadata_raw_old：用于开始比较的原始元数据
  • metadata_raw_new：用于对比的原始元数据
• 输出：
  • diff：这是您可以在节点显示界面上看到的结果，也可用于其他节点。

---

调试器

节点：显示元数据

通过此节点，您可以快速查看由整个提示词和工作流生成的 JSON 数据，从而无需打开 PNG 或 JSON 文件即可了解提示词中的所有值及其他信息。

示例： debugger-metadata.json

参数说明

• 选项：
  • Active：启用或禁用该节点
  • Parsed：显示解析后的 JSON 或纯文本
  • What：显示提示词或工作流（提示词是生成图像的参数，而工作流则是 ComfyUI 的完整流程）

节点：显示任意内容

您可以将任何文本或节点数据输出到控制台或显示界面上。只需将其连接到您想要检查的内容，即可立即查看。

示例： debugger-any.json

参数说明

• 输入：
  • any_value：要显示的任意值，可以是字符串、数字等
• 选项：
  • Console：是否写入控制台
  • Display：是否在此节点上显示
  • Prefix：控制台前缀

节点：将任意内容转换为 JSON 并显示

此节点与上一个类似，但会将值格式化为 JSON（仅在显示界面上）。

示例： debugger-json.json

参数说明

• 输入：
  • any_value：要尝试转换为 JSON 的任意值
• 输出：
  • string：显示界面上呈现的相同字符串

---

图像

节点：加载带元数据的图像

此节点与默认节点相同，但增加了三个功能：提示词、元数据，并支持“input”文件夹的子文件夹。

示例： image-load.json

参数

• 输入：
  • image：从输入文件夹（及子文件夹）中读取图像（你可以将图像拖放到此处，甚至可以直接从剪贴板粘贴图像）
• 输出：
  • 图像/遮罩：与默认节点相同
  • 提示词：用于生成该图像的提示词（非工作流中的提示词）
  • 元数据原始数据：图像的元数据原始内容（完整工作流），以字符串形式输出

注意： 子文件夹支持灵感来源于：comfyui-imagesubfolders

节点：保存带额外元数据的图像

此节点与默认节点相同，但增加了两个功能：是否将工作流一同保存到 PNG 文件中，以及可以添加任意元数据（以 JSON 格式）。

这会在图像中保存自定义数据，以便与其他用户共享，他们可以看到工作流和元数据（参见从元数据预览），甚至包括你的自定义数据。

这些数据可以是任何支持文本和 JSON 的信息类型。

示例： image-save.json

参数

• options：
  • with_workflow：是否要将工作流一同保存到图像中（特别适合与他人分享工作流）
• 输入：
  • image：要保存的图像（与默认节点相同）
• 输出：
  • 元数据原始数据：图像的元数据原始内容（完整工作流），以字符串形式输出

注意： 数据会以特殊的“exif”格式（如同 ComfyUI 所做）保存在 PNG 文件中；你可以使用加载带元数据的图像来读取这些数据。

重要提示：

• 如果你想以特定名称保存你的工作流，并将自己的数据作为创作者信息一并保存，你需要使用 ComfyUI-Crystools-save 插件；不妨试试！

节点：从图像预览

此节点用于根据当前提示词及其他附加信息预览图像。

功能： 支持缓存（显示为“CACHED”）（目前还不是永久性的），因此即使断开节点连接，你仍然可以看到图像和相关数据，从而可以用来与其他图像进行对比！

如你所见，种子、步骤和 CFG 已被更改

示例： image-preview-image.json

参数

• 输入：
  • image：任何类型的图像链接
• 输出：
  • 元数据原始数据：图像及其完整工作流的元数据原始内容。
    • 你可以用它来与其他图像比较（参见元数据比较器）
    • 包括文件名、分辨率、日期时间及大小等文件信息，但这些信息均基于当前提示词，而非原始提示词！（请参阅重要提示）

重要提示：

• 如果你想读取图像的元数据，需要使用加载带元数据的图像，并使用其“元数据原始数据”输出，而不是图像链接。
• 进行预览时，必须先将其保存到临时文件夹中，显示的数据来自临时图像，并非原始图像或原始提示词！

节点：从元数据预览

此节点用于根据图像的元数据预览图像，并显示附加信息（围绕该图像的所有信息）。
它支持与从图像预览相同的功能（缓存、元数据原始数据等）。但重要的区别在于，你看到的是图像的真实数据（而非临时图像或当前提示词）。

示例： image-preview-metadata.json

节点：显示分辨率

此节点用于显示图像的分辨率。

可用于任何图像链接。

示例： image-resolution.json

参数

• 输入：
  • image：任何类型的图像链接
• 输出：
  • 宽度：图像的宽度
  • 高度：图像的高度

---

管道

节点：管道至/编辑任意，管道自任意

这一组强大的节点用于更好地组织你的管道。

“管道至/编辑任意”节点用于将多个链接封装成一个单一的链接。它支持编辑功能，并可轻松将修改后的内容重新添加回同一管道编号中。

“管道自任意”节点则用于提取管道中的内容。

典型示例：

使用管道后：

示例： pipe-1.json

编辑管道：

示例： pipe-2.json

参数

• 输入：
  • CPipeAny：这是可用于编辑的管道类型（参见示例）
  • any_*：6 种可能的输入来源
• 输出：
  • CPipeAny：你可以继续使用此输出来延续管道；也可以用它来分叉管道（参见示例）

重要提示：

• 请注意，它支持“any”，这意味着它不会验证输入节点与输出节点之间的对应关系（目前尚未实现）。创建链接时，建议有意识地按编号逐一连接。
• “递归错误” 必须注意的是，链接的流向必须保持一致方向，不能与其他使用此管道结果的流程混合。否则可能导致递归，进而阻塞服务器（需要重启！）

带有“递归错误：超过最大递归深度”的不良示例

如果你在控制台中看到类似情况，就需要检查你的管道。那是一个不良的管道示例，不能混用不同的流程。

---

工具类节点

一些在工作流中非常实用的节点。

节点：JSON 比较器

这个节点非常有用，可以用来比较两个 JSON 文件并查看它们之间的差异。

示例： utils-json-comparator.json

参数

• 输入：
  • json_old：用于开始比较的第一个 JSON
  • json_new：要比较的 JSON
• 输出：
  • diff：包含差异的新 JSON

注释：
正如你所看到的，它与元数据比较器类似，但处理的是 JSON 数据。
另一个节点是为了简单地比较两张图像的元数据而设计的；而这个节点则更加通用。
主要区别在于，它可以比较任何 JSON 数据，而不仅仅是元数据。

节点：系统统计信息

此节点用于显示系统统计信息（RAM、VRAM 和磁盘空间）。
它应该以管道方式连接。

示例： utils-stats.json

参数

• 输入：
  • latent：用于测量系统统计信息的潜变量
• 输出：
  • latent：返回相同的潜变量以继续管道

注释： 原始版本来自 WAS，我只是将其显示在界面上。

---

基本类型节点

节点：基本布尔型、基本整数型、基本浮点型、基本字符串型、基本多行字符串型

一组用于在提示词中使用的原始值节点。

---

列表

一组包含任意值或字符串/文本列表的节点，可用于各种用途（即将推出使用这些节点的新功能！）。

重要提示： 你可以使用“显示任意”等其他节点来查看列表中的值。

节点：字符串列表

特点： 你可以将它们连接起来。

示例： list-strings.json

参数

• 输入：
  • string_*：8 个可能的输入
  • delimiter：用于在输出中连接各个值的分隔符
• 输出：
  • concatenated：所有值连接成的一个字符串
  • list_string：仅包含值的字符串列表

节点：任意值列表

你可以连接任何类型的值（它会尝试将其转换为字符串并显示），因此非常适合同时查看多个值。

示例： list-any.json

参数

• 输入：
  • any_*：8 个可能的输入
• 输出：
  • list_any：仅包含值的任意值列表

---

开关

一组用于在不同流程之间切换的节点。

所有开关都是布尔型的；只需更改开关的值即可在不同流程之间切换。
你有预定义的开关（字符串、潜变量、图像、条件），但也可以使用“任意开关”来处理任何值/类型。

示例： switch.json

---

关于

作者注：

• 这是我用 Python 编写的第一个项目 ¯\(ツ)/¯（欢迎提交 PR！）
• 我是一名软件工程师，但主要从事其他语言（Web 技术）的工作。
• 我的 Instagram 是：https://www.instagram.com/crystian.ia 我会在上面发布我的作品，所以请关注我以获取最新消息！ :)
• 我不是英语母语者，所以如果我的英语不好，请见谅 :P

---

待办事项

• 多个单元测试
• 为预览/元数据图像添加永久缓存（以便在刷新页面或重启服务器时仍能保留）

---

更改记录

Crystools

1.27.0 (2025年8月17日)

• 恢复名称的大写形式，因为注册表无法更改 ¯_(ツ)_/¯
• 移除了 zluda 检查，现在已不再需要

1.25.3 (2025年7月27日)

• 将名称改为小写

1.25.1 (2025年6月2日)

• 修复了设置菜单中开关的问题
• 新增了“任意开关”节点
• 加载带元数据的图像功能进行了过滤（排除隐藏文件夹和典型的元数据文件）
• 其他修复

1.24.0 (2025年6月2日)

• 合并了社区提交的 PR
• 改进了 VRAM 的使用和读取
• 添加了硬盘错误处理
• 懒加载开关

1.23.0 (2025年6月2日)

• @johnnynunez 添加了对 Jetson 的支持
• 进行了一些 UI 修复

1.20.0 (2024年10月21日)

• JSON 文件读取和提取工具的 BETA 版本，允许你读取自己的 JSON 文件并将其中的值提取出来用于工作流

1.19.0 (2024年10月6日)

• 横向 UI！新版本已经准备就绪！🎉

1.18.0 (2024年9月21日)

• 横向 UI！🎉
• 设置菜单中可配置显示器大小

1.17.0 (2024年9月21日)

• 重新组织了设置菜单
• 准备横向 UI
• 更新自 ComfyUI（TypeScript 和新功能）

1.16.0 (2024年7月31日)

• 回滚了 AMD 支持，因为管理器不支持其他仓库参数（https://test.pypi.org/simple by pyrsmi）

1.15.0 (2024年7月21日)

• AMD 分支合并到主分支，应该适用于Linux平台上的 AMD 用户

1.14.0 (2024年7月15日)

• 曾尝试使用 AMD 信息，但导致 Windows 上的安装失败，因此我将其移除 ¯_(ツ)_/¯
• 添加了 AMD 分支，如果你使用 AMD 和 Linux，可以尝试一下（我自己没有测试过）

1.13.0 (2024年7月1日)

• 与 ComfyUI 的新生态系统集成
• 在加载带元数据的图像节点中添加了 Webp 支持

1.12.0 (2024年3月27日)

• 添加了 GPU 温度监测

1.10.0 (2024年1月17日)

• 添加了多 GPU 支持

1.9.2 (2024年1月15日)

• 对 hardwareInfo 和 monitor.ts 进行了大规模重构，将 GPU 相关代码分离到另一个文件中，为多 GPU 支持做准备

1.8.0 (2024年1月14日) - 内部版本

• 设置菜单中增加了 HDD 监控选择项

1.7.0 (2024年1月11日) - 内部版本

• 添加了 TypeScript！

1.6.0 (2024年1月11日)

• 修复了线程死锁问题 #7

1.5.0 (2024年1月10日)

• 改进了资源监控以及线程处理方式
• 进行了一些修复

1.3.0 (2024年1月8日)

• 总体上添加了资源监控（CPU、GPU、RAM、VRAM 和磁盘空间）
• 添加了此图标来标识这套工具：🪛

1.2.0 (2024年1月5日)

• 添加了进度条

1.1.0 (2023年12月29日)

• 新增了节点：“保存带有额外元数据的图像”
• 增加了对 Jpeg 元数据的读取支持（但不能保存）

1.0.0 (2023年12月26日)

• 首次发布

Crystools-save - 已弃用（2025年6月1日）

1.1.0 (2024年1月7日)

• 标签根据 Crystools 的新版本进行了更新（该项目）

1.0.0 (2023年12月29日)

• 创建了另一个扩展，用于在工作流中保存作者信息：ComfyUI-Crystools-save

---

安装

从 GitHub 安装

1. 安装 ComfyUi。
2. 将此仓库克隆到 custom_nodes 目录下：

   cd ComfyUI/custom_nodes
   git clone https://github.com/crystian/comfyui-crystools.git
   cd comfyui-crystools
   pip install -r requirements.txt
   

3. 启动 ComfyUI。

针对 AMD 用户

如果你使用的是 Linux 系统的 AMD 显卡，可以尝试 AMD 分支：

注意： 不要通过管理器安装，需要手动安装：

cd ComfyUI/custom_nodes
git clone -b AMD https://github.com/crystian/comfyui-crystools.git
cd comfyui-crystools
pip install -r requirements.txt

通过管理器安装

在 管理器 中搜索 crystools 并安装。

在 Google Colab 上使用

你可以在 Google Colab 上使用，但需要手动安装：

Google Colab

• 运行第一个单元格以安装 ComfyUI 并启动服务器
• 完成后，使用链接打开一个新的标签页，你会看到类似如下的行：

这是访问 ComfyUI 的 URL：https://identifying-complications-fw-some.trycloudflare.com    

---

使用方法

你可以像使用其他节点一样使用它，只需在 crystools 类别中选择菜单，或双击画布（推荐使用“oo”进行快速筛选）。所有节点都已加上 [Crystools] 标记。

如果出于某种原因你需要查看日志，可以定义环境变量 CRYSTOOLS_LOGLEVEL，并设置相应的值。

---

由 Crystian 用心制作。

ComfyUI-Crystools 快速上手指南

ComfyUI-Crystools 是一套强大的 ComfyUI 辅助工具集，提供实时资源监控、进度条、元数据提取与对比、调试节点、增强型图像加载/保存以及灵活的管道（Pipe）管理功能。

环境准备

• 系统要求：
  • 操作系统：Windows, Linux, macOS
  • Python 版本：与 ComfyUI 要求的版本一致（通常建议 3.10+）
  • ComfyUI 版本：必须为 1915 或更高版本。
• 硬件注意：
  • GPU 监控功能（显存、温度等）仅支持 NVIDIA 显卡（基于 CUDA）。AMD 用户无法查看 GPU 详细数据。
• 前置依赖：
  • 安装本插件后，以下库将自动被调用（通常无需手动安装，若报错可手动执行）：

    pip install psutil pynvml deepdiff
    

安装步骤

推荐使用 ComfyUI Manager 进行安装，也可通过 Git 命令行安装。

方法一：使用 ComfyUI Manager（推荐）

1. 启动 ComfyUI，点击右侧菜单的 "Manager" 按钮。
2. 选择 "Install Custom Nodes"。
3. 在搜索框输入 Crystools。
4. 找到 ComfyUI-Crystools，点击 "Install"。
5. 安装完成后，重启 ComfyUI。

方法二：命令行安装

进入 ComfyUI 的 custom_nodes 目录，执行以下命令：

cd ComfyUI/custom_nodes
git clone https://github.com/crystian/comfyui-crystools.git

安装依赖（如果自动安装失败）：

pip install -r comfyui-crystools/requirements.txt

重启 ComfyUI 即可生效。

基本使用

安装重启后，您可以在节点搜索栏中输入关键词找到相关节点。以下是核心功能的快速用法：

1. 开启资源监控与进度条

无需添加节点，功能默认集成在界面菜单中。

• 资源监控：查看 CPU、GPU、RAM、VRAM 及温度的实时占用情况。
  • 设置：在插件设置中可调整刷新率（设为 0 可禁用以降低开销）。
• 进度条：顶部菜单显示工作流进度和耗时，点击可高亮显示当前正在运行的节点。

2. 图像元数据提取与对比

这是该插件的核心功能，用于分析图片生成参数。

• 加载带元数据的图片： 使用 Load Image with Metadata 节点替代默认加载节点。它支持子文件夹，并输出 prompt（提示词）、workflow（工作流 JSON）和 metadata_raw。
• 提取详细信息： 连接 Metadata Extractor 节点，可将原始元数据转换为可读的 JSON、CSV 或属性格式。
• 对比两张图片差异： 使用 Metadata Comparator 节点。
  1. 输入两张图片的 metadata_raw 数据（分别连接到 old 和 new 端口）。
  2. 选择对比内容（Prompt、Workflow 或文件信息）。
  3. 节点将输出具体的差异项（如参数变更、新增或删除的配置），非常适合调试生成效果变化。

3. 调试与信息展示

• 查看任意数据：使用 Show Any 节点，连接任意数据类型（字符串、数字、列表等），可直接在节点面板或控制台打印内容，方便排查数据流。
• 查看工作流 JSON：使用 Show Metadata 节点，无需打开文件即可查看当前提示词和工作流的完整 JSON 结构。

4. 管道（Pipe）管理

使用 Pipe To Any 和 Pipe From Any 节点简化连线。

• 封装：将多个分散的输出线（如 model, clip, vae）连接到 Pipe To Any，合并为一根线传输。
• 解包：在需要使用的地方，通过 Pipe From Any 指定索引号，将数据还原出来。
• 编辑：支持在传输过程中修改管道内的特定数据。

5. 保存带额外信息的图片

使用 Save Image with Extra Metadata 节点。

• 勾选 with_workflow 可将完整工作流嵌入图片。
• 可通过输入端口添加自定义的 JSON 数据到图片 EXIF 中，便于后续分享和追溯。