SD-PPP 安装与首次连通（主推）

一、SD-PPP 双端架构

┌─────────────┐         HTTP/WS          ┌─────────────┐
│ Photoshop   │ ◄──────────────────────► │  ComfyUI    │
│ SD-PPP 插件 │    127.0.0.1:8188        │ SD-PPP 节点 │
└─────────────┘                          └─────────────┘

PS 不发 prompt 算法，只 传图/收图；推理仍在 ComfyUI。

二、ComfyUI 端安装

步骤 1：Manager 安装

1. 打开 ComfyUI Manager；

2. 搜索 SD-PPP 或 sd-ppp；

3. Install → Restart ComfyUI。

步骤 2：Git 安装（备选）

cd ComfyUI/custom_nodes
git clone https://github.com/zombieyang/sd-ppp

重启 ComfyUI。

步骤 3：依赖

终端报错则 Manager → Install dependencies（sd-ppp 目录）。

步骤 4：验证

节点菜单出现 SD-PPP 分类或 Get Image From Photoshop 等。

三、Photoshop 端安装

3.1 获取 .ccx

• SD-PPP 仓库 Releases 或文档中的 Photoshop 插件链接；

• 或 ComfyUI SD-PPP 节点右键 Install Plugin（部分版本提供）。

3.2 安装 .ccx

方式 A：双击 .ccx，Creative Cloud 安装。

方式 B：ccx 改后缀 .zip 解压，复制到：

Photoshop/Plug-ins/
或
C:\Users\<用户>\AppData\Roaming\Adobe\UXP\Plugins\External\

（路径因 PS 版本而异，见 9-9。）

3.3 启用插件

1. 重启 Photoshop；

2. 插件 → SD-PPP（或 增效工具 里启用）；

3. 面板停靠侧边。

四、首次连接

4.1 启动顺序

1. 先启动 ComfyUI（等终端 Ready）
2. 再打开 Photoshop SD-PPP 面板
3. 地址填：http://127.0.0.1:8188
   （或 http://localhost:8188）
4. 点击 Connect / 连接

4.2 成功指示

• 面板 绿灯 / Connected；

• ComfyUI 终端可能有 client connected 类日志；

• 工作流列表可刷新（若面板支持）。

4.3 失败

见 9-9；常见：Comfy 未开、端口错、防火墙、插件未启用。

五、最小连通测试

ComfyUI 端

1. 加载 SD-PPP 官方或社区 minimal 工作流（含 Get + 简单 Save 或 Send）；

2. Get Image From Photoshop 节点在链上；

3. 工作流 保持打开，Queue 等待 PS 发送（或 PS 触发运行，视版本）。

PS 端

1. 打开任意 小文档；

2. 面板点 Send to ComfyUI / Run（按钮名因版本）；

3. Comfy 收到图 → 走 Save 或 Send 回 PS。

成功标准

• PS 出现 新图层 含 Comfy 处理结果，或

• Comfy output/ 出现刚发送的测试图。

六、地址与端口配置

初学只用 127.0.0.1。

七、与 ComfyUI 桌面版

ComfyUI Desktop 同样监听本地端口；SD-PPP 连接方式 与便携版相同，以实际端口为准。

八、安装后建议

1. 固定 一个 PS 专用工作流 目录；

2. Comfy 工作流 Save 后，PS 面板 刷新工作流列表；

3. Note 记录：插件版本、Comfy commit、PS 版本（便于 9-9 排查）。