Context Engineering：AI时代高效上手新项目的上下文工程实践
2026/8/27 4:42:41
SD-PPP：把 ComfyUI 接进 Photoshop 的免费开源 AI 绘图插件
【免费下载链接】sd-pppA Photoshop AI plugin项目地址: https://gitcode.com/gh_mirrors/sd/sd-ppp
SD-PPP 是一个免费的开源 Photoshop AI 插件，核心能力是把 Stable Diffusion、Flux 等模型接进 Photoshop：提示词在 PS 面板填写，生成的图像直接回到画布成为可编辑图层。它适合已经在用 Photoshop、又想叠加本地 ComfyUI 或云端 AI 生成能力的设计师与插画师，文生图、局部重绘、批量变体都能在不切换软件的情况下完成。
一分钟认识 SD-PPP
SD-PPP 解决的是一个具体的问题：Photoshop 本身没有生成式 AI，传统流程要在 PS、浏览器、独立 WebUI 之间来回倒图。SD-PPP 把这条链路合并成一步。
它做的事可以概括为三件：
- 双向传图：ComfyUI 的节点可以从 PS 取图层、文档、选区、文字，也能把结果按指定图层和边界写回画布
- 图层级操作：生成结果默认落在独立图层（以工作流命名），支持对现有图层做重绘、取内容做输入
- 模型来源灵活：本地 ComfyUI 免费使用；也可接 RunningHub 等云端 API，调用 Nano-banana、Flux-Kontext、Midjourney 等模型
代码由两部分组成：TypeScript 写的 Photoshop 扩展（面板、画布交互），以及 Python 写的 ComfyUI 自定义节点与 Socket.IO 通信层（见 sdppp_python/sdppp.py）。GPL-3.0 协议，仓库里带 changelog 与示例工作流，可以直接看演进记录（changelog.md）。
版本要求注意一点：2.0 Beta 需要 Photoshop 2025（PS26.0+）。
快速跑起来
整条流程分三步，命令很少。
1. 拿到仓库
git clone https://gitcode.com/gh_mirrors/sd/sd-ppp2. 安装 PS 侧插件：把plugins/photoshop/里的文件（index.html、index.js、manifest.json、icons）复制到Adobe/Adobe Photoshop [版本]/Plug-ins/下，完全退出并重启 Photoshop，在「窗口 → 扩展」中找到 SD-PPP 启用。
3. 安装 ComfyUI 侧节点：走本地 ComfyUI 路线时，把仓库根目录放进 ComfyUI 的custom_nodes，重启 ComfyUI（默认地址127.0.0.1:8188）。
装完后的连通判断标准：PS 侧面板能显示 ComfyUI 连接状态与队列数，ComfyUI 侧出现 SD-PPP 节点组即可。仓库的static/目录下附有.ccx扩展包，可从 ComfyUI 内的节点面板直接下载安装，省去手动拷贝。
按场景看能力
文生图，结果直接进画布
- 想做什么：输入一句描述，拿一张可继续编辑的图
- 用什么：PS 侧面板的提示词框 + 已保存的工作流（或 RunningHub 云端模型）
- 关键点：执行后结果以独立图层回到当前文档，图层名取自工作流名；面板可设图像来源（文档/画布）与边界
局部重绘、区域编辑
- 想做什么：只改画面某一块，其余保持不动
- 用什么：PS 的选区或蒙版 +
GetSelection/LoadImage as Mask节点 - 关键点：选区直接作为生成的边界输入，边界可连接 ComfyUI 自带节点做外扩；结果按原边界写回，避免位置偏移
批量出图与多版本对比
- 想做什么：同提示词出一批变体，挑最好的
- 用什么：工作流编辑面板的队列按钮（提供 queueX1、queueX3 等档位）
- 关键点：多张结果逐层回填，在图层面板里逐张对比；种子参数可固定以便复现
工作流模板化，一键复跑
- 想做什么：把调好的参数组合固化下来，团队或自己反复用
- 用什么：PS 面板的工作流列表与保存功能
- 关键点：面板按节点名记忆各组件的输入值，下次打开自动回填；仓库 static/sdppp-workflows/Sample_SDXL.json 提供了 SDXL 示例工作流可直接参考
本地 GPU 不够，走云端 API
- 想做什么：不占本地显卡，用 Nano-banana、Flux-Kontext-Pro/Max、Midjourney 等模型
- 用什么：RunningHub 等云端服务，面板选择服务类型并填入 API Key
- 关键点：云端路线下 ComfyUI 不需要安装任何自定义节点，2.0 Beta 的面板对新 UI 与键盘快捷选图做了专门优化
参数速查
以下区间对应 ComfyUI 侧采样器节点的常用取值，具体以所用工作流为准。
| 参数 | 档位 | 适用场景 |
|---|---|---|
| 采样步数 | 15–20 | 草图与概念探索，出图快 |
| 25–30 | 日常设计的主力区间 | |
| 35–40 | 成品交付前的正式出图 | |
| 45+ | 需要极限细节的少数场景，耗时明显增加 | |
| CFG Scale | 5–6 | 希望模型有更多自由发挥 |
| 7–8 | 遵循提示词与画面质量的平衡点 | |
| 9–10 | 严格贴合提示词的精确控制 | |
| 11+ | 容易出现过饱和或失真，谨慎使用 | |
| 分辨率 | 512×512 | 图标、表情包、快速预览 |
| 768×768 | 社交媒体图、网页元素 | |
| 1024×1024 | 高质量数字内容的主力规格 | |
| 2048×2048 | 印刷与大幅面，显存占用高 |
常见坑与排查
| 现象 | 原因 | 处理 |
|---|---|---|
| 连接被拒，提示版本不匹配 | PS 插件与 ComfyUI 节点版本不一致 | 两侧同时重新安装到同一版本，仓库内 version.txt 记录了 API 级别 |
| PS 装了扩展却看不到 AI 功能 | 只装了 PS 侧，没装 ComfyUI 节点 | 确认custom_nodes中已放入本仓库并重启 ComfyUI |
| 连不上 ComfyUI | 地址端口错误，默认非 8188 或被防火墙拦截 | 核对 ComfyUI 启动参数里的 listen 地址；内网环境注意 404/502 提示 |
| 生成结果位置偏移 | 文档 DPI/PPI 不为 72 时换算出错 | 升级到 1.9.12 及以上版本，该问题已修复 |
| 取图报 -1 错误或图层不可选 | 16 位、灰度、CMYK 图层的兼容性 | 转成 8 位 RGB 再操作；图层组场景下先展开再选 |
| 大图解码后回传卡住 | 图像体积过大 | 调低 GetImage 节点的 quality 压缩率，或先降分辨率再放大 |
| 面板空白、加载失败 | Webview 加载异常 | 查看面板错误提示，多数情况重启 Photoshop 后重连即可恢复 |
接下来做什么
先跑通「文生图进画布」这一条最基础的链路，熟悉面板各区域；再挑一个真实项目用局部重绘走一遍完整流程。遇到具体报错，优先查 changelog.md 确认是否为已知版本问题。
附：想读源码的话，入口是 sdppp_python/sdppp.py（Socket.IO 事件注册与实例管理）、sdppp_python/protocols/photoshop.py（取图/回图协议），PS 侧界面代码在 typescripts/modules/photoshop/，其中 Main.tsx 是主面板组件。
【免费下载链接】sd-pppA Photoshop AI plugin项目地址: https://gitcode.com/gh_mirrors/sd/sd-ppp
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考