Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@
"group": "Interface Guide",
"pages": [
"interface/overview",
"interface/nodes-2",
"interface/maskeditor",
"interface/features/template",
"interface/features/subgraph",
Expand Down Expand Up @@ -684,6 +685,7 @@
"group": "界面指南",
"pages": [
"zh-CN/interface/overview",
"zh-CN/interface/nodes-2",
"zh-CN/interface/maskeditor",
"zh-CN/interface/features/template",
"zh-CN/interface/features/subgraph",
Expand Down
Binary file added images/interface/nodes_2.0.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
67 changes: 67 additions & 0 deletions interface/nodes-2.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
title: "Nodes 2.0"
description: "Learn about Nodes 2.0, the new Vue-based node rendering system in ComfyUI that enables faster development and richer interactions."
sidebarTitle: "Nodes 2.0"
icon: "sparkles"
---

Nodes 2.0 is now available in the nightly version of ComfyUI. This update transitions the node system from LiteGraph.js Canvas rendering to a Vue-based architecture, unlocking faster iteration and richer interactions.

## Why this change?

The previous Canvas rendering system had become a development bottleneck. Even small UI changes often required deep modifications and could take days to implement. This slowed the ability to respond to community feedback and made node customization difficult for developers.

The new Vue-based system enables:

- **Faster feature development** - UI changes can be implemented more quickly
- **Richer interactions** - Dynamic widgets, expandable nodes, and better components
- **A more flexible foundation** - Better support for future tools and customization

## Current status and known issues

We're actively working on improvements and want to be transparent about current limitations:

| Area | Status |
|------|--------|
| **Performance** | Still optimizing toward Canvas-level performance. Certain scenarios may behave differently. |
| **Compatibility** | Some custom nodes may require updates to be fully supported. |
| **Edge cases** | At extreme zoom levels or within very large workflows, minor visual issues may appear. |

We're gathering feedback to prioritize improvements. The LiteGraph.js rendering system remains available, and you can toggle between systems at any time.

## How to try it

### Enable Nodes 2.0

1. Visit [cloud.comfy.org](https://cloud.comfy.org) or update to the nightly version (Desktop coming soon)
2. Click **Try it out** on the top banner when you launch ComfyUI

### What to test

Use Nodes 2.0 in your daily workflows and share feedback with us:

- **Basic interactions** - Dragging, resizing, selecting
- **Daily workflows** - Execution, parameters, custom nodes
- **Performance** - Especially with complex workflows

## How to provide feedback

Encountered issues or have suggestions for interaction improvements?

- **Support center** - [ComfyUI Help Center](https://support.comfy.org)
- **GitHub issues** - [Create an issue in ComfyUI_frontend](https://github.com/Comfy-Org/ComfyUI_frontend/issues)

<Tip>
Including reproduction steps, screenshots, and system info is extremely helpful when reporting issues.
</Tip>

## Switching back

If you encounter issues:

1. Click on the **ComfyUI logo** to open the menu
2. Toggle **Nodes 2.0** to switch back to the previous interface

![Nodes 2.0 toggle location in ComfyUI menu](/images/interface/nodes_2.0.jpg)

Your feedback helps us prioritize improvements. Enable Nodes 2.0 in settings and start exploring the new node design!
67 changes: 67 additions & 0 deletions zh-CN/interface/nodes-2.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
title: "Nodes 2.0"
description: "了解 Nodes 2.0,ComfyUI 中全新的基于 Vue 的节点渲染系统,实现更快的开发速度和更丰富的交互体验。"
sidebarTitle: "Nodes 2.0"
icon: "sparkles"
---

Nodes 2.0 现已在 ComfyUI 的 nightly 版本中提供。此更新将节点系统从 LiteGraph.js Canvas 渲染过渡到基于 Vue 的架构,实现更快的迭代和更丰富的交互。

## 为什么要做这个改变?

之前的 Canvas 渲染系统已成为开发瓶颈。即使是小的 UI 更改也常常需要深度修改,可能需要数天才能实现。这减慢了响应社区反馈的能力,也使开发者难以进行节点自定义。

新的基于 Vue 的系统带来:

- **更快的功能开发** - UI 更改可以更快地实现
- **更丰富的交互** - 动态小部件、可展开节点和更好的组件
- **更灵活的基础** - 更好地支持未来的工具和自定义

## 当前状态和已知问题

我们正在积极改进,并希望对当前的限制保持透明:

| 领域 | 状态 |
|------|------|
| **性能** | 仍在优化以达到 Canvas 级别的性能。某些场景可能表现不同。 |
| **兼容性** | 一些自定义节点可能需要更新才能完全支持。 |
| **边缘情况** | 在极端缩放级别或非常大的工作流中,可能会出现轻微的视觉问题。 |

我们正在收集反馈以确定改进优先级。LiteGraph.js 渲染系统仍然可用,你可以随时在两个系统之间切换。

## 如何试用

### 启用 Nodes 2.0

1. 访问 [cloud.comfy.org](https://cloud.comfy.org) 或更新到 nightly 版本(桌面版即将推出)
2. 启动 ComfyUI 时点击顶部横幅上的 **Try it out**

### 测试内容

在日常工作流中使用 Nodes 2.0 并与我们分享反馈:

- **基本交互** - 拖动、调整大小、选择
- **日常工作流** - 执行、参数、自定义节点
- **性能** - 特别是复杂工作流

## 如何提供反馈

遇到问题或有交互改进建议?

- **支持中心** - [ComfyUI 帮助中心](https://support.comfy.org)
- **GitHub Issues** - [在 ComfyUI_frontend 创建 issue](https://github.com/Comfy-Org/ComfyUI_frontend/issues)

<Tip>
报告问题时,包含复现步骤、截图和系统信息会非常有帮助。
</Tip>

## 切换回旧版

如果遇到问题:

1. 点击 **ComfyUI 图标** 打开菜单
2. 切换 **Nodes 2.0** 以返回之前的界面

![ComfyUI 菜单中 Nodes 2.0 切换位置](/images/interface/nodes_2.0.jpg)

你的反馈帮助我们确定改进优先级。在设置中启用 Nodes 2.0,开始探索新的节点设计!