diff --git a/docs.json b/docs.json index c8e8e0fc..11184c20 100644 --- a/docs.json +++ b/docs.json @@ -62,6 +62,8 @@ "pages": [ "interface/overview", "interface/maskeditor", + "interface/features/subgraph", + "interface/features/partial-execution", { "group": "ComfyUI Settings", "icon": "gear", @@ -609,6 +611,8 @@ "pages": [ "zh-CN/interface/overview", "zh-CN/interface/maskeditor", + "zh-CN/interface/features/subgraph", + "zh-CN/interface/features/partial-execution", { "group": "ComfyUI 设置", "icon": "gear", diff --git a/images/interface/features/partial-execution/partial-execution-icon.jpg b/images/interface/features/partial-execution/partial-execution-icon.jpg new file mode 100644 index 00000000..79a2d053 Binary files /dev/null and b/images/interface/features/partial-execution/partial-execution-icon.jpg differ diff --git a/images/interface/features/partial-execution/partial-execution-vs-run-workflow.jpg b/images/interface/features/partial-execution/partial-execution-vs-run-workflow.jpg new file mode 100644 index 00000000..4a55654e Binary files /dev/null and b/images/interface/features/partial-execution/partial-execution-vs-run-workflow.jpg differ diff --git a/images/interface/features/partial-execution/require.jpg b/images/interface/features/partial-execution/require.jpg new file mode 100644 index 00000000..56329a41 Binary files /dev/null and b/images/interface/features/partial-execution/require.jpg differ diff --git a/images/interface/features/partial-execution/requirement.jpg b/images/interface/features/partial-execution/requirement.jpg new file mode 100644 index 00000000..861c21d6 Binary files /dev/null and b/images/interface/features/partial-execution/requirement.jpg differ diff --git a/images/interface/features/subgraph/editing_subgraph.jpg b/images/interface/features/subgraph/editing_subgraph.jpg new file mode 100644 index 00000000..e467f61f Binary files /dev/null and b/images/interface/features/subgraph/editing_subgraph.jpg differ diff --git a/images/interface/features/subgraph/enter_subgraph-2.jpg b/images/interface/features/subgraph/enter_subgraph-2.jpg new file mode 100644 index 00000000..6241105d Binary files /dev/null and b/images/interface/features/subgraph/enter_subgraph-2.jpg differ diff --git a/images/interface/features/subgraph/enter_subgraph.jpg b/images/interface/features/subgraph/enter_subgraph.jpg new file mode 100644 index 00000000..3f69e2ee Binary files /dev/null and b/images/interface/features/subgraph/enter_subgraph.jpg differ diff --git a/images/interface/features/subgraph/subgraph.jpg b/images/interface/features/subgraph/subgraph.jpg new file mode 100644 index 00000000..9abd6564 Binary files /dev/null and b/images/interface/features/subgraph/subgraph.jpg differ diff --git a/images/interface/features/subgraph/subgraph_after_edited-2.jpg b/images/interface/features/subgraph/subgraph_after_edited-2.jpg new file mode 100644 index 00000000..dbb20c0a Binary files /dev/null and b/images/interface/features/subgraph/subgraph_after_edited-2.jpg differ diff --git a/images/interface/features/subgraph/subgraph_after_edited.jpg b/images/interface/features/subgraph/subgraph_after_edited.jpg new file mode 100644 index 00000000..f766ae4b Binary files /dev/null and b/images/interface/features/subgraph/subgraph_after_edited.jpg differ diff --git a/images/interface/features/subgraph/subgraph_icon.jpg b/images/interface/features/subgraph/subgraph_icon.jpg new file mode 100644 index 00000000..b4197dbb Binary files /dev/null and b/images/interface/features/subgraph/subgraph_icon.jpg differ diff --git a/images/interface/features/subgraph/subgraph_navigation.jpg b/images/interface/features/subgraph/subgraph_navigation.jpg new file mode 100644 index 00000000..21dda09e Binary files /dev/null and b/images/interface/features/subgraph/subgraph_navigation.jpg differ diff --git a/images/interface/features/subgraph/subgraph_nested.jpg b/images/interface/features/subgraph/subgraph_nested.jpg new file mode 100644 index 00000000..4bb99ecc Binary files /dev/null and b/images/interface/features/subgraph/subgraph_nested.jpg differ diff --git a/images/interface/features/subgraph/subgraph_slot.jpg b/images/interface/features/subgraph/subgraph_slot.jpg new file mode 100644 index 00000000..53bc4dfc Binary files /dev/null and b/images/interface/features/subgraph/subgraph_slot.jpg differ diff --git a/images/interface/features/subgraph/workflow_using_subgraph.jpg b/images/interface/features/subgraph/workflow_using_subgraph.jpg new file mode 100644 index 00000000..c0eb5409 Binary files /dev/null and b/images/interface/features/subgraph/workflow_using_subgraph.jpg differ diff --git a/interface/features/partial-execution.mdx b/interface/features/partial-execution.mdx new file mode 100644 index 00000000..c5c00da5 --- /dev/null +++ b/interface/features/partial-execution.mdx @@ -0,0 +1,34 @@ +--- +title: "Partial Execution - Run Only Part of Your workflow in ComfyUI" +description: "How to use and the requirements for the Partial Execution feature in ComfyUI" +sidebarTitle: "Partial Execution" +icon: "play" +--- + +![Partial Execution Feature](/images/interface/features/partial-execution/partial-execution-icon.jpg) + +The Partial Execution feature is located in the ComfyUI node selection toolbox. It allows you to run only a part of your workflow instead of executing all nodes. This feature is only available when the selected node is an output node, and when available, it appears as a green triangle icon. + +## What is Partial Execution? + +Partial Execution, as the name suggests, lets you run only a part of your workflow instead of executing all nodes in the workflow. + +![Partial Execution](/images/interface/features/partial-execution/partial-execution-vs-run-workflow.jpg) + +The diagram above compares Partial Execution and running the entire workflow: + +1. Partial Execution (left): Only runs the branch of the workflow from the starting node to the output node. +2. Run Workflow (right): Runs all nodes in the workflow. + +This feature allows you to flexibly execute specific parts of your workflow, rather than running the entire workflow every time. + +## How to Use the Partial Execution Feature? + +![Partial Execution Requirements](/images/interface/features/partial-execution/requirement.jpg) + +To use the Partial Execution feature, the currently selected node must be an output node, such as preview or save nodes. When the corresponding node meets the criteria, after selecting the node, the button in the toolbox will display as a green triangle icon. Click this icon to run the partial workflow. + +## Common Issues + +Q: Why do all nodes run when I use this feature? +A: Please ensure your ComfyUI frontend version is after v1.23.4, or possibly requires v1.24.x version. The corresponding bug was fixed around version 1.24.x, so please update your ComfyUI to the latest version to ensure the frontend version meets the requirements. \ No newline at end of file diff --git a/interface/features/subgraph.mdx b/interface/features/subgraph.mdx new file mode 100644 index 00000000..a53d48a3 --- /dev/null +++ b/interface/features/subgraph.mdx @@ -0,0 +1,85 @@ +--- +title: "Subgraph - Simplify your workflow" +description: "An introduction to the Subgraph feature in ComfyUI, including how to create, navigate, and manage subgraphs." +sidebarTitle: "Subgraph" +icon: "share-nodes" +--- + + + The subgraph feature requires ComfyUI frontend version 1.24.3 or later. If you don't see this feature, please refer to: [How to Update ComfyUI](/installation/update_comfyui) + - Images in this document are made with nightly version frontend, please refer to the actual interface + + +A subgraph is a powerful ComfyUI feature that lets you package complex workflows into a single reusable subgraph node, making them easier to manage and share. + +![Subgraph](/images/interface/features/subgraph/subgraph.jpg) + +Think of a subgraph as a "folder" for your workflow – you can group related nodes together and use the entire collection as one unified subgraph node. + +**Use subgraphs to:** +- Simplify complex workflows +- Reuse common node combinations +- Build more efficient workflows with modular components + +## Creating a Subgraph + + + + Select the nodes you want to group in ComfyUI + + + ![Subgraph icon](/images/interface/features/subgraph/subgraph_icon.jpg) + Find the subgraph icon in the toolbar + + + ![Workflow using subgraph](/images/interface/features/subgraph/workflow_using_subgraph.jpg) + ComfyUI automatically creates a subgraph based on your selected nodes' inputs and outputs + + + Refer to [Editing Subgraphs](#editing-subgraphs), you can edit and organize the subgraph to create a fully functional node + ![Workflow using subgraph](/images/interface/features/subgraph/subgraph_after_edited.jpg) + + + +## Working with Subgraphs + +### Basic Operations + +Subgraphs work just like regular nodes. You can: +- Change colors and names +- Use bypass to disable +- Apply all standard node operations + +### Editing Subgraphs + +**To enter edit mode:** +- Double-click the empty area inside the subgraph (not on widgets), or +- Click the subgraph edit button + +![Subgraph editing mode](/images/interface/features/subgraph/editing_subgraph.jpg) + +**In edit mode you'll see:** + +1. **Navigation bar**: Exit the current subgraph and return to the parent level +2. **Input slots**: Internal node inputs exposed to the outside + - Connect outputs to slots like normal nodes + - **Right-click** connection points to rename/delete exposed slots +3. **Output slots**: Outputs exposed to the outside (same functionality as input slots) + +![Subgraph slots](/images/interface/features/subgraph/subgraph_slot.jpg) + +**Working with slots:** +1. **Default slot** (labeled 1): Use this to add new input/output connections +2. **Right-click** existing slots to rename, delete, or disconnect from original nodes + +> Note: Slot connections follow standard data type validation rules + +### Nested Subgraphs + +Create even more complex workflows by nesting subgraphs within subgraphs. + +![Nested subgraph](/images/interface/features/subgraph/subgraph_nested.jpg) + +The navigation bar shows your current level and lets you easily move between nested subgraphs. + +![Nested subgraph navigation](/images/interface/features/subgraph/subgraph_navigation.jpg) \ No newline at end of file diff --git a/tutorials/video/wan/wan-ati.mdx b/tutorials/video/wan/wan-ati.mdx index b5a212c7..6606cc45 100644 --- a/tutorials/video/wan/wan-ati.mdx +++ b/tutorials/video/wan/wan-ati.mdx @@ -1,7 +1,7 @@ --- title: "Wan ATI ComfyUI Native Workflow Tutorial" description: "Using trajectory control for video generation." -sidebarTitle: "WAN ATI" +sidebarTitle: "WAN2l1 ATI" --- import UpdateReminder from '/snippets/tutorials/update-reminder.mdx' diff --git a/tutorials/video/wan/wan-video.mdx b/tutorials/video/wan/wan-video.mdx index 90e9124c..69461089 100644 --- a/tutorials/video/wan/wan-video.mdx +++ b/tutorials/video/wan/wan-video.mdx @@ -1,10 +1,9 @@ --- title: ComfyUI Wan2.1 Video Examples description: "This guide demonstrates how to generate videos with first and last frames using Wan2.1 Video in ComfyUI" -sidebarTitle: Wan Video +sidebarTitle: Wan2.1 --- -import UpdateReminder from "/snippets/tutorials/update-reminder.mdx"; Wan2.1 Video series is a video generation model open-sourced by Alibaba in February 2025 under the [Apache 2.0 license](https://github.com/Wan-Video/Wan2.1?tab=Apache-2.0-1-ov-file). It offers two versions: diff --git a/zh-CN/interface/features/partial-execution.mdx b/zh-CN/interface/features/partial-execution.mdx new file mode 100644 index 00000000..35595671 --- /dev/null +++ b/zh-CN/interface/features/partial-execution.mdx @@ -0,0 +1,34 @@ +--- +title: "部分执行 - 允许你只运行 ComfyUI 中的部分节点" +description: "ComfyUI 中部分执行(Partial Execution)功能的使用方法和条件" +sidebarTitle: "部分执行" +icon: "play" +--- + +![部分执行功能](/images/interface/features/partial-execution/partial-execution-icon.jpg) + +**部分执行** 功能是位于 ComfyUI 节点选择工具箱上的一个功能,它能够让你 **只运行工作流的一部分** ,而不是完整运行工作流中的所有节点,它仅在所选节点是一个 **输出节点** 时才可用,可用时会显示为绿色的三角形图标 + +## 什么是部分执行? + +部分执行(Partial Execution),就像它字面上的意思一样,只运行工作流的一部分,而不是完整运行工作流中的所有节点 + +![部分执行](/images/interface/features/partial-execution/partial-execution-vs-run-workflow.jpg) + +在上面的示意图中,是部分执行与运行工作流功能的对比 + +1. 部分执行(左侧):只运行从起始节点到输出节点分支的工作流 +2. 运行工作流(右侧):运行工作流中的所有节点 + +这个功能能够运行你更灵活地运行工作流的特定部分,而不是每次都运行整个工作流。 + +## 如何使用部分执行功能? + +![部分执行功能的使用条件](/images/interface/features/partial-execution/requirement.jpg) + +要使用部分执行功能,需要满足,当前选中的节点是一个输出节点,如保存或者预览节点,当对应的节点符合条件时,选中节点后选择工作箱上的按钮会显示为绿色三角形图标,点击该图标即可运行部分工作流 + +## 常见问题 + +Q: 为什么在使用这个功能的时候,所有节点都运行了? +A: 前确保你的 ComfyUI 前端版本是在 v1.23.4 版本之后,甚至可能需要 v1.24.x 的版本,对应的缺陷是在 1.24.x 左右版本的才修复,所以请更新你的 ComfyUI 到最新版本,确保前端版本符合要求 \ No newline at end of file diff --git a/zh-CN/interface/features/subgraph.mdx b/zh-CN/interface/features/subgraph.mdx new file mode 100644 index 00000000..a443af5a --- /dev/null +++ b/zh-CN/interface/features/subgraph.mdx @@ -0,0 +1,83 @@ +--- +title: "子图功能 - ComfyUI 中的工作流组织工具" +description: "讲解 ComfyUI 中子图(Subgraph)功能的使用方法,包括创建、导航和管理子图" +sidebarTitle: "子图功能" +icon: "share-nodes" +--- + + + 子图功能需要至少 ComfyUI 前端版本 1.24.3 版本的支持,如果你未在你的 ComfyUI 中发现此功能,请参考这篇文档进行更新: [如何更新ComfyUI](/zh-CN/installation/update_comfyui) + - 本文示例图片使用nightly 版本前端制作,界面请以实际为准 + + +子图是 ComfyUI 中的一个高级功能,它允许你将复杂的工作流打包成一个新的节点,使得它更易管理和复用。 + +![子图](/images/interface/features/subgraph/subgraph.jpg) + +简单来说,子图就像是工作流程中的"文件夹",你可以将相关的节点组织在一起像使用单个节点一样使用整个子图。 + +你可以使用子图达到: +- 简化复杂工作流 +- 轻松复用一些常见的节点组合 +- 创建可快速复用的节点组合来提高搭建工作流的效率 + + +## 如何创建子图? + + + + 在 ComfyUI 中选中任意节点 + + + ![子图icon](/images/interface/features/subgraph/subgraph_icon.jpg) + + + ![使用子图的工作流](/images/interface/features/subgraph/workflow_using_subgraph.jpg) + ComfyUI 会根据选中节点的输入输出,自动创建一个子图,并将其添加到画布中。 + + + ![使用子图的工作流](/images/interface/features/subgraph/subgraph_after_edited.jpg) + 经过编辑和整理,你可以将子图调整成一个具备完善功能的节点。 + + + +## 编辑子图 + +### 1. 子图有和普通节点一样的编辑功能 + +你可以像一般节点一样使用子图: +1. 修改外观节点颜色 +2. 修改节点名称 +3. 使用绕过(Bypass)来禁用 +4. 等等 + +### 2. 子图的编辑 + +- 在子图非组件(widget) 空白处双击以进入子图编辑状态, +- 点击子图编辑按钮 + +下面为进入子图的编辑状态 +![子图编辑状态](/images/interface/features/subgraph/editing_subgraph.jpg) + +1. 子图导航,你可以通过这里退出当前子图,并返回上级 +2. 输入插槽(slot): 会显示在子图外部的内部节点输入 + - 你可以像链接正常节点一样将输出连接到插槽中 + - 通过在连接点上**点击鼠标右键**,你可以重命名/删除 暴露在子图外部的插槽 +3. 输出插槽(slot): 暴露在子图外部的输出,和输入插槽功能类似 + +![子图插槽](/images/interface/features/subgraph/subgraph_slot.jpg) + +1. 图中数字为 1 的插槽为**默认插槽**: 用于新增 输出 / 输出 连接以暴露给上级的子图视图 +2. 在已有插槽上**点击鼠标右键**,可以重命名、删除、取消已原有的节点的连接 + +> 插槽连接同样遵循数据类型验证 + +### 3. 子图的嵌套 + +在子图中你可以进一步嵌套的子图,来创建更复杂的工作流 + +![子图嵌套](/images/interface/features/subgraph/subgraph_nested.jpg) + +同时在编辑嵌套的子图时也提供了多级的导航来方便你返回到上一级 + +![嵌套子图导航](/images/interface/features/subgraph/subgraph_navigation.jpg) \ No newline at end of file