# ComfyPanel 🎨⚡ > **The Artisan’s Bridge between ComfyUI and Adobe Photoshop.** [English](#english) | [中文](#中文) | [📖 Detailed Tutorials](https://lazyet.com/blogs/labs/comfypanel-tutorial) | [💎 ComfyPanel Pro](https://lazyet.com/products/comfypanel-pro) --- ## Photoshop AI Full-Featured Panel ComfyPanel is a professional Photoshop plugin built for designers and AI developers. Acting as a central hub, it seamlessly bridges **local ComfyUI computing power** with **cloud platforms (RunningHub, BizyAir)** to deliver a high-performance Edge-Cloud Hybrid workflow. --- ## Core Data Flow & Integration Architecture ### 🔄 PS ↔ Local ComfyUI (Full-State Real-Time Bidirectional Mirroring) * **Deep State Synchronization**: Moves far beyond simple canvas, mask, and image syncing to deliver full operational state mirroring. * **Bi-directional Interactivity**: Adjusting parameters, setting nodes, and even toggling execution modes like `Run` / `Run (on change)` are fully interactive, editable, and synchronized across both Photoshop and ComfyUI in real time. ### ⚡ ComfyUI ↔ RunningHub (Local Front-end Editing + Cloud Compute Offloading) * **Advanced Front-end UI**: Utilizes the built-in Webview window as a rich, local visual workflow editor. * **One-Click Compute Switching**: Users can instantly switch the **GPU Server** from local to cloud (e.g., RunningHub 24G/48G) via the right panel. Once switched, clicking `Run` inside the ComfyUI interface automatically **reroutes** the execution request to RunningHub's native API, to RunningHub's native API (with auto-adaptive geo-routing to runninghub.ai for international users or runninghub.cn for domestic users), seamlessly leveraging cloud GPU power. * **Real-time Status Feedback**: Track rendering progress, active nodes, and execution steps instantly via the built-in Webview canvas. ### 🚀 PS ↔ RunningHub Native API (Asynchronous Direct-Connect Mode) * **Bypass Rendering Engine**: When a cloud node is selected in the **GPU Server**, users can configure workflows inside the Webview and then trigger generation directly via the `Run` button on the main Photoshop panel side. * **Direct Task Submission**: Tasks are dispatched independently to RunningHub's native ComfyUI API, and final outputs are rendered straight back onto your PS layers. The entire process completely bypasses the Webview window, preventing overhead and ensuring smooth performance. ### ☁️ PS ↔ RunningHub / BizyAir (SaaS API Configuration-Free Lightweight Calls) * **Out-of-the-Box Setup**: Zero local deployment required. No need to install complex local nodes or manage heavy checkpoints. * **Cloud Ecosystem Integration**: Trigger pre-packaged cloud AI Apps, model library APIs, and BizyAir acceleration nodes directly from the PS panel, unlocking pure cloud computing power on low-spec hardware. --- ## 🌟 Overview ComfyPanel is a professional-grade, high-performance integration for **Adobe Photoshop** and **ComfyUI**. Built by designers for designers, it treats AI generation not just as a button, but as a fine-tuned "artisan tool" seamlessly woven into your creative layers.

ComfyPanel Interface

### 🚀 Key Features - **Multi-Cloud & Local Engine Ecosystem**: Seamlessly switch compute backends between **Local ComfyUI** (Maximum Privacy), **BizyAir Cloud**, and the newly integrated **RunningHub Cloud API** (Maximum Power), with native support for the dedicated **NanoBanana Engine**. - **ModelZoo API with Instant Live Sync**: Real-time cloud model library integration for BizyAir and RunningHub. New models added to official cloud repositories become immediately available in ComfyPanel without any plugin updates. Features dynamic parameter UI generation, **Smart-Loader** grouping, and transparent billing references.

ComfyPanel cloud engine ModelZoo

- **Immersive Multi-Dimensional Previews (New)**: The result preview box goes beyond flat images: - **360° VR Panoramic View**: Fully interactive, equirectangular panoramic viewer built directly into the Photoshop sidebar.

ComfyPanel pano_viewer

- **Native 3D Mesh Viewer**: Smooth interactive rendering for 3D assets (supports `.glb` and `.obj` files) generated from backend nodes (e.g., SV3D / Tripo3D workflows). - **Integrated Split-View (App + Graph)**: No need to switch between browser and Photoshop. Open the full ComfyUI workflow graph directly inside the Photoshop panel side-by-side with your "App" controls.

ComfyPanel model3d_viewer

