AudionAudion
ENDERU

VapourWiki — справочник пресетов Audion VS Engine (RU)

USER_GUIDE_RU.md

VapourWiki — справочник пресетов Audion VS Engine (RU)

Содержание

Полный русский справочник по 28 пресетам в 4 палитрах. В начале — decision tree «какой пресет тянуть для конкретной задачи». Дальше — детальное описание каждого пресета: что делает, под какой материал, ключевые параметры, рекомендуемый энкодер.

Английский эквивалент — docstring внутри каждого .vpy файла в system_core/presets/<palette>/. Этот документ — русское дополнение для быстрой навигации.

Перед началом: доустановить движок

В раздачу не входят VapourSynth, его плагины и модели vs-mlrt — около семидесяти модулей, у каждого своя лицензия, почти три гигабайта вместе. Программа ставит их сама, с сайтов авторов.

Пока это не сделано, ни один пресет из описанных ниже не запустится.

Запустите builder_main.cmd и выберите по порядку: VAPOURSYNTH (10), VS PLUGINS (11), затем при карте NVIDIA RTX — VS-MLRT LEAN (14). Порядок важен: плагинам нужен уже установленный движок.

Decision tree — какой пресет под какую задачу

Читать сверху вниз: первый совпавший случай — ваш пресет.

Симптом материалаПресетПалитра
Чересстрочный legacy (DV, HDV, оцифровка VHS, broadcast TS)qtgmc_deinterlacerestoration
NTSC 29.97 fps с 3:2 pulldown (телекино, плёнка → видео)tivtc_ivtcrestoration
Шум от высокого ISO, ночная съёмка, сохранить деталиmvtools_mcdegrainrestoration
Радуга / dot crawl на VHS-rip / композитном захватеderainbow_decrossrestoration
Пережатый H.264/MPEG (YouTube-rip, WhatsApp, SD broadcast)deblock_h264_artefactsrestoration
Дымка / низкая чёткость / нужно «приподнять» картинкуdehaze_local_contrastrestoration
ML upscale 1080p → ~4K (резкие лица, fabric texture)vsmlrt_realesrgan_2xrestoration
ML интерполяция 24 → 60fps (плавнее Optical Flow)vsmlrt_rife_60fpsrestoration
ML denoise тяжёлого шума / high-ISO без потери текстурыdpir_denoiserestoration
Цифровой шум только в тенях ("ночная" цифровая съёмка)shadow_denoise_sota ⭐precision
Лёгкий равномерный шум, hardware-agnostic (без CUDA/OpenCL)mild_denoiseprecision
Только хроматический шум (грязный синий канал)chroma_cleanupprecision
Бандинг в градиентах (небо, стена)deband_safe или deband_fine_grainprecision
Хочу один пресет «всё сразу» под filmic-материалfilmic_rebuild ⭐precision
Подготовка к colour grading в DaVincipregrade_prepprecision
Чистый архивный мастер без зернаarchive_cleanprecision
Тонкий filmic look, безопасный defaultcinematicfilm_looks
Конкретный 35mm Kodak (250D / 500T / 50D)film_35mmfilm_looks
16mm органичный, поднятые тениfilm_16mmfilm_looks
Super 8, выцветшие 70-е, тяжёлое зерноsuper8film_looks
High contrast desaturated (Se7en, Saving Private Ryan)bleach_bypassfilm_looks
Large-format IMAX feel — минимум зерна, gate weaveimax_70mmfilm_looks
Hollywood cinemascope (горизонтальные blue lens flares + teal shadows)anamorphic_scopefilm_looks
VHS / CRT эстетикаvhs_crtretro
90s любительский camcordercamcorder_90sretro
1970s Polaroid SX-70 (candy-bloom, тёплая кремовость)polaroidretro

Pipeline-сценарии (несколько пресетов цепочкой через apply-profile-batch или ручной запуск):

