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
24 changes: 24 additions & 0 deletions troubleshooting/custom-node-issues.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,30 @@ python main.py --disable-all-custom-nodes

We'll use **binary search** to quickly find which custom node is causing issues. This is much faster than testing nodes one by one.

### Option A: Using Comfy CLI (Recommended)

If you have [Comfy CLI](/comfy-cli/getting-started) installed, you can use the automated bisect tool to find the problematic node:

```bash
# Start a bisect session
comfy-cli node bisect start

# Follow the prompts:
# - Test ComfyUI with the current set of enabled nodes
# - Mark as 'good' if the issue is gone: comfy-cli node bisect good
# - Mark as 'bad' if the issue persists: comfy-cli node bisect bad
# - Repeat until the problematic node is identified

# Reset when done
comfy-cli node bisect reset
```

The bisect tool will automatically enable/disable nodes and guide you through the process.

### Option B: Manual Binary Search

If you prefer to do the process manually or don't have Comfy CLI installed, follow the steps below:

### How Binary Search Works

Instead of testing each node individually (which could take hours), we split the nodes in half repeatedly:
Expand Down
24 changes: 24 additions & 0 deletions zh-CN/troubleshooting/custom-node-issues.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,30 @@ python main.py --disable-all-custom-nodes

我们将使用**二分搜索**快速找到哪个自定义节点导致问题。这比逐个测试节点要快得多。

### 选项 A:使用 Comfy CLI(推荐)

如果你已安装 [Comfy CLI](/zh-CN/comfy-cli/getting-started),可以使用自动化的二分工具来找到有问题的节点:

```bash
# 开始二分会话
comfy-cli node bisect start

# 按照提示操作:
# - 使用当前启用的节点集测试 ComfyUI
# - 如果问题消失,标记为 'good':comfy-cli node bisect good
# - 如果问题仍然存在,标记为 'bad':comfy-cli node bisect bad
# - 重复直到识别出有问题的节点

# 完成后重置
comfy-cli node bisect reset
```

二分工具将自动启用/禁用节点并引导你完成整个过程。

### 选项 B:手动二分搜索

如果你更喜欢手动操作或没有安装 Comfy CLI,请按照以下步骤操作:

### 二分搜索的工作原理

我们不是逐个测试每个节点(可能需要几个小时),而是反复将节点分成两半:
Expand Down