- **Interactive Control (Pause & Preview)**: Integrated `AnyPreviewPause` node allows you to stop and preview directly in the Photoshop panel. Tweak parameters or continue only when you're satisfied. - **Infinite Offline Recovery**: Never lose a masterpiece. If Photoshop crashes or closes, ComfyPanel automatically retrieves and renders your asynchronous cloud results (RunningHub / BizyAir) upon the next launch. - **Deep Canvas Awareness**: Real-time synchronization of layer visibility, transparency, masks, and sub-pixel selections via Photoshop UXP core. - **Zero-Copy Performance**: Architecture-level optimization. Utilizing direct local file referencing to completely bypass binary IPC data bottlenecks. Delivers instant synchronization for 4K+ high-resolution textures out of the box with **zero manual configuration required**. - **Remote Tunnel (FRP)**: Access your local ComfyUI instance from anywhere via integrated FRP tunneling. Features on-demand dependency downloading with multi-source fallback and auto-resume logic. ### 🏗️ Structure 1. **[ComfyPanel (PS Plugin)](./photoshop_plugin/ComfyPanel)**: The UXP core. A modern, minimalist UI built for the Photoshop sidebar. 2. **Custom Nodes**: A robust library of back-end nodes for flow control, multi-dimensional asset rendering, and image IO. 3. **App System**: Pre-built "Apps" that turn scary JSON workflows into beautiful, familiar UI sliders. ### 🛠️ Installation * **Photoshop**: Adobe Photoshop 2025 (v26.0) or higher. * **ComfyUI**: Clone this repo to `custom_nodes/` and restart. * **PS Plugin Setup**: * **Auto**: Run `comfypanel.ccx` (recommended). * **Manual**: Copy the plugin folder to `Adobe Photoshop */Plug-ins/` directory. * *Need help? See the [Full Setup Guide](https://lazyet.com/blogs/labs/comfypanel-tutorial).* ### ❓ AI-Assisted Troubleshooting & FAQ > **Q: 为什么插件无法加载？** > **A:** Please check your Adobe account sign-in status (Photoshop > Help). Photoshop must be signed in to an Adobe account to load plugins normally. After signing in once, the plugin can still be loaded offline as long as the account remains signed in. This is a Photoshop requirement, not a plugin requirement. > **Q: How do I sync account balances and user info for BizyAir and RunningHub?** > - **BizyAir Cloud**: Simply enter your `API Key` (no user registration or sensitive data required). ComfyPanel will execute workflows and instantly fetch your **Username** and **Account Balance** automatically. > - **RunningHub Cloud**: Supports two convenient login methods: > - **Phone / Email + Password (Recommended)**: Directly log in with your account credentials without manual configuration. > - **API Key Mode**: Enter your **API Key** (with optional **Shared API Key** and **User ID**). > **Q: How do I fix interface lag or memory overflows when transferring large images?** > **A:** You don't have to configure anything. ComfyPanel utilizes a native, architecture-level **Zero-Copy mechanism** by default. It leverages direct local file references via Photoshop UXP to completely bypass standard binary IPC data bottlenecks, delivering near-instant synchronization for 4K+ high-resolution textures without consuming extra panel memory. > **Q: How can I interact with 360° Panoramas or 3D Assets (GLB/OBJ) generated by ComfyUI?** > **A:** Simply run your workflow. When ComfyPanel detects panoramic outputs or 3D mesh file formats (`.glb`/`.obj`), the result preview widget automatically switches to an interactive 3D/VR viewport, allowing you to orbit, pan, or spin the asset directly inside the Photoshop UI sidebar. --- ## Photoshop AI 全功能面板 ComfyPanel 是一款专为设计师与 AI 开发者打造的 Photoshop 插件。它以 Photoshop 为核心枢纽，完美打通了**本地 ComfyUI 算力**与**云端算力平台（RunningHub、BizyAir）**，实现跨平台的无缝混合渲染（Edge-Cloud Hybrid Layout）。 --- ## 核心数据流与互通架构 ### 🔄 PS ↔ 本地 ComfyUI（全状态实时双向镜像） * **深度状态同步**：不仅同步画布、遮罩与图像像素，更是操作状态的完全互通。 * **双向实时联动**：参数调节、节点设置、甚至是 `Run` / `Run (on change)` 触发模式切换，在 Photoshop 与 ComfyUI 两端皆可双向修改、实时同步。 ### ⚡ ComfyUI ↔ RunningHub（本地前端编辑 + 云端算力托管） * **超级前端交互**：依托插件内置的 Webview 窗口，将本地 ComfyUI 作为可视化工作流编辑器。 * **算力一键切换**：用户可在右侧面板的 **GPU Server** 中一键从本地切换至云端（如 RunningHub 24G/48G）。切换后，在本地画布中点击 `Run`，插件会自动**将渲染请求重定向**至 RunningHub 原生接口，无缝调用云端 GPU 算力。 * **状态实时回显**：渲染进度、当前运行节点及实时状态，均可在内置的 Webview 画布中直观预览。 ### 🚀 PS ↔ RunningHub 原生接口（异步任务直连模式） * **无干扰旁路渲染**：当 **GPU Server** 选择云端节点时，用户在内置 Webview 中配置好工作流，可直接在 Photoshop 侧面板点击 `Run`。 * **独立任务直连**：任务单独提交给 RunningHub 原生 ComfyUI 接口（智能识别账号区划，自适应分流至 runninghub.cn 或 runninghub.ai 网关），无缝调用云端 GPU 算力，渲染结果直接返回并载入 PS 图层。整个过程与状态不经过、不占用内置 Webview 窗口，保障性能畅快。 ### ☁️ PS ↔ RunningHub / BizyAir（SaaS API 免配置轻量调用） * **即开即用**：无需本地部署任何复杂的节点与模型。 * **全云端生态**：通过 PS 面板直接调用云端封装好的 AI App、模型库 API 以及 BizyAir 加速节点算力，实现低配电脑的云端算力自由。 --- ## 🌟 项目简介 ComfyPanel 是一套专为 **Adobe Photoshop** 开发的高灵敏度、专业级 **ComfyUI** 深度整合方案。它由设计师发起，旨在将复杂的节点工作流打磨成设计师手中得心应手的“算力画笔”，让 AI 真正回归到图层创作的本源。

