629 lines
7.1 KiB
Markdown
629 lines
7.1 KiB
Markdown
# Node Explorer
|
|
|
|
# ComfyFlow Insight
|
|
|
|
Technical Documentation
|
|
|
|
---
|
|
|
|
# Overview
|
|
|
|
The Node Explorer is the workflow inventory and discovery system of ComfyFlow Insight.
|
|
|
|
Its purpose is to provide a centralized view of every node present within a ComfyUI workflow.
|
|
|
|
As workflows grow larger, manually locating specific nodes becomes increasingly difficult.
|
|
|
|
A workflow containing:
|
|
|
|
```text
|
|
100 Nodes
|
|
200 Nodes
|
|
300+ Nodes
|
|
```
|
|
|
|
can become difficult to inspect using the ComfyUI canvas alone.
|
|
|
|
Node Explorer solves this problem by presenting a structured inventory of workflow components.
|
|
|
|
---
|
|
|
|
# Why Node Explorer Exists
|
|
|
|
Most workflow tools focus on execution and outputs.
|
|
|
|
However, understanding what exists inside a workflow is equally important.
|
|
|
|
Users frequently need to answer questions such as:
|
|
|
|
```text
|
|
How many nodes exist?
|
|
|
|
What node types are being used?
|
|
|
|
Where is a specific node?
|
|
|
|
Which nodes belong to the workflow?
|
|
|
|
What does the workflow contain?
|
|
```
|
|
|
|
Node Explorer provides immediate answers.
|
|
|
|
---
|
|
|
|
# Objectives
|
|
|
|
The Node Explorer Engine performs the following tasks:
|
|
|
|
```text
|
|
Enumerate Workflow Nodes
|
|
|
|
Display Node IDs
|
|
|
|
Display Node Types
|
|
|
|
Provide Workflow Inventory
|
|
|
|
Support Workflow Navigation
|
|
|
|
Support Documentation
|
|
|
|
Support Analysis Engines
|
|
```
|
|
|
|
---
|
|
|
|
# Workflow Inventory
|
|
|
|
## Definition
|
|
|
|
Workflow Inventory is the complete list of nodes detected within a workflow.
|
|
|
|
---
|
|
|
|
## Example
|
|
|
|
Workflow:
|
|
|
|
```text
|
|
CheckpointLoader
|
|
|
|
KSampler
|
|
|
|
VAEDecode
|
|
|
|
SaveImage
|
|
|
|
PreviewImage
|
|
```
|
|
|
|
Node Explorer Output:
|
|
|
|
```text
|
|
Node Inventory
|
|
|
|
CheckpointLoader
|
|
|
|
KSampler
|
|
|
|
VAEDecode
|
|
|
|
SaveImage
|
|
|
|
PreviewImage
|
|
```
|
|
|
|
---
|
|
|
|
# Why Inventory Matters
|
|
|
|
Workflow inventory provides:
|
|
|
|
```text
|
|
Workflow Visibility
|
|
|
|
Workflow Auditing
|
|
|
|
Workflow Discovery
|
|
|
|
Engineering Documentation
|
|
```
|
|
|
|
Without inventory systems, large workflows become difficult to understand.
|
|
|
|
---
|
|
|
|
# Node Identification
|
|
|
|
Every workflow node can be identified using:
|
|
|
|
```text
|
|
Node ID
|
|
|
|
Node Type
|
|
```
|
|
|
|
---
|
|
|
|
# Node ID
|
|
|
|
## Definition
|
|
|
|
A Node ID uniquely identifies a node within the workflow.
|
|
|
|
---
|
|
|
|
## Example
|
|
|
|
```text
|
|
Node ID: 3
|
|
```
|
|
|
|
This identifier is used throughout ComfyFlow Insight.
|
|
|
|
---
|
|
|
|
## Usage
|
|
|
|
Node IDs are used by:
|
|
|
|
```text
|
|
Workflow Actions
|
|
|
|
Dependency Graph
|
|
|
|
Workflow Advisor
|
|
|
|
Health Analyzer
|
|
```
|
|
|
|
to reference workflow components.
|
|
|
|
---
|
|
|
|
# Node Type
|
|
|
|
## Definition
|
|
|
|
Node Type represents the category or functionality of a node.
|
|
|
|
---
|
|
|
|
## Examples
|
|
|
|
```text
|
|
CheckpointLoader
|
|
|
|
KSampler
|
|
|
|
VAEDecode
|
|
|
|
SaveImage
|
|
|
|
ControlNet
|
|
|
|
ImageScale
|
|
|
|
PreviewImage
|
|
```
|
|
|
|
---
|
|
|
|
# Why Node Types Matter
|
|
|
|
Node Types reveal:
|
|
|
|
```text
|
|
Workflow Purpose
|
|
|
|
Processing Stages
|
|
|
|
Workflow Composition
|
|
|
|
Technology Usage
|
|
```
|
|
|
|
---
|
|
|
|
# Workflow Composition Analysis
|
|
|
|
Node Explorer helps users understand workflow composition.
|
|
|
|
---
|
|
|
|
# Example
|
|
|
|
Workflow:
|
|
|
|
```text
|
|
CheckpointLoader
|
|
|
|
CLIPTextEncode
|
|
|
|
KSampler
|
|
|
|
VAEDecode
|
|
|
|
SaveImage
|
|
```
|
|
|
|
Interpretation:
|
|
|
|
```text
|
|
Image Generation Workflow
|
|
```
|
|
|
|
---
|
|
|
|
# Example
|
|
|
|
Workflow:
|
|
|
|
```text
|
|
LoadVideo
|
|
|
|
FrameExtractor
|
|
|
|
WANVideoSampler
|
|
|
|
VideoCombine
|
|
```
|
|
|
|
Interpretation:
|
|
|
|
```text
|
|
Video Generation Workflow
|
|
```
|
|
|
|
---
|
|
|
|
# Workflow Discovery
|
|
|
|
Large workflows often contain components users were not expecting.
|
|
|
|
Node Explorer helps discover:
|
|
|
|
```text
|
|
Unused Nodes
|
|
|
|
Experimental Nodes
|
|
|
|
Legacy Components
|
|
|
|
Utility Nodes
|
|
```
|
|
|
|
These discoveries can assist workflow reviews.
|
|
|
|
---
|
|
|
|
# Node Explorer Workflow
|
|
|
|
Recommended process:
|
|
|
|
```text
|
|
Load Workflow
|
|
↓
|
|
|
|
Open Node Explorer
|
|
↓
|
|
|
|
Review Node Inventory
|
|
↓
|
|
|
|
Review Architecture
|
|
↓
|
|
|
|
Review Dependencies
|
|
↓
|
|
|
|
Review Advisor
|
|
```
|
|
|
|
Node Explorer should generally be the first tab reviewed.
|
|
|
|
---
|
|
|
|
# Relationship With Workflow Actions
|
|
|
|
Node Explorer works closely with Workflow Actions.
|
|
|
|
---
|
|
|
|
# Node Explorer
|
|
|
|
Answers:
|
|
|
|
```text
|
|
What nodes exist?
|
|
```
|
|
|
|
---
|
|
|
|
# Workflow Actions
|
|
|
|
Answers:
|
|
|
|
```text
|
|
Where is the node?
|
|
```
|
|
|
|
Together they provide workflow discovery and navigation.
|
|
|
|
---
|
|
|
|
# Relationship With Dependency Graph
|
|
|
|
Dependency Graph uses Node Explorer data.
|
|
|
|
Example:
|
|
|
|
```text
|
|
Node ID: 3
|
|
|
|
Node Type: KSampler
|
|
```
|
|
|
|
Dependency Graph can then analyze:
|
|
|
|
```text
|
|
Dependencies
|
|
|
|
Dependents
|
|
|
|
Impact
|
|
```
|
|
|
|
for that node.
|
|
|
|
---
|
|
|
|
# Relationship With Health Analyzer
|
|
|
|
Health Analyzer uses Node Explorer inventory when identifying:
|
|
|
|
```text
|
|
Orphan Nodes
|
|
|
|
Dead-End Nodes
|
|
|
|
Disconnected Nodes
|
|
```
|
|
|
|
Node Explorer provides the underlying node dataset.
|
|
|
|
---
|
|
|
|
# Relationship With Workflow Advisor
|
|
|
|
Workflow Advisor uses node inventory information to generate recommendations.
|
|
|
|
Example:
|
|
|
|
```text
|
|
Unused Utility Nodes Detected
|
|
```
|
|
|
|
Advisor Recommendation:
|
|
|
|
```text
|
|
Review Node Usage
|
|
```
|
|
|
|
---
|
|
|
|
# Large Workflow Navigation
|
|
|
|
One of the primary use cases for Node Explorer is navigating large workflows.
|
|
|
|
---
|
|
|
|
# Example
|
|
|
|
Workflow Size:
|
|
|
|
```text
|
|
250 Nodes
|
|
```
|
|
|
|
Without Node Explorer:
|
|
|
|
```text
|
|
Manual Searching Required
|
|
```
|
|
|
|
With Node Explorer:
|
|
|
|
```text
|
|
Instant Node Visibility
|
|
```
|
|
|
|
This significantly improves workflow review speed.
|
|
|
|
---
|
|
|
|
# Engineering Benefits
|
|
|
|
Node Explorer provides:
|
|
|
|
```text
|
|
Workflow Inventory
|
|
|
|
Workflow Auditing
|
|
|
|
Workflow Discovery
|
|
|
|
Workflow Visibility
|
|
|
|
Documentation Support
|
|
|
|
Navigation Support
|
|
```
|
|
|
|
These benefits become increasingly valuable as workflow size increases.
|
|
|
|
---
|
|
|
|
# Common Use Cases
|
|
|
|
## Workflow Review
|
|
|
|
Before modifying a workflow:
|
|
|
|
```text
|
|
Review Node Inventory
|
|
```
|
|
|
|
to understand workflow composition.
|
|
|
|
---
|
|
|
|
## Workflow Documentation
|
|
|
|
Generate workflow documentation using:
|
|
|
|
```text
|
|
Node Types
|
|
|
|
Node Counts
|
|
|
|
Workflow Components
|
|
```
|
|
|
|
provided by Node Explorer.
|
|
|
|
---
|
|
|
|
## Workflow Auditing
|
|
|
|
Identify:
|
|
|
|
```text
|
|
Unused Components
|
|
|
|
Experimental Nodes
|
|
|
|
Unexpected Elements
|
|
```
|
|
|
|
during workflow reviews.
|
|
|
|
---
|
|
|
|
## Team Collaboration
|
|
|
|
Node Explorer helps team members quickly understand workflow structure.
|
|
|
|
---
|
|
|
|
# Example Analysis
|
|
|
|
Workflow:
|
|
|
|
```text
|
|
Nodes: 124
|
|
```
|
|
|
|
Node Explorer Output:
|
|
|
|
```text
|
|
CheckpointLoader
|
|
|
|
CLIPTextEncode
|
|
|
|
KSampler
|
|
|
|
VAEDecode
|
|
|
|
SaveImage
|
|
|
|
ControlNet
|
|
|
|
PreviewImage
|
|
|
|
Upscaler
|
|
```
|
|
|
|
Interpretation:
|
|
|
|
```text
|
|
Advanced Image Generation Workflow
|
|
|
|
Multiple Processing Stages
|
|
|
|
Output Pipeline Present
|
|
```
|
|
|
|
---
|
|
|
|
# Best Practices
|
|
|
|
## Review First
|
|
|
|
Node Explorer should typically be the first dashboard tab reviewed.
|
|
|
|
---
|
|
|
|
## Understand Workflow Composition
|
|
|
|
Before making modifications:
|
|
|
|
```text
|
|
Review Node Types
|
|
|
|
Review Node Count
|
|
|
|
Review Workflow Inventory
|
|
```
|
|
|
|
---
|
|
|
|
## Combine With Dependency Graph
|
|
|
|
Use Node Explorer and Dependency Graph together for maximum visibility.
|
|
|
|
---
|
|
|
|
## Combine With Workflow Actions
|
|
|
|
Use Node Explorer to discover nodes and Workflow Actions to locate them.
|
|
|
|
---
|
|
|
|
# Summary
|
|
|
|
The Node Explorer is the workflow inventory engine of ComfyFlow Insight.
|
|
|
|
It provides:
|
|
|
|
```text
|
|
Complete Node Inventory
|
|
|
|
Node Identification
|
|
|
|
Node Type Discovery
|
|
|
|
Workflow Visibility
|
|
|
|
Workflow Auditing
|
|
|
|
Navigation Support
|
|
|
|
Documentation Support
|
|
```
|
|
|
|
For large workflows, Node Explorer is often the fastest way to understand workflow composition before performing deeper analysis using Architecture Analyzer, Dependency Graph, Health Analyzer, and Workflow Advisor.
|
|
|
|
---
|
|
|
|
# Next Document
|
|
|
|
Continue with:
|
|
|
|
```text
|
|
docs/health-analyzer.md
|
|
```
|
|
|
|
This document explains workflow health scoring, orphan node detection, dead-end node detection, missing output detection, and workflow quality assessment.
|