Start bez spiny

Szybki start

1

Ustaw ujęcie w kontekście

Otwórz NL Workflow, wklej link taska albo shota z ShotGrid i kliknij populate. Jeśli rozdzielczość albo zakres klatek nie siada, popraw je od razu, potem Apply & Close. Od tej chwili graf wie, dla czego pracuje.

2

Wrzuć plate albo referencję

NL Read wciąga obrazy, sekwencje, wideo, maski i pliki z inputów. Ustaw źródłową przestrzeń koloru tak, jak trzeba, a podgląd puść przez view wybrany w workflow.

3

Sprawdź obraz i popraw drobiazgi

NL Preview daje spokojny, zarządzany podgląd. NL Edit przydaje się, gdy trzeba szybko domalować notkę, rough maskę albo małą poprawkę bez wychodzenia z ComfyUI.

4

Wypuść wynik

NL Write ogarnia wersjonowane EXR-y, opcjonalne podglądy PNG, movie i rendery porównawcze. Kontekst workflow pilnuje ścieżek i nazw, więc nie musisz robić tego ręcznie za każdym razem.

Najpierw ustawiamy scenę

Kontekst ujęcia

Panel NL Workflow trzyma aktualny kontekst shota dla całego grafu.

Zacznij tutaj. Wklejasz link taska albo shota z ShotGrid, klikasz populate, sprawdzasz format i zakres klatek, a potem Apply & Close. Ten kontekst to mała kotwica grafu: nody pomocnicze i IO wiedzą dzięki niemu, jaki projekt, shot i zakres mają obsłużyć.

  • Project, scene, shot/asset, task: produkcyjna tożsamość grafu, używana przez helpery, ledger i metadane outputów.
  • Width, height, FPS, start, end: format i timeline. Te liczby lepiej ustawić raz dobrze niż poprawiać potem po nodach.
  • Project path: root dla NL Write. Najwygodniej wskazać folder Comfy danego shota.
  • Color Management: projektowe OCIO, display, view i polityka inputów dla IO oraz podglądów.
  • Recent contexts: szybki powrót do ostatnich shotów albo assetów, kiedy dzień skacze między zadaniami.
Codzienna pętla

Read, Preview, Write

NL Read na wejściu, podgląd po drodze, NL Write na końcu. Klasyka.

Najczęstszy układ jest prosty: NL Read wpuszcza materiał do grafu, NL Preview pozwala go obejrzeć bez zgadywania, a NL Write wypuszcza wynik na dysk.

  • NL Read przyjmuje obrazy, sekwencje, wideo, maski i uploadowane inputy. Może samplować, przycinać, odwracać, skalować i pokazać preview, ale nie rusza tensora bez wyraźnej prośby.
  • NL Preview to node display/output do widoków color, mask, RGBA, A/B comparison i comparison reveal.
  • NL Write lubi EXR-y, ale potrafi też PNG preview, MP4/MOV z sekwencji, klatki porównawcze i sidecary z metadanymi.
Modele pod ręką

Open Models Management

Model Manager pokazuje, co masz lokalnie, co leży w sieci i co warto dociągnąć.

NL Model Manager jest od tego, żeby modele nie robiły dramatu. Widzisz, czego potrzebuje workflow, co już masz lokalnie, co jest na sieci i ile waży cache.

  • Workflow: modele używane przez aktualny graf. Dzięki temu lokalizujesz tylko to, co faktycznie jest potrzebne.
  • All Local: widok sprzątania lokalnego cache: prune, upload albo usuwanie zaznaczonych plików.
  • Log: ślad po akcjach localize, upload, delete i prune, gdy później trzeba sprawdzić, co się wydarzyło.

Najpierw prune

Auto-prune trzyma cache poniżej limitu i usuwa starsze lokalne pliki, które są też w sieci. Gdy dysk zaczyna marudzić, zacznij właśnie od tego.

Lokalizuj to, czego potrzebujesz

Localize kopiuje model z sieci do lokalnego cache. Workflow rusza szybciej, a Ty nie czekasz na każdy oddech sieci. Gdy brakuje tylko kilku plików, wybierz konkretne.

