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.

🚀 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.

<img width="900" alt="ComfyPanel cloud engine ModelZoo" src="https://github.com/user-attachments/assets/cf93c7a5-2e51-4725-b9b7-61300c3f49df" /> - **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. <img width="900" alt="ComfyPanel pano_viewer" src="https://github.com/user-attachments/assets/bead3fdb-3f33-4ade-93ec-1ebc293dc70c" /> - **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. <img width="900" alt="ComfyPanel model3d_viewer" src="https://github.com/user-attachments/assets/67c8da0c-b95a-41e0-906b-6037685ce6dd" /> - **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

ComfyPanel (PS Plugin): The UXP core. A modern, minimalist UI built for the Photoshop sidebar.
Custom Nodes: A robust library of back-end nodes for flow control, multi-dimensional asset rendering, and image IO.
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.

❓ AI-Assisted Troubleshooting & FAQ

Q: How do I sync account balances and user info for BizyAir and RunningHub? A: ComfyPanel features a built-in real-time billing and account dashboard inside the sidebar panel:

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: Log in using your API Key + Shared API Key + User ID (find API Keys in the top navigation "API Keys" tab, and User ID in your account dropdown menu). ComfyPanel will fully unlock your Username and Credits Balance.

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 真正回归到图层创作的本源。

✨ 核心特性

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

<img width="900" alt="ComfyPanel cloud engine ModelZoo" src="https://github.com/user-attachments/assets/cf93c7a5-2e51-4725-b9b7-61300c3f49df" /> - **沉浸式多维资产预览 (全新升级)**：结果预览框打破平面图层限制，迎来空间维度的全面跃升： - **360° VR 全景视图**：在 Photoshop 侧边栏内直接嵌入全交互式、等距柱状投影全景图渲染视口。 <img width="900" alt="ComfyPanel pano_viewer" src="https://github.com/user-attachments/assets/bead3fdb-3f33-4ade-93ec-1ebc293dc70c" /> - **原生 3D 模型视口**：支持由后端节点（如 SV3D / Tripo3D 工作流）生成的 3D 资产（支持 `.glb` 和 `.obj` 格式文件）在面板内进行平滑的 3D 轨道交互旋转与预览。 <img width="900" alt="ComfyPanel model3d_viewer" src="https://github.com/user-attachments/assets/67c8da0c-b95a-41e0-906b-6037685ce6dd" /> - **全功能双分栏模式 (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/插件目录。
- 安装遇到问题？查看完整中文教程。

❓ 常见问题与 AI 诊断 (FAQ)

Q: 在 ComfyPanel 中如何同步 BizyAir 与 RunningHub 的余额和用户信息？ A: ComfyPanel 在 Photoshop 面板内内置了极其方便的实时账户与计费看板：

BizyAir 云端：只需输入 API Key (无需注册或绑定任何个人敏感信息，全匿名安全鉴权），系统在驱动渲染的同时，就会自动秒速拉取并显示你的用户名称与账户余额。

RunningHub 云端：使用 API Key + Shared API Key + User ID 登录（API Key 和 Shared API Key 在顶部导航"密钥"标签页中，User ID 在右上角账号下拉菜单中）。ComfyPanel 将完美解锁并显示你的用户名称、账户余额/点数。

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 专业版。

💬 Support & Feedback / 反馈与升级

ComfyPanel is an independent tool hand-crafted by Gino @ LAZYet, designed to bring professional AI workflows directly into Adobe Photoshop. ComfyPanel 是由 Gino @ LAZYet 独立开发与精心打磨的设计师级 AI 整合方案，旨在将专业的 AI 工作流无缝融入 Adobe Photoshop。

⚖️ License

This project uses a Dual License model:

See LICENSE for full terms.