Poradniki po polsku

Jak otworzyć pliki .npy i .npz z NumPy w VS Code

Zainstaluj darmowe rozszerzenie Tensor Viewer (NPZ Viewer & NPY Viewer) i kliknij plik .npy albo .npz. Każda tablica jest na liście z nazwą, typem danych (dtype) i kształtem, a po kliknięciu widzisz min, max, średnią, odchylenie standardowe, liczbę wartości NaN, wykres, histogram i same wartości, bez Pythona. Podgląd, obrazy, tabela Values oraz zapis do .npy i CSV są za darmo. Zovo Pro (19 USD jednorazowo) dodaje dwa narzędzia, Compare two checkpoints i Scan all tensors, a każde z nich możesz uruchomić 3 razy za darmo.

Za darmo, licencja MIT. ID rozszerzenia zovo.tensor-viewer, wersja 0.6.5.

Ten poradnik przeczytasz też w wersji English, Deutsch, Español, Français, Italiano, 日本語, Português (Brasil), 简体中文.

Kroki w VS Code

1. Zainstaluj Tensor Viewer z Marketplace albo naciśnij Ctrl+P (Cmd+P w macOS) i uruchom ext install zovo.tensor-viewer.
2. Kliknij plik .npy albo .npz w widoku Explorer. Tabela pokazuje każdą tablicę z nazwą, typem, kształtem, liczbą parametrów i rozmiarem.
3. Kliknij tablicę. Prawy panel pokazuje min, max, średnią, odchylenie standardowe oraz liczbę wartości NaN, Inf i zer, pod nimi mapę cieplną dla tablic 2-D albo wykres liniowy dla tablic 1-D, a na końcu histogram.
4. Liczby odczytasz w tabeli Values, po 32 wiersze naraz. Dla tablic o 3 lub więcej wymiarach wpisz wycinek, na przykład [5, :, :], w polu Slice.
5. Jeśli tablica ma kształt obrazu, na przykład (H, W, 3) albo (N, 3, H, W), sekcja Image rysuje ją jako obraz. Tam wybierzesz Layout, Frame i Range. Macierze zmiennoprzecinkowe mają zamiast tego przycisk „Show as image”.
6. Kliknij „Save as .npy...” albo „Save as CSV...”, żeby zapisać tablicę lub wycinek do nowego pliku.

Co jest za darmo, a co dodaje Zovo Pro

Za darmo są wszystkie formaty, statystyki, mapy cieplne, wykresy liniowe, histogramy, obrazy, tabela Values, wycinki, surowe tablice (raw arrays) oraz zapis do .npy i CSV. Python nie jest potrzebny, a podgląd nie łączy się z siecią.

Scan all tensors czyta każdą wartość każdej tablicy w pliku, a nie próbkę, i oznacza wartości NaN i Inf, tablice z samymi zerami, tablice stałe oraz wartości float równe 10 000 lub większe. Dla każdej tablicy podaje dokładne min, max, średnią, odchylenie standardowe i normę L2 w jednym raporcie, który możesz filtrować i zapisać jako CSV, Markdown albo JSON. Uszkodzoną tablicę w dużym pliku .npz znajdziesz bez klikania w każdą po kolei.

Narzędzie Scan all tensors (Zovo Pro)

7. Otwórz plik i kliknij przycisk „Scan all tensors” u góry podglądu albo kliknij plik prawym przyciskiem w widoku Explorer i wybierz „Zovo Pro: Scan Tensors for NaN, Inf and Zeros”.
8. Możesz też uruchomić z Command Palette polecenie „NumPy Viewer Pro: Scan All Tensors for NaN, Inf and Zeros” i wybrać plik.
9. Postęp widać w powiadomieniu, a Cancel przerywa długie skanowanie. W raporcie użyj filtra „Only tensors to check”, a potem zapisz raport jako CSV, Markdown albo JSON.

Scan all tensors działa 3 razy na twoim komputerze, zanim poprosi o licencję. Przy otwieraniu pliku nie ma wyskakujących okienek ani odliczania.

Zovo Pro kosztuje 19 USD jednorazowo. To nie jest subskrypcja. Licencja włącza narzędzia Pro we wszystkich rozszerzeniach Zovo, nie tylko w Tensor Viewer. Po płatności kartą (Stripe) klucz licencyjny pojawi się na następnej stronie. W VS Code uruchom z Command Palette polecenie „Zovo Pro: Enter Zovo Pro license key” i wklej klucz. Klucz jest sprawdzany na twoim komputerze, bez połączenia z siecią. Przez GitHub Sponsors wybierz poziom "$19 one time", a potem uruchom „Zovo Pro: I already paid: unlock with GitHub Sponsors”.

Zespół 5 osób płaci 59 USD jednorazowo (kartą). Wszystkie zasady i narzędzia Pro opisuje strona Zovo Pro (po angielsku).

Kroki w Cursor, Windsurf lub VSCodium

1. Otwórz widok Extensions skrótem Ctrl+Shift+X (Cmd+Shift+X w macOS).
2. Wyszukaj zovo.tensor-viewer i kliknij Install. Cursor, Windsurf i VSCodium instalują rozszerzenia z Open VSX, gdzie to rozszerzenie ma nazwę zovo/tensor-viewer.
3. Jeśli edytor nie ma galerii rozszerzeń, pobierz plik .vsix ze strony Open VSX i uruchom „Extensions: Install from VSIX...”.
4. Dalej wszystko działa tak samo jak w VS Code.

Co otwiera Tensor Viewer

• Pliki .npy z nagłówkiem w wersji 1, 2 i 3, w porządku C i Fortran, z dowolną kolejnością bajtów.
• Archiwa .npz z wpisami bez kompresji (stored) i skompresowanymi (deflate), także zip64.
• Typy bool, od int8 do int64, od uint8 do uint64, float16, float32, float64 i liczby zespolone (statystyki liczone z modułu).
• Tablice o kształcie obrazu, stosy i batche rysowane jako obrazy, po jednej klatce.
• To samo rozszerzenie otwiera też pliki .safetensors, .gguf oraz pliki PyTorch .pt, .pth i .ckpt.

Czego nie robi

• Tablice obiektów zapisane jako pickle są na liście, ale zostają odrzucone i nigdy nie są wykonywane. Tablice tekstowe i strukturalne są na liście bez statystyk.
• Dla tablic z ponad 2 000 000 wartości statystyki i wykresy są liczone z próbki (ustawienie tensorViewer.sampleValues). Panel informuje, kiedy statystyki pochodzą z próbki.
• Skompresowane wpisy .npz są czytane tylko od początku. Wartości za pierwszymi 64 MB nie są pokazywane, a wpisów większych niż 512 MB nie da się zapisać.
• Obrazy mają najwyżej 512 pikseli na dłuższym boku. Tablice 2-kanałowe i tablice w porządku Fortran nie mają widoku obrazu.
• Eksport do CSV kończy się na 20 milionach wartości. Wartości int64 powyżej 2^53 tracą ostatnie cyfry w tabeli i w CSV.

Pytania

Więcej informacji

Więcej szczegółów i inne możliwości znajdziesz w angielskiej wersji poradnika. Wszystkie funkcje i ustawienia opisuje strona Tensor Viewer (po angielsku).

Fakty sprawdzone 12 listopada 2026 na wersji dostępnej w Marketplace.