Core Vision 核心定位
ComfyPanel is a seamless bridge connecting ComfyUI's infinite computing power with Photoshop's ultimate creative environment. It provides professional designers with a complete industrial workflow from content sensing and real-time intervention to high-precision output. ComfyPanel 是连接 ComfyUI 无限算力 与 Photoshop 极致创作环境 的无缝桥梁。它为专业设计师提供了一套从内容感知、实时干预到高精产出的完整工业化流程。
Real-time Bi-directional Sensing 实时双向感知
The plugin detects selection changes and layer data on the Photoshop canvas in seconds, converting them into signals recognizable by ComfyUI, completely eliminating the tedious export-import process. 插件秒级感知 Photoshop 画布的选区变化及图层数据，并将其转化为 ComfyUI 可识别的信号，彻底告别繁琐的导出导入过程。
Native Parameter Mapping 原生参数映射
Automatically maps complex backend node parameters to native sliders in the plugin, allowing designers to precisely control AI power within their familiar Photoshop environment. 自动将后端的复杂节点参数映射为插件侧的原生滑块，让设计师在熟悉的 Photoshop 环境中精准控制 AI 算力。
Plugin Installation 插件安装
ComfyPanel for Photoshop Installation ComfyPanel for Photoshop 插件安装
Photoshop Version: Adobe Photoshop 2025 (v26.0) or higher. Photoshop 版本：Adobe Photoshop 2025 (v26.0) 或更高版本。
1. Automatic Installation: Run
comfypanel-main/photoshop plugins/comfypanel.ccx directly (Requires Adobe
Creative Cloud desktop app).
1. 自动安装：直接运行
comfypanel-main/photoshop plugins/comfypanel.ccx。（需 Adobe Creative Cloud
桌面应用）
2. Manual Installation: Place the
comfypanel-main/photoshop plugins/comfypanel folder into the Photoshop UXP
plugins directory.
2. 手动安装：将
comfypanel-main/photoshop plugins/comfypanel 文件夹放入 Photoshop 的 UXP 插件目录。
C:\Users\YourUser\AppData\Roaming\Adobe\UXP\Plugins\Mac:
/Users/YourUser/Library/Application Support/Adobe/UXP/Plugins/
ComfyPanel for ComfyUI Installation ComfyPanel for ComfyUI 插件安装
(Required for Local Engine mode only) （仅本地引擎模式需要安装）
Place comfypanel-main into the comfyui/custom_nodes/
directory, removing any suffix.
将 comfypanel-main 放到 comfyui/custom_nodes/ 目录下，去掉后缀
(如果有)。
Journey: Engine Connection & Initialization 启程：引擎连接与初始化
After launching the plugin, the system automatically detects the environment and establishes communication. This is a crucial step to ensure AI logic feedback is synced to the Photoshop interface in real-time. 启动插件后，系统会自动检测环境并建立通信联调。这是确保 AI 逻辑能实时反馈到 Photoshop 界面的关键步骤。
If connection times out, please check if ComfyUI is running and ensure no
firewall is blocking the port. In Local mode, the plugin automatically looks for
127.0.0.1:8188.
若遇到连接超时，请检查 ComfyUI 是否开启，并确保没有防火墙拦截端口。Local 模式下，插件会自动寻找
127.0.0.1:8188。
Dual-Core Multi-Engine Modes 双核多引擎运行模式
ComfyPanel adopts a "Local + Cloud" dual-drive architecture to meet different computing needs: ComfyPanel 采用“本地 + 云端”双驱动架构，满足不同算力场景：
1. ComfyUI EngineComfyUI 引擎
Features: Supports both local LAN and Remote Access (Provider) connections. Fully compatible with native ComfyUI workflows, supporting custom UI widgets, mask interaction, and smart canvas/layer data exchange. 功能：支持本地局域网及 远程访问 (Remote Access) 连接模式。完美兼容原生 ComfyUI 工作流，支持自定义 UI 参数交互、选区/遮罩同步，以及智能的画布/图层数据交换。
Scenario: High-performance GPU environment. Fast response, zero cost, and high privacy. 场景：拥有高性能显卡的环境。响应快、零成本、高私密性。
2. Cloud NanoBanana Exclusive Engine专属引擎
Features: Cloud-hosted, zero-deployment high-performance engine. Optimized for Photoshop tasks like inpainting, outpainting, and style transfer with exclusive highly-tuned workflows. 功能：云端托管、零部署的高性能引擎。针对 Photoshop 的局部重绘、扩图、风格转换等任务进行了深度优化，内置多套经过精密调优的专属工作流。
Scenario: Multiple ways to achieve precise local modification and inpainting. 场景：多种方式实现更精准的局部修改重绘。
3. Cloud Cloud Engine (e.g., BizyAir)云端引擎 (如 BizyAir)
Scenario: Laptop office work or when massive GPU power is needed. BizyAir is the currently integrated high-performance cloud engine. 场景：笔记本办公或需要海量 GPU 算力时。BizyAir 是目前内置的高性能云端引擎。
BizyAir supports asynchronous rendering; even if Photoshop is closed, cloud tasks continue processing in the queue, and results sync back to your history library automatically. BizyAir 支持异步渲染，即使关闭 Photoshop，云端任务依然在队列中处理，结果会自动同步回你的历史库。
10MB Limit Bypassed (Pro Exclusive): While some cloud engines (like BizyAir) officially cap uploads at 10MB, ComfyPanel Pro utilizes optimized direct cloud storage. Pro members can bypass this 10MB limit entirely and upload massive high-resolution layers. 突破 10MB 上传限制 (Pro 会员专属)：虽然某些云端引擎（如 BizyAir）限制单张图片上传不得超过 10MB，但 ComfyPanel Pro 采用了独家云存储直传优化，Pro 会员在云端模式下可以无视此限制，自由上传超大分辨率高清底图进行渲染。
Quick Start: 3 Steps to Create 快速上手：3 步开启创作
Click the "Camera" or "Layer" icon in the toolbar to input the Photoshop canvas as a reference. 在工具栏点击“相机”或“层”按钮，将 Photoshop 的画面作为参考图输入。
Enter Prompt and other parameters, then click the large
RUN button. Watch the real-time progress bar.
输入 Prompt 及其它参数，点击大大的 RUN 按钮。观察实时进度条。
Generated images can sync back to PS automatically, or you can manually click the toolbar icons in the result box to send them back instantly for further adjustments. 生成的结果图可自动传回 PS，也可以手动点击结果预览框中的工具栏工具，将其秒传回 PS 画布进行后续调整。
⚡️ Troubleshooting: Plugin vs. Backend Engine Errors ⚡️ 常见故障排查：区分『插件问题』与『后端引擎报错』
When a task fails to render or outputs an error in the console, it is vital to distinguish whether the issue lies within the ComfyPanel Plugin (Photoshop side) or the Backend Rendering Engine (ComfyUI / Cloud Servers). In 99% of cases, error alerts displayed during generation are backend engine execution errors rather than plugin bugs. 当控制台输出红字报错或生成中断时，请首要区分这是 ComfyPanel 插件本身（Photoshop端） 的问题，还是 后端渲染引擎（本地 ComfyUI / 云生态服务器） 的执行层报错。在 99% 的情况下，生成过程中出现的红字报错均属于后端引擎算力或工作流本身的问题，而非插件本身的 Bug。
🤖 1. Engine & Model Errors (Backend)1. 引擎与模型报错 (后端执行层)
Phenomenon常见现象: The progress bar runs, but suddenly aborts with a red log saying "Task Failed: CUDA out of memory", "Node execute failed", or missing models/nodes.进度条在正常走，但运行到一半突然变红报错，日志显示“任务失败: CUDA out of memory”（显存溢出）、“节点执行失败”（代码错）、“模型不存在”或找不到特定节点等具体的 Python 英文堆栈。
Cause根本原因: Your local graphics card VRAM is full, or the selected workflow relies on models/custom nodes that you have not downloaded or installed in your ComfyUI directory, or cloud API limits are reached.本地 GPU 显存溢出、工作流中引用的模型在本地未放置正确、自定义节点未下载安装，或者云端算力节点访问超时。这完全是后端运行环境的限制，与 Photoshop 插件本身逻辑无关。
Solution排查解决方法: Check your local ComfyUI terminal console window to view the full python traceback, download/install missing assets, or restart your ComfyUI server.查看本地 ComfyUI 黑色命令行终端窗口中的报错细节，使用 ComfyUI Manager 补充缺失的节点或模型，或者重启 ComfyUI 服务。
🔌 2. Connection & Communication Errors2. 联调与通信报错 (插件层)
Phenomenon常见现象: The status dot is Red, and clicking RUN immediately alerts "Bridge is not connected" or times out with "Failed to fetch".标题栏状态圆点显示为红色，点击 RUN 按钮立即弹出“Bridge is not connected”或“Failed to fetch”报错，进度条根本没有开始走。
Cause根本原因: ComfyUI has not been started, the port (default 8188) is blocked by a local firewall/antivirus, or the Server URL in settings is incorrect.本地 ComfyUI 服务尚未启动、8188 端口被本地防火墙/安全软件拦截，或者设置中的服务器 API 地址填写不正确。这属于插件与服务之间的网络通信受阻。
Solution排查解决方法: Ensure ComfyUI is fully started and listening on 8188, or double-check the server settings in the plugin sidebar.确认 ComfyUI 服务已经在黑窗口中开启并正常侦听，检查插件侧边栏设置中的服务器 API 地址是否与本地或中继服务器保持一致。
Detailed Features: Input Box 功能详解：取图预览框 (Input)
The input area at the top of the panel serves as the AI's "eyes," capturing the Photoshop content you wish to process. Control your inputs using the following buttons: 位于面板上方的取图区是 AI 的“眼睛”，负责捕获你想要处理的 Photoshop 内容。通过以下按钮，你可以实现不同维度的输入管控：
Requires LoadImage, LoadAudio, or LoadVideo nodes; otherwise, input cannot be captured. 依赖 LoadImage, LoadAudio, LoadVideo 节点，否则无法取图。
Selections use the LoadImage node's Mask output as the ComfyUI Mask by default. 选区默认利用 LoadImage 节点的 Mask 输出端作为 ComfyUI 的 Mask。
📷 Camera Capture (Canvas)相机捕获 (Canvas)
Function功能: Captures a full visual preview of the current canvas.捕获当前画布的完整视觉预览。
Scenario场景: Best for sketching or ControlNet global references. Merges all visible layers for AI processing.适用于草描绘图、ControlNet 全局参考。它会合并所有可见图层送入 AI。
🗂 Layer Capture (Layers)图层捕获 (Layers)
Function功能: Captures only currently selected layers and their transparency (supports multiple layers/groups).仅捕获当前选中的图层及其透明信息(支持多选图层、组)。
Scenario场景: Inpainting or specific object redrawing. Maintains canvas dimensions.抠图修复、特定物件重绘。它能保持画布尺寸。
📁 Local Load (Load)本地加载 (Load)
Function功能: Choose images from the local filesystem. Displays media library list; browse to select manually.从本地文件系统选择图片。点击后显示设置中添加的媒体库中的图片列表，点击浏览手动选择加载。
Scenario场景: Loading presets or reference images.加载预设图片、参考图。
✂️ Crop by Layer Bounds按图层边界裁剪
Function功能: Captures images within the current layer's boundaries. Automatically generates a Mask when used with Inpaint nodes.激活后将 Photoshop 当前的图层边界范围内取图。若配合 Inpaint 节点，它能自动生成对应的 Mask。
Scenario场景: Ideal for multi-layer documents when modifying specific layers.适用于多图层文档，需修改特定图层。
✂️ Crop by Selection按选区裁剪
Function功能: Captures images within the current marquee selection. Automatically generates a Mask when used with Inpaint nodes.激活后将 Photoshop 当前的选区范围内取图。若配合 Inpaint 节点，它能自动生成对应的 Mask。
Scenario场景: Best for large images where only a local area needs to be processed.适用于原图较大，需要局部修改时局部取图。
✨ Stroke Selection Edge描边选区
Function功能: Strokes the current marquee selection to create a red bounding box.激活后将 Photoshop 当前的选区描边，生成红框。
Scenario场景: Used for nodes without mask support, like NanoBanana or Flux, to reinforce semantic cues (e.g., "Replace... inside the red box").用于不支持 mask 的节点，比如 NanoBanana 或 Flux 强化语义（例：替换红框内的...）。
🔒 Lock锁定 (Lock)
Function功能: Locks the currently captured image.锁定当前捕获的图。
场景Scenario: Prevents overwriting when using multiple LoadImage nodes for different inputs.用于多 LoadImage 节点时，各自取不同的图。
Detailed Features: Result Previewer (Output Sync) 功能详解：结果管理与回传 (Output)
Once generation is complete, results appear in the preview area below. This is where designers review and apply their creative output: 生成完成后，结果会立即出现在下方的结果预览区。这里是设计师最终验收并应用创意的产房：
Requires SaveImage, SaveAudio, or SaveVideo nodes; otherwise, results cannot be synced. 依赖 SaveImage, SaveAudio, SaveVideo 节点，否则无法回传。
The preview area supports lists for images, audio, and video, with type filtering and swipe navigation. 结果预览框支持（图像、音频、视频）列表，支持类型过滤，可左右滑动查看。
Settings allow auto-insertion into the document; Crop mode auto-inserts into selection/layer boundaries. 可在设置中设置自动插入当前文档图层，Crop 模式自动插入选区/图层边界。
📥 Sent to Photoshop (Sync回传)
Manual Action手动操作: Click icons > To Canvas, To Selection, To New Doc.直接点击图标 > 到画布， 到选区， 到新文档。
Effect: Images auto-align to coordinates and are placed as new layers in Photoshop, perfectly matching your original design position. 效果：图片将自动对齐坐标并创建新图层置入当前文档
Hold Shift while sending to Canvas for centering without distortion. Hold Shift while sending to Selection to fit layer bounds. 到画布可选按住 Shift 键，居中不变形。到选区可选按住 Shift 键，适配到图层边界。
🎞 Frame Export (Video Tools)截帧导出 (Video Tools)
Scenario: For video workflows. Click
Capture Frame to instantly turn a perfect video moment into a Photoshop
layer for post-processing.
场景：针对视频工作流。点击
Capture Frame，可以将视频中的完美时刻瞬间转为 Photoshop 图层进行后期修图。
🧐 History Stream (History)历史流 (History)
Features: Slide the timeline at the bottom to view all historical versions of the current run. Supports side-by-side comparison for easy selection. 功能：滑动底部的时间轴可查阅本次运行的所有历史版本。支持左右对比，方便从中选优。
The result previewer supports video results, allowing you to capture a screenshot of the video frame with a single click and insert it into the current document or a new document. 结果预览框支持视频类型结果，视频画面可一键截屏插入当前文档/新文档。
Preview Box预览框
1. Native ComfyUI PreviewImage & MaskPreview; 2. ComfyUI's AnyPreview (Preview only) & AnyPreviewPause (Preview and Edit). 1. ComfyUI 原生 PreviewImage & MaskPreview; 2. ComfyUI 自带 AnyPreview (仅预览) & AnyPreviewPause (预览再编辑)。
- Smart-Previewer Mode (Can be disabled in settings; shows single node if disabled.)Smart-Previewer 模式（设置中可关闭，关闭后按单节点显示。）: In Smart-Previewer mode, all visible PreviewImage, MaskPreview, and AnyPreview nodes in the workflow are merged into a single preview box. It automatically shows the current preview node's result during a Run (switchable). Smart-Previewer 模式下，自动将工作流中所有可见 PreviewImage, MaskPreview, AnyPreview 合并到一个预览框中，Run 时自动显示当前预览节点的结果（可切换）。
By default, it recognizes Primitive (Native ComfyUI), PrimitivePlus (ComfyPanel), AnyPreviewPause (ComfyPanel), and rgthree series nodes (for Mute/Bypass). See user_config.js for more custom node recognition. 默认识别 Primitive (ComfyUI 原生节点), PrimitivePlus (ComfyPanel 自带节点), AnyPreviewPause (ComfyPanel 自带节点) 以及 rgthree 系列节点 (控制 Mute, Bypass)，更多自定义节点识别见 user_config.js 文件。
Dynamic Parameters & Widget Control 动态参数与 Widget 控制
The plugin automatically parses core nodes like LoadImage and
LoadAudio in the current workflow and converts them into adjustable widgets.
插件会自动解析当前工作流中的 LoadImage, LoadAudio 等核心节点，并将其转化为可调节的
Widget。
- Text Box文本框: Enter prompts directly; supports multi-line expansion.直接输入提示词，支持多行扩展。
- Float/Int Sliders浮点/整数滑块: Precisely control Steps, Denoise strength, etc.精准控制步数 (Steps)、重绘强度 (Denoise) 等。
- Seed Control种子控制: Switch between Random/Fixed modes; lock your lucky seeds with one click.提供 Random/Fixed 模式切换，支持一键锁定幸运 Seed。
Default recognition includes Primitive (Native), PrimitivePlus (ComfyPanel), AnyPreviewPause (ComfyPanel), PreviewImage, MaskPreview, and rgthree nodes. See user_config.js for more details. 默认识别 Primitive (ComfyUI 原生节点), PrimitivePlus (ComfyPanel 自带节点), AnyPreviewPause (ComfyPanel 自带节点), PreviewImage, MaskPreivew 节点以及 rgthree 系列节点 (控制 Mute, Bypass)，更多自定义节点识别见 user_config.js 文件。
Advanced Features and Helper Nodes 高级功能与辅助节点
Smart-Previewer (Photoshop)
Combine multiple Preview Image nodes into a navigation strip. 将多个“预览图像”节点合并为一个导航条。
AnyPreview (ComfyUI / Photoshop)
Enabling you to monitor the AnyPreview nodes within a ComfyUI workflow directly from the PS interface. Supported types: Image, Mask, Audio, Text; includes list and batch support. 默认识别AnyPreview节点，用于PS侧观察ComfyUI工作流中的AnyPreview节点。预览类型：Image, Mask, Audio, Text。支持 list, batch。
Ecosystem: Helper Nodes 生态：辅助节点
AnyPreviewPause (ComfyUI / Photoshop): Logic Fuse逻辑熔断器
When the workflow reaches this node, it pauses and jumps back to PS. You can preview results, modify prompts, or click Cancel to terminate the task. Supported types: Image, Mask, Audio, Text; includes list and batch support. 当工作流运行到此节点时会暂时并弹回 PS。你可以在此处进行预览确认、修改 Prompt 指令或直接点击 Cancel 熔断任务。预览类型：Image, Mask, Audio, Text。支持 list, batch。
Mask Re-editingMask 再编辑
仅ComfyUIComfyUI Only: Edit masks during pause (Right-click > Open in MaskEditor).暂停状态二次编辑 mask（右键 > Open in MaskEditor）。
Text Re-editingText 再编辑
ComfyUI & Photoshop: Edit text during pause.暂停状态二次编辑文本。
Audio TrimAudio Trim
ComfyUI & Photoshop: Trim audio length during pause.暂停状态可修剪音频长度。
Advanced: Config File 进阶：配置文件
- User Config用户配置: For Local ComfyUI User Configuration and Node Filtering. 本地 ComfyUI 用户配置与节点过滤。
By modifying the config file, you can evolve ComfyPanel into your personal customized version: 通过修改配置文件，你可以让 ComfyPanel 进化为你的私人定制版：
- Prompt Templates提示词模板: Using/Configuring Custom Prompts.使用/配置自定义提示词。
By modifying the prompt templates, you can evolve ComfyPanel prompt into your personal customized version: 通过修改提示词模板，你可以让 ComfyPanel 提示词进化为你的私人定制版：
Advanced: Remote Access (Provider) 进阶：远程访问 (服务端)
The "Remote Access" feature allows you to connect your Photoshop plugin to a ComfyUI instance running on a different machine, or to use an encrypted HTTPS connection when local network policies prevent standard HTTP access. “远程访问”功能允许您将 Photoshop 插件连接到运行在不同机器上的 ComfyUI 实例，或者在本地网络政策阻止标准 HTTP 访问时，使用加密的 HTTPS 连接。
Scenario: Accessing home/studio GPU power while working remotely, or bypassing HTTPS restrictions in corporate networks. 场景：在外远程办公时调用家或工作室的算力，或在公司等受限网络环境下绕过 HTTPS 限制。
Official Relay Tunnel Beta 官方中转隧道 内测中
Uses ComfyPanel's official high-speed relay nodes to provide a stable, zero-config tunnel. No public IP or port forwarding required. 使用 ComfyPanel 官方高速中继节点，提供稳定、零配置的隧道。无需公网 IP 或端口转发。
Custom Relay (Frp) 自定义中继 (Frp)
Supports Frp-based custom servers. You can configure your own Server IP, Port, and Token to maintain full control over your private tunnel. 支持基于 Frp 的自定义服务器。您可以配置自己的服务器 IP、端口和 Token，以完全掌控您的私有隧道。
Status Indicator 状态指示
A status dot in the header bar indicates the tunnel health: Green (Connected), Orange (Connecting), or Red (Error). 顶部标题栏的状态圆点指示隧道健康状况：绿色（已连接）、橙色（连接中）、红色（错误）。
1. Computer 1 (Provider): Configure and enable Remote Access in Global Settings. 1. 电脑 1 (服务端)：在“全局设置”中配置并开启 **远程访问 (Remote Access)**。
2. Copy the generated HTTPS URL. 2. 复制生成的 HTTPS 网址。
3. Computer 2 (Client): Paste it into Engine > ComfyUI Server URL. 3. 电脑 2 (客户端)：将其粘贴到 **引擎 > ComfyUI服务器地址** 中。
You can also use this generated URL to access and use your home ComfyUI directly in any web browser on any internet-connected device (Laptop, Tablet, or Phone). 您还可以直接在任何可联网终端（笔记本、平板或手机）的浏览器中使用此生成的 URL，直接访问并使用家中的 ComfyUI。