# Context pack: Zainstaluj, katalog danych i logi Source: https://nordvec.com/pl/docs/guides/desktop/install-and-data Pack: https://nordvec.com/pl/docs/packs/desktop/install-and-data This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow. ## Contents 1. [Zainstaluj, katalog danych i logi](https://nordvec.com/pl/docs/guides/desktop/install-and-data) (this guide) 2. [Znane problemy aplikacji komputerowej](https://nordvec.com/pl/docs/guides/desktop/known-issues) (linked from this guide) --- # Zainstaluj, katalog danych i logi Source: https://nordvec.com/pl/docs/guides/desktop/install-and-data Co instaluje aplikacja Nordvec na komputerze z systemem Windows, macOS i Linux, jakie pliki zapisuje na dysku i gdzie znajduje się jej plik logów. Ta strona informuje, gdzie aplikacja desktopowa zapisuje dane na każdym systemie operacyjnym, dla twoich własnych potrzeb lub przeglądu IT. Jest generowana na podstawie konfiguracji kompilacji aplikacji oraz nazw plików, które zapisuje jej kod, więc zmienia się, gdy one się zmieniają. Aplikacja to **Nordvec Desktop**, identyfikator aplikacji `com.nordvec.desktop`. ## Windows [#windows] * **Instalator:** program instalacyjny `.exe` dla x64. * **Instalacja dla:** instalator pyta, czy zainstalować tylko dla ciebie, czy dla wszystkich użytkowników komputera. Opcja *tylko dla ciebie* jest domyślnie zaznaczona i nie wymaga uprawnień administratora. * **Folder instalacji:** możesz go wybrać w instalatorze. * **Odinstalowanie** usuwa folder danych poniżej wraz z aplikacją. Aktualizacja tego nie robi. * **Folder danych:** `%APPDATA%\Nordvec Desktop` * **Plik dziennika:** `%APPDATA%\Nordvec Desktop\logs\nordvec-.log` ## macOS [#macos] * **Pobieranie:** obraz dysku (`.dmg`) lub archiwum `.zip`, dla komputerów Apple silicon i Intel Macs (jeden uniwersalny build). * **Wymagania:** macOS 13.0 lub nowszy. * **Usunięcie aplikacji** pozostawia poniższy folder danych; usuń go, aby usunąć lokalne dane synchronizacji. * **Folder danych:** `~/Library/Application Support/Nordvec Desktop` * **Plik dziennika:** `~/Library/Application Support/Nordvec Desktop/logs/nordvec-.log` ## Linux [#linux] * **Pobieranie:** AppImage dla x64. Uruchamia się jako twój użytkownik, bez instalacji systemowej. * **Usunięcie aplikacji** pozostawia poniższy folder danych; usuń go, aby usunąć lokalne dane synchronizacji. * **Pęk kluczy:** aplikacja wymaga działającego gnome-keyring lub KWallet do szyfrowania lokalnych danych synchronizacji i nie synchronizuje się bez jednego z nich. * **Folder danych:** `~/.config/Nordvec Desktop` * **Plik dziennika:** `~/.config/Nordvec Desktop/logs/nordvec-.log` * Gdy ustawione jest `XDG_CONFIG_HOME`, folder danych to `$XDG_CONFIG_HOME/Nordvec Desktop` zamiast tego. ## Co zawiera katalog danych [#co-zawiera-katalog-danych] Wszystko, co aplikacja przechowuje na twoim komputerze, znajduje się w katalogu danych dla twojego systemu operacyjnego, powyżej. Każde zalogowane konto ma własny magazyn synchronizacji. | Nazwa | Co zawiera | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `sync-state-.sqlite` | Magazyn synchronizacji dla jednego zalogowanego konta: obserwowane foldery, wykluczenia, kolejki przesyłania i usuwania oraz to, co zostało zsynchronizowane. Nazwy plików i ścieżki są szyfrowane kluczem chronionym przez pęk kluczy systemu operacyjnego. | | `logs/nordvec-.log` | Dziennik aplikacji na jeden dzień. Rejestruje zdarzenia, liczniki i kody błędów, a każda linia zawiera wersję aplikacji, która ją zapisała. Nie zawiera nazw plików, ścieżek ani treści plików. | | `logs/nordvec-.1.log` | Wcześniejsza część dziennika danego dnia, przechowywana, gdy dziennik osiągnie limit rozmiaru. Maksymalnie jeden na dzień. | | `window-state.json` | Ostatni rozmiar i pozycja okna. | | `ui-locale` | Język ostatniej strony wyświetlonej przez aplikację, aby menu zasobnika i powiadomienia używały tego samego języka. | | `update-health.json` | Kiedy aplikacja ostatnio sprawdzała aktualizacje i czy te sprawdzenia kończą się niepowodzeniem. | | `whats-new-version` | Ostatnia wersja, której lista zmian została wyświetlona przez aplikację, aby zmiany każdej aktualizacji były pokazywane tylko raz. | | `first-run-done` | Oznacza, że pierwszy uruchomienie zostało wykonane, więc uruchamianie przy starcie jest włączone tylko dla nowej instalacji. | | `crash-ledger.json` | Kiedy aplikacja ostatnio zatrzymała się z powodu błędu, zapisane tylko jako czasy, aby drugie zatrzymanie wkrótce po ponownym otwarciu powodowało jej zamknięcie zamiast ponownego otwierania. | Gdy magazyn synchronizacji jest otwarty, SQLite przechowuje pliki `-wal`, `-shm`, `-journal` obok `sync-state-.sqlite`; należą one do magazynu. Aplikacja przechowuje również ciasteczka i dane witryny dla zalogowanej sesji w katalogu danych. Magazyn ciasteczek jest szyfrowany kluczem chronionym przez pęk kluczy systemu operacyjnego. Na komputerze, który uruchamiał wczesną kompilację, możesz również znaleźć: | Nazwa | Co zawiera | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `sync-state.json` | Stan zapisany przez wczesną wersję. Przy logowaniu aplikacja przekazuje go koncie, do którego należy, a przechowuje go, gdy nie może określić właściciela. | | `logs/nordvec.log` | Dziennik zapisany przez wczesną wersję. Jest usuwany wraz z dziennikami dziennymi, gdy jest wystarczająco stary. | | `logs/nordvec.log.old` | Poprzedni dziennik przechowywany przez wczesną wersję, usuwany na tych samych zasadach. | | `sync-state-.json` | Stan na konto zapisany przez wczesną wersję. Przy logowaniu aplikacja kopiuje go do magazynu synchronizacji i zmienia jego nazwę po odczytaniu kopii. | | `sync-state-.json.imported` | Ten sam wczesny stan po skopiowaniu jego zawartości do magazynu synchronizacji. Zawiera nieszyfrowane nazwy plików i ścieżki, a nic go ponownie nie odczytuje, więc można go bezpiecznie usunąć. | ## Plik dziennika [#plik-dziennika] Aplikacja zapisuje jeden plik dziennika na dzień, `logs/nordvec-.log` w folderze danych, gdzie data to dzień na twoim komputerze. Aby otworzyć ich folder z poziomu aplikacji, wybierz **Pomoc > Pokaż plik dziennika**. Gdy dziennik osiągnie 5 MB, jego wcześniejsze linie są przenoszone do `nordvec-.1.log`, więc jeden dzień przechowuje maksymalnie dwa pliki. Aplikacja przechowuje ostatnie 14 dni, w tym dzisiejszy, i maksymalnie 50 MB dzienników łącznie, usuwając najstarsze dni jako pierwsze. Nigdy nie usuwa dzisiejszego dziennika i usuwa tylko pliki o tych nazwach. Każda linia zawiera wersję, która ją zapisała, jako `v= sha=` po czasie i poziomie. ## Którą wersję masz [#którą-wersję-masz] * Windows: wybierz **Pomoc > Informacje o Nordvec Desktop**. * macOS: wybierz **Nordvec Desktop > Informacje o Nordvec Desktop**. * Linux: wybierz **Pomoc > Informacje o Nordvec Desktop**. * Przy każdym uruchomieniu zapisywana jest również linia zaczynająca się od `app_ready version=` w pliku dziennika, po której następuje numer wersji. ## Zgłaszanie problemu [#zgłaszanie-problemu] Najpierw sprawdź [znane problemy](/docs/guides/desktop/known-issues). Aby zgłosić błąd, dołącz wersję aplikacji i, jeśli możesz, plik dziennika. Aplikacja jest napisana tak, aby nie logować nazw plików, ścieżek ani zawartości plików, ale przeczytaj dziennik przed udostępnieniem i usuń wszystko, czym nie chcesz się dzielić. --- # Znane problemy aplikacji komputerowej Source: https://nordvec.com/pl/docs/guides/desktop/known-issues Dlaczego aplikacja komputerowa Nordvec odrzuca folder, pomija plik, wstrzymuje usunięcie lub przestaje synchronizować i co zrobić w każdym przypadku. Każdy wpis poniżej to decyzja, którą podejmuje aplikacja desktopowa celowo. Ta strona jest generowana na podstawie kodów, z którymi aplikacja podejmuje decyzje, więc każdy kod odmowy, jaki może zgłosić, jest tutaj wymieniony wraz z przyczyną i obejściem. Jeśli tego, co widzisz, nie ma tutaj, [zgłoś to](/docs/guides/desktop/install-and-data#reporting-a-problem) wraz z wersją aplikacji i plikiem dziennika. ## Foldery, których aplikacja nie doda [#foldery-których-aplikacja-nie-doda] Aplikacja odrzuca te foldery, gdy je wybierzesz, i podaje powód. ### Nie można dodać całego dysku [#nie-można-dodać-całego-dysku] Co widzisz: **Cały dysk jest zbyt obszerny, aby go synchronizować. Wybierz zamiast tego folder na nim.** **Przyczyna:** Katalog główny dysku zawiera znacznie więcej niż tylko dokumenty, a monitorowanie go spowodowałoby, że każde skanowanie i usuwanie przechodziłoby przez cały dysk. **Obejście:** Dodaj foldery na tym dysku, które zawierają twoje dokumenty, jeden po drugim. ### Nie można dodać twojego folderu domowego [#nie-można-dodać-twojego-folderu-domowego] Co widzisz: **Twój folder konta zawiera dane aplikacji i ustawienia, a także dokumenty, a jego nazwa to nazwa konta komputera. Wybierz Dokumenty, Pulpit lub inny folder wewnątrz niego.** **Przyczyna:** Twój folder domowy zawiera dane aplikacji, ustawienia i pamięć podręczną, a także dokumenty, więc monitorowanie go spowodowałoby umieszczenie ich wszystkich w Nordvec. Jego nazwa to również nazwa konta komputera. **Obejście:** Zamiast tego dodaj foldery Dokumenty, Pulpit lub inny folder wewnątrz twojego folderu domowego. ### Nie można dodać folderu wewnątrz lub wokół monitorowanego folderu [#nie-można-dodać-folderu-wewnątrz-lub-wokół-monitorowanego-folderu] Co widzisz: **Ten folder nakłada się na folder, który już monitorujesz.** **Przyczyna:** Plik w dwóch monitorowanych folderach miałby dwóch właścicieli, a zestaw wykluczeń nałożony na jeden folder nie obowiązywałby przez drugi. **Obejście:** Pliki w folderze wewnątrz monitorowanego folderu już się synchronizują, więc nie ma nic do dodania. Aby monitorować szerszy folder, najpierw przestań monitorować węższy: jego dokumenty znikną z Nordvec, dopóki szerszy folder nie zsynchronizuje ich ponownie. ## Pliki, które nie są synchronizowane [#pliki-które-nie-są-synchronizowane] Te pliki pozostają na twoim komputerze i są wymienione na stronie synchronizacji pulpitu wraz z przyczyną, więc odpowiedzi nie mogą ich cytować. ### Ścieżka pliku jest zbyt długa [#ścieżka-pliku-jest-zbyt-długa] Co widzisz: **Ścieżka jest zbyt długa dla tego systemu** **Przyczyna:** Pełna ścieżka jest dłuższa niż pozwala na to system operacyjny, aby aplikacja mogła ją odczytać. **Obejście:** Skróć nazwy folderów lub plików albo przenieś folder bliżej początku dysku. Plik zsynchronizuje się, gdy jego ścieżka będzie wystarczająco krótka. ### Nie można odczytać pliku [#nie-można-odczytać-pliku] Co widzisz: **Nie można odczytać tego pliku** **Przyczyna:** System operacyjny odmówił aplikacji dostępu do odczytu pliku. **Obejście:** Przyznaj swojemu kontu użytkownika uprawnienia do odczytu pliku. Na macOS zezwól Nordvec Desktop w Ustawieniach systemowych, Prywatność i bezpieczeństwo, Pliki i foldery. Aplikacja ponownie odczyta plik, gdy się zmieni, oraz przy każdym uruchomieniu aplikacji. ### Element nie jest zwykłym plikiem [#element-nie-jest-zwykłym-plikiem] Co widzisz: **To nie jest zwykły plik** **Przyczyna:** To dowiązanie symboliczne, urządzenie, potok lub inny specjalny plik. Aplikacja odczytuje tylko zwykłe pliki, więc dowiązanie nigdy nie doprowadzi jej do pliku, którego nie wybrałeś. **Obejście:** Dodaj folder, który zawiera rzeczywisty plik, zamiast dowiązania. ### Plik ma więcej niż jedną nazwę na dysku [#plik-ma-więcej-niż-jedną-nazwę-na-dysku] Co widzisz: **Ten plik ma więcej niż jedną nazwę na dysku** **Przyczyna:** Plik jest twardym dowiązaniem: te same dane mają drugą nazwę, która może znajdować się poza wybranym folderem. Aplikacja nie może określić, do którego folderu należą dane, więc ich nie odczytuje. Narzędzia do tworzenia kopii zapasowych, które oszczędzają miejsce w ten sposób, tworzą takie pliki. **Obejście:** Zastąp plik zwykłą kopią, która ma jedną nazwę. ### Plik prowadzi poza monitorowany folder [#plik-prowadzi-poza-monitorowany-folder] Co widzisz: **Ten plik prowadzi poza monitorowany folder** **Przyczyna:** Ścieżka pliku rozwiązuje się, przez dowiązanie lub skrzyżowanie, do miejsca poza wybranym folderem. **Obejście:** Dodaj folder, w którym naprawdę znajduje się plik. ### Plik znajduje się w folderze, który wykluczyłeś [#plik-znajduje-się-w-folderze-który-wykluczyłeś] Co widzisz: **Ten plik znajduje się w folderze, który wykluczyłeś** **Przyczyna:** Wykluczyłeś podfolder monitorowanego folderu, a plik, który wybierasz wewnątrz niego, pozostaje wykluczony. **Obejście:** Włącz ponownie podfolder w karcie folderu na stronie synchronizacji pulpitu, a jego pliki się zsynchronizują. ### Plik jest większy niż limit dla jego typu [#plik-jest-większy-niż-limit-dla-jego-typu] Co widzisz: **Ten plik jest większy niż limit dla jego typu** **Przyczyna:** Każdy typ pliku ma limit rozmiaru, sprawdzany przed odczytem pliku. Jeśli wcześniejsza, mniejsza wersja została zsynchronizowana, jej kopia jest usuwana, aby odpowiedzi nigdy nie cytowały treści, której plik już nie zawiera. **Obejście:** Podziel plik na mniejsze pliki lub zapisz go w bardziej zwartym formacie. ### Plik jest pusty [#plik-jest-pusty] Co widzisz: **Ten plik jest pusty, więc nie ma czego wyszukiwać** **Przyczyna:** Plik bez zawartości nie ma nic do wyszukania. Jeśli wcześniejsza wersja miała zawartość, jej kopia jest usuwana z tego samego powodu, co zbyt duża. **Obejście:** Nic nie rób: plik zsynchronizuje się, gdy będzie miał zawartość. ### Typ pliku nie może być przeszukiwany [#typ-pliku-nie-może-być-przeszukiwany] Co widzisz: **Tego typu pliku nie można przeszukiwać** **Przyczyna:** Rozszerzenie pliku nie jest jednym z tych, które synchronizuje aplikacja. **Obejście:** Zapisz lub wyeksportuj plik jako jeden z typów w tabeli limitów rozmiaru na końcu tej strony. ### Nie można dodać pliku [#nie-można-dodać-pliku] Co widzisz: **Nie można dodać tego pliku** **Przyczyna:** Odczyt pliku nie powiódł się z innego powodu niż wymienione powyżej, na przykład dlatego, że zmienił się lub był zablokowany podczas odczytu przez aplikację. **Obejście:** Zamknij wszystko, co ma otwarty plik. Aplikacja ponownie odczyta plik, gdy się zmieni, oraz przy każdym uruchomieniu aplikacji. Jeśli ten sam plik nadal się nie udaje, zgłoś to z załączonym plikiem dziennika. ## Usuwania, które czekają na ciebie [#usuwania-które-czekają-na-ciebie] Nic nie jest usuwane z Nordvec, gdy aplikacja nie może odróżnić usunięcia od folderu, który jest tylko poza zasięgiem. ### Wiele plików usuniętych jednocześnie pozostaje w Nordvec do potwierdzenia [#wiele-plików-usuniętych-jednocześnie-pozostaje-w-nordvec-do-potwierdzenia] Co widzisz: **Duże usunięcie wstrzymane do przejrzenia** **Przyczyna:** Gdy więcej niż 25% plików w folderze zniknie w ciągu 7 dni (w folderze liczącym co najmniej 20 plików), aplikacja wstrzymuje ich usunięcie z Nordvec zamiast je przeprowadzić, ponieważ przeniesiony lub odłączony folder wygląda tak samo jak usunięcie. **Obejście:** Potwierdź usunięcie w karcie folderu na stronie synchronizacji pulpitu lub przywróć pliki. Wstrzymane usunięcie, którego nie potwierdzisz, zostanie przeprowadzone w dniu pokazanym na stronie. ### Folder, którego nie można odczytać, zachowuje swoje dokumenty w Nordvec [#folder-którego-nie-można-odczytać-zachowuje-swoje-dokumenty-w-nordvec] Co widzisz: **Brakuje zsynchronizowanego folderu** **Przyczyna:** Gdy monitorowany folder nie może być w ogóle odczytany, na przykład na odłączonym dysku lub udziale sieciowym, aplikacja traktuje go jako niedostępny, a nie pusty, i nic nie usuwa. **Obejście:** Podłącz ponownie dysk, a synchronizacja zostanie wznowiona. Aby usunąć dokumenty folderu z Nordvec, przestań monitorować folder. ## Dokumenty, które opuszczają Nordvec [#dokumenty-które-opuszczają-nordvec] Dokument w Nordvec podąża za swoim plikiem na twoim komputerze. Oto dwa sposoby, w jakie jest usuwany. ### Dokument opuścił Nordvec po przeniesieniu, zmianie nazwy lub usunięciu pliku [#dokument-opuścił-nordvec-po-przeniesieniu-zmianie-nazwy-lub-usunięciu-pliku] **Przyczyna:** Dokument znajduje się w Nordvec, ponieważ jego plik jest w monitorowanym folderze. Gdy plik zostanie usunięty lub przeniesiony poza folder, jego kopia jest usuwana. Zmieniony lub przeniesiony plik to nowa ścieżka, więc synchronizuje się ponownie jako nowy dokument. **Obejście:** Przywróć plik lub poczekaj, aż przeniesiony plik się zsynchronizuje. Plik, który wróci na dysk przed uruchomieniem usuwania, zachowa swój dokument. ### Dokumenty opuściły Nordvec po tym, jak przestałeś monitorować lub wykluczyłeś folder [#dokumenty-opuściły-nordvec-po-tym-jak-przestałeś-monitorować-lub-wykluczyłeś-folder] **Przyczyna:** Zaprzestanie monitorowania folderu lub wykluczenie podfolderu usuwa jego dokumenty z Nordvec. Pliki na twoim komputerze nie są naruszane. **Obejście:** Dodaj folder ponownie lub usuń wykluczenie, a jego pliki zsynchronizują się ponownie. ## Gdy synchronizacja jest wyłączona [#gdy-synchronizacja-jest-wyłączona] Każda z tych sytuacji zatrzymuje synchronizację dla zalogowanego konta, dopóki nie zostanie naprawiona, a aplikacja informuje, która to jest. ### Synchronizacja jest wyłączona, ponieważ komputer nie ma pęku kluczy [#synchronizacja-jest-wyłączona-ponieważ-komputer-nie-ma-pęku-kluczy] Co widzisz: **Nordvec szyfruje twoje lokalne dane synchronizacji za pomocą klucza z pęku kluczy systemu, a ten komputer nie ma dostępnego żadnego. Zainstaluj i odblokuj pęk kluczy (gnome-keyring lub kwallet), a następnie zaloguj się ponownie.** **Przyczyna:** Aplikacja szyfruje swoje lokalne dane synchronizacji za pomocą klucza chronionego przez pęk kluczy systemu operacyjnego i nigdy nie przechodzi na przechowywanie nazw plików w postaci nieszyfrowanej. Na Linuksie bez działającego gnome-keyring lub KWallet nie ma pęku kluczy, który mógłby przechowywać klucz. **Obejście:** Zainstaluj i odblokuj gnome-keyring lub KWallet, a następnie zaloguj się ponownie. ### Synchronizacja jest wyłączona, ponieważ nowsza wersja zapisała lokalne dane [#synchronizacja-jest-wyłączona-ponieważ-nowsza-wersja-zapisała-lokalne-dane] Co widzisz: **Twoje dane synchronizacji zostały zapisane przez nowszą wersję Nordvec. Zaktualizuj aplikację, aby wznowić synchronizację.** **Przyczyna:** Lokalne dane synchronizacji zostały zapisane przez nowszą wersję aplikacji, zwykle dlatego, że starsza wersja została zainstalowana nad nią. **Obejście:** Zainstaluj najnowszą wersję. ### Synchronizacja jest wyłączona, ponieważ nie można odczytać lokalnych danych synchronizacji [#synchronizacja-jest-wyłączona-ponieważ-nie-można-odczytać-lokalnych-danych-synchronizacji] Co widzisz: **Nie można odczytać twojego lokalnego stanu synchronizacji. Synchronizacja jest wstrzymana; może być wymagana ponowna instalacja.** **Przyczyna:** Magazyn synchronizacji nie mógł zostać otwarty lub odczytany, na przykład dlatego, że plik jest uszkodzony lub jego klucz nie może zostać odblokowany przez to konto użytkownika. **Obejście:** Zgłoś to z załączonym plikiem dziennika. Nie usuwaj najpierw katalogu danych: może zawierać usuwania, które jeszcze nie dotarły do Nordvec. ## Limity rozmiaru plików [#limity-rozmiaru-plików] Aplikacja synchronizuje te typy plików, każdy do podanego rozmiaru. Większy plik jest wymieniony jako zbyt duży, a typ nieznajdujący się w tej tabeli jako taki, którego nie można przeszukiwać. | Największy plik | Typy plików | | --------------- | ------------------------------------------------------------------ | | 50 MB | `.csv`, `.docx`, `.htm`, `.html`, `.pdf`, `.pptx`, `.xls`, `.xlsx` | | 20 MB | `.json`, `.xml` | | 15 MB | `.gif`, `.jpeg`, `.jpg`, `.png`, `.svg`, `.webp` | | 10 MB | `.md`, `.txt` | | 5 MB | `.js`, `.jsx`, `.py`, `.sql`, `.ts`, `.tsx` |