Uploaduj przydatne pliki

Upload wrzuca lokalny model na wspólną stronę, żeby reszta ekipy też mogła z niego korzystać. Najlepiej wtedy, gdy plik ma sensowną nazwę, jest sprawdzony i nie jest tylko jednorazowym eksperymentem.

Zamknięte modele bez strachu

API nodes

API node może siedzieć normalnie w grafie między NL Read i NL Write. Koszt jest widoczny, a użycie trafia do NL Cost Ledger.

Zamknięte modele przez API są po to, żeby ich używać. Jeśli dają lepszy wynik, szybszy wariant albo dobry kierunek artystyczny, nie omijaj ich tylko dlatego, że pojawia się koszt. To nie jest prywatny rachunek artysty; to narzędzie produkcyjne, a koszty są śledzone.

  • Konto firmowe: używaj konta ComfyUI NL i loguj się przez Google Sign-In, nie przez zwykłe logowanie mailem. Login i hasło są w bezpiecznym firmowym źródle, nie w tej dokumentacji.
  • Workflow-context: od API nodes oczekujemy pracy na ustawionym kontekście workflow. Dzięki temu producent dostaje poprawne dane: projekt, shot albo asset, task, użytkownika, model i koszt.
  • NL Cost Ledger: zapisuje użycie API i pozwala sprawdzić koszty według projektu, shota, użytkownika i modelu. To jest licznik produkcyjny, nie straszak.

Używaj, gdy pomaga

Closed models potrafią dać bardzo dobre obrazy, cleanup, warianty i szybkie odpowiedzi na pytanie “czy ten kierunek ma sens?”. Lepiej zrobić jedną mocną próbę niż długo kręcić się wokół słabszego rozwiązania.

Koszt miej z tyłu głowy

Normalne użycie API jest częścią pracy. Zatrzymaj się dopiero przy naprawdę ciężkich setupach, czyli kiedy przynajmniej trzy z tych warunków są spełnione: drogie modele, wysoka rozdzielczość, długi length, dużo wariantów albo długie serie testów.

W razie wątpliwości pytaj producenta

Jeśli nie masz pewności, czy koszty użycia API nodes nie są za duże dla danego zadania, zapytaj producenta. Lepiej szybko potwierdzić kierunek niż zgadywać.

Kolor i comp

Kolor i compositing

Narzędzia koloru NL są po to, żeby obraz wyglądał zrozumiale dla oka, a dane w grafie dalej były przewidywalne. Spokojny podgląd, spokojny tensor.

NL OCIO Convert i NL Linear To Log robią jawne transformacje wtedy, gdy graf naprawdę potrzebuje przekonwertowanych danych.
NL Merge i NL Shuffle dają compositingowy routing kanałów w duchu Nuke, bez zbędnego klikania dookoła.

Zarządzane podglądy

preview_colorspace wybiera sposób patrzenia na obraz. To jest podgląd, nie nowa prawda o danych, chyba że używasz jawnego noda transformacji.

Domyślne wejścia koloru

Jeśli zwykle pracujesz na materiałach Rec.709, ustaw NL Tools > Configuration > Color Defaults > PNG/JPG/Video Input na Output - Rec.709. Nowe źródła w NL Read z polityką Auto użyją tego ustawienia; ręcznie wybrany colorspace w nodzie nadal ma pierwszeństwo.

Jawne transformacje

NL OCIO Convert, NL Linear To Log i NL Log To Linear są od realnej konwersji danych, gdy graf ma dostać obraz w innej przestrzeni.

Praca na kanałach jak w Nuke

NL Merge i NL Shuffle dają znajome operacje A/B, maski, matte, routing kanałów i przekazywanie metadanych image-info.

Szybki paint i maska

Edycja

NL Edit to mały warsztat do szybkiego malowania i poprawek maski wewnątrz ComfyUI.

