连接失败与权限排查

一、连接架构回顾

Photoshop（SD-PPP 插件）
        ↕ HTTP / WebSocket
ComfyUI（127.0.0.1:8188 + SD-PPP 自定义节点）

任一环断开 → PS 显示 Disconnected / Timeout / No workflow。

二、快速检查清单（5 分钟）

#	检查项	期望
1	ComfyUI 已启动	浏览器能开 `http://127.0.0.1:8188`
2	SD-PPP 节点已装	节点菜单有 Get/Send
3	工作流已加载	含 Get/Send 的 JSON 打开且无红框
4	PS 插件已启用	扩展面板可见 SD-PPP
5	地址一致	PS 填 `127.0.0.1:8188`（非 localhost 混用）
6	防火墙	本机 8188 未被拦

三、ComfyUI 端排查

3.1 服务未启动

现象：浏览器 8188 打不开；PS 连接拒绝。

处理：

cd ComfyUI
python main.py --listen 127.0.0.1 --port 8188

确认终端无 ImportError（缺 SD-PPP 依赖）。

3.2 SD-PPP 节点缺失

现象：工作流 JSON 打开后 Get/Send 红框。

处理：

确认 ComfyUI/custom_nodes/sd-ppp 存在；
重启 Comfy；
查看启动日志是否有 sd-ppp load failed。

3.3 端口被占用

现象：Address already in use。

处理：

换端口 --port 8189，PS 同步改；
或结束占用 8188 的旧 Comfy 进程。

3.4 `--listen` 与远程

本机 PS + 本机 Comfy：127.0.0.1 即可。
Comfy 在 另一台机器：Comfy 需 --listen 0.0.0.0，PS 填 局域网 IP；防火墙放行 8188。

四、Photoshop 端排查

4.1 插件未加载

现象：菜单无 SD-PPP。

处理：

增效工具 → 管理增效工具 确认启用；
重启 PS；
查 Plug-ins 或 UXP 安装路径是否正确（见 9-4）。

4.2 版本不兼容

现象：面板空白、闪退。

处理：

对照 SD-PPP README 支持的 PS 版本（通常 CC 2022+）；
升级插件到 最新 Release；
macOS / Win 分别下载对应包。

4.3 连接地址错误

错误写法	正确
`8188` 无协议	`http://127.0.0.1:8188`
`https://`	默认 http
尾随 `/` 部分版本敏感	试去掉或保留，与文档一致

4.4 工作流列表为空

JSON 放到 user/default/workflows/Photoshop/；
PS 面板 Refresh；
Comfy 先打开 该工作流再刷新。

五、运行时报错

5.1 Queue 无反应

原因	处理
Get 未触发	PS 点 Send 后再 Queue
工作流有红节点	修模型路径 / 缺节点
GPU OOM	降分辨率；关其他占显存程序

5.2 Send 成功但 PS 无图层

PS 文档未激活（无前台文档）；
Send 未接 IMAGE；
PS 只读/锁定 背景层——新建文档试一次。

5.3 图全黑 / 全噪点

VAE / Checkpoint 不匹配；
denoise 或 Mask 错误（回 9-6）。

六、权限与安全

6.1 Windows 防火墙

首次运行 Python/Comfy 时弹窗 → 允许专用网络。
手动：高级安全 Windows 防火墙 → 入站规则 → 新建端口 8188 TCP。

6.2 杀毒 / 企业策略

拦截 python.exe 或插件 DLL → 加白名单；
公司电脑可能 禁止 UXP 未签名插件 → 联系 IT 或 9-10 无插件方案。

6.3 macOS

隐私与安全性 允许 PS 网络；
Gatekeeper 拦截插件 → 系统设置中允许。

七、日志在哪里看？

来源	位置
Comfy	启动终端 stdout；`ComfyUI/user/comfyui.log`（若有）
SD-PPP	Comfy 终端 `[sd-ppp]` 前缀行
PS	帮助 → 系统信息 → 增效工具；UXP 开发者控制台（进阶）

建议：复现一次失败，复制终端最后 30 行 再搜 Issue。

八、分场景决策树

PS 显示 Disconnected
  ├─ 8188 浏览器打不开 → 启动 Comfy / 查端口
  ├─ 8188 能开，PS 不行 → 地址、防火墙、http
  └─ 连上但无工作流 → 路径、Refresh、JSON 格式

能 Queue 无结果
  ├─ 红节点 → 模型/自定义节点
  └─ OOM → 降尺寸

有结果 PS 收不到
  └─ Send 接线、PS 前台文档、图层权限

九、仍无法解决时

SD-PPP GitHub Issues 搜关键词；
提供：OS、PS 版本、Comfy 版本、插件版本、终端日志；
临时改用 9-10 导出/回导 继续作业。