150 lines
2.0 KiB
Markdown
150 lines
2.0 KiB
Markdown
# Technical Deep Dive
|
|
|
|
## Overview
|
|
|
|
Workflow Guide Generator is a ComfyUI extension that analyzes workflow JSON and converts technical workflow structures into artist-friendly documentation.
|
|
|
|
The extension operates entirely locally within ComfyUI and does not execute workflow nodes during analysis.
|
|
|
|
---
|
|
|
|
# System Architecture
|
|
|
|
The project consists of two layers:
|
|
|
|
## Backend Analysis Layer
|
|
|
|
Responsible for:
|
|
|
|
* Workflow Analysis
|
|
* Workflow Classification
|
|
* Model Discovery
|
|
* Workflow Flow Generation
|
|
* Node Purpose Analysis
|
|
* Documentation Generation
|
|
|
|
Core Components:
|
|
|
|
* WorkflowAnalyzer
|
|
* WorkflowPurposeEngine
|
|
* WorkflowFlowEngine
|
|
* WorkflowInsightsEngine
|
|
* WorkflowDiagramEngine
|
|
* ModelDiscoveryEngine
|
|
* ModelParameterEngine
|
|
* ModelExplanationEngine
|
|
* NodePurposeEngine
|
|
|
|
---
|
|
|
|
## Frontend Presentation Layer
|
|
|
|
Responsible for:
|
|
|
|
* Workflow Guide Generation
|
|
* Documentation Rendering
|
|
* Dynamic Layout
|
|
* Artist Workflow Guide UI
|
|
|
|
Core Components:
|
|
|
|
* workflow_guide_node.js
|
|
* workflow_documentation_panel.js
|
|
|
|
---
|
|
|
|
# Analysis Pipeline
|
|
|
|
Workflow JSON
|
|
↓
|
|
Workflow Analyzer
|
|
↓
|
|
Workflow Type Detection
|
|
↓
|
|
Model Discovery
|
|
↓
|
|
Workflow Insights
|
|
↓
|
|
Workflow Flow Generation
|
|
↓
|
|
Node Purpose Analysis
|
|
↓
|
|
Documentation Assembly
|
|
↓
|
|
Artist Workflow Guide
|
|
|
|
---
|
|
|
|
# Workflow Classification
|
|
|
|
The analyzer uses node pattern detection.
|
|
|
|
Examples:
|
|
|
|
### Flux Workflow
|
|
|
|
Detected by:
|
|
|
|
* UNETLoader
|
|
* Flux-specific nodes
|
|
|
|
---
|
|
|
|
### ControlNet Workflow
|
|
|
|
Detected by:
|
|
|
|
* ControlNetLoader
|
|
* ApplyControlNet
|
|
|
|
---
|
|
|
|
### Inpainting Workflow
|
|
|
|
Detected by:
|
|
|
|
* Mask nodes
|
|
* Inpainting nodes
|
|
|
|
---
|
|
|
|
### Video Workflow
|
|
|
|
Detected by:
|
|
|
|
* VHS_LoadVideo
|
|
* Video processing nodes
|
|
|
|
---
|
|
|
|
### Video To EXR Workflow
|
|
|
|
Detected by:
|
|
|
|
* VHS_LoadVideo
|
|
* SaveEXRFrames
|
|
|
|
---
|
|
|
|
# Dynamic Documentation Panel
|
|
|
|
The panel automatically:
|
|
|
|
* Wraps text
|
|
* Calculates content height
|
|
* Resizes sections
|
|
* Adjusts overall node height
|
|
|
|
This ensures all generated content remains visible regardless of workflow size.
|
|
|
|
---
|
|
|
|
# Design Goals
|
|
|
|
* Artist Friendly
|
|
* Fast Analysis
|
|
* Minimal Configuration
|
|
* Workflow Agnostic
|
|
* Local Execution
|
|
* Easy Maintenance
|