СценарийШаги
Ночной timelapse → плёнкаshadow_denoise_sota → filmic_rebuild → cinematic
Архив VHS → отреставрированный мастерqtgmc_deinterlace → derainbow_decross → mvtools_mcdegrain → archive_clean
Старый YouTube-rip → пригодный для проектаdeblock_h264_artefacts → dehaze_local_contrast → pregrade_prep
Telecined NTSC DVD → 24p мастерtivtc_ivtc → archive_clean
Современный цифровой → плёночный лукmild_denoise → film_35mm

Палитра PRECISION — технический pipeline (8 пресетов)

Меню в порядке pipeline-логики: Stage 1 (denoise) → Stage 2 (deband) → Stage 3 (compositions).

Stage 1 — шумодав

mild_denoise — мягкий универсальный шумодав

DFTTest спектральный шумодав. Pure CPU, hardware-agnostic — работает одинаково на любом процессоре. Рекомендуется как первый выбор когда не известно про материал ничего конкретного: лёгкий шум, нужно немного почистить без риска.

shadow_denoise_sota ⭐ — флагман шумодава теней

BM3D с float32-конвейером + smooth luma-mask «только тени». Шум давится только в зонах ниже shadow_threshold, остальная картинка не трогается. Хрома плоскости денойзятся всегда (хроматический шум одинаково уродлив везде). Опциональный возврат микрозерна grain_back чтобы тени не выглядели «пластиковыми».

chroma_cleanup — очистка только хромы

DFTTest на planes=[1,2]. Luma не трогается. Применяется когда «грязный синий канал» (типичная проблема старых компактных камер, низкобитных AVCHD).

Stage 2 — дебанд

deband_safe — безопасный дебанд

neo_f3kdb с лёгкими настройками, без зерна. Убирает бандинг в градиентах (небо, стена, ночное освещение) без потери резкости.

deband_fine_grain — дебанд + восстановление тонкого зерна

Тот же neo_f3kdb + AddGrain. После дебанда добавляется лёгкое монотонное зерно — исключает «слишком чистую» картинку (характерное свойство дешёвой компрессии).

Stage 3 — композиции

filmic_rebuild ⭐ — флагман композиций

Полная цепочка: BM3D denoise → neo_f3kdb deband → 3-zone luma grain (тени / midtones / highlights). Зерно зональное — больше в тенях (как настоящая киноплёнка), меньше в highlights. Рекомендуется как «один пресет на всё» для filmic-материала.

archive_clean — нейтральный архивный мастер

DFTTest + neo_f3kdb. Без зерна. Цель — максимально чистая «плоская» картинка для архивирования. Не использовать если планируется грейдинг (он лучше работает на материале с зерном).

pregrade_prep — подготовка под DaVinci

Минимальное воздействие: только лёгкий DFTTest. Без дебанда, без зерна. Цель — отдать в Resolve самый чистый источник, чтобы колорист не работал поверх артефактов компрессии.

Палитра FILM_LOOKS — эмуляции киноплёнки (7 пресетов)

Каждый look использует общую библиотеку audion_lib (MTF-софтенинг, halation bloom, zone grain, gamma curve, black-lift, desaturation).

cinematic — универсальный subtle filmic

Безопасный default. Лёгкий MTF softening + halation + микрозерно. Не привязан к конкретной плёнке. Работает на любом современном digital-материале.

film_35mm — Kodak 35mm с stock-вариантами

Эмуляция реальных Kodak stocks: 250D (дневной баланс), 500T (вольфрам), 50D (мелкое зерно). Каждый stock имеет свою кривую гаммы, баланс, плотность зерна.

film_16mm — органичный, более зернистый

Поднятые тени (lifted blacks), более выраженное зерно, мягче 35mm. Подходит для «documentary» / arthouse эстетики.

super8 — самый сильный лук

Самое тяжёлое зерно, самая мягкая оптика, выцветшие 70-е. Для music video / стилизованных вставок.

