FLSampler (Foveated Latent Sampler) (BSS)

FLSampler (BSS) — это высокотехнологичный пользовательский сэмплер для ComfyUI, вдохновленный принципами физиологии человеческого зрения (Foveated Vision / Фовеальное зрение). Он предназначен для получения кинематографичной четкости, прорисовки богатых микро-текстур и управления глубиной детализации в латентном пространстве без увеличения времени генерации.

Important

Автор и разработчик: blacksnowskill (BSS)
© 2026 blacksnowskill (BSS). Все права защищены.
Данный проект защищен авторским правом. Любое несанкционированное копирование, модификация без указания авторства или выдача данного кода за свой продукт строго запрещены.

Tip

Ультимативный бустер скорости и производительности:
Чтобы получить идеальный баланс между потрясающей детализацией и молниеносной генерацией, мы настоятельно рекомендуем использовать FLSampler (BSS) совместно с нашим основным пакетом оптимизации ANIMA_BOOSTER. Он обеспечивает колоссальное ускорение от 3.5× до 5.0× на моделях Anima DiT, пока FLSampler безупречно сохраняет и улучшает каждую высокочастотную деталь!

🔬 Физика и математика процесса

Стандартные сэмплеры (KSampler) применяют шум и очистку равномерно ко всему скрытому пространству (latent space), что часто приводит либо к замыливанию мелких текстур, либо к перегрузке изображения шумом и артефактами (пережженности).

FLSampler решает эту проблему за счет интеллектуального избирательного воздействия:

Дифференциальный анализ латента (Focus Detection): На каждом шаге очистки шума сэмплер вычисляет абсолютную разницу \Delta = |x_{0, t} - x_{0, t-1}| между текущим предсказанным чистым изображением x_0 и его состоянием на предыдущем шаге. Это позволяет с высокой точностью локализовать области, где в данный момент формируется геометрия (контуры лица, границы объектов, мелкие детали).
Адаптивная карта Fovea с инерцией (Momentum Mask): Разностная карта сглаживается с помощью пулинга (avg_pool2d), после чего для нее рассчитывается динамический порог на основе среднего значения и стандартного отклонения: Threshold = \mu + 0.5 \cdot \sigma Через сигмоидную активацию формируется мягкая маска фокуса зрения (Fovea Mask). Для предотвращения резких скачков маски между шагами применяется инерция (Momentum / mask_inertia), обеспечивающая плавное перетекание зон детализации.
Локальный контраст (Sharpness Boost): В зонах высокой активности Fovea применяется метод Unsharp Masking непосредственно в скрытом пространстве. Из оригинального тензора вычитается его размытая версия для получения карты высоких частот (High Frequencies), которая затем точечно усиливается. Это придает границам объектов невероятную четкость и кинематографичную глубину.
Стохастическое инжектирование текстуры (Texture Grain): В активные области фокуса на ранних и средних этапах генерации подмешивается контролируемый микро-шум, который на последующих шагах сэмплинга превращается в реалистичные высокочастотные текстуры (поры кожи, ткань одежды, текстура дерева, листья, шерсть), избегая пластикового "замыливания". На поздних шагах воздействие плавно затухает (decay), гарантируя чистоту финального кадра.

🎨 BSS Premium UI

В ноду интегрирована фирменная роскошная надстройка BSS Premium UI в едином стиле с пакетом ANIMA_BOOSTER:

Luxury Matte Theme: Глубокий ультра-темный матовый графитовый корпус (#0f0f0eff), сливающий разъемы в монолит.
Rich Gold Accents: Активные золотые слайдеры (#d4af37), золотые бегунки (#e5c158), золотые стрелочки выпадающих списков и золотистые скругленные рамки для числовых параметров.
Полная тишина: Бронебойное подавление назойливых всплывающих тултипов (tooltips) при настройке параметров и перетаскивании.
Брендинг: Изысканный золотой разделитель над виджетами и гравировка "BSS OPTIMIZED" на свободном месте снизу.

🎛️ Параметры и их влияние

Нода полностью заменяет стандартный KSampler и содержит как базовые, так и уникальные физические регуляторы:

Параметр	Диапазон	Рекомендуемое	Описание
fovea_strength	`0.0 – 10.0`	`3.0 – 8.0`	Сила текстуры: отвечает за микро-детализацию, пористость и проработку мелких текстур. При `0.0` инжекция шума отключена. По умолчанию: `3.0`.
sharpness	`0.0 – 3.0`	`0.3 – 1.0`	Локальный контраст: отвечает за очерченность границ и резкость контуров объектов. Предотвращает пережженность кадра в зонах фокуса. По умолчанию: `0.5`.
mask_inertia	`0.0 – 0.99`	`0.80 – 0.90`	Инерция маски: степень плавности перехода фокуса между шагами. Высокие значения (`>0.85`) делают детали более стабильными, низкие заставляют фокус реагировать мгновенно. По умолчанию: `0.85` (шаг `0.01`).
denoise	`0.0 – 1.0`	`1.0`	Сила денойзинга (классический параметр).
steps / cfg	-	-	Количество шагов и сила соответствия промпту.

📊 Выходы ноды

Нода имеет два выхода:

🖼️ latent: Оптимизированный латентный тензор для последующего декодирования через VAE Decode.
👁️ fovea_mask: Визуализированная в формате RGB (IMAGE) накопленная карта фокуса Fovea. Вы можете передать её в Save Image или Preview Image, чтобы увидеть, на каких именно областях концентрировался сэмплер в процессе генерации. Это беспрецедентный инструмент для отладки воркфлоу!

📋 Рекомендуемый воркфлоу (Workflow)

[ MODEL (например, Anima / SDXL) ] ──> [ positive ]
                                 ──> [ negative ]
                                          ↓
[ Latent Image (разрешение) ] ──────> [ latent_image ] ──> [ FLSampler (BSS) ] ──(latent)──> [ VAE Decode ] ──> [ Save Image ]
                                                                   └──(fovea_mask)──> [ Preview Image ]

📥 Установка

Откройте терминал в папке ComfyUI/custom_nodes/.

Склонируйте репозиторий:

git clone https://github.com/BlackSnowSkill/ComfyUI-BSS_FLSampler.git

Перезапустите ComfyUI и очистите кэш браузера (Ctrl + F5), чтобы применилась тема оформления BSS Premium UI.

9.9 KiB Raw Permalink Blame History Unescape Escape