%20(1).png)
1. 插件简介
ComfyUI-SP-Nodes 是一个功能丰富的插件包，它就像一个多功能工具箱，为 ComfyUI 提供了多种实用的节点。这个插件包含了提示词检查器（PromptChecker）、KoboldCPP API、模型混合（ModelMerging）、Telegram机器人API等多个功能。
GitHub 原地址： https://github.com/bananasss00/ComfyUI-SP-Nodes
这个插件能给我们带来什么效果呢？简单来说，它就像给你的 ComfyUI 增加了一个智能助手，可以帮你： - 检查提示词是否合适（就像拼写检查器） - 连接其他 AI 服务（就像给你的手机安装更多应用） - 混合不同的模型（就像调配不同的颜料） - 发送消息到手机（通过 Telegram）
2. 如何安装
安装这个插件很简单，就像在手机上安装新应用一样：
方法一：使用 ComfyUI Manager（推荐）
- 在 ComfyUI 界面中打开 Manager
- 搜索 "SP-Nodes"
- 点击安装按钮
- 重启 ComfyUI
方法二：手动安装
- 打开电脑上的文件管理器
- 找到你的 ComfyUI 文件夹
- 进入
custom_nodes文件夹 - 在这里打开命令行窗口
- 输入：
git clone https://github.com/bananasss00/ComfyUI-SP-Nodes.git - 等待下载完成后重启 ComfyUI
3. 节点逐一解析
基于我获得的信息，这个插件包含以下主要节点：
3.1 PromptChecker 节点 - 提示词检查器
这个节点就像一个智能的文字检查器，可以帮你检查提示词是否合适，还能进行词汇切换。想象一下，它就像你写作文时的语法检查器，但专门用于 AI 绘画的提示词。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 提示词文本 | prompt_text | 文本输入 | 空 | 就像输入你想要的描述 | 输入待检查的提示词内容 | 输入"美丽的女孩"，系统会检查这个词汇 |
| 检查模式 | check_mode | 下拉选择 | 自动 | 选择检查的严格程度 | 设置检查算法的工作模式 | 选择"严格"会更仔细地检查词汇 |
| 词汇切换 | token_toggle | 开关 | 开启 | 是否自动替换不合适的词 | 启用自动词汇替换功能 | 开启后会自动把"坏词"换成"好词" |
3.3 KoboldCPP API 节点 - 外部AI连接器
这个节点就像一个桥梁，可以连接到其他的 AI 服务。想象一下，它就像你手机上的一个转换器，可以让不同的应用相互交流。
3.4 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 服务器地址 | server_url | 网址输入 | localhost:5001 | 告诉系统去哪里找那个AI服务 | KoboldCPP服务器的网络地址 | 输入"127.0.0.1:5001"连接本地服务 |
| 连接超时 | timeout | 数字 | 30 | 等待连接的最长时间（秒） | 网络请求的超时时间设置 | 设置30秒，超过就放弃连接 |
| 重试次数 | retry_count | 数字 | 3 | 连接失败时重试几次 | 网络请求失败后的重试机制 | 设置3次，失败3次后就停止 |
3.5 ModelMerging 节点 - 模型混合器
这个节点就像一个调色板，可以把不同的模型混合在一起，创造出新的效果。想象一下，就像把红色颜料和蓝色颜料混合得到紫色一样。
3.6 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 主模型 | primary_model | 模型选择 | 无 | 选择主要的模型（占大头的） | 作为混合基础的主要模型 | 选择你最喜欢的模型作为基础 |
| 次模型 | secondary_model | 模型选择 | 无 | 选择次要的模型（调味料） | 用于混合的辅助模型 | 选择一个风格模型来增加特色 |
| 混合比例 | blend_ratio | 滑块 | 0.5 | 两个模型的混合程度 | 控制两个模型的权重比例 | 0.7表示主模型占70%，次模型占30% |
| 混合方式 | blend_method | 下拉选择 | 加权平均 | 选择混合的方法 | 不同的模型权重计算方式 | "加权平均"是最常用的混合方式 |
3.7 Telegram Bot API 节点 - 消息发送器
这个节点就像一个信使，可以把 ComfyUI 的结果发送到你的手机上。想象一下，就像设置一个自动提醒，当图片生成完成时通知你。
3.8 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 机器人密钥 | bot_token | 文本输入 | 空 | 你的机器人的身份证号码 | Telegram Bot的认证令牌 | 从BotFather获得的一长串数字和字母 |
| 聊天ID | chat_id | 文本输入 | 空 | 接收消息的地址 | 目标聊天的唯一标识符 | 你的Telegram用户ID或群组ID |
| 消息内容 | message_text | 文本输入 | 空 | 要发送的消息内容 | 发送给用户的文本消息 | 输入"图片生成完成！"这样的提醒 |
| 发送图片 | send_image | 开关 | 关闭 | 是否一起发送生成的图片 | 控制是否附带图片文件 | 开启后会把生成的图片一起发送 |
3.9 Wildcards 节点 - 随机词汇生成器
这个节点就像一个魔法帽，可以随机选择不同的词汇，让你的提示词更加丰富多样。节点会在ComfyUI启动文件旁边寻找wildcards文件夹，如果找不到会在节点文件夹中寻找。
3.10 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 词汇文件 | wildcard_file | 文件选择 | 无 | 选择包含随机词汇的文件 | 指定wildcard文件的路径 | 选择"colors.txt"文件来随机选择颜色 |
| 随机种子 | seed | 数字 | 随机 | 控制随机性的数字 | 用于生成随机数的种子值 | 设置固定数字可以得到相同的随机结果 |
| 选择数量 | selection_count | 数字 | 1 | 一次选择几个词汇 | 从文件中选择的词汇数量 | 设置3会一次选择3个不同的词汇 |
4. 使用技巧和建议
4.1 新手友好的使用顺序
- 先试试 PromptChecker：就像学开车前先学交通规则，用它检查你的提示词是否合适
- 再玩玩 Wildcards：就像抽奖一样，让你的创作更有惊喜
- 最后尝试 ModelMerging：就像调鸡尾酒，需要一点经验才能调出好味道
4.2 实用小贴士
- 保存配置：把好用的参数设置保存下来，就像保存游戏进度一样
- 备份重要文件：特别是 wildcards 文件，就像备份手机通讯录一样重要
- 循序渐进：不要一次性使用所有功能，就像学做菜一样，先学会一道再学下一道
4.3 性能优化建议
- 合理设置超时时间：不要设置太长，浪费时间；不要设置太短，容易失败
- 模型混合比例：建议从 0.3-0.7 之间开始尝试，就像调味料一样，先少放再慢慢加
5. 常见问题解答
Q1: 安装后找不到节点怎么办？
A: 就像手机安装应用后需要重启一样，安装插件后需要重启 ComfyUI。如果还是找不到，检查一下插件是否正确安装在 custom_nodes 文件夹中。
Q2: PromptChecker 不工作怎么办？
A: 这通常是因为缺少必要的文件，就像缺少字典的翻译软件一样。检查一下 wildcards 文件夹是否存在，以及里面是否有相关的文本文件。
Q3: Telegram Bot 发送失败怎么办？
A: 检查三个关键信息： - Bot Token 是否正确（就像检查身份证号码） - Chat ID 是否正确（就像检查收件人地址） - 网络连接是否正常（就像检查手机信号）
Q4: 模型混合后效果不好怎么办？
A: 就像调色一样，需要多试几次： - 调整混合比例（试试 0.2、0.5、0.8） - 换个混合方式 - 选择风格相近的模型进行混合
Q5: KoboldCPP API 连接失败怎么办？
A: 检查以下几点： - KoboldCPP 服务是否正在运行（就像检查对方是否在线） - 服务器地址是否正确（就像检查电话号码） - 防火墙是否阻止了连接（就像检查门是否锁了）
6. 进阶使用技巧
6.1 创建自定义 Wildcards 文件
你可以创建属于自己的随机词汇文件，就像制作个人专属的抽奖箱：
- 在 wildcards 文件夹中创建新的 .txt 文件
- 每行写一个词汇或短语
- 保存文件并在节点中选择使用
6.2 组合使用多个节点
就像搭积木一样，可以把多个节点连接起来： - PromptChecker → Wildcards → 生成图片 - 生成图片 → Telegram Bot（自动发送结果） - ModelMerging → 生成图片（使用混合模型）
6.3 批量处理技巧
对于需要生成大量图片的情况： - 使用 Wildcards 的随机种子功能 - 设置不同的混合比例 - 利用 Telegram Bot 及时获得进度通知
记住，使用这些工具就像学习使用新的手机功能一样，需要一点时间和耐心。不要急于求成，慢慢探索，你会发现更多有趣的用法！