NL Edit jest na szybkie notatki compowe, rough maski, poprawki i ręcznie malowane guide data. Jeśli możesz, najpierw pobierz upstream input, potem otwórz edytor i zrób swoje.

  • Layer: wybierz, czy malujesz po RGB, czy po masce.
  • View: przełączaj combined, RGB i mask, żeby widzieć dokładnie to, co trzeba.
  • Tool: brush dodaje pociągnięcia, erase zdejmuje je z wybranej warstwy.
  • Export to NL Read: zamienia zapisany output edycji w nowe źródło do dalszej pracy.
Rzeczy pod ręką

Narzędzia z górnego paska

NL Tools otwiera główne panele NL i przydatne akcje prosto z górnego paska ComfyUI.
Configuration trzyma username, wielkość tekstu UI, domyślne ustawienia koloru i status dependency.
Model Manager mówi, co jest w sieci, co jest lokalnie i czego brakuje.
Templates to wspólna półka ze startowymi workflow i setupami do ponownego użycia.
Subgraphs wstawia gotowe blueprint blocks do aktywnego grafu.
Cost Ledger pilnuje kosztów API według projektu, shota albo assetu, użytkownika i modelu.
Co jest czym

Lista nodów

Poniżej masz krótką ściągę po zarejestrowanych NL Nodes. Nazwy inputów i outputów zostały sprawdzone względem object info załadowanego w ComfyUI, więc można się ich trzymać.

NOLABEL / IO

NL Read

NOLABEL/IO

Wczytuje obrazy, sekwencje, wideo, maski i uploadowane inputy. To zwykle pierwszy przystanek dla materiału w grafie.

Kontrolki artysty
source, frame sampling, range, mask mode, reverse, resize, input colorspace, preview colorspace.
Outputy
image, mask, inverted_mask, frame_count, resolved_path, image_info_json.

NL Write

NOLABEL/IO

Zapisuje finalne obrazy albo sekwencje, używając kontekstu workflow. Najczęściej ląduje na końcu grafu, tam gdzie robi się wynik.

Kontrolki artysty
single or sequence mode, base name, output colorspace, preview mode, save mode, frame range, MP4/MOV options.
Inputy
images, mask, comparison_images, image_info_json.

NL Image Info Debug

NOLABEL/IO

Wypisuje metadane obrazu z NL Read w ludzkiej formie. Przydaje się, gdy kolor albo dane źródła zaczynają wyglądać podejrzanie.

Input
image_info_json.
Outputy
source_path, detected_color_space, working_color_space, is_data, pretty_json.

NOLABEL / Workflow

NL Resolution

NOLABEL/Workflow

Zwraca width i height zapisane w NL Workflow. Dobre do generatorów, resize i wszystkich miejsc, gdzie format ma iść za shotem.

NL FPS

NOLABEL/Workflow

Zwraca workflow FPS jako float i integer. Przydaje się przy sekwencjach, wideo i nodach, które muszą czuć timing.

NL Frame Range

NOLABEL/Workflow

Zwraca start frame, end frame i frame count z aktywnego kontekstu workflow. Timeline bez zgadywania.

NL Project Path

NOLABEL/Workflow

Zwraca project path zapisany w panelu workflow. Użyj go, gdy własne nody mają trafić do folderu shota.

NL Workflow Color Context

NOLABEL/Workflow

Zwraca resolved OCIO config, working space, display, view, input policy i status JSON. Czyli całą kolorową metrykę workflow.

NL Context Debug

NOLABEL/Workflow

Zwraca cached workflow context JSON. Narzędzie do diagnozy, nie coś, co zwykle mieszka w finalnym grafie artysty.

NOLABEL / Color

NL Preview

NOLABEL/Color

Zarządzany viewer/output node dla obrazów, masek, RGBA, porównań i comparison reveal. W sam raz, gdy chcesz zobaczyć, co naprawdę masz na kablu.

Inputy
image, mask, comparison_images, image_info_json.
Outputy
image, mask, image_info_json.

NL OCIO Convert

NOLABEL/Color

Konwertuje tensory obrazu między jawnymi przestrzeniami koloru OCIO i aktualizuje image_info_json, żeby metadane nie zostały z tyłu.

NL Linear To Log

NOLABEL/Color

Konwertuje scene-linear image data do skonfigurowanej compositing log role.

NL Log To Linear

