Pakiety diagnostyczne

Pakiet diagnostyczny to pojedynczy plik ZIP, który utrwala stan mostu w chwili, gdy coś poszło nie tak. To jedyny materiał, o który poprosimy przy analizie zgłoszenia. Ta strona dokładnie opisuje jego zawartość, żeby było jasne, co wysyłasz.

Jak wyeksportować pakiet

1. Otwórz FFB-Bridge i przejdź na stronę Wsparcie (pasek boczny), a następnie na kartę Diagnostyka tej strony.
2. Kliknij Pakiet diagnostyczny (w prawym górnym rogu karty „Diagnostyka”).
3. Po chwili pojawia się baner z nazwą i rozmiarem pliku, linkiem do formularza opinii oraz — jeśli jest dostępny — przyciskiem Pokaż plik.
4. Otwórz formularz opinii i dołącz plik ZIP, jeśli chcesz go wysłać.

Wyślij zgłoszenie z aplikacji

Wybierz „Zgłoś problem” na pasku bocznym. Po potwierdzeniu Bridge tworzy pakiet diagnostyczny i wysyła go bezpośrednio, a postęp jest widoczny w aplikacji; opcja „Pomiń potwierdzenie następnym razem” dotyczy kolejnych zgłoszeń. Podczas przesyłania wpisz opis, a następnie wybierz „Wyślij szczegóły”, aby dołączyć go do tego samego zgłoszenia. Jeśli przesyłanie lub wysłanie szczegółów się nie powiedzie, twój tekst zostaje zachowany do ponownej próby; „Nowe zgłoszenie” zbiera świeże dane diagnostyczne, a przycisk „Pakiet diagnostyczny” w sekcji Wsparcie → Diagnostyka nadal zapisuje lokalny plik ZIP, niczego nie wysyłając.

Adres e-mail jest opcjonalny, ale bez niego wsparcie nie może odpowiedzieć. Opcja „Zapamiętaj adres e-mail na tym komputerze” jest domyślnie wyłączona; po jej zaznaczeniu twój adres jest automatycznie wpisywany w kolejnych zgłoszeniach, a jej odznaczenie usuwa zapisany adres. Zapamiętany adres nigdy nie jest dołączany do pakietu diagnostycznego. Zgłoszenia wysłane z aplikacji są przetwarzane tak samo jak pakiety dołączone do zgłoszenia przez formularz opinii, zgodnie z opisem poniżej.

Po awarii okno przy uruchomieniu może otworzyć formularz „Zgłoś problem” z dołączoną awarią. Sprawdź zgłoszenie i potwierdzenie wysłania diagnostyki; możesz też wyeksportować pakiet lokalnie, jeśli wolisz go zapisać lub wysyłanie się nie powiedzie.

Co zawiera pakiet

Pakiet to zwykły plik ZIP. Poniższe nazwy plików stanowią pełną listę dozwolonych plików — pakiet nigdy nie będzie zawierał niczego spoza tego zestawu.

sysinfo.txt

Metadane systemu. Zwykły tekst, wiersze w formacie klucz:wartość. Pola:

• os-name — „Windows”, „Linux” lub „macOS”.
• os-version — wersja jądra, numer kompilacji systemu Windows lub wersja macOS.
• distro — w systemie Linux, /etc/os-release PRETTY_NAME.
• cpu-model, cpu-cores — z /proc/cpuinfo lub Win32_Processor.
• ram-total-mb — z /proc/meminfo lub Win32_ComputerSystem.
• dotnet-version — wersja środowiska działania dołączonej platformy .NET.
• platform — jawny klucz rozróżniający gałąź Linux / Windows.
• locale — bieżące ustawienia regionalne użytkownika.
• bridge-version, build-hash — wersja mostu i SHA commita git z chwili kompilacji.

session.log

Pełny dziennik zdarzeń bieżącej sesji. Zawiera ten sam typ zdarzeń co pasek dziennika na karcie „Diagnostyka” i obejmuje każdy wpis od uruchomienia, również wpisy spoza widocznego okna. UTF-8.

last-crash.log

Jeśli poprzednie uruchomienie zakończyło się awarią, trafia tutaj dziennik awarii. Ślad stosu, zrzuty wątków, kilka ostatnich wierszy dziennika przed awarią. Plik nie występuje, jeśli sesja nie uległa awarii.

previous-session.log

Dziennik po rotacji z uruchomienia poprzedzającego bieżące, jeśli istnieje. Po zgłoszeniu awarii z ponownym uruchomieniem to często właśnie ten plik pokazuje, co działo się przed ponownym uruchomieniem.

doctor.json