imax_70mm — large-format IMAX feel ⭐

Противоположность Super 8: минимум зерна, максимум разрешения, очень мягкая halation на highlights, опциональный 1px gate weave (детерминированный, seed=42 → reproducible). Большой кадр настоящего 70mm IMAX → каждое серебряное зерно крошечное относительно картинки. Подходит для шотов, которые должны ощущаться «эпично», а не «плёночно».

anamorphic_scope ⭐ — Hollywood cinemascope

Сигнатура anamorphic-оптики: длинные горизонтальные blue lens flares только на highlights (ровно те «горизонтальные синие черты» через всё небо в фильмах Abrams / Nolan / Villeneuve, которые делаются Panavision / Hawk / ARRI Master Anamorphic). Плюс subtle teal-cool тени для классического blockbuster-эстетики.

В нашей реализации: highlight-mask (flare_thr) → горизонтальный low-pass blur длиной flare_len → blue tint (R 10% / G 55% / B 100%) → additive merge поверх оригинала. Затем shadow-masked teal shift (R −10% / G +5% / B +12%). Всё в 16-bit RGB чтобы streak'и не клипались.

bleach_bypass — high contrast desaturated

«Se7en» / «Saving Private Ryan» лук. Высокий контраст, серебряная серость, яркие highlights. Жёсткий стилистический выбор.

Палитра RETRO — аналоговый характер (3 пресета)

vhs_crt — VHS / CRT

Chroma bleed (горизонтальное растекание цвета), мягкая оптика, аналоговый шум. Эмуляция воспроизведения с VHS-кассеты на CRT-телевизоре.

camcorder_90s — любительский camcorder

Мягче VHS, лёгкая переэкспозиция, минимальный chroma bleed. Эстетика домашних видео 90-х.

polaroid ⭐ — 1970s Polaroid SX-70

Сильная candy-bloom на highlights, lifted blacks (никогда не идёт в чёрный, кремовое затухание), warm gamma push, mild desaturation, radial edge vignette. Распадается на 5 шагов — то что в NLE требует стэка из 5-6 эффектов вручную.

Палитра RESTORATION — суперпушки (10 пресетов, Phase 18.B + 18.B-ML)

То, чего нет или плохо реализовано в Adobe Premiere / DaVinci Resolve.

qtgmc_deinterlace — эталонный деинтерлейс

havsfunc.QTGMC (NNEDI3 + MVTools motion estimation). Реконструирует прогрессивные кадры из чересстрочного источника через neural network upscaling каждого поля + motion-compensated temporal smoothing. Лучше любого NLE out-of-the-box.

tivtc_ivtc — обратный telecine

TIVTC.TFM (field matching) + TIVTC.TDecimate (drop duplicate). Reference-quality 3:2 pulldown removal: NTSC 29.97i → 23.976p. Возвращает оригинальный плёночный 24p мастер из telecined источника.

mvtools_mcdegrain — motion-compensated denoise

MVTools motion estimation → MDeGrain temporal averaging вдоль motion vectors. Убирает шум БЕЗ потери детализации — то что Topaz Video Enhance AI и Neat Video делают внутри. DaVinci Temporal NR — coarse implementation того же; здесь reference-grade.

derainbow_decross — NTSC composite cleanup

MVTools-based motion-compensated chroma-only smoothing. Убирает rainbow / dot crawl / cross-color на материале с композитного захвата (VHS-rip, U-matic, BetaSP, S-Video → SDI). Luma не трогается.

deblock_h264_artefacts — спасение пережатого

havsfunc.Deblock_QED — edge-aware deblocker для H.264 / MPEG-2 / MPEG-4. Сглаживает 8x8 границы блоков, ringing вокруг edges, mosquito noise. Edge-aware — не трогает реальную детализацию.

dehaze_local_contrast — clarity без halos

