Two remaining noise sources fixed:
1. CFG amplification: the return value is uncond + cond_scale * u_sw * sigma,
so the noise-space correction is cond_scale * K per element. At cfg=12
with K=0.2, that's 2.4 — far too large. Fix: K_eff = K / cond_scale,
making the effective correction just K regardless of cfg scale.
2. Hard switching: even clamp(s/phi) creates sharp transitions at the
boundary. Replace with tanh(s/phi) for a fully smooth correction.
phi = std(s) normalizes the sliding surface to its natural scale.
Net effect: the noise-space correction is now bounded by K=0.2 per element
regardless of cfg scale, and varies smoothly across spatial positions.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The hard sign(s) creates a random +/-1 pattern in regions where the
guidance error is near zero. When amplified by cond_scale (e.g. 12),
this produces severe high-frequency noise artifacts, especially on
SDXL which has smaller guidance magnitudes than SD3/FLUX.
Replace sign(s) with sat(s/phi) — the standard boundary layer approach
in practical sliding mode control. phi adapts to the guidance error
std so the switching threshold is meaningful across different models.
- |s| >> phi: correction = +/-K (same as paper)
- |s| << phi: correction = K*s/phi (smooth, proportional)
- Near-zero guidance regions get near-zero correction (no noise)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The previous fix (denoised space) still had the problem: K * cond_scale
produced a constant ±2.4 perturbation per element at cfg=12, destroying
the image at every step.
The paper's K=0.2 is calibrated for unit-variance noise predictions.
ComfyUI's cond/uncond are sigma-scaled (x - denoised ≈ sigma * epsilon).
Now we divide by sigma to recover epsilon-space, apply SMC there, then
multiply back by sigma. This gives natural dampening at late steps:
- sigma=14 (early): correction ±33 in latent space (image is noise anyway)
- sigma=0.01 (late): correction ±0.024 in latent space (negligible)
This matches the paper's behavior where the scheduler conversion
inherently dampens the noise-space correction at low sigma values.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
ComfyUI's args["cond"]/["uncond"] are (x - denoised), which are
sigma-scaled. At late denoising steps (sigma~0.01), the fixed K=0.2
correction was 200x the signal magnitude, destroying the image.
Fix: compute SMC in denoised space using args["cond_denoised"] and
args["uncond_denoised"], which have consistent magnitude across all
sigma values — matching the paper's noise-prediction space.
Also fixes first-step behavior to match the original paper (SMC
correction applied from step 0, not step 1).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Includes algorithm comparison, node wiring, and parameter guide
diagrams. SVGs use <picture> tags for GitHub compatibility.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implements the Sliding Mode Control CFG algorithm from the paper
"CFG-Ctrl: A Control-Theoretic Perspective on Classifier-Free Guidance" (CVPR 2026)
as a ComfyUI model patch node.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
