# Instrukcja bazy NERO AI Atlas

## Jak czytać plakietki

Każdy wpis ma tablicę `capabilities` w `dist/models.json`. Przypisuj wszystkie potwierdzone cechy, nie tylko główną kategorię. Kamera i zdjęcie obok siebie oznaczają pracę z wideo oraz obrazem; sam opis wyjaśnia, czy jest to generowanie, montaż, analiza czy obraz wejściowy.

| Kod | Plakietka | Zastosowanie |
| --- | --- | --- |
| video | Kamera / Wideo | Generowanie, obróbka lub analiza filmów |
| image | Zdjęcie / Obrazy | Zdjęcia, obrazy i klatki wejściowe |
| music | Nuta / Muzyka | Generowanie, miks i separacja muzyki |
| audio | Fala / Dźwięk i głos | Głos, nagrywanie i obróbka dźwięku |
| editing | Nożyczki / Montaż i edycja | Cięcie, retusz, zmiana istniejącego materiału |
| graphics | Stalówka / Grafika i 3D | Ilustracje, grafika i zasoby 3D |
| animation | Klatki / Animacja | Tworzenie ruchu i sekwencji animowanych |
| automation | Błyskawica / Automatyzacja | API, CLI lub procesy agentowe |
| text | Litera T / Teksty i napisy | Redakcja, transkrypcja, napisy |
| code | Nawiasy / Programowanie | Tworzenie i analiza programów |
| skills | Element układanki / Skille | Instrukcje lub pakiety umiejętności agenta |
| research | Kolba / Badania | Metody i demonstracje badawcze |
| hardware | Układ / Sprzęt | Fizyczne urządzenie |

Filtry plakietek łączą się przez AND: kamera + zdjęcie pokazują wyłącznie wpisy posiadające obie cechy. „Wszystkie funkcje” usuwa ten filtr. Filtry rodzaju dostępu, licencji kodu, sprzętu, kategorii i wyszukiwarka nadal działają razem.

## Dodawanie programu

1. Najpierw sprawdź oficjalną stronę, dokumentację i repozytorium. Nie opieraj tożsamości projektu na samym skopiowanym README.
2. Dodaj unikatowy identyfikator i opisy `pl`, `en`, `de` w `models.json`. Uzupełnij `checked` faktyczną datą weryfikacji tego wpisu.
3. Dodaj kategorię główną i listę `capabilities`; np. edytor łączący zdjęcia z filmami i muzyką: `["video", "image", "audio", "editing"]`.
4. Ustaw `studioRelevant: true` tylko wtedy, gdy jest przydatny do reklam, rolek, grafiki lub muzyki. `isSkillResource` dotyczy bazy umiejętności. Nie używaj tych oznaczeń jako gwarancji jakości.
5. Zapisz oddzielnie licencję kodu i wag. `openCode` nie oznacza, że wagi są dostępne na tej samej licencji. Własne licencje i warunki niekomercyjne mają być jawnie opisane. Nie utożsamiaj otwartego kodu z bezpłatnym instalatorem.
6. Uzupełnij wymagania sprzętowe na podstawie dokumentacji. Rozróżniaj RAM, VRAM i dysk oraz profil producenta od szacunku. Brak potwierdzenia oznacz wprost.
7. W `auditNote` podaj wykonany zakres kontroli. Metadane, dokumentacja i format safetensors nie stanowią pełnego audytu. Nie nazywaj programu bezpiecznym na podstawie samego pochodzenia.
8. Przed publikacją sprawdź składnię JS, unikatowość ID, kompletność tłumaczeń, filtry plakietek i linki. Przebuduj `hostinger.zip`, żeby zawierał bieżące pliki strony i tę instrukcję.

## Bieżące ograniczenia

Katalog nie instaluje programów, modeli ani skilli. Pobiera jedynie dane katalogowe do przeglądarki i udostępnia linki do źródeł. Opisy zastosowań są redakcyjne. Nie wykonano pełnego audytu kodu, zależności, plików wag ani instalatorów wszystkich wpisów. Odświeżenie audytu bazowego może wymagać ponownego scalenia nowszych wyników i przeglądu dokumentacji.

## Dowody i powtarzalna weryfikacja

Każda karta prowadzi do `verify.html?model=ID&lang=pl` (także en/de).
Panel odczytuje istniejący `audit.json`, pokazuje przypiętą rewizję, hashe
wybranych plików i sygnały do ręcznej oceny. Nie uznaje metadanych ani braku
sygnałów za dowód bezpieczeństwa. Podpisy, zależności, antywirus i test runtime
pozostają „nie zweryfikowano”, dopóki nie mamy osobnego, odtwarzalnego dowodu.
Suma SHA-256 z katalogu nie jest niezależnym dowodem tożsamości wydawcy.

Porównanie pliku do 128 MiB odbywa się lokalnie Web Crypto SHA-256, bez
wysyłania pliku; wynik JSON można pobrać. Dla dużych wag służy
`verify-file.py` (Python 3.9+, standard library): strumieniowo czyta bajty,
nie deserializuje, nie uruchamia i nie pobiera plików. Kody wyjścia:
0 zgodność, 1 różnica, 2 błąd. Nie porównuj sumy pojedynczego pliku z ZIP-em.

`triage-code.py` służy do lokalnego, ograniczonego przeglądu tekstów.
Nie zastępuje antywirusa/SAST/audytu zależności ani oceny człowieka.
Raport zawiera hashe, numery linii sygnałów, limity, pominięcia i błędy.
Nie importuj wyników lokalnych jako „bezpieczne”. Przed szerszą weryfikacją
zapisz tożsamość repozytorium, commit, wersje narzędzi i reguł, datę bazy
antywirusowej, zakres, błędy/pominięcia i log. Powtórz dla każdej wersji,
wtyczki i zmiany zależności. Nie wykonuj kodu sprawdzanego projektu na hoście.
Przegląd i ewentualne budowanie wykonuj w jednorazowej maszynie wirtualnej.

Dokumentacja pierwotna:
- https://huggingface.co/docs/hub/security
- https://docs.github.com/en/actions/concepts/security/artifact-attestations
- https://docs.pypi.org/using-pypi/package-security/source-code-security/
- https://docs.clamav.net/manual/Usage/Scanning.html
- https://github.com/semgrep/semgrep


## Kolekcja 05.11.2026
22 nowe rekordy oznaczono sourceVideo=ZjVIb3qs4p8. Filtr kolekcji pozwala wyświetlić nowości oraz priorytety redakcyjne NERO. Priorytet oznacza przydatność tematyczną, nie dostępność instalacji lub potwierdzone bezpieczeństwo. Profil cuda8 dotyczy deklaracji IDOL, nie dowolnego modelu. Pole compatibility=not-assessed oznacza brak testu na komputerze studia. Szczegóły i ograniczenia: november-5-review.md.


Ważny proces NERO STUDIO: zachowanie postaci z oryginalnego filmu i wymiana tła. Szczegóły: subject-background-workflow.md. MatAnyone-E pozostaje kandydatem do wdrożenia po wydaniu kodu/wag, zgodzie komercyjnej i testach.


## Gotowość
Każdy wpis wymaga readiness.state, reason PL/EN/DE, daty oceny, daty ostatniego dowodu i evidenceSources. Zasady: readiness-policy.md. Gotowość, bezpieczeństwo, zgoda komercyjna i zgodność sprzętowa to odrębne oceny. Nie odświeżaj daty dowodu, gdy odczyt źródła się nie powiódł.
