Sklep z dodatkami dla NVDA

Ważna informacja dla testerów wersji beta: Jeśli testowałeś dodatek TiendaNVDA_Modern, odinstaluj go przed instalacją tej wersji. Tamta wersja była wersją testową i beta, więc nie powinna działać równocześnie z tą wersją końcową. Aby ją odinstalować, przejdź do menu NVDA -> Narzędzia -> Sklep z dodatkami, wybierz "TiendaNVDA_Modern" i usuń go. Następnie uruchom NVDA ponownie i dopiero zainstaluj tę wersję.

Ujednolicony sklep dodatków dla NVDA: łączy sklep społeczności hiszpańskojęzycznej (NVDA.ES) oraz oficjalny sklep NV Access w jednym dostępnym interfejsie.

Autor: Héctor J. Benítez Corredera
Licencja: GNU General Public License v2
Wersja: 2026.05.09
Zgodność: NVDA 2025.1 do NVDA 2026.1
Repozytorium: https://github.com/hxebolax/Tienda-para-NVDA


Spis treści

  1. Wprowadzenie
  2. Instalacja
  3. Pierwsze kroki
  4. Trzy sklepy
  5. Interfejs sklepu
  6. Wskaźniki stanu
  7. Skróty klawiszowe i funkcje specjalne
  8. Menu kontekstowe
  9. Zarządzanie zainstalowanymi dodatkami
  10. Pakowarka dodatków
  11. Wyszukiwanie aktualizacji
  12. Panel opcji
  13. System pamięci podręcznej
  14. Tryb offline
  15. Kopia zapasowa i przywracanie
  16. Tłumaczenie opisów
  17. Serwery niestandardowe
  18. Uwagi i zabezpieczenia
  19. Podsumowanie skrótów klawiszowych
  20. Rejestr zmian

Wprowadzenie

Sklep z dodatkami dla NVDA jest kompletnym rozwinięciem dawnego sklepu dla NVDA.ES. Został przebudowany od podstaw, aby zapewnić nowocześniejsze, szybsze i ujednolicone korzystanie z dodatków.

Co nowego w porównaniu z poprzednią wersją?


Instalacja

  1. Pobierz plik .nvda-addon ze strony wydań repozytorium.
  2. Otwórz pobrany plik albo przeciągnij go na okno NVDA.
  3. Potwierdź instalację, gdy NVDA o to poprosi.
  4. Uruchom NVDA ponownie, aby aktywować dodatek.

Pierwsze kroki

Dodatek jest dostarczany bez przypisanych skrótów klawiszowych. Własne skróty możesz przypisać w:

Menu NVDA -> Preferencje -> Zdarzenia wejścia -> Sklep z dodatkami NVDA

Znajdziesz tam następujące akcje:

Dostęp z menu

Do wszystkich funkcji można też przejść z menu NVDA:

Menu NVDA -> Narzędzia -> Sklep z dodatkami NVDA

W tym miejscu dostępne są następujące podmenu:


Trzy sklepy

Nowa wersja integruje trzy tryby wyświetlania dodatków.

Sklep NVDA.ES

Jest to sklep społeczności hiszpańskojęzycznej. Pobiera dodatki z serwera https://nvda.es oraz z dowolnego serwera niestandardowego, który dodasz samodzielnie.

Oficjalny sklep NVDA