ComfyPanel 界面演示

### ✨ 核心特性 - **云/地多算力与引擎矩阵**：支持**本地运行**（极致隐私）、**BizyAir 云端加速**、全新集成的 **RunningHub 算力云/API 工作流调度**以及 **NanoBanana 专属引擎**一键无缝切换。 - **ModelZoo API 实时同步模型库**：完美整合 RunningHub 与 BizyAir 的云端海量模型库。云端官方库新增模型无需更新插件即可**即时全自动同步**，在 Photoshop 内直接解析模型参数并自动生成 UI 控制项，支持智能加载器（Smart-Loader）自动分组及云端计费参考。

ComfyPanel cloud engine ModelZoo

- **沉浸式多维资产预览 (全新升级)**：结果预览框打破平面图层限制，迎来空间维度的全面跃升： - **360° VR 全景视图**：在 Photoshop 侧边栏内直接嵌入全交互式、等距柱状投影全景图渲染视口。

ComfyPanel pano_viewer

- **原生 3D 模型视口**：支持由后端节点（如 SV3D / Tripo3D 工作流）生成的 3D 资产（支持 `.glb` 和 `.obj` 格式文件）在面板内进行平滑的 3D 轨道交互旋转与预览。

ComfyPanel model3d_viewer

- **全功能双分栏模式 (App + Graph)**：无需在浏览器和 PS 之间切换。直接在 Photoshop 插件面板内打开完整的 ComfyUI 工作流连线图，与 App 操作面板并排显示，实时联动。 - **交互式过程控制**：内置 `AnyPreviewPause` 节点，支持在 PS 面板中直接预览。暂停、微调或继续，确保生成过程完全可控。 - **离线断点找回**：首创云端任务持久化机制。即便中途关闭 PS 或遇到程序崩溃，重启后系统也会自动抓回并渲染来自 RunningHub / BizyAir 已完成的算力任务，绝不丢失灵感。 - **深层画布感知**：基于 Photoshop UXP 核心，全自动同步图层显隐、透明度、选区及蒙版。 - **零拷贝（Zero-Copy）架构级加速**：架构级无感优化。独有的本地路径直接引用技术，彻底告别二进制 IPC 传输带来的延迟与大图（4K+ 纹理）内存溢出。**全自动后台运行，无需用户在 UI 面板上手动开启任何开关。** - **远程隧道 (FRP)**：内置 FRP 隧道技术，支持从公网远程访问本地 ComfyUI。具备按需自动下载依赖、多源重试、SSL 校验绕过及断线自动重连等鲁棒特性。 ### 🛠️ 快速安装 * **Photoshop 要求**：Adobe Photoshop 2025 (v26.0) 或更高版本。 * **ComfyUI 端**：克隆本仓库至 `custom_nodes/` 目录并重启。 * **PS插件安装**： * **自动安装**：直接运行 `comfypanel.ccx`（推荐）。 * **手动安装**：将插件文件夹复制到`Adobe Photoshop */Plug-ins/`插件目录。 * *安装遇到问题？查看[完整中文教程](https://lazyet.com/blogs/labs/comfypanel-tutorial)。* ### ❓ 常见问题与 AI 诊断 (FAQ) > **Q: 为什么插件无法加载？** > **A:** 请检查 Photoshop 的 Adobe 账号登录状态（Photoshop > Help 菜单）。Photoshop 必须登录 Adobe 账号才能正常加载插件。首次登录后，即使处于离线状态，只要账号保持登录，插件仍可正常加载。这是 Photoshop 本身的要求，与插件无关。 > **Q: 在 ComfyPanel 中如何同步 BizyAir 与 RunningHub 的余额和用户信息？** > **A:** ComfyPanel 在 Photoshop 面板内内置了极其方便的实时账户与计费看板： > - **BizyAir 云端**：**只需输入 API Key**（无需注册或绑定任何个人敏感信息，全匿名安全鉴权），系统在驱动渲染的同时，就会自动秒速拉取并显示你的**用户名称与账户余额**。 > - **RunningHub 云端**：提供两种极简的接入方式： > - **手机号 / 邮箱 + 密码（推荐）**：直接输入账号与密码登录，无需手动查找配置； > - **API Key 模式**：输入你的 **API Key**（可选填 **Shared API Key** 与 **User ID**）快速绑定。 > **Q: 如何排查大图传输时插件卡死或内存溢出？** > **A:** 你不需要进行任何手动配置。ComfyPanel 默认原生采用了**底层的“零拷贝（Zero-Copy）”性能机制**。通过 Photoshop UXP 的本地文件直接引用技术，从架构上彻底绕过了传统的二进制 IPC 数据传输瓶颈，4K+ 超高清纹理在生成与同步时天然就是秒速响应且不占额外面板内存。 > **Q: 在 Photoshop 面板中如何交互查看生成的 360° 全景图或 3D 模型（GLB/OBJ）？** > **A:** 无需任何额外设置。当 ComfyPanel 感知到后端输出的资产属于全景图或 3D 网格网格格式（`.glb`/`.obj`）时，结果预览框会自动激活 3D/VR 交互视口。你直接在 PS 侧边栏内拖拽鼠标，即可进行 360° 旋转、缩放和全方位观察。 --- ## 💎 Free Community vs Pro / 免费社区版与专业版 ComfyPanel is committed to the open-source community. The **Free Community Edition** is 100% free, forever free, and unlimited for all core local workflow requirements! If you need advanced professional tools to supercharge your design workflow, consider upgrading to the **Pro Edition**. ComfyPanel 始终拥抱开源社区。**免费社区版**是 100% 永久免费的，不限制本地核心工作流的基础生成！如果您需要更高级的专业功能以大幅提升创作效率，可以考虑升级为 **Pro 专业版**。 | Feature / 功能 | Free Community / 免费社区版 | Pro Edition / Pro专业版 💎 | | :--- | :--- | :--- | | **Local Execution / 本地运行** | Unlimited / 无限制 | Unlimited / 无限制 | | **Interactive Pause / 暂停再编辑** | Static only / 仅限静态执行 | Interactive re-edit / 交互式暂停再重绘 | | **Video & Audio / 视频与音频节点** | Image only / 仅限图像 (LoadImage) | Full video & audio / 音视频全功能及本地导出 | | **Resolution Limit / 分辨率上限** | Up to 2000px / 限制 2K 以内 | Unlimited resolution / 无损超高清无上限 | | **History Manager / 历史生成记录** | Last 5 items / 仅保留 5 条 | Unlimited history / 无上限保存 | | **Smart Layout / 清爽排版** | Standard tiled / 标准平铺 | Smart-Loader & Capsule / 极简胶囊布局 | | **Upload Image Format / 上传图片格式** | PNG (Standard) | PNG (Standard) / WebP (Fast) | --- ## 💬 Support & Feedback / 反馈与升级 ComfyPanel is an independent tool hand-crafted by **[Gino @ LAZYet](https://lazyet.com)**, designed to bring professional AI workflows directly into Adobe Photoshop. ComfyPanel 是由 **[Gino @ LAZYet](https://lazyet.com)** 独立开发与精心打磨的设计师级 AI 整合方案，旨在将专业的 AI 工作流无缝融入 Adobe Photoshop。 - 💎 **[Upgrade to ComfyPanel Pro / 升级至 Pro 专业版](https://lazyet.com/products/comfypanel-pro)** - 🛍️ **[Explore our Physical Designs at LAZYet Studio / 探索我们的物理设计产品](https://lazyet.com)** - 🐛 **[Submit Feedback & Bug Reports / 提交反馈与 Bug 报告 (GitHub)](https://github.com/ginolazy/ComfyPanel/issues)**

ComfyPanel 交流群

Name	Type	Description
image	IMAGE	—
maskopt	MASK	—
align_dataopt	ALIGN_DATA	—

Name	Type	Description
image	IMAGE	—
mask	MASK	—

ImageMask_AlignRestore

Inputs (3)

Outputs (2)