%20(1).png)
ComfyUI-QualityOfLifeSuit_Omar92 插件完全教程
1. 插件简介
插件地址： https://github.com/omar92/ComfyUI-QualityOfLifeSuit_Omar92
ComfyUI-QualityOfLifeSuit_Omar92 是一个超级实用的"生活质量提升工具包"，就像给你的 ComfyUI 装了一个"万能工具箱"。这个插件包含了各种各样的小工具，能让你的工作流程变得更加便捷和高效。
这个插件主要能帮你做这些事情：
- ChatGPT 智能助手 - 连接 ChatGPT 来自动生成图片描述和提示词，就像有个专业的文案助手
- 文字处理工具 - 各种文字操作，比如合并文字、替换内容、生成文字图片等
- 图片缩放工具 - 用倍数来放大缩小图片，比传统的宽高设置更直观
- 数学计算器 - 可以做各种数学运算，支持公式计算
- 调试工具 - 帮你查看和调试工作流中的各种数据
- 实用小工具 - 种子生成器、文件保存、随机提示词等
想象一下，这就像是给你的 ComfyUI 装了一个"瑞士军刀"，各种常用功能都有！
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI，点击右侧的 "Manager" 按钮
- 在搜索框里输入 "QualityOfLifeSuit"
- 找到插件后点击 "Install" 安装
- 重启 ComfyUI 服务器
- 刷新网页界面
方法二：手动下载安装
- 打开终端/命令行
- 进入 ComfyUI 的 custom_nodes 文件夹
- 运行命令：
git clone https://github.com/omar92/ComfyUI-QualityOfLifeSuit_Omar92.git - 重启 ComfyUI
特殊设置
安装后插件会自动创建一个 config.json 配置文件，如果你要使用 ChatGPT 功能，需要在这个文件里填入你的 OpenAI API 密钥。
3. 节点详细解析
3.1 ChatGPT Simple _O（简单聊天机器人节点）
这个节点就像一个"智能文案助手"，你给它一个简单的描述，它就能帮你生成详细的图片描述或提示词。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| prompt | prompt | 多行文本 | 输入你的想法 | 告诉机器人你想要什么 | 输入给ChatGPT的提示文本 | 输入"一只可爱的小猫"，它会生成详细描述 |
| model | model | 模型选择 | @cf/meta/llama-2-7b-chat-int8 | 选择使用哪个智能模型 | 选择ChatGPT的模型版本 | 默认模型就够用，高级用户可选gpt-3.5-turbo |
| behaviour | behaviour | 行为模式 | description | 设置机器人的工作模式 | 控制输出格式是描述还是标签 | description生成描述文字，tags生成标签格式 |
| seed | seed | 整数 | 0 | 随机种子数字 | 控制输出的随机性 | 相同种子得到相同结果，不同种子得到不同结果 |
3.2 ChatGPT compact _O（紧凑聊天机器人节点）
这个节点像一个"可定制的智能助手"，你可以自己设置它的行为方式和初始指令。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| prompt | prompt | 多行文本 | 输入你的问题 | 你要问机器人的问题 | 发送给ChatGPT的用户消息 | 输入"帮我写一个科幻场景的描述" |
| initMsg | initMsg | 多行文本 | 系统预设指令 | 告诉机器人应该怎么回答 | ChatGPT的系统初始化消息 | 设置"你是一个专业的图片描述专家" |
| model | model | 模型选择 | gpt-3.5-turbo | 选择智能模型版本 | 选择使用的ChatGPT模型 | gpt-3.5-turbo性能好，其他模型可能更快 |
| seed | seed | 整数 | 0 | 随机种子控制 | 控制生成结果的随机性 | 固定种子可以得到一致的结果 |
3.3 load_openAI _O（加载OpenAI客户端节点）
这个节点像一个"连接器"，专门用来建立与 OpenAI 服务的连接。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| base_url | base_url | 网址文本 | https://openai-cf.realnow.workers.dev/v1 | OpenAI服务器地址 | OpenAI API的基础URL地址 | 默认地址就行，除非你有特殊需求 |
| api_key | api_key | 密钥文本 | 输入你的密钥 | 你的OpenAI账号密钥 | 用于验证身份的API密钥 | 在OpenAI官网获取，格式像sk-xxxxxxx |
3.4 Chat_Message _O（聊天消息创建节点）
这个节点像一个"消息制造机"，专门用来创建发送给 ChatGPT 的消息。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| role | role | 角色选择 | user | 设置消息发送者身份 | 定义消息的角色类型 | user是用户，assistant是助手，system是系统 |
| content | content | 多行文本 | 输入消息内容 | 要发送的具体消息内容 | 消息的文本内容 | 输入"请帮我生成一个梦幻场景的描述" |
3.5 combine_chat_messages _O（合并聊天消息节点）
这个节点像一个"消息合并器"，能把两个聊天消息合并成一个对话。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| message1 | message1 | 聊天消息 | 连接第一个消息 | 第一条要合并的消息 | 第一个聊天消息对象 | 连接系统指令消息 |
| message2 | message2 | 聊天消息 | 连接第二个消息 | 第二条要合并的消息 | 第二个聊天消息对象 | 连接用户问题消息 |
3.6 Chat completion _O（聊天完成节点）
这个节点像一个"智能对话处理器"，把消息发送给 ChatGPT 并获取回复。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| client | client | 客户端连接 | 连接OpenAI客户端 | OpenAI的连接通道 | OpenAI客户端实例 | 连接load_openAI节点的输出 |
| model | model | 模型选择 | gpt-3.5-turbo | 选择使用的AI模型 | ChatGPT模型版本 | gpt-3.5-turbo是最常用的 |
| messages | messages | 消息列表 | 连接消息节点 | 要发送的所有消息 | 聊天消息的集合 | 连接合并后的消息 |
| seed | seed | 整数 | 0 | 随机种子控制 | 控制回复的随机性 | 相同种子得到相似回复 |
3.7 create image _O（创建图片节点）
这个节点像一个"AI画家"，能根据文字描述生成图片。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| client | client | 客户端连接 | 连接OpenAI客户端 | OpenAI的连接通道 | OpenAI客户端实例 | 连接load_openAI节点的输出 |
| prompt | prompt | 多行文本 | 描述你想要的图片 | 告诉AI要画什么 | 图像生成的文本描述 | 输入"一只在花园里的橙色小猫" |
| number | number | 整数 | 1 | 要生成几张图片 | 生成图像的数量 | 1张够用，最多10张 |
| size | size | 尺寸选择 | 256x256 | 图片的大小 | 生成图像的分辨率 | 256x256最快，1024x1024最清晰 |
| seed | seed | 整数 | 0 | 随机种子控制 | 控制生成结果的随机性 | 相同种子和描述得到相似图片 |
3.8 variation_image _O（图片变化节点）
这个节点像一个"图片变化师"，能基于一张图片生成相似但不同的变化版本。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| client | client | 客户端连接 | 连接OpenAI客户端 | OpenAI的连接通道 | OpenAI客户端实例 | 连接load_openAI节点的输出 |
| image | image | 图片数据 | 连接图片输入 | 要变化的原始图片 | 输入的图像数据 | 连接一张你想要变化的图片 |
| number | number | 整数 | 1 | 要生成几个变化版本 | 生成变化图像的数量 | 1个够用，最多10个 |
| size | size | 尺寸选择 | 256x256 | 变化图片的大小 | 生成图像的分辨率 | 建议与原图尺寸一致 |
| seed | seed | 整数 | 0 | 随机种子控制 | 控制变化结果的随机性 | 不同种子得到不同变化效果 |
3.9 LatentUpscaleFactor _O（潜在空间放大节点）
这个节点像一个"图片放大器"，能用倍数的方式来放大图片的潜在表示。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| samples | samples | 潜在数据 | 连接潜在空间数据 | 要放大的图片数据 | 潜在空间的样本数据 | 连接KSampler等节点的输出 |
| upscale_method | upscale_method | 放大方法 | nearest-exact | 选择放大的算法 | 图像放大的插值方法 | nearest-exact最快，bilinear质量好 |
| WidthFactor | WidthFactor | 宽度倍数 | 1.25 | 宽度放大多少倍 | 宽度的缩放因子 | 1.25表示放大到原来的1.25倍 |
| HeightFactor | HeightFactor | 高度倍数 | 1.25 | 高度放大多少倍 | 高度的缩放因子 | 2.0表示放大到原来的2倍 |
| crop | crop | 裁剪方式 | disabled | 是否裁剪多余部分 | 图像裁剪的处理方式 | disabled不裁剪，center居中裁剪 |
3.10 LatentUpscaleFactorSimple _O（简单潜在空间放大节点）
这个节点像一个"简化版放大器"，用同一个倍数来放大宽度和高度。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| samples | samples | 潜在数据 | 连接潜在空间数据 | 要放大的图片数据 | 潜在空间的样本数据 | 连接KSampler等节点的输出 |
| upscale_method | upscale_method | 放大方法 | nearest-exact | 选择放大的算法 | 图像放大的插值方法 | nearest-exact最快，bilinear质量好 |
| factor | factor | 放大倍数 | 1.25 | 整体放大多少倍 | 统一的缩放因子 | 2.0表示宽高都放大2倍 |
| crop | crop | 裁剪方式 | disabled | 是否裁剪多余部分 | 图像裁剪的处理方式 | disabled保持完整，center居中裁剪 |
3.11 selectLatentFromBatch _O（从批次选择潜在图片节点）
这个节点像一个"图片选择器"，能从一批生成的图片中选出一张来继续处理。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| samples | samples | 潜在数据 | 连接批次数据 | 一批生成的图片数据 | 包含多个样本的潜在数据 | 连接生成了4张图的节点输出 |
| index | index | 索引数字 | 0 | 选择第几张图片 | 要选择的图像索引 | 0是第一张，1是第二张，以此类推 |
3.12 RandomNSP _O（随机NSP提示词节点）
这个节点像一个"随机提示词生成器"，能从预设的词库中随机选择提示词。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| terminology | terminology | 词汇类别 | 选择词汇分类 | 选择什么类型的词汇 | NSP词库中的术语分类 | 比如选择"colors"会随机给出颜色词 |
| seed | seed | 随机种子 | 0 | 控制随机选择 | 控制随机性的种子值 | 相同种子得到相同词汇 |
3.13 ConcatRandomNSP_O（连接随机NSP节点）
这个节点像一个"词汇添加器"，能在现有文字后面添加随机选择的词汇。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 原始文本 | 输入基础文字 | 要添加词汇的原始文字 | 基础的文本内容 | 输入"beautiful girl" |
| terminology | terminology | 词汇类别 | 选择词汇分类 | 选择添加什么类型词汇 | NSP词库中的术语分类 | 选择"hair_color"添加发色词汇 |
| separator | separator | 分隔符 | , | 用什么符号分隔 | 文本之间的分隔符 | 用逗号分隔比较常见 |
| seed | seed | 随机种子 | 0 | 控制随机选择 | 控制随机性的种子值 | 不同种子得到不同词汇 |
3.14 Concat Text _O（连接文本节点）
这个节点像一个"文字拼接器"，能把多个文字片段拼接成一个完整的句子。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text1 | text1 | 文本1 | 输入第一段文字 | 第一个要拼接的文字 | 第一个文本片段 | 输入"beautiful" |
| text2 | text2 | 文本2 | 输入第二段文字 | 第二个要拼接的文字 | 第二个文本片段 | 输入"girl" |
| text3-text13 | text3-text13 | 文本3-13 | 可选的更多文字 | 更多要拼接的文字片段 | 额外的文本片段 | 可以添加更多描述词 |
| separator | separator | 分隔符 | , | 用什么符号连接 | 文本片段之间的分隔符 | 逗号、空格或其他符号 |
3.15 QOL Split String（文本分割节点）
这个节点像一个"文字切割器"，能把一段文字按照指定符号切割成多个部分。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 原始文本 | 输入要分割的文字 | 要切割的完整文字 | 需要分割的文本字符串 | 输入"red,blue,green,yellow" |
| delimiter | delimiter | 分隔符 | , | 按什么符号切割 | 用于分割文本的字符 | 用逗号分割会得到4个颜色词 |
3.16 Trim Text _O（修剪文本节点）
这个节点像一个"文字清理器"，能去掉文字前后多余的空格。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 原始文本 | 输入要清理的文字 | 要去掉空格的文字 | 需要修剪的文本内容 | 输入" hello world "会变成"hello world" |
3.17 Replace Text _O（替换文本节点）
这个节点像一个"文字替换器"，能把文字中的某些内容替换成其他内容。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 原始文本 | 输入要修改的文字 | 要进行替换的原始文字 | 需要处理的文本内容 | 输入"I like cats" |
| old | old | 要替换的内容 | 输入要换掉的部分 | 要被替换掉的文字 | 需要被替换的文本片段 | 输入"cats" |
| new | new | 新的内容 | 输入替换后的内容 | 用来替换的新文字 | 用于替换的新文本片段 | 输入"dogs"，结果变成"I like dogs" |
3.18 saveTextToFile _O（保存文本到文件节点）
这个节点像一个"文字记录器"，能把文字内容保存到电脑文件里。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 文本内容 | 输入要保存的文字 | 要写入文件的文字内容 | 需要保存的文本数据 | 输入生成的提示词或描述 |
| filename | filename | 文件名 | log.txt | 保存的文件名字 | 输出文件的名称 | 可以改成"prompts.txt"或其他名字 |
| append | append | 追加模式 | true | 是否追加到文件末尾 | 文件写入模式选择 | true追加内容，false覆盖文件 |
3.19 Text2Image _O（文本转图片节点）
这个节点像一个"文字印刷机"，能把文字变成图片，可以设置字体、颜色、大小等。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 文本内容 | 输入要变成图片的文字 | 要转换成图片的文字 | 需要渲染的文本内容 | 输入"Hello World" |
| font | font | 字体选择 | 选择字体文件 | 选择文字的字体样式 | 用于渲染的字体文件 | CALIBRI.TTF是默认字体 |
| size | size | 字体大小 | 36 | 文字的大小 | 字体的像素大小 | 36是中等大小，可以调大调小 |
| font_R/G/B/A | font_R等 | 颜色数值 | 0-255 | 文字的颜色 | 字体颜色的RGBA值 | R=255,G=0,B=0是红色 |
| background_R/G/B/A | background_R等 | 背景颜色 | 0-255 | 背景的颜色 | 背景颜色的RGBA值 | 全255是白色背景 |
| width/height | width/height | 图片尺寸 | 128 | 图片的宽度和高度 | 生成图像的像素尺寸 | 512x512是常用尺寸 |
| expand | expand | 自动扩展 | true | 是否自动调整图片大小 | 是否根据文本自动调整尺寸 | true会根据文字长度调整 |
| x/y | x/y | 文字位置 | 0 | 文字在图片中的位置 | 文本在图像中的坐标 | 0,0是居中，可以调整位置 |
3.20 ImageScaleFactor _O（图片缩放倍数节点）
这个节点像一个"图片缩放器"，能用倍数的方式来放大或缩小图片。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片数据 | 连接图片输入 | 要缩放的原始图片 | 输入的图像数据 | 连接任何图片节点的输出 |
| upscale_method | upscale_method | 缩放方法 | nearest-exact | 选择缩放算法 | 图像缩放的插值方法 | nearest-exact最快，bilinear质量好 |
| WidthFactor | WidthFactor | 宽度倍数 | 1.25 | 宽度缩放多少倍 | 宽度的缩放因子 | 2.0表示宽度放大2倍 |
| HeightFactor | HeightFactor | 高度倍数 | 1.25 | 高度缩放多少倍 | 高度的缩放因子 | 0.5表示高度缩小一半 |
| MulOf46 | MulOf46 | 尺寸对齐 | enabled | 是否对齐到64的倍数 | 是否强制尺寸为64的倍数 | enabled确保兼容性 |
| crop | crop | 裁剪方式 | disabled | 是否裁剪多余部分 | 图像裁剪的处理方式 | disabled保持完整图片 |
4. 使用技巧和建议
4.1 ChatGPT 功能使用技巧
- 获取API密钥 - 需要在OpenAI官网注册并获取API密钥
- 选择合适模型 - gpt-3.5-turbo性价比最高，适合大多数场景
- 写好提示词 - 清晰具体的描述能得到更好的结果
- 设置初始指令 - 告诉ChatGPT它应该扮演什么角色
4.2 文本处理技巧
- 合理使用分隔符 - 逗号适合提示词，空格适合句子
- 善用替换功能 - 可以批量修改提示词中的内容
- 保存重要内容 - 用保存节点记录好的提示词
- 文本转图片 - 可以制作标题图或说明图
4.3 图片缩放建议
- 选择合适倍数 - 1.5-2.0倍比较常用
- 注意尺寸限制 - 太大的图片可能占用过多内存
- 保持宽高比 - 避免图片变形
- 启用尺寸对齐 - 确保与其他节点兼容
5. 常见问题解答
Q1: ChatGPT节点提示API密钥错误？
A: 检查config.json文件中的API密钥是否正确，确保格式是sk-开头的完整密钥。
Q2: 文本转图片时字体显示异常？
A: 确保fonts文件夹中有对应的字体文件，可以尝试使用默认的CALIBRI.TTF。
Q3: 图片缩放后质量下降？
A: 尝试使用bilinear缩放方法，质量会比nearest-exact更好。
Q4: 随机NSP节点没有词汇？
A: 第一次使用时需要下载词库，确保网络连接正常。
Q5: 保存文件节点找不到输出文件？
A: 文件保存在插件的output文件夹中，检查该目录。
6. 总结
ComfyUI-QualityOfLifeSuit_Omar92 是一个功能丰富的工具包插件，包含了58个实用节点。本次详细介绍了前20个核心节点，涵盖了ChatGPT智能助手、文本处理、图片缩放等主要功能。
这些节点就像是给ComfyUI装了一个"万能工具箱"，能大大提升你的工作效率。无论是生成智能提示词、处理文本内容，还是调整图片尺寸，都能找到对应的工具。