ComfyUI 魔法书 Logo
🏠 首页
👥 加群
🔥 报错不求人
😎 大帅比
登录 →
ComfyUI 魔法书 Logo
🏠 首页 👥 加群 🔥 报错不求人 😎 大帅比
登录
  1. 首页
  2. 🧩 插件工坊 (Plugin Workshop)
  3. ComfyUI插件SD-PPP完整使用指南

ComfyUI插件SD-PPP完整使用指南

0
  • 🧩 插件工坊 (Plugin Workshop)
  • 发布于 2025-06-27
  • 53 次阅读
编程界的小学生
编程界的小学生

【版权严正声明】

本文系作者 [编程界的小学生] 原创,并拥有完整、独立的著作权。

未经本人 书面授权 ,任何单位、平台或个人, 严禁 以任何形式(包括但不限于转载、复制、摘编、修改、链接、转贴、建立镜像等)使用本文的全部或部分内容。

任何无视本声明的侵权行为,本人将依据《中华人民共和国著作权法》等相关法律法规,采取一切必要的法律手段,追究其侵权责任,要求其 立即停止侵权、赔礼道歉、消除影响,并赔偿因此造成的一切经济损失及维权成本(包括但不限于律师费、诉讼费、公证费等)。

侵权必究,切勿以身试法!

插件简介

SD-PPP 是一个强大的 ComfyUI 插件,它的主要作用是简化 ComfyUI 的使用并连接 Photoshop。这个插件就像一座桥梁,让你可以在 Photoshop 和 ComfyUI 之间轻松传递图像和数据。

GitHub 原地址: https://github.com/zombieyang/sd-ppp

主要功能

  • 🎨 简化 ComfyUI 界面:将复杂的节点工作流转换为类似 WebUI 的简单界面

  • 🔗 连接 Photoshop:支持多图层、多文档、多 Photoshop 实例

  • 📍 区域工作:可以在文档的特定区域进行 AI 处理

  • 🎯 精确控制:支持选区、图层边界等精确操作

如何安装

方法一:使用 ComfyUI Manager(推荐)

  1. 在 ComfyUI Manager 中搜索 sd-ppp

  2. 点击安装即可

方法二:手动安装

  1. 将插件克隆到 <ComfyUI目录>/custom_nodes 文件夹

  2. 重启 ComfyUI

安装 Photoshop 插件

  1. 如果你安装了 Adobe Creative Cloud:

    • 在任意 SDPPP 节点或 ComfyUI 设置界面下载 .ccx 文件

    • 双击 .ccx 文件,会自动安装

  2. 如果你没有 Adobe Creative Cloud:

    • 将 .ccx 文件重命名为 .zip

    • 解压到 Photoshop 安装目录的 Plug-ins 或 Plug-ins/Generator 文件夹

节点详解

当前插件包含节点总数:11个 本次输出节点数:11个 剩余未输出节点数:0个

1. SDPPP Get Document(获取文档)

这个节点是干嘛的? 这个节点就像一个"文档选择器",它帮你从 Photoshop 中选择要处理的文档。就像你在文件夹里选择要打开的文件一样简单。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

文档名称

document_name

STRING

"### 当前文档 ###"

选择要处理的 Photoshop 文档

指定要操作的 Photoshop 文档标识符

选择"### 当前文档 ###"处理当前打开的文档,或选择具体文档名

输出

  • document:文档对象,用于传递给其他节点

  • document boundary:文档边界遮罩,表示整个画布范围

  • selection boundary:选区边界遮罩,表示当前选中的区域

2. SDPPP Get Layer By ID(获取图层)

这个节点是干嘛的? 这个节点就像一个"图层选择器",帮你从 Photoshop 文档中选择特定的图层或图层组。就像在图层面板中点击某个图层一样。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

文档

document

DOCUMENT

必需

要操作的文档对象

从 Get Document 节点获取的文档引用

连接 Get Document 节点的输出

图层或组

layer_or_group

STRING

""

选择要处理的图层

图层的标识符或名称

选择"### 选中图层 ###"或具体图层名

输出

  • layer_or_group:图层对象,用于传递给其他节点

  • layer boundary:图层边界遮罩,表示图层的范围

  • layer_info:图层信息对象,包含图层的详细属性

3. SDPPP Get Linked Layers(获取链接图层)

这个节点是干嘛的? 这个节点就像一个"关联图层收集器",它能找到与指定图层相关联的所有图层。就像找到一个图层的"朋友圈"。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

图层或组

layer_or_group

LAYER

必需

要查找关联图层的基础图层

输入图层对象

连接 Get Layer 节点的输出

选择类型

select

COMBO

"all"

选择要获取的图层类型

过滤条件:all(全部)、text(文本)、image(图像)、first(第一个)

