Skip to content

Commit cb0610e

Browse files
Add Nodes 2.0 documentation for English and Chinese (#610)
* Update interface/nodes-2.mdx * Update zh-CN/interface/nodes-2.mdx * Update docs.json * Update docs.json * Add image * Update interface/nodes-2.mdx * Update zh-CN/interface/nodes-2.mdx * Update interface/nodes-2.mdx * Update zh-CN/interface/nodes-2.mdx --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: ComfyUI Wiki <[email protected]>
1 parent 920d4ef commit cb0610e

File tree

4 files changed

+136
-0
lines changed

4 files changed

+136
-0
lines changed

docs.json

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,7 @@
6262
"group": "Interface Guide",
6363
"pages": [
6464
"interface/overview",
65+
"interface/nodes-2",
6566
"interface/maskeditor",
6667
"interface/features/template",
6768
"interface/features/subgraph",
@@ -684,6 +685,7 @@
684685
"group": "界面指南",
685686
"pages": [
686687
"zh-CN/interface/overview",
688+
"zh-CN/interface/nodes-2",
687689
"zh-CN/interface/maskeditor",
688690
"zh-CN/interface/features/template",
689691
"zh-CN/interface/features/subgraph",

images/interface/nodes_2.0.jpg

126 KB
Loading

interface/nodes-2.mdx

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: "Nodes 2.0"
3+
description: "Learn about Nodes 2.0, the new Vue-based node rendering system in ComfyUI that enables faster development and richer interactions."
4+
sidebarTitle: "Nodes 2.0"
5+
icon: "sparkles"
6+
---
7+
8+
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.
9+
10+
## Why this change?
11+
12+
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.
13+
14+
The new Vue-based system enables:
15+
16+
- **Faster feature development** - UI changes can be implemented more quickly
17+
- **Richer interactions** - Dynamic widgets, expandable nodes, and better components
18+
- **A more flexible foundation** - Better support for future tools and customization
19+
20+
## Current status and known issues
21+
22+
We're actively working on improvements and want to be transparent about current limitations:
23+
24+
| Area | Status |
25+
|------|--------|
26+
| **Performance** | Still optimizing toward Canvas-level performance. Certain scenarios may behave differently. |
27+
| **Compatibility** | Some custom nodes may require updates to be fully supported. |
28+
| **Edge cases** | At extreme zoom levels or within very large workflows, minor visual issues may appear. |
29+
30+
We're gathering feedback to prioritize improvements. The LiteGraph.js rendering system remains available, and you can toggle between systems at any time.
31+
32+
## How to try it
33+
34+
### Enable Nodes 2.0
35+
36+
1. Visit [cloud.comfy.org](https://cloud.comfy.org) or update to the nightly version (Desktop coming soon)
37+
2. Click **Try it out** on the top banner when you launch ComfyUI
38+
39+
### What to test
40+
41+
Use Nodes 2.0 in your daily workflows and share feedback with us:
42+
43+
- **Basic interactions** - Dragging, resizing, selecting
44+
- **Daily workflows** - Execution, parameters, custom nodes
45+
- **Performance** - Especially with complex workflows
46+
47+
## How to provide feedback
48+
49+
Encountered issues or have suggestions for interaction improvements?
50+
51+
- **Support center** - [ComfyUI Help Center](https://support.comfy.org)
52+
- **GitHub issues** - [Create an issue in ComfyUI_frontend](https://github.com/Comfy-Org/ComfyUI_frontend/issues)
53+
54+
<Tip>
55+
Including reproduction steps, screenshots, and system info is extremely helpful when reporting issues.
56+
</Tip>
57+
58+
## Switching back
59+
60+
If you encounter issues:
61+
62+
1. Click on the **ComfyUI logo** to open the menu
63+
2. Toggle **Nodes 2.0** to switch back to the previous interface
64+
65+
![Nodes 2.0 toggle location in ComfyUI menu](/images/interface/nodes_2.0.jpg)
66+
67+
Your feedback helps us prioritize improvements. Enable Nodes 2.0 in settings and start exploring the new node design!

zh-CN/interface/nodes-2.mdx

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: "Nodes 2.0"
3+
description: "了解 Nodes 2.0,ComfyUI 中全新的基于 Vue 的节点渲染系统,实现更快的开发速度和更丰富的交互体验。"
4+
sidebarTitle: "Nodes 2.0"
5+
icon: "sparkles"
6+
---
7+
8+
Nodes 2.0 现已在 ComfyUI 的 nightly 版本中提供。此更新将节点系统从 LiteGraph.js Canvas 渲染过渡到基于 Vue 的架构,实现更快的迭代和更丰富的交互。
9+
10+
## 为什么要做这个改变?
11+
12+
之前的 Canvas 渲染系统已成为开发瓶颈。即使是小的 UI 更改也常常需要深度修改,可能需要数天才能实现。这减慢了响应社区反馈的能力,也使开发者难以进行节点自定义。
13+
14+
新的基于 Vue 的系统带来:
15+
16+
- **更快的功能开发** - UI 更改可以更快地实现
17+
- **更丰富的交互** - 动态小部件、可展开节点和更好的组件
18+
- **更灵活的基础** - 更好地支持未来的工具和自定义
19+
20+
## 当前状态和已知问题
21+
22+
我们正在积极改进,并希望对当前的限制保持透明:
23+
24+
| 领域 | 状态 |
25+
|------|------|
26+
| **性能** | 仍在优化以达到 Canvas 级别的性能。某些场景可能表现不同。 |
27+
| **兼容性** | 一些自定义节点可能需要更新才能完全支持。 |
28+
| **边缘情况** | 在极端缩放级别或非常大的工作流中,可能会出现轻微的视觉问题。 |
29+
30+
我们正在收集反馈以确定改进优先级。LiteGraph.js 渲染系统仍然可用,你可以随时在两个系统之间切换。
31+
32+
## 如何试用
33+
34+
### 启用 Nodes 2.0
35+
36+
1. 访问 [cloud.comfy.org](https://cloud.comfy.org) 或更新到 nightly 版本(桌面版即将推出)
37+
2. 启动 ComfyUI 时点击顶部横幅上的 **Try it out**
38+
39+
### 测试内容
40+
41+
在日常工作流中使用 Nodes 2.0 并与我们分享反馈:
42+
43+
- **基本交互** - 拖动、调整大小、选择
44+
- **日常工作流** - 执行、参数、自定义节点
45+
- **性能** - 特别是复杂工作流
46+
47+
## 如何提供反馈
48+
49+
遇到问题或有交互改进建议?
50+
51+
- **支持中心** - [ComfyUI 帮助中心](https://support.comfy.org)
52+
- **GitHub Issues** - [在 ComfyUI_frontend 创建 issue](https://github.com/Comfy-Org/ComfyUI_frontend/issues)
53+
54+
<Tip>
55+
报告问题时,包含复现步骤、截图和系统信息会非常有帮助。
56+
</Tip>
57+
58+
## 切换回旧版
59+
60+
如果遇到问题:
61+
62+
1. 点击 **ComfyUI 图标** 打开菜单
63+
2. 切换 **Nodes 2.0** 以返回之前的界面
64+
65+
![ComfyUI 菜单中 Nodes 2.0 切换位置](/images/interface/nodes_2.0.jpg)
66+
67+
你的反馈帮助我们确定改进优先级。在设置中启用 Nodes 2.0,开始探索新的节点设计!

0 commit comments

Comments
 (0)