Luma-only local contrast через high-pass + zone-weighted MaskedMerge. Zone-mask (parabolic, peak в midtones) предотвращает выгорание highlights и crushed shadows. Цвет не сдвигается (luma-only). 16-bit math.

Энкодеры — мои паттерны

(Audion default workflow по результатам обсуждения 2026-04-28)

Quality ladder (одинаковая 14 / 17 / 21 сетка для software, NVENC, QuickSync и AMF): 14 → 17 → 21, три различимые ступени без overlap.

ПрофильКогда использовать
h264_crf14 / h265_crf14 ⭐ defaultSemi-lossless архив, мастер для последующей работы. Default Audion с 2026-04-28.
h264_crf17 / h265_crf17«Почти невидимый lossy», финальный master
h264_crf21 / h265_crf21Web preview / proxy / превью
prores_lt ⭐Audion default ProRes — без keying, под grading и round-trip
prores_lt_mxf ⭐ProRes LT в MXF wrapper — для Adobe Premiere / Avid round-trip
prores_422Если нужно чуть больше bitrate чем LT
prores_422_mxfProRes 422 в MXF wrapper для Adobe / Avid handoff
prores_422hqТолько если планируется keying
prores_422hq_mxfHQ + MXF для broadcast / Avid finishing
dnxhr_lb / _sq / _hq / _hqxAvid-style DNxHR (LB low / SQ standard / HQ high / HQX 10-bit)
h264_nvenc_q14 / _q17 / _q21NVENC hardware-encode H.264 на NVIDIA. Снимает CPU-bottleneck с libx264 — VS-фильтрация не упирается в encode. CQ — аналог CRF. 8-bit yuv420p.
h265_nvenc_q14 / _q17 / _q21NVENC hardware-encode HEVC, 10-bit p010le. Идеально для full pipeline на NVIDIA: VS-фильтрация на CPU/CUDA + encode на NVENC = ноль CPU-затыка.
h264_qsv_q14 / _q17 / _q21Intel QuickSync H.264. Удобно для Intel iGPU batch/proxy, когда CPU нужен VapourSynth.
h265_qsv_q14 / _q17 / _q21Intel QuickSync HEVC, p010le для 10-bit output где поддерживается.
h264_amf_q14 / _q17 / _q21AMD AMF H.264 через CQP, та же визуальная ladder-сетка.
h265_amf_q14 / _q17 / _q21AMD AMF HEVC, p010le output; полезно на Radeon-хостах.

Правило: для любой не-final обработки → prores_lt / prores_lt_mxf или DNxHR, если принимающее приложение любит DNx. Для final delivery → h264_crf14 / h264_crf17 (software, лучшая плотность на бит) ИЛИ hardware ladder под текущий хост (nvenc, qsv, amf), когда важен wall-time.

Когда использовать hardware encode vs software

СценарийEncoder
Тяжёлый VS-pipeline (filmic_rebuild, mvtools_mcdegrain) на NVIDIANVENC — CPU освобождается под VS-фильтр, общий wall-time падает на 30-50%
Финальный delivery где важна максимальная плотность битlibx264/libx265 CRF — software encoder всё ещё чуть точнее на низких CRF
Intel iGPU / ноутбучный batchQuickSync — хороший throughput при низкой нагрузке на CPU
AMD/Radeon hostAMF — та же 14/17/21 CQP ladder, без CPU encode bottleneck
Большой батч на сотни файловNVENC / QSV / AMF — экономия времени накапливается
Нет рабочего hardware encoderТолько software (h264_crf* / h265_crf*)

NVENC требует: NVIDIA driver R525+. Качество: NVENC на Ada/Blackwell (RTX 40/50) сравнимо с libx264 medium на одинаковом CQ; на старых поколениях (Pascal/Turing) software CRF немного выигрывает в эффективности bitrate за то же качество, но NVENC всё равно быстрее в разы.

Установочные и сервисные скрипты — что когда запускать