NOLABEL/Color

Konwertuje compositing log data z powrotem do skonfigurowanej scene-linear role.

NL Merge

NOLABEL/Color

Merge obrazu A/B inspirowany Nuke, z opcjonalnymi A/B matte, effect mask, canvas behavior, invert mask i mix. Klasyczne składanie, tylko bliżej ręki.

NL Shuffle

NOLABEL/Color

Składa kanały RGB i alpha/mask z A, B, black albo white w nowy obraz i maskę. Przydatne, gdy kanały trzeba ułożyć po swojemu.

Deprecated: NL To Model Space

NOLABEL/Color/Deprecated

Stary node konwersji do model-space, zachowany dla dawnych workflow. W nowych setupach spokojniej używać jawnych nodów OCIO/color.

Deprecated: NL From Model Space

NOLABEL/Color/Deprecated

Stara konwersja z przestrzeni outputu modelu. Zostawiaj ją tam, gdzie utrzymujesz starszy graf, który już na niej jedzie.

NOLABEL / Utilities

NL Constant Color

NOLABEL/Utilities

Tworzy jednolity obraz i maskę w rozdzielczości workflow albo custom. Dobry do matte, slate i testowych inputów, kiedy potrzebujesz czystej plamy koloru.

NL Match

NOLABEL/Utilities

Dopasowuje streamy A/B do wspólnej rozdzielczości, długości batcha i przestrzeni koloru. Używaj go przed merge, preview albo model pass, gdy źródła przychodzą z różnych miejsc.

NL Edit

NOLABEL/Utilities

Wbudowany node edytora paint i mask. Pobierz upstream inputy, namaluj poprawki RGB albo maski, zapisz i jedź dalej.

Video Model Utilities

NL WanVideo ImageToVideo Encode v2 (multi-ref)

WanVideoWrapper

Utility encoder obraz-do-wideo dla workflow WanVideo, z obsługą multi-reference frame placement, temporal masks, control embeds i tiled VAE.

NL LTXV Img To Video Inplace At Index

conditioning/video_models

Umieszcza obraz zakodowany przez LTXV w dowolnej klatce istniejącego video latent i zachowuje łańcuchowe noise masks.

Gdy coś nie gra

Rozwiązywanie problemów

Workflow działa bardzo wolno

Najpewniej modele nie są zlokalizowane. Otwórz NL Model Manager, przeskanuj workflow i dociągnij brakujące modele z sieci. Jeśli brakuje ich także na dysku sieciowym, pobierz pliki do właściwych ścieżek modeli lokalnie, a potem wrzuć je na wspólny dysk przez Upload All. Dobra karma dla całej ekipy.

API nodes nie działają albo proszą o logowanie

Najpierw sprawdź, czy logujesz się na konto ComfyUI NL przez Google Sign-In. Nie wybieraj zwykłego logowania mailem i hasłem, nawet jeśli formularz wygląda kusząco. Login i hasło są w bezpiecznym firmowym źródle. Jeśli przeglądarka podsuwa prywatne konto Google, przełącz konto albo wyloguj się z niego w tym oknie. Po zalogowaniu ustaw workflow-context i uruchom node jeszcze raz, żeby NL Cost Ledger dostał poprawne dane projektu, shota, użytkownika i kosztu.

Zapisy trafiają do nieoczekiwanego folderu

Sprawdź Project Path w NL Workflow i pole name w NL Write. To one prowadzą NL Write do wersjonowanych ścieżek outputu.

Kolor podglądu wygląda źle

Sprawdź color management w NL Workflow, input_colorspace w NL Read i preview_colorspace w Preview. Gdy coś dalej pachnie dziwnie, podepnij NL Image Info Debug i zobacz metadane.

Templates albo subgraphs są puste

Sprawdź shared paths w extra_model_paths.yaml. Templates potrzebują wspólnych template roots, a subgraphs biorą pierwszy dostępny shared subgraph key.

Pojawiają się ostrzeżenia username

Otwórz NL Tools > Configuration. Templates i Ledger potrzebują poprawnego username, żeby autorstwo i koszty trafiały pod właściwą osobę.