选择"text"只获取文本图层

输出

  • layer_or_group:链接的图层列表

  • layer_boundary:每个图层的边界遮罩列表

  • layer_info:每个图层的信息对象列表

4. SDPPP Get Layers In Group(获取组中图层)

这个节点是干嘛的? 这个节点就像一个"文件夹内容查看器",它能列出图层组里面的所有图层。就像打开一个文件夹看里面有什么文件。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

图层或组

layer_or_group

LAYER

必需

要查看内容的图层组

输入图层组对象

连接指向图层组的 Get Layer 节点

选择类型

select

COMBO

"all"

选择要获取的图层类型

过滤条件:all(全部)、text(文本)、image(图像)、first(第一个)

选择"image"只获取图像图层

输出

  • layer_or_group:组内图层列表

  • layer_boundary:每个图层的边界遮罩列表

  • layer_info:每个图层的信息对象列表

5. SDPPP Get Text From Layer(获取图层文本)

这个节点是干嘛的? 这个节点就像一个"文字提取器",它能从 Photoshop 的文本图层中提取出文字内容。就像复制粘贴文本一样。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

图层或组

layer_or_group

LAYER

必需

要提取文本的图层

输入文本图层对象

连接指向文本图层的节点

文档

document

STRING

""

文档标识符(可选)

文档名称ID,用于兼容性

通常留空,让系统自动处理

输出

  • text:提取的文本内容列表

6. SDPPP Parse Layer Info(解析图层信息)

这个节点是干嘛的? 这个节点就像一个"图层属性查看器",它能把图层的各种属性(透明度、位置、大小等)分解成单独的数值。就像查看文件的详细属性。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

图层信息

layer_info

LAYER_INFO

必需

要解析的图层信息对象

从其他节点获取的图层信息

连接 Get Layer 节点的 layer_info 输出

输出

  • opacity:图层透明度(0-1之间的小数)

  • bound_left:图层左边界位置

  • bound_top:图层上边界位置

  • bound_width:图层宽度

  • bound_height:图层高度

  • name:图层名称

7. SDPPP Get Selection(获取选区)

这个节点是干嘛的? 这个节点就像一个"选区复制器",它能获取 Photoshop 中当前的选区并转换为遮罩。就像把选区变成一个黑白图片。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

文档

document

DOCUMENT

必需

要获取选区的文档

文档对象引用

连接 Get Document 节点的输出

边界

bound

MASK

None

限制选区的范围(可选)

遮罩对象,用于裁剪选区

可以连接其他遮罩来限制范围

输出

  • mask:选区遮罩,白色表示选中区域,黑色表示未选中

8. SDPPP Get Image From Photoshop(从PS获取图像)

这个节点是干嘛的? 这个节点就像一个"图像抓取器",它能从 Photoshop 的图层中获取图像数据,包括颜色和透明度信息。就像截图一样。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

图层或组

layer_or_group

LAYER

必需

要获取图像的图层

图层对象引用

连接 Get Layer 节点的输出

边界

bound

MASK

None

限制获取的区域(可选)

遮罩对象,用于裁剪图像

连接选区遮罩来只获取选中部分

图像质量

quality

FLOAT

100.0

图像压缩质量

JPEG压缩质量,0-100

设置为100获得最高质量

文档

document

STRING

""

文档标识符(兼容性)

文档名称ID

通常留空

输出

  • rgb_out:RGB图像数据列表

  • alpha_out:透明度遮罩列表

9. SDPPP Send Images To Photoshop(发送图像到PS)

这个节点是干嘛的? 这个节点就像一个"图像传送器",它能把 ComfyUI 生成的图像发送回 Photoshop,创建新图层或替换现有图层。就像把图片拖拽到 PS 里。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

图像

images

IMAGE

必需

要发送的图像数据

图像张量数据

连接生成图像的节点输出

图层或组

layer_or_group

LAYER

必需

目标图层

图层对象引用

连接 Get Layer 节点或选择新建图层

边界

bound

MASK

None

限制放置的区域(可选)

遮罩对象,用于定位图像

连接选区遮罩来精确放置

文档

document

STRING

""

文档标识符(兼容性)

文档名称ID

通常留空

输出

  • layer_or_group:创建或修改的图层对象列表

10. SDPPP Select Layer And Run PS Action(选择图层并运行PS动作)

这个节点是干嘛的? 这个节点就像一个"自动化助手",它能选择指定图层并运行 Photoshop 的动作(Action)。就像录制的宏命令一样。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

图层或组

layer_or_group

LAYER

必需

要选择的图层

图层对象引用

连接 Get Layer 节点的输出

动作

action

COMBO

""

要执行的PS动作

Photoshop动作名称

选择预设的滤镜或效果动作

输出

  • layer_or_group:处理后的图层对象