Скриптов в install/ много, и не все очевидны. Этот раздел — карта «когда что зовёшь» с конкретными аргументами и примерами. Все скрипты идут парами .cmd (тонкий wrapper, резолвит portable PowerShell) + .ps1 (вся логика). Запускать обычно из builder_main.cmd (FZF-меню), но любой можно дёрнуть напрямую двойным кликом или из CLI.

Точка входа: builder_main.cmd

Главное меню сервисных операций. FZF-навигация (если есть system_core\fzf.exe), иначе CMD-fallback с буквенными хоткеями. Карта пунктов:

#ПунктЧто делаетСкрипт под капотом
[01]Build portable env CMD builderпервичная сборка runtime/Build_Portable_Env_Build.cmd
[02]Build portable env PSальтернативный билдер на PowerShellBuild_Portable_Env.ps1
[03]Install portable offlineоффлайн-установка из заранее скачанного wheelhouseinstall_portable_offline.cmd
[04]Verify portable envпроверка orchestrator-питонаverify_portable_env.cmd
[05]Update FZFобновить fzf.exe до latestlauncher-tools-update_fzf.cmd
[06..08]Licensesсбор / прюнинг / дедупликация лицензийsystem_core\license\Run-*.cmd
[09]Make release archiveрелизный zip с исключениями output/, logs/, ._runtime/, install/download/, приватного MEMORY.mdmake_release_archive.cmd
[04]PowerShellportable pwsh 7 → system_core\powershell\Install-Portable-PowerShell.cmd
[10]VapourSynthlatest VS stable + latest Python 3.12.x embed → system_core\vapoursynth\Install-Portable-VapourSynth.cmd
[11]VS pluginsvsrepo + 12 плагинов (включая bm3dcuda по умолчанию)Install-VS-Plugins.cmd
[12]FFmpegExact-stable Gyan по политике драйвера; BtbN rolling только opt-in → Tools\ffmpeg\bin\Install-Portable-FFmpeg.cmd
[13] ⭐VS-MLRT LEANfresh-download vs-mlrt TensorRT bundle, очистка plugins\vsmlrt, lean-trim под текущий SMInstall-VS-mlrt.cmd /LEAN
[14]VS-MLRT FULLfresh-download тот же install, но без trim — для USB-distributionInstall-VS-mlrt.cmd /FULL
[70]Clean install cacheочистка transient install downloads, staging dirs и bytecode caches с сохранением portable payloadsClean-Install-Cache.cmd
[90..99]Open / Projectпроводник по подпапкам / переход в project launcher—
[00]Exit——

Порядок «с нуля»: [01] -> [03] -> [04] -> [10] -> [11] -> [12] -> (опционально) [13] -> [70]. После всех install-шагов один раз runtime\python.exe system_core\doctor.py — должен быть весь зелёный.

install\Install-Portable-VapourSynth.{cmd,ps1} — latest VS stable + own Python 3.12.x

Резолвит latest stable VapourSynth и latest Python 3.12.x embed, очищает system_core\vapoursynth\, ставит подходящий VapourSynth wheel, прописывает portable.vs marker (чтобы vsrepo переходил в portable mode). После wheel install явно создаёт и печатает active plugin dir из vapoursynth.get_plugin_dir(); VS R74+ уже не ориентируется на legacy vs-plugins\. Использует Expand-7zArchive (через Ensure-7zip.ps1) — на больших архивах ~×3 быстрее Expand-Archive.

В конце вызывает Repair-PipShims.cmd — чинит shebang в Scripts\*.exe сразу после wheel install (свежая установка не требует ручного fix).

Флаги: /R <rev> (например /R R76 для пинования версии). /F принимается для совместимости; текущий installer и так refresh по умолчанию.

install\Install-VS-Plugins.{cmd,ps1} — 12 плагинов через vsrepo

Ставит:

Дополнительно ставит vsutil через pip (импортируется внутри havsfunc.py на module top-level — без него Restoration-пресеты падают с ModuleNotFoundError).

