Documentazione in versione beta. Alcuni testi e immagini verranno rielaborati man mano che l'app si installa nella versione 1.0. Se una sezione risulta obsoleta, segnalala tramite il file modulo di feedback.

Pacchetti di supporto

Un bundle di supporto è un singolo ZIP che racchiude lo stato del bridge nel momento in cui qualcosa è andato storto. È l'unico artefatto che chiederemo durante la valutazione di un ticket. Questa pagina descrive esattamente cosa c'è in uno, quindi sai cosa stai inviando.

Come esportarne uno

  1. Apri FFB-Bridge e vai a Diagnostica.
  2. Fare clic Pacchetto di supporto per l'esportazione (in alto a destra).
  3. Dopo un breve ritardo, un banner mostra il nome e la dimensione del file, con Rivela e Apri il modulo di feedback pulsanti.
  4. Fare clic Apri il modulo di feedback — la pagina di feedback si apre con il pacchetto già allegato.
Pagina Diagnostica FFB-Bridge dopo l'esportazione di un pacchetto di supporto, che mostra il banner dei risultati con le azioni Reveal e Open-feedback-form
Figure 1. Export flow: Diagnostics page button, then the banner with filename and Reveal / Open feedback form actions.

Cosa c'è nel pacchetto

Un bundle è un semplice ZIP. I nomi dei file riportati di seguito rappresentano l'elenco completo dei consentiti: il pacchetto lo farà mai contenere qualcosa al di fuori di questo insieme.

sysinfo.txt

Metadati di sistema. Testo semplice, righe chiave:valore. Campi:

  • os — “windows” or “linux”.
  • os-version — kernel version or Windows build string.
  • distro — on Linux, /etc/os-release PRETTY_NAME.
  • cpu-model, cpu-cores — from /proc/cpuinfo or Win32_Processor.
  • ram-total-mb — from /proc/meminfo or Win32_ComputerSystem.
  • dotnet-version — runtime version of the bundled .NET.
  • platform — explicit key for the Linux-vs-Windows branch.
  • locale — current user locale.
  • bridge-version, build-hash — bridge version and git SHA at build time.

sessione.log

Registro eventi completo per la sessione corrente. Stesso contenuto della striscia di registro della pagina Diagnostica, ma include tutto dal lancio, non solo ciò che è visibile. UTF-8.

last-crash.log

Se il lancio precedente si è bloccato, il registro degli arresti anomali viene visualizzato qui. Analisi dello stack, dump dei thread, le ultime righe di registro prima dell'arresto anomalo. Assente se la sessione non si è bloccata.

dottore.json

Scansione della pagina Doctor più recente in formato leggibile dalla macchina. Ogni riga riporta il nome del controllo, lo stato (superato/avviso/fallito/n/a) e la stringa dei dettagli grezzi. Questo ci consente di vedere il tuo stato di Dottore senza che tu debba incollare screenshot.

sintonizzabili.yaml

I valori del profilo di ottimizzazione attivo al momento dell'esportazione. Stesso schema di un profilo salvato. Utilizzato per riprodurre l'esatta configurazione della forza con cui stavi volando.

simconnect-config.xml

MSFS's SimConnect.xml if the bridge could read one, with any <Password> entries stripped. Absent if you were on X-Plane or Mock at export time.

Cosa NON c'è nel pacchetto

Il generatore di pacchetti di supporto utilizza un rigoroso elenco di nomi di file consentiti. Non includerà nulla al di fuori di tale elenco, anche se nella stessa directory è presente qualcosa di corrispondente. In particolare:

  • Nessuna password o credenziale salvata. Il ponte non ne immagazzina.
  • Nessun file di profilo altro che quello attivo.
  • Nessun registro di sistema, diario o altro al di fuori delle directory dei dati del bridge.
  • Nessun pacchetto di rete acquisito.
  • Nessun token cloud (il bridge non ne utilizza).

Elaborazione lato server

Quando alleghi un pacchetto a un rapporto di feedback, l'operatore di assunzione del sito lo analizza per estrarre dati indicizzabili utili nel nostro database:

  • Informazioni di sistema in una riga di riepilogo per il raggruppamento ("quanti rapporti da questa distribuzione?").
  • Righe di avviso ed errore dal registro, con firme di errore stabili, così possiamo vedere a colpo d'occhio quante persone hanno riscontrato lo stesso bug.
  • Risultati del controllo medico per un'analisi dettagliata di ciò che non funziona nella base utenti.
  • Il testo letterale del file di ogni voce consentita, archiviato in modo da poter rileggere il contesto durante la valutazione.

Il bundle grezzo stesso viene conservato per un breve periodo (30 giorni per impostazione predefinita) in modo da poterlo rieseguire se la nostra logica di estrazione migliora. Successivamente, i dati analizzati vengono conservati; il blob grezzo viene eliminato.

Limiti

LimiteValore
Dimensione totale del pacchetto50 MB compressi
Dimensioni non compresse per voce5 MB
Numero massimo di iscrizioni30
Totale non compresso20 MB
CodificaSolo file di testo UTF-8 (più XML)

In pratica un bundle normale è sotto il megabyte. Questi limiti esistono per escludere caricamenti ostili, non per escludere segnalazioni reali.

Invio senza modulo di feedback

If you'd rather email the bundle directly, write to 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.