11. CLIP Text Encode PS Regional(PS区域文本编码)

这个节点是干嘛的? 这个节点就像一个"区域提示词处理器",它能把文本提示词和对应的遮罩区域结合起来,实现分区域的AI生成控制。

参数详解

参数名 (UI显示)

参数名 (代码里)

参数值

建议值

通俗解释 (能干嘛的)

专业解释

怎么用/举个例子

CLIP模型

clip

CLIP

必需

文本编码模型

CLIP模型对象

连接加载的CLIP模型

文本列表

texts

STRING

必需

提示词文本

多行文本输入

输入"beautiful face, detailed eyes"

遮罩列表

masks

MASK

必需

对应的区域遮罩

遮罩对象列表

连接图层或选区遮罩

强度列表

strengths

FLOAT

1.0

每个区域的影响强度

0.0-10.0的浮点数

设置为1.5增强效果

输出

  • CONDITIONING:编码后的条件数据,用于AI生成

使用技巧和建议

1. 工作流程建议

  1. 先获取文档:始终从 SDPPP Get Document 开始

  2. 选择图层:使用 SDPPP Get Layer By ID 选择要处理的图层

  3. 获取图像:用 SDPPP Get Image From Photoshop 获取图像数据

  4. AI处理:连接到你的AI生成节点

  5. 发送回PS:用 SDPPP Send Images To Photoshop 发送结果

2. 性能优化

  • 设置合适的图像质量(quality参数)

  • 使用边界遮罩限制处理区域

  • 避免处理过大的图像

3. 常用组合

  • 图层替换:Get Layer → Get Image → AI处理 → Send Images

  • 选区处理:Get Document → Get Selection → 作为遮罩使用

  • 批量处理:Get Layers In Group → 批量处理多个图层

常见问题解答

Q: Photoshop 连接不上怎么办?

A:

  1. 确保 Photoshop 版本是 24.4.0 以上

  2. 检查插件是否正确安装

  3. 重启 Photoshop 和 ComfyUI

Q: 获取选区需要什么版本?

A: GetSelection 功能需要 Photoshop 25.0+ 版本

Q: 图像质量参数怎么设置?

A:

  • 100:最高质量,文件较大

  • 80-90:平衡质量和大小

  • 60-70:较小文件,质量略降

Q: 如何处理多个图层?

A: 使用 Get Layers In Group 或 Get Linked Layers 获取多个图层,然后批量处理

Q: 边界遮罩怎么用?

A: 边界遮罩用于限制处理区域,白色区域会被处理,黑色区域会被忽略

高级应用

1. 区域提示词

使用 CLIP Text Encode PS Regional 可以为不同区域设置不同的提示词:

  • 人脸区域:使用人像相关提示词

  • 背景区域:使用风景相关提示词

  • 服装区域:使用服装相关提示词

2. 自动化工作流

结合 PS Action 可以创建复杂的自动化流程:

  1. 选择图层

  2. 运行预设的滤镜效果

  3. 获取处理结果

  4. 进行AI增强

3. 批量处理

利用图层组功能可以批量处理多个图层:

  1. 将要处理的图层放入一个组

  2. 使用 Get Layers In Group 获取所有图层

  3. 批量进行AI处理

  4. 批量发送回 Photoshop

总结

SD-PPP 插件为 ComfyUI 和 Photoshop 之间搭建了一座强大的桥梁。通过这11个节点,你可以:

  • 🎯 精确控制图像处理区域

  • 🔄 实现双向数据传输

  • 🎨 结合两个软件的优势

  • ⚡ 提高工作效率

掌握这些节点的使用方法,你就能创建出强大的AI辅助设计工作流,让创作变得更加高效和有趣!


注意:本教程基于 SD-PPP 插件的当前版本编写,如有更新请参考官方文档。

标签: #插件 2338
相关文章

ComfyUI错误修复插件详解:轻松解决常见问题 2025-07-10 18:25

ComfyUI-CustomMenu插件使用教程:高效自定义工作流指南 2025-07-10 17:50

ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44

ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件,就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址:https://github.com/LingSss9/com

ComfyUI WAN 2.2视频插件教程:万相AI提示词全攻略 2025-07-31 11:47

ComfyUI WAN 2.2视频插件教程:万相AI提示词实战指南 2025-07-29 20:10

ComfyUI HeyGem数字人插件教程:零基础快速精通指南 2025-07-22 14:10

目录

从节点基础到高阶工作流,我们为你绘制最清晰的 ComfyUI 学习路径。告别困惑,让每一次连接都充满创造的魔力,轻松驾驭 AI 艺术的无限可能。

  • 微信
  • B站
  • GitHub
Copyright © 2025 AIX All Rights Reserved. Powered by AIX.
隐私政策
津ICP备2024019312号