Update-safe: vsrepo update обновляет базу, installer очищает активный vapoursynth.get_plugin_dir() path с сохранением plugins\vsmlrt если он уже есть, затем vsrepo install заново ставит нужный список. Безопасно дёргать после обновления списка.

install\Install-Portable-FFmpeg.{cmd,ps1} — BtbN GPL latest, Gyan.dev fallback

По умолчанию устанавливает совместимую с драйвером exact-stable сборку Gyan. Rolling release-branch BtbN доступна только через явный opt-in. Кладёт ffmpeg.exe / ffprobe.exe / ffplay.exe в Tools\ffmpeg\bin\. Через Expand-7zArchive распаковывает быстро.

Флаги: /V <variant> (gpl default / lgpl / gpl-shared), /F (force).

install\Install-VS-mlrt.{cmd,ps1} — ML-стек (Phase 18.B-ML)

Только для тех кто хочет ML-пресеты (vsmlrt_realesrgan_2x, vsmlrt_rife_60fps, dpir_denoise). Ставит полный TensorRT bundle: VSTRT + VSORT + VSOV + VSNCNN + ONNX runtime + TensorRT runtime DLLs + полная коллекция ONNX-моделей. После распаковки Audion выносит OpenVINO/vsov из активной autoload-папки в system_core\vapoursynth\disabled_plugins\vsmlrt-openvino: TensorRT / TensorRT-RTX / ONNX Runtime остаются активны, а Windows Bad Image 0xc0e90002 от OpenVINO DLL не ломает запуск.

Working set после install: ~3.5 GB при /LEAN (по умолчанию), ~10 GB при /FULL. Каждый запуск fresh-download выбранных vs-mlrt assets и очищает только subtree plugins\vsmlrt перед копированием runtime DLLs, scripts и models. Распаковка через 7zr.exe (нужно для BCJ2-filtered streams в TRT runtime DLL — py7zr это не умеет).

Порядок Full-update: если запускался [10] VAPOURSYNTH или [11] VS PLUGINS, после них обязательно запускать [13] VS-MLRT LEAN заново перед Full all-presets smoke. ML-пресеты нельзя валидировать на старом MLRT-слое после обновления базового VS runtime/plugins.

Флаги:

После install — backend в ML-пресетах выбирается автоматически: TRT (если NVIDIA + corresponding TRT runtime) → ORT_DML (DirectML, любой DX12 GPU включая Intel Xe / AMF) → ORT_CPU. Cross-vendor устойчиво (через audion_lib.vsmlrt_backend_chain() — на не-NVIDIA даже не пытаемся компилировать TRT engine, экономим 30–120 секунд).

