File size: 4,261 Bytes
695fbf0 8e7e41a 695fbf0 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 |
# CADE 2.5 (ComfyAdaptiveDetailEnhancer25)
CADE 2.5 is a refined adaptive enhancer with a single clean iteration loop, optional reference‑driven polishing, and flexible sampler scheduling. It can run standalone or as part of multi‑step pipelines (e.g., with ControlFusion masks in between passes).
This document describes the Hard variant — the full‑surface node that exposes advanced controls. For a minimal, preset‑driven experience, use the Easy variant or the `MG_SuperSimple` orchestrator.
## Overview
- Iterative latent refinement with configurable steps/CFG/denoise
- Optional guidance override (Rescale/CFGZero‑style, FDG/NAG ideas, epsilon scaling)
- Hybrid schedule path (`MGHybrid`) that builds ZeSmart‑style sigma stacks
- Local spatial guidance via CLIPSeg prompts
- Reference polishing with CLIP‑Vision (preserves low‑frequency structure)
- Optional upscaling mid‑run, detail stabilization, and gentle sharpening
- Determinism helpers: CLIPSeg pinned to CPU, mask state cleared per run
## Inputs
- `model` (MODEL)
- `positive` (CONDITIONING), `negative` (CONDITIONING)
- `vae` (VAE)
- `latent` (LATENT)
- `reference_image` (IMAGE, optional)
- `clip_vision` (CLIP_VISION, optional)
## Outputs
- `LATENT`: refined latent
- `IMAGE`: decoded image after the last internal iteration
- `mask_preview` (IMAGE): last fused mask preview (RGB 0..1)
- Internal values like effective `steps/cfg/denoise` are tracked across the loop (the Easy wrapper surfaces them if needed).
## Core Controls (essentials)
- `seed` (with control_after_generate)
- `steps`, `cfg`, `denoise`
- `sampler_name` (e.g., `ddim`)
- `scheduler` (`MGHybrid` recommended for smooth tails)
Typical starting points
- General: steps≈25, cfg≈7.0, denoise≈0.7, sampler=`euler_ancestral`, scheduler=`MGHybrid`
- As the first pass of a multi‑step pipeline: denoise=1.0 (full rewrite pass)
## MGHybrid schedule
When `scheduler = MGHybrid`, CADE builds a hybrid sigma schedule compatible with the internal KSampler path. It follows ZeSmart principles (hybrid mix and smooth tail), then calls a custom sampler entry — falling back to `nodes.common_ksampler` if anything goes wrong. The behavior remains deterministic under fixed `seed/steps/cfg/denoise`.
## Local guidance (CLIPSeg)
- CLIPSeg prompts (comma‑separated) produce a soft mask that can attenuate denoise/CFG.
- CLIPSeg inference is pinned to CPU by default for reproducibility.
## Reference polish (CLIP‑Vision)
Provide `reference_image` and `clip_vision` to preserve global form while refining details. CADE encodes the current and reference images and reduces denoise/CFG when they diverge; in polish mode it also mixes low frequencies from the reference using a blur‑based split.
## Advanced features (high‑level)
- Guidance override wrapper (rescale curves, momentum, perpendicular dampers)
- FDG/ZeRes‑inspired options with adaptive thresholds
- Mid‑run upscale support via `MagicUpscaleModule` with post‑adjusted CFG/denoise
- Post passes: `IntelligentDetailStabilizer`, optional mild sharpen
## Related
- QSilk (micrograin stabilizer + AQClip): a lightweight latent‑space regularizer that suppresses rare activation tails while preserving micro‑texture. Works plug‑and‑play inside CADE 2.5 and synergizes with ZeResFDG by allowing slightly higher effective CFG without speckle.
## Tips
- Keep `vae` consistent across passes; CADE re‑encodes when scale changes.
- For multi‑step flows (e.g., with ControlFusion), feed the current decoded `IMAGE` into CF, update `positive/negative`, then run CADE again with the latest `LATENT`.
- If you rely on presets, consider the Easy wrapper or `MG_SuperSimple` to avoid UI/preset drift.
## Quickstart (Hard)
1) Connect `MODEL / VAE / CONDITIONING / LATENT`.
2) Set `seed`, `steps≈25`, `cfg≈7.0`, `denoise≈0.7`, `sampler=euler_ancestral`, `scheduler=MGHybrid`.
3) (Optional) Add `reference_image` and `clip_vision`, and a CLIPSeg prompt.
4) Run and fine‑tune denoise/CFG first; only then adjust sampler/schedule.
Notes
- The node clears internal masks and patches at the end of a run even on errors.
- Some experimental toggles are intentionally conservative in default configs to avoid destabilizing results.
|