%20(1).png)
ComfyUI-PNG-Metadata 插件完全保姆级教程
1. 插件简介
ComfyUI-PNG-Metadata 是一个为 ComfyUI 设计的插件工具包，它能让你在保存的 PNG 图片里添加自定义的小纸条（就像在照片背后写字一样）。这些小纸条记录了你生成图片时用的提示词、参数设置等重要信息。
GitHub 原地址： https://github.com/romeobuilderotti/ComfyUI-PNG-Metadata
这个插件能给你带来什么好处？
- 就像给每张照片贴上标签，记录你用了什么咒语（提示词）
- 记录你调了哪些参数设置，下次想复制效果就不用瞎猜了
- 兼容 AUTOMATIC1111 的记录格式，和其他工具互通
- 自动工作，不需要你手动操作，连上就能用
2. 如何安装
方法一：用 ComfyUI-Manager（推荐给新手）
- 确保你已经安装了 ComfyUI-Manager（这就像一个应用商店）
- 在 ComfyUI 界面点击 ComfyUI-Manager 菜单
- 选择"安装自定义节点"
- 在搜索框输入"ComfyUI-PNG-Metadata"
- 找到后点击安装
- 重启你的 ComfyUI
方法二：手动安装（适合有经验的用户）
- 打开命令行工具（就像电脑的小黑窗）
- 导航到你的 ComfyUI 文件夹
- 输入这个命令：
git clone https://github.com/romeobuilderotti/ComfyUI-PNG-Metadata custom_nodes/ComfyUI-PNG-Metadata
- 重启 ComfyUI
3. 节点详细解析
这个插件提供了两个主要的工具节点：Set Metadata（设置单个信息）和 Set Metadata (All)（批量设置多个信息）。
3.1 Set Metadata 节点 - 单个信息记录器
这个节点就像一个小标签机，让你给图片贴上一个自定义的小纸条。比如你想记录用了什么模型、什么风格等。
3.2 Set Metadata 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Key（键名） | key | 文本字符串 | "model" 或 "style" | 就像便利贴上写的标题，告诉别人这个信息是关于什么的 | 自定义metadata字段的标识符 | 输入"使用模型"，这样看图片信息时就知道这个值代表什么 |
| Value（值） | value | 文本字符串 | 具体的信息内容 | 就像便利贴上的具体内容，记录实际的信息 | 对应key的具体数据内容 | 如果Key是"使用模型"，这里就写"realistic_v5.0" |
| Update Parameters（更新参数） | update_parameters | 布尔值（开/关） | True（开启） | 决定是否同时更新那个兼容其他工具的特殊记录本 | 是否同时更新AUTOMATIC1111兼容的parameters字段 | 开启后，其他软件也能读取这些信息 |
3.3 Set Metadata (All) 节点 - 批量信息记录器
这个节点就像一个超级标签机，可以一次性给图片贴上好多张小纸条，非常适合需要记录很多信息的时候。
3.4 Set Metadata (All) 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Positive Prompt（正面提示词） | positive_prompt | 文本字符串 | 你的完整提示词 | 记录你告诉AI画什么的那些话 | 记录生成图像时使用的正向提示词 | 输入"beautiful girl, anime style, detailed face" |
| Negative Prompt（负面提示词） | negative_prompt | 文本字符串 | 你的负面词汇 | 记录你告诉AI不要画什么的那些话 | 记录生成图像时使用的负向提示词 | 输入"blurry, low quality, distorted" |
| Steps（步数） | steps | 整数 | 20-50 | 记录AI画了多少遍才完成（越多越精细但越慢） | 扩散模型的采样步数 | 输入"30"表示用了30步 |
| CFG Scale（引导强度） | cfg_scale | 浮点数 | 7.0-12.0 | 记录AI听你话的程度（数字越大越听话） | 分类器自由引导缩放值 | 输入"7.5"表示中等听话程度 |
| Sampler（采样器） | sampler | 文本字符串 | "DPM++ 2M" 等 | 记录AI用什么方法来画画的 | 采样算法的类型 | 输入"DPM++ 2M Karras" |
| Scheduler（调度器） | scheduler | 文本字符串 | "karras" 等 | 记录AI画画时的节奏控制方法 | 噪声调度器类型 | 输入"karras"或"normal" |
| Seed（种子） | seed | 整数 | 任意数字 | 记录这次画画的随机数起点（同样种子=同样结果） | 随机数种子，控制生成的随机性 | 输入"12345"，下次用同参数和种子会得到相同图片 |
| Model（模型） | model | 文本字符串 | 模型文件名 | 记录用了哪个AI画师（不同模型画风不同） | 使用的checkpoint模型名称 | 输入"realismEngine_v30.safetensors" |
4. 使用技巧和建议
4.1 连接顺序很重要
⚠️ 重要提醒： 目前这些记录节点必须在保存图片节点之前执行，否则信息记录不进去。就像你必须先写好便利贴，再贴到照片上一样。
4.2 推荐的工作流程设置
- 生成图片 → 设置信息记录 → 保存图片
- 把 Set Metadata 或 Set Metadata (All) 节点放在 Save Image 节点的前面
- 用连线把它们串起来，确保执行顺序正确
4.3 什么时候用哪个节点？
- 只需要记录1-2个特殊信息：用 Set Metadata 节点
- 需要记录完整的生成参数：用 Set Metadata (All) 节点
- 要和其他软件兼容：确保开启 Update Parameters 选项
4.4 信息记录的最佳实践
- Key 名称用英文，方便其他软件识别
- Value 内容可以用中文，方便自己查看
- 重要参数都记录下来，方便以后复制效果
5. 常见问题解答
Q1：为什么我的图片没有记录信息？
A： 检查节点连接顺序，确保记录节点在保存图片节点之前执行。就像你必须先写字再贴标签一样。
Q2：其他软件读不到我记录的信息怎么办？
A： 确保开启了"Update Parameters"选项，这样就能兼容 AUTOMATIC1111 等其他工具了。
Q3：可以记录中文信息吗？
A： 可以的！Value 部分支持中文，但建议 Key 部分用英文，这样兼容性更好。
Q4：一张图片能记录多少个信息？
A： 理论上没有限制，但建议记录最重要的信息就够了，避免文件变得太大。
Q5：怎么查看图片里记录的信息？
A： 可以把图片拖拽回 ComfyUI，或者用专门的图片信息查看工具。
6. 进阶玩法和扩展用途
6.1 创建自己的信息模板
你可以创建标准化的信息记录模板，比如：
- 项目名称
- 客户要求
- 创作日期
- 版本号
6.2 批量处理工作流
结合其他节点，可以创建批量处理并自动记录信息的工作流，提高工作效率。
6.3 团队协作应用
在团队项目中，统一的信息记录格式能帮助团队成员快速了解每张图片的生成背景。
7. 注意事项和限制
- 目前节点执行顺序需要手动控制，未来版本会改进
- 只支持 PNG 格式的图片信息记录
- 记录的信息会增加文件大小，但通常影响很小
- 某些图片分享平台可能会删除这些信息，下载前要注意
这个插件虽然功能简单，但对于需要管理大量AI生成图片的用户来说非常实用。就像给每张照片都配上了详细的说明书，让你随时都能知道这张图是怎么来的！