Гадость: Windows Defender блокирует неподписанный openvino_intel_npu_plugin.dll. Скрипт автоматом удаляет его после extract (для NVIDIA / DirectML setup'ов он не нужен).

install\Clean-Install-Cache.{cmd,ps1} — освобождение диска

Чистит transient install downloads (.7z, .zip, .tar.*, .msi, .exe), точные installer staging dirs и Python bytecode caches вне payload/user-data зон. Preserve-list внутри install\download\ (всегда сохраняется):

Когда нужен: после успешного [13] VS-MLRT LEAN или [14] VS-MLRT FULL (~3.5 GB compressed архивов), периодически после Install-Portable-* (свежий FFmpeg build / новый VS R75+).

Философия: storage > bandwidth. Re-download = ~1.5 минуты на гигабите, а 3.5 GB на диске сидят навсегда. Working set после lean+cleanup: ~3.5 GB вместо 10.

install\Repair-PipShims.{cmd,ps1} — починка Scripts\*.exe после переезда

Симптом: после переноса проекта на другую букву диска / другой путь / другую машину, vspipe.exe и другие Scripts\*.exe молча возвращают exit 1 без вывода. doctor.py показывает [FAIL] vspipe runs, при этом python.exe -c "import vapoursynth" работает.

Причина: pip вшивает абсолютный shebang #!"<полный путь к python.exe>" внутрь каждого Scripts\*.exe. После переезда этот путь больше не существует.

Что делать: запустить install\Repair-PipShims.cmd. Перезаписывает shebang во всех Scripts\*.exe на текущий system_core\vapoursynth\python.exe. Stub launcher'а и trailing-zip остаются нетронутыми.

Флаги:

В нормальной работе не нужен: system_core\engine\selfheal.py хукнут в начало main.py и doctor.py — на старте читает первые 16 KB vspipe.exe, парсит embedded shebang, при mismatch silently зовёт Repair-PipShims.cmd. Идемпотентно через AUDION_SELFHEAL_DONE=1. Manual repair нужен только если бьёшь vspipe мимо main.py/doctor.py (например прямым CLI бенч-скриптом, который не успел пройти self-heal).

install\Bench-CUDA.{cmd,ps1} — pure-pipeline CPU vs CUDA на BM3D

Что бенчит: два BM3D-тяжёлых пресета (shadow_denoise_sota и filmic_rebuild), каждый прогоняется дважды — на CPU и на CUDA. Pipeline vspipe → ffmpeg -f null (без энкодинга). Без энкодинга нужно чтобы libx264 не съел всё wall-time на быстром многоядернике и не спрятал CUDA-выигрыш.

Как использовать:

:: Drag-n-drop файла на Bench-CUDA.cmd:
:: или из CLI:
install\Bench-CUDA.cmd "C:\clips\test.mov"
install\Bench-CUDA.cmd "C:\clips\test.mov" 2.5    :: второй аргумент = sigma (default 2.5)

Вывод: 4 строки с таймингом + итоговая таблица CPU/CUDA + Δ %. На диск ничего не пишется.

Как читать:

install\Bench-AllPresets.{cmd,ps1} ⭐ — smoke по всем 28 пресетам

Walker по system_core\presets\<palette>\*.vpy. Каждый пресет прогоняется через vspipe -c y4m --end <Frames-1> | ffmpeg -f null — pure pipeline, без записи на диск. Smoke-цель: убедиться что (а) пресет парсится, (б) все плагин-namespace'ы резолвятся, (в) кадры доезжают до ffmpeg без exception.

Как использовать:

:: Drag-n-drop:
:: Или из CLI:
install\Bench-AllPresets.cmd "C:\clips\test.mp4"
install\Bench-AllPresets.cmd "C:\clips\test.mp4" 30 sweep auto

Текущие локальные references:

Аргументы:

  1. Путь к видео (обязательно)
  2. Frames per preset (default 30)
  3. Cuda mode: off / on / sweep (default off)
  1. ML backend: auto / trt / ort_dml / ort_cpu / sweep (default auto)

Сколько строк выходит:

В конце — Summary Total / PASS / FAIL, для -Cuda sweep — таблица CPU vs CUDA Δ % по Precision-пресетам, плюс JSON-отчёт в logs\bench_all_presets_<TS>.json.

Когда запускать:

Что в нём важного скрыто:

install\Ensure-7zip.ps1 — dot-source helper для 7-Zip

Не запускается напрямую — другие *.ps1 его dot-source'ят:

. "$PSScriptRoot\Ensure-7zip.ps1"
$exe = Ensure-7zr -ProjectRoot $ProjectRoot
Expand-7zArchive -Archive $zip -Destination $dst -ProjectRoot $ProjectRoot

Build env steps [01]/[02] явно ставят 7zr.exe (~1.5 MB, чистый 7z extractor с поддержкой BCJ2) и 7za.exe (~1.7 MB, универсальный — zip / 7z / tar / gz / bz2 / xz) в system_core\7zip\ до установки Python. Один раз скачался — путешествует с проектом.

Зачем нужен:

Сводная карта «когда что зовёшь»

СценарийСкрипты в порядке
Свежая установка с нуляbuilder_main → [01] → [10] → [11] → [12] → [13] → опц. [14] → [16] → doctor.py
Перенёс проект на другой диск / машинуdoctor.py (selfheal сам зовёт Repair-PipShims) — или вручную install\Repair-PipShims.cmd
Нужен/обновлён ML-стекbuilder_main → [13] VS-MLRT LEAN после [10] / [11] / [12], затем Bench-AllPresets с -MlBackend sweep
Хочу проверить что CUDA реально живойinstall\Bench-CUDA.cmd <video> — измеряет реальный wall-time delta
Хочу проверить что все 28 пресетов работают локально без NVIDIAsystem_core\powershell\pwsh.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File install\Bench-AllPresets.ps1 -ProjectRoot . -InputFile <video> -Frames 1 -Cuda off -MlBackend ort_cpu
RTX / TensorRT validationsystem_core\powershell\pwsh.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File install\Bench-AllPresets.ps1 -ProjectRoot . -InputFile <video> -Frames 1 -Cuda sweep -MlBackend auto
На диске стало мало местаbuilder_main → [16] CLEAN INSTALL CACHE — освобождает ~3.5 GB compressed архивов
Обновил NVIDIA driver / поменял GPUdoctor.py (live bm3dcuda smoke-test) → Bench-CUDA → Bench-AllPresets (TRT engine'ы пересоберутся при первом ML-пресете)
Добавил новый пресетBench-AllPresets для smoke + добавить запись в engine/presets.py + добавить пункт в launcher + обновить эту вики
Готовлю release archivebuilder_main → [09] Make release archive — output исключает output/, logs/, ._runtime/, install/download/, release/, API keys и приватный MEMORY.md; MEMORY.example.md остаётся публичным

Дополнительно — полная справка

AI / ML (Phase 18.B-ML) — vs-mlrt стек

Эти пресеты используют vs-mlrt (ONNX-инференс в VapourSynth). Backend выбирается автоматически: trt (TensorRT, NVIDIA, fastest) → ort_dml (DirectML, любой DX12 GPU включая Intel Xe / AMF) → ort_cpu (CPU fallback). Установка через builder_main.cmd → [13] VS-MLRT LEAN (~3.5 GB download, ~6 GB extracted).

vsmlrt_realesrgan_2x ⭐ — ML 2x upscale

Real-ESRGAN — де-факто референс ML video super-resolution. На 1080p input даёт ~3840×2160 с резкостью лиц и fabric texture, которая не достижима через Lanczos / Spline36 / Resolve SuperScale.

soft_hd_rebuild_2x — cleanup + ML-реконструкция мягкого HD

Для формально HD-материала, где реальная детализация ближе к 480-720p из-за мягкой оптики, binning, агрессивного OLPF, старых кодеков или поколений архивного копирования. Сначала чистит кадр, затем делает Real-ESRGAN 2x, затем аккуратно возвращает luma-detail.

vsmlrt_rife_60fps ⭐ — ML интерполяция кадров

RIFE 4.x — современная ML модель frame interpolation. Понимает контент (не только pixel motion) → корректно обрабатывает occlusion, прозрачные объекты, fades. Заметно плавнее Resolve Optical Flow на сложном движении.

dpir_denoise — ML denoise тяжёлого шума

DPIR — deep network для denoise, сохраняет текстуру кожи и ткани там где BM3D / DFTTest начинают smearить. Использовать когда BM3D «убивает» детализацию на high-ISO материале.

Last updated: 2026-05-27 (28 presets across 4 palettes, Soft HD Rebuild 2X в Restoration; локальный CPU/ORT smoke 28/28 PASS при Frames=1, Cuda=off, MlBackend=ort_cpu; RTX 5070 CUDA/auto smoke 36/36 PASS при Frames=1, Cuda=sweep, MlBackend=auto)

Все проекты