Zapewnia dostęp do oficjalnego sklepu dodatków NV Access (https://addons.nvda-project.org). Dodatki z tego źródła są pobierane bezpośrednio z API oficjalnego sklepu i pokazywane z pełnymi informacjami o zgodności.

Ujednolicony sklep

To widok łączony, który pokazuje wszystkie dodatki ze wszystkich źródeł na jednej liście. Dodatki są oznaczane etykietami [ES] (społeczność hiszpańskojęzyczna) i [OF] (sklep oficjalny), aby było wiadomo, skąd pochodzi dany dodatek.


Interfejs sklepu

Po otwarciu dowolnego sklepu pojawia się okno podzielone na dwa panele.

Lewy panel, czyli obszar pracy

  1. Pole wyszukiwania: po otwarciu sklepu fokus trafia właśnie tutaj. Wpisz dowolny tekst i naciśnij Enter, aby przefiltrować listę. Aby ponownie pokazać wszystkie dodatki, usuń zawartość pola i naciśnij Enter przy pustym polu.

  2. Lista dodatków: pokazuje wszystkie dostępne dodatki wraz ze wskaźnikiem stanu w nawiasach kwadratowych, na przykład [I] albo [U]. Po liście poruszasz się strzałkami w górę i w dół.

  3. Przycisk akcji, Instaluj/Aktualizuj: jest dynamiczny i automatycznie zmienia tekst zależnie od stanu zaznaczonego dodatku:

  4. jeśli dodatek nie jest zainstalowany, pokazuje "Instaluj";
  5. jeśli jest dostępna aktualizacja, pokazuje "Aktualizuj".

Prawy panel, czyli karta informacyjna

Podczas poruszania się po liście dodatków ten panel wypełnia się pełnymi informacjami o zaznaczonym dodatku:


Wskaźniki stanu

Podczas poruszania się po liście dodatków NVDA wypowiada litery w nawiasach kwadratowych. Oznaczają one stan danego dodatku.

Wskaźnik Znaczenie
[I] Zainstalowany: dodatek jest zainstalowany i aktywny.
[U] Aktualizacja: dostępna jest nowsza wersja. Warto zaktualizować.
[U-I] Niezgodna aktualizacja: dostępna jest nowsza wersja, ale nie jest zgodna z Twoją wersją NVDA.
[D] Wyłączony: dodatek jest zainstalowany, ale ręcznie wyłączony.
[R] Oczekuje na usunięcie: dodatek zostanie usunięty po ponownym uruchomieniu NVDA.
[I-I] Zainstalowany niezgodny: dodatek jest zainstalowany, ale zablokowany z powodu niezgodności z Twoją wersją NVDA.
[X] Niezgodny: dodatek nie jest zgodny z Twoją wersją NVDA.

W ujednoliconym sklepie widoczne jest również źródło dodatku.

Etykieta Źródło
[ES] Serwery NVDA.ES, czyli społeczność hiszpańskojęzyczna
[OF] Oficjalny sklep NV Access

Skróty klawiszowe i funkcje specjalne

Te klawisze działają wtedy, gdy fokus znajduje się na liście dodatków.

F1 - bieżąca pozycja

Naciśnij F1, aby NVDA powiedział, na której pozycji listy jesteś, na przykład: "Dodatek 15 z 200".

Ctrl+F1 - wyjaśnienie wskaźnika

Jeśli nie pamiętasz, co oznaczają wskaźniki [I] albo [U], naciśnij Ctrl+F1. NVDA wyjaśni prostym językiem stan zaznaczonego dodatku.

F2 - odczytanie całej karty

Naciśnij F2, aby NVDA przeczytał całą kartę techniczną i opis dodatku bez przechodzenia tabulatorem do prawego panelu. Działa to we wszystkich sklepach.

F3 - tłumaczenie opisu

Jeśli opis jest po angielsku albo w innym języku, naciśnij F3, a sklep przetłumaczy go na język ustawiony w opcjach. Domyślnie jest to hiszpański, ale można wybrać też polski. Na początku i na końcu tłumaczenia odtworzony zostanie dźwięk.

Uwaga: aby używać F3, musisz najpierw włączyć tłumacza w opcjach dodatku. Funkcja wymaga połączenia z internetem.


Menu kontekstowe

Na liście dodatków naciśnij klawisz aplikacji albo Shift+F10, aby otworzyć menu kontekstowe z następującymi opcjami.

Filtry

Uwaga: filtry nie łączą się ze sobą. Każdy filtr działa osobno, a tytuł okna informuje o aktywnym filtrze. Wybrany filtr pozostaje aktywny do czasu ponownego uruchomienia NVDA.

Kopiowanie do schowka


Zarządzanie zainstalowanymi dodatkami

Jedną z ważniejszych funkcji jest możliwość zarządzania już zainstalowanym dodatkiem bez opuszczania sklepu.

  1. Wybierz na liście dodatek oznaczony jako [I], [D] albo [U].
  2. Naciśnij klawisz aplikacji albo kliknij prawym przyciskiem.
  3. W podmenu Zarządzanie zainstalowanym znajdziesz:

  4. Wyłącz / Włącz: tymczasowo wyłącza albo włącza dodatek.

  5. Odinstaluj: oznacza dodatek do usunięcia. Usunięcie nastąpi po ponownym uruchomieniu NVDA.
  6. Zobacz dokumentację: otwiera dokumentację dodatku w przeglądarce. Jeśli dokumentacja istnieje w Twoim języku, zostanie otwarta ta wersja; w przeciwnym razie użyty zostanie domyślny język dodatku.

Pakowarka dodatków

Pakowarka pozwala tworzyć pliki .nvda-addon z dodatków, które są już zainstalowane. Przydaje się to do:

Aby spakować dodatek:

  1. Przejdź do Menu NVDA -> Narzędzia -> Sklep z dodatkami NVDA -> Pakowarka dodatków.
  2. Wybierz z listy dodatek, który chcesz spakować.
  3. Wskaż katalog, w którym ma zostać zapisany plik.
  4. Plik .nvda-addon zostanie utworzony automatycznie w formacie nazwa_wersja_Gen.nvda-addon.

Wyszukiwanie aktualizacji

Dodatek oferuje dwa sposoby wyszukiwania aktualizacji.

Wyszukiwanie ręczne

W menu narzędzi wybierz Szukaj aktualizacji w jednym ze sklepów, NVDA.ES albo oficjalnym. Zostanie wyświetlone okno z dodatkami, dla których są dostępne aktualizacje.

W tym oknie możesz:

Sprawdzanie automatyczne

Po włączeniu automatycznego sprawdzania w opcjach:

Powiadomienia są bardziej szczegółowe, na przykład:

```text Znaleziono 3 aktualizacje. - NVDA.ES (2): Dodatek A, Dodatek B - Oficjalny sklep (1): Dodatek C

Uruchom wyszukiwanie aktualizacji dodatków. ```


Panel opcji

Konfigurację dodatku otworzysz z:

Menu NVDA -> Preferencje -> Opcje -> Sklep z dodatkami NVDA

A. Sklep NVDA.ES

B. Oficjalny sklep NVDA

C. Aktualizacje

D. Tłumaczenie

E. Opcje ogólne

F. Kopia zapasowa i przywracanie

G. Zainstalowane dodatki dostępne na serwerze

Na dole opcji znajduje się lista Twoich dodatków, które są też dostępne na serwerze. Z tego miejsca możesz:

  1. Wybrać dodatek i nacisnąć spację.
  2. W menu podręcznym wybrać kanał aktualizacji (stabilny, beta, rozwojowy itd.) albo Odrzuć aktualizacje, aby sklep przestał informować o tym dodatku.

Ważne: zmiany są zapisywane dopiero po naciśnięciu OK albo Zastosuj w oknie opcji.


System pamięci podręcznej

Sklep używa wielopoziomowego systemu pamięci podręcznej, aby przyspieszyć działanie.

Cache serwerów

Listy dodatków są zapisywane na dysku. Jeśli cache nie wygasł, po otwarciu sklepu lista jest ładowana z dysku zamiast z serwera.

Cache tłumaczeń

Tłumaczenia wykonane klawiszem F3 są zapisywane w trwałym pliku JSON. Przy kolejnym żądaniu tego samego tłumaczenia wynik zostanie odczytany natychmiast z cache.

Cache w pamięci RAM

Oprócz cache na dysku sklep przechowuje najczęstsze zapytania w pamięci RAM, co ogranicza dostęp do dysku podczas bieżącej sesji.


Tryb offline

Tryb offline pozwala przeglądać sklep bez połączenia z internetem, używając wcześniej zapisanych danych.

Aby go używać:

  1. Włącz opcje Włącz pamięć podręczną serwerów i Włącz tryb offline.
  2. Otwórz sklep przynajmniej raz z działającym internetem, aby utworzyć cache.
  3. Następnym razem, gdy otworzysz sklep bez internetu, dane zostaną wczytane z cache.

Uwaga: w trybie offline nie można pobierać ani instalować dodatków, ale można czytać informacje o dodatkach, które wcześniej zostały zapisane w cache.


Kopia zapasowa i przywracanie

Tworzenie kopii zapasowej

  1. Przejdź do Opcje -> Sklep z dodatkami NVDA -> Utwórz kopię zapasową dodatków.
  2. Wybierz nazwę i miejsce zapisu pliku .json.
  3. Zostanie utworzony plik z listą wszystkich zainstalowanych dodatków, obejmujący nazwę, wersję i podsumowanie.

Automatyczna kopia przy zamykaniu

Sklep może automatycznie tworzyć kopię zapasową przy zamykaniu NVDA, jeśli odpowiednia opcja jest włączona.

Przywracanie z kopii zapasowej

  1. Przejdź do Opcje -> Sklep z dodatkami NVDA -> Przywróć z kopii zapasowej.
  2. Wybierz plik .json kopii zapasowej.
  3. Sklep pokaże kreatora, który wyszuka najnowsze wersje każdego dodatku na serwerach i pozwoli zainstalować je zbiorczo.

Przydatne do: przeniesienia dodatków na nowy komputer albo odtworzenia konfiguracji po ponownej instalacji NVDA.


Tłumaczenie opisów

Sklep ma wbudowanego tłumacza opartego o Google Translate.

  1. Włącz tłumacza w opcjach dodatku.
  2. Wybierz język docelowy, domyślnie jest to hiszpański.
  3. Naciśnij F3 na dowolnym dodatku na liście, aby przetłumaczyć jego opis.

Funkcje:


Serwery niestandardowe

Możesz dodać zewnętrzne repozytoria dodatków, jeśli używają formatu zgodnego z NVDA.ES.

Dodawanie serwera

  1. Przejdź do Opcje -> Sklep z dodatkami NVDA -> Zarządzaj serwerami dodatków.
  2. Naciśnij Dodaj.
  3. Wpisz opisową nazwę i adres URL serwera.
  4. Zatwierdź, a serwer pojawi się w wyborze serwerów.

Przykład: serwer społeczności rosyjskiej

Szybka zmiana serwera

W głównym oknie sklepu NVDA.ES naciśnij Alt+C albo przycisk Zmień serwer, aby rozwinąć menu z wszystkimi skonfigurowanymi serwerami. Zmiana działa natychmiast i tymczasowo; jako domyślna zostanie zapisana dopiero po zmianie w opcjach.

Uwaga: domyślnego serwera społeczności hiszpańskojęzycznej nie można edytować ani usunąć.


Uwagi i zabezpieczenia

Dodatek zawiera kilka zabezpieczeń, które mają zapewnić stabilne działanie:

  1. Dodatki oczekujące na odinstalowanie: są automatycznie pomijane podczas sprawdzania aktualizacji.
  2. Walidacja zgodności API: nawet jeśli wersja na serwerze jest nowsza, aktualizacja nie zostanie zaproponowana, jeśli nie jest zgodna z Twoją wersją NVDA.
  3. Powiadomienia o błędach instalacji: jeśli któregoś dodatku nie uda się zaktualizować, pojawi się informacja z jego nazwą.
  4. Blokada po aktualizacji: sklep nie pozwala szukać kolejnych aktualizacji, jeśli wykonano aktualizację i NVDA nie został jeszcze ponownie uruchomiony.
  5. Powiadomienie po restarcie: jeśli automatyczne sprawdzanie wykryje, że po aktualizacji nie uruchomiono ponownie NVDA, pojawi się przypomnienie.
  6. Ochrona przy braku internetu: jeśli biblioteki nie mogą zostać wczytane z powodu braku połączenia, informacja trafi do logu NVDA, a przy próbie wejścia do sklepu usłyszysz komunikat.
  7. Inteligentny restart: sklep wykrywa, czy dodatek faktycznie został zainstalowany. Jeśli anulujesz instalator, nie będzie niepotrzebnej prośby o restart.
  8. Sprawdzanie zależności: przed instalacją weryfikowane jest spełnienie wymaganych zależności.

Podsumowanie skrótów klawiszowych

Główne okno sklepu

Akcja Klawisz
Przejście do pola wyszukiwania Alt+B
Przejście do listy dodatków Alt+L
Instalacja / aktualizacja Alt+I
Przejście do informacji o dodatku Alt+I w prawym panelu
Przejście do strony internetowej dodatku Alt+P
Zmiana serwera, tylko NVDA.ES Alt+C
Zamknięcie sklepu Alt+S / Escape / Alt+F4

Na liście dodatków

Akcja Klawisz
Odczyt bieżącej pozycji na liście F1
Wyjaśnienie wskaźnika stanu Ctrl+F1
Odczyt pełnej karty dodatku F2
Tłumaczenie opisu F3
Menu kontekstowe, filtry, kopiowanie i zarządzanie Klawisz aplikacji / Shift+F10

Okno aktualizacji

Akcja Klawisz
Zaznaczenie wszystkich dodatków Alt+S
Odznaczenie wszystkich Alt+D
Rozpoczęcie aktualizacji Alt+A
Zamknięcie okna Alt+C / Escape / Alt+F4

Rejestr zmian

Wersja 2026.05.11

Wersja 2026.05.10

Wersja 2026.05.09

Poprzednie wersje, sklep dla NVDA.ES

To repozytorium zawierało wcześniej klasyczną wersję sklepu dla NVDA.ES (wersje 0.1 do 0.10). Od wersji 2026.05.09 repozytorium zostało zastąpione nowym ujednoliconym sklepem dodatków dla NVDA, czyli kompletnym przepisaniem dodatku.

Jeśli chcesz sprawdzić kod źródłowy albo dokumentację starej wersji, możesz przejrzeć historię commitów w repozytorium GitHub:

  1. Przejdź do https://github.com/hxebolax/Tienda-para-NVDA.
  2. Kliknij link commits albo licznik commitów widoczny u góry repozytorium.
  3. Znajdź dowolny commit sprzed 9 maja 2026, aby uzyskać dostęp do kodu i wydań klasycznego sklepu.
  4. Po wejściu w wybrany commit możesz kliknąć Browse files, aby zobaczyć pełny stan repozytorium z tego momentu.

Alternatywnie starsze wydania z plikami .nvda-addon powinny pozostać dostępne w sekcji Releases, o ile nie zostaną ręcznie usunięte.


Miłego korzystania ze sklepu z dodatkami dla NVDA.

Z pozdrowieniami: Héctor J. Benítez Corredera.