%20(1).png)
ComfyUI-Scepter 插件完全教程
1. 插件简介
ComfyUI-Scepter 是阿里巴巴通义实验室开发的强大AI图像生成插件，原项目地址：https://github.com/modelscope/scepter
这个插件就像一个"万能的AI画师工具箱"，集成了多种先进的图像生成和编辑技术。它不仅能根据文字描述生成图片，还能进行图像编辑、风格转换、控制生成等多种操作。
主要用途：
- 文字生成图片（就像跟AI画师说话，它就能画出你想要的图）
- 图像风格转换（把照片变成油画、水彩画等各种艺术风格）
- 精确控制图像生成（通过线稿、深度图等控制AI画画的方向）
- 图像编辑和修复（局部修改图片内容）
- 模型微调和个性化定制
能带来的效果：
- 专业级的AI绘画作品
- 各种艺术风格的图像转换
- 精确控制的图像生成
- 个性化的AI模型训练
- 批量图像处理和编辑
2. 如何安装
方法一：通过ComfyUI管理器安装（推荐）
- 打开ComfyUI管理器
- 搜索"ComfyUI-Scepter"
- 点击安装即可
方法二：手动安装
- 克隆项目到ComfyUI的custom_nodes目录：
git clone https://github.com/modelscope/scepter.git
cd scepter
pip install -e .
cp -r workflow/ path/to/ComfyUI/custom_nodes/ComfyUI-Scepter
- 安装依赖包：
pip install -r requirements.txt
- 重启ComfyUI
注意： 插件支持从ModelScope、HuggingFace或本地加载模型，首次使用时会自动下载所需模型。
3. 节点详细解析
3.1 ModelNode 节点 - AI模型大脑
这个节点就像一个"超级AI画师大脑"，是整个插件的核心，负责根据你的要求生成或编辑图片。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model | model | 多个AI模型选项 | 根据需求选择 | 选择不同功能的AI大脑 | 选择预训练的生成模型 | SD1.5适合基础生成，SDXL质量更高，FLUX速度快 |
| model_source | model_source | ModelScope/HuggingFace/Local | ModelScope | 选择模型下载来源 | 模型获取源配置 | ModelScope国内快，HuggingFace国外资源多 |
| prompt | prompt | 文本描述 | - | 告诉AI你想要什么样的图片 | 正向提示词输入 | "一只可爱的小猫在花园里玩耍" |
| negative_prompt | negative_prompt | 文本描述 | - | 告诉AI你不想要什么 | 负向提示词输入 | "模糊，低质量，变形" |
| parameters | parameters | CONDITIONING | - | 接收参数设置节点的输出 | 生成参数配置 | 连接ParameterNode的输出 |
| mantras | mantras | CONDITIONING | - | 接收咒语模板节点的输出 | 提示词模板配置 | 连接MantrasNode的输出 |
| tuners | tuners | CONDITIONING | - | 接收调优器节点的输出 | 模型微调配置 | 连接TunerNode的输出 |
| controls | controls | CONDITIONING | - | 接收控制节点的输出 | 控制条件配置 | 连接ControlNode的输出 |
| image | image | IMAGE | - | 输入要编辑的图片 | 输入图像数据 | 用于图像编辑或参考 |
| mask | mask | MASK | - | 输入编辑区域的遮罩 | 编辑区域掩码 | 白色区域会被编辑，黑色区域保持不变 |
3.2 ParameterNode 节点 - 参数调节器
这个节点就像一个"画画参数控制面板"，用来调节AI画画的各种细节设置。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| sample | sample | 多种采样器 | DPMSolverMultistep | 选择AI画画的方式 | 扩散采样器类型 | DPM速度快，Euler质量好 |
| sample_steps | sample_steps | 1-100 | 50 | AI思考画画的步数 | 采样迭代步数 | 步数越多质量越好但越慢 |
| guide_scale | guide_scale | 0-10 | 5 | AI听话程度，数值越高越按提示词画 | CFG引导强度 | 7-9比较合适，太高会过度拟合 |
| guide_rescale | guide_rescale | 0-1 | 0.5 | 调节画面对比度和饱和度 | CFG重缩放系数 | 0.5是平衡值，可以防止过曝 |
| discretization | discretization | 多种离散化方法 | legacy | 选择时间步长的计算方式 | 时间步离散化方法 | legacy适合大多数情况 |
| output_height | output_height | 像素值 | 1024 | 生成图片的高度 | 输出图像高度 | 1024适合SDXL，512适合SD1.5 |
| output_width | output_width | 像素值 | 1024 | 生成图片的宽度 | 输出图像宽度 | 保持长宽比例协调 |
| random_seed | random_seed | -1000000到1000000 | -1 | 随机数种子，控制结果的随机性 | 随机种子值 | -1表示随机，固定数值可重复结果 |
3.3 MantrasNode 节点 - 咒语模板库
这个节点就像一个"魔法咒语收藏夹"，里面存放了各种预设的提示词模板，让你的描述更专业更有效果。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| mantra_styles | mantra_styles | 多种风格模板 | 根据需求选择 | 选择预设的描述风格模板 | 提示词风格模板选择 | 选择"写实摄影"会自动添加专业摄影术语 |
常见风格模板说明：
- 写实摄影：添加专业摄影参数，让图片更像真实照片
- 动漫风格：添加动漫相关描述词，生成二次元风格
- 油画风格：添加绘画技法描述，生成艺术画作效果
- 科幻风格：添加未来科技元素描述
3.4 TunerNode 节点 - 个性化调优器
这个节点就像一个"个人定制师"，可以加载专门训练的小模型来实现特定的风格或效果。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| tuner | tuner | 多种调优器 | 根据需求选择 | 选择特定风格的小模型 | LoRA/微调模型选择 | 选择"粘土风格"让所有图片都变成粘土质感 |
| tuner_scale | tuner_scale | 0-1 | 1 | 调优器的影响强度 | 微调模型权重系数 | 1是完全应用，0.5是一半效果 |
常见调优器类型：
- 风格调优器：改变图片的艺术风格
- 角色调优器：生成特定角色或人物
- 概念调优器：添加特定的概念或元素
- 技法调优器：模拟特定的绘画技法
3.5 ControlNode 节点 - 精确控制器
这个节点就像一个"画画指导老师"，通过线稿、深度图等方式精确控制AI画画的构图和形状。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| source_image | source_image | IMAGE | - | 用来提取控制信息的原图 | 输入控制参考图像 | 上传一张照片用来提取轮廓或深度 |
| control_model | control_model | 多种控制模型 | 根据需求选择 | 选择控制方式的类型 | ControlNet模型类型 | Canny提取边缘，Depth提取深度 |
| control_preprocessor | control_preprocessor | 多种预处理器 | 根据控制模型选择 | 选择如何处理原图 | 图像预处理器类型 | Canny检测边缘，Midas估计深度 |
| crop_type | crop_type | CenterCrop/NoCrop | CenterCrop | 选择图片裁剪方式 | 图像裁剪策略 | CenterCrop居中裁剪，NoCrop保持原样 |
| control_scale | control_scale | 0-1 | 1 | 控制的影响强度 | 控制条件权重 | 1是完全按控制图生成，0.5是一半影响 |
| output_height | output_height | 256-2048 | 1024 | 输出图片的高度 | 输出图像高度 | 建议与模型训练尺寸一致 |
| output_width | output_width | 256-2048 | 1024 | 输出图片的宽度 | 输出图像宽度 | 保持合适的长宽比 |
控制类型说明：
- Canny：边缘检测，适合控制轮廓
- Depth：深度估计，适合控制空间层次
- Pose：姿态检测，适合控制人物动作
- Normal：法线贴图，适合控制表面细节
3.6 ACEPlusProcessorNode 节点 - ACE+图像处理器
这个节点就像一个"智能图像编辑助手"，专门用于ACE+模型的图像预处理和编辑任务。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| ref_image | ref_image | IMAGE | - | 参考图片，用作编辑的基础 | 参考图像输入 | 上传要编辑的原始图片 |
| task_type | task_type | 多种任务类型 | 根据需求选择 | 选择要执行的编辑任务 | 图像处理任务类型 | 选择"去除文字"可以清除图片中的文字 |
| repainting_scale | repainting_scale | 0-1 | 1 | 重绘区域的强度 | 重绘强度系数 | 1是完全重绘，0.5是部分保留原图 |
| edit_mask | edit_mask | MASK | - | 编辑区域的遮罩 | 编辑区域掩码 | 白色区域会被编辑 |
| edit_image | edit_image | IMAGE | - | 编辑后的图片 | 编辑目标图像 | 某些任务需要提供目标图片 |
任务类型说明：
- image_processor：通用图像处理
- depth_estimation：深度估计
- edge_detection：边缘检测
- segmentation：图像分割
- inpainting：图像修复
3.7 CalculatorNode 节点 - 数值计算器
这个节点就像一个"智能计算器"，用来对参数进行数学运算，方便动态调整各种数值。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| parameter | parameter | 整数 | - | 要计算的基础数值 | 输入参数值 | 输入1024作为基础分辨率 |
| type | type | add/sub/mul/div | add | 选择计算类型 | 数学运算类型 | add是加法，mul是乘法 |
| value | value | 整数 | - | 参与计算的数值 | 运算操作数 | 输入2表示乘以2或加2 |
| round_method | round_method | ceil/floor/round | round | 选择取整方式 | 数值舍入方法 | round四舍五入，ceil向上取整 |
计算类型说明：
- add：加法运算
- sub：减法运算
- mul：乘法运算
- div：除法运算
取整方式说明：
- ceil：向上取整（如1.1变成2）
- floor：向下取整（如1.9变成1）
- round：四舍五入（如1.5变成2）
3.8 NoteNode 节点 - 笔记本
这个节点就像一个"便签纸"，用来在工作流中添加说明文字，方便记录和分享。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Notebook | Notebook | 多行文本 | - | 写下你的笔记或说明 | 文本注释内容 | "这个工作流用于生成动漫风格的人物肖像" |
4. 使用技巧和建议
4.1 新手入门建议
- 从基础开始：先使用ModelNode + ParameterNode的简单组合
- 选择合适的模型：SD1.5适合入门，SDXL质量更高，FLUX速度快
- 提示词要具体：详细描述你想要的效果，避免模糊表达
4.2 进阶使用技巧
- 组合使用节点：
- ModelNode + MantrasNode：快速应用风格模板
- ModelNode + TunerNode：实现个性化风格
- ModelNode + ControlNode：精确控制构图
- 参数调优：
- 降低guide_scale可以增加创意性
- 增加sample_steps可以提高质量
- 使用固定seed可以重复结果
4.3 性能优化建议
- 显存管理：
- 选择合适的模型尺寸
- 避免同时加载多个大模型
- 使用model_source选择最快的下载源
- 速度优化：
- 减少采样步数
- 使用快速采样器
- 选择合适的输出分辨率
4.4 质量提升技巧
- 提示词优化：
- 使用MantrasNode的专业模板
- 添加质量相关的关键词
- 合理使用负面提示词
- 控制精度：
- 使用ControlNode精确控制构图
- 调整control_scale找到最佳平衡
- 选择合适的预处理器
5. 常见问题解答
Q1: 为什么生成的图片质量不好？
A: 可能的原因和解决方法：
- 检查提示词是否足够详细和准确
- 增加sample_steps提高采样质量
- 调整guide_scale找到合适的引导强度
- 使用MantrasNode添加质量提升模板
Q2: 模型下载失败怎么办？
A: 尝试以下解决方案：
- 检查网络连接是否正常
- 切换model_source到其他源（ModelScope/HuggingFace）
- 确保有足够的磁盘空间
- 手动下载模型到本地目录
Q3: 显存不够用怎么办？
A: 可以采取以下措施：
- 降低输出分辨率
- 选择较小的模型（如SD1.5而不是SDXL）
- 减少同时运行的节点数量
- 关闭不必要的其他程序
Q4: 如何实现特定风格？
A: 有几种方法：
- 使用MantrasNode选择预设风格模板
- 使用TunerNode加载特定风格的微调模型
- 在提示词中添加风格相关的描述
- 组合使用多个节点实现复杂效果
Q5: ControlNode不起作用怎么办？
A: 检查以下设置：
- 确保control_model与base_model匹配
- 选择正确的control_preprocessor
- 调整control_scale的数值
- 检查输入图片是否合适
Q6: 如何重复生成相同的图片？
A: 需要固定以下参数：
- 设置固定的random_seed（不要用-1）
- 保持所有其他参数不变
- 使用相同的提示词和模型
- 确保节点连接方式一致
6. 工作流程示例
6.1 基础文字生成图片
ParameterNode → ModelNode → 输出图片
6.2 风格化图片生成
ParameterNode → ModelNode ← MantrasNode
↓
输出图片
6.3 个性化风格生成
ParameterNode → ModelNode ← TunerNode
↓
输出图片
6.4 精确控制生成
输入图片 → ControlNode → ModelNode ← ParameterNode
↓
输出图片
6.5 复合高级生成
输入图片 → ControlNode ↘
ParameterNode --------→ ModelNode ← MantrasNode
TunerNode -----------↗ ↓
输出图片
6.6 ACE+图像编辑
输入图片 → ACEPlusProcessorNode → ModelNode ← ParameterNode
遮罩图片 ↗ ↓
输出图片
7. 总结
ComfyUI-Scepter插件是一个功能强大且全面的AI图像生成工具集，提供了从基础生成到高级编辑的完整解决方案。通过8个不同功能的节点，用户可以：
- 灵活组合：根据需求自由组合不同节点
- 精确控制：通过多种控制方式实现精确生成
- 个性化定制：使用调优器实现独特风格
- 专业品质：利用先进的AI模型获得专业级效果
无论你是AI绘画新手还是专业用户，这个插件都能满足你的需求。建议从简单的组合开始学习，逐步掌握更复杂的功能，最终创造出令人惊艳的AI艺术作品！
记住，好的AI艺术作品需要：清晰的想法 + 合适的工具 + 耐心的调试。SCEPTER插件为你提供了强大的工具，剩下的就是发挥你的创意了！