Wynik ostatniego skanowania na karcie „Kontrole stanu” strony „Wsparcie” w formie czytelnej maszynowo. Każdy wiersz zawiera nazwę kontroli, status (pass / info / warn / fail / ready / checking / n/a) i surowy tekst szczegółów. Dzięki temu widzimy stan kontroli bez potrzeby wklejania przez ciebie zrzutów ekranu. Plik nosi nazwę doctor.json z przyczyn historycznych — strona „Wsparcie” nazywała się kiedyś Doctor.

tunables.json

Wartości aktywnego profilu strojenia w chwili eksportu. Ten sam schemat co w zapisanym profilu. Służą do odtworzenia dokładnej konfiguracji sił, z którą odbywał się lot.

hardware-settings.json

— wybór fizycznego urządzenia i mechanizmu renderowania, górny limit bezpieczeństwa, kalibracja i polaryzacja sił, jawne przypisania elementów sterujących oraz ustawienia zgodności z chwili eksportu.

aircraft-profiles.json

Plik powiązań statków powietrznych z profilami, dołączany bez zmian, jeśli istnieje. Określa, który zapisany profil jest automatycznie stosowany dla każdego statku powietrznego, dzięki czemu wsparcie widzi, dlaczego wybrano dany profil.

profiles-index.txt

Indeks zapisanych profili z chwili eksportu: nazwa pliku, rozmiar, czas modyfikacji oraz tytuł, identyfikator i rewizja każdego profilu. Sama zawartość profili pozostaje na twoim komputerze.

simconnect.txt

Należący do MSFS plik SimConnect.xml — o ile most zdołał go odczytać — z zanonimizowanymi adresami IP innymi niż localhost. Jeśli pliku nie znaleziono, ten plik podaje to wprost, zamiast zgadywać.

Dodatki zależne od platformy

Pakiety z systemu Windows zawierają hid-devices.txt do dopasowania rekordów urządzeń Plug and Play. Pakiety z systemu Linux zawierają usb.txt, evdev.txt, udev.txt, a także dmesg.txt jako kontekst stosu USB/wejścia. Każdy pakiet zawiera też README.txt z podsumowaniem zawartości i informacją o prywatności.

Czego NIE ma w pakiecie

Mechanizm tworzenia pakietów diagnostycznych korzysta ze ścisłej listy dozwolonych nazw plików. Nie dołączy niczego spoza tej listy, nawet jeśli w tym samym katalogu znajduje się coś pasującego. W szczególności:

• Pliki magazynów poświadczeń są wykluczone, w tym zapisane poświadczenia dostępu do AirframeDB.
• Brak plików profili innych niż aktywny.
• Brak zbierania dowolnych katalogów. Jawne kontrole platformy mogą obejmować szczegóły USB/urządzeń wejściowych oraz przefiltrowane komunikaty jądra Linux.
• Brak przechwyconych pakietów sieciowych.
• Dozwolone wpisy pakietu nie zawierają tokena dostępu AirframeDB ani poświadczeń instalacji.

Przetwarzanie po stronie serwera

Gdy dołączysz pakiet do zgłoszenia w formularzu opinii, proces przyjmujący zgłoszenia w serwisie analizuje go i wyodrębnia do naszej bazy danych przydatne dane nadające się do indeksowania:

• Informacje o systemie — do wiersza podsumowania służącego do grupowania („ile zgłoszeń pochodzi z tej dystrybucji?”).
• Wiersze ostrzeżeń i błędów z dziennika wraz ze stabilnymi sygnaturami błędów, dzięki czemu od razu widzimy, ile osób trafiło na ten sam błąd.
• Wyniki kontroli stanu, pozwalające zestawić, co zawodzi w całej bazie użytkowników.
• Dosłowna treść każdego pliku z listy dozwolonych, przechowywana, abyśmy podczas wstępnej analizy zgłoszeń mogli ponownie sprawdzić kontekst.

Sam surowy pakiet jest przechowywany przez krótki czas (domyślnie 30 dni), abyśmy mogli przetworzyć go ponownie, jeśli ulepszymy logikę wyodrębniania danych. Potem zachowywane są przetworzone dane, a surowy plik jest usuwany.

Limity

W praktyce typowy pakiet ma mniej niż megabajt. Te limity blokują złośliwe przesyłki, a jednocześnie zostawiają dużo miejsca na prawdziwe zgłoszenia.

Wysyłanie bez formularza opinii

Jeśli wolisz wysłać pakiet bezpośrednio e-mailem, napisz na adres feedback·ffb-bridge.com (replace the · with an @) and attach the ZIP. The server-side parser doesn't run for email, so the triage is slower — but the bundle is just as usable.

Plik hardware-settings.json zawiera też, jeśli są dostępne, ograniczone zapisy ostatnich danych o siłach, autopilocie i bezpieczeństwie ruchu. Dołącz pakiet z sesji, której dotyczy problem, podaj statek powietrzny i wersję symulatora, model i firmware urządzenia oraz czynność, która wywołała problem. Wyeksportuj pakiet przed wyczyszczeniem dzienników lub zmianą kilku ustawień.