Documentação em beta. Alguns textos e imagens serão retrabalhados à medida que o aplicativo se adapta à versão 1.0. Se uma seção estiver obsoleta, sinalize-a através do formulário de comentários.

Pacotes de suporte

Um pacote de suporte é um único ZIP que empacota o estado da ponte no momento em que algo deu errado. É o único artefato que solicitaremos ao fazer a triagem de um ticket. Esta página descreve exatamente o que há em um, para que você saiba o que está enviando.

Como exportar um

  1. Abra o FFB-Bridge e navegue até Diagnóstico.
  2. Clique Exportar pacote de suporte (canto superior direito).
  3. Após um breve atraso, um banner mostra o nome e o tamanho do arquivo, com Revelar e Abrir formulário de feedback botões.
  4. Clique Abrir formulário de feedback — a página de feedback é aberta com seu pacote pré-anexado.
Página FFB-Bridge Diagnostics após exportar um pacote de suporte, mostrando o banner de resultado com ações Revelar e Abrir formulário de feedback
Figure 1. Export flow: Diagnostics page button, then the banner with filename and Reveal / Open feedback form actions.

O que há no pacote

Um pacote é um ZIP simples. Os nomes de arquivos abaixo são a lista completa de permissões - o pacote será nunca contém qualquer coisa fora deste conjunto.

sysinfo.txt

Metadados do sistema. Texto simples, linhas chave:valor. Campos:

  • 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.

sessão.log

Log de eventos completo da sessão atual. O mesmo conteúdo da faixa de log da página Diagnóstico, mas incluindo tudo desde o lançamento, não apenas o que está visível. UTF-8.

last-crash.log

Se a inicialização anterior travou, o log de travamento chega aqui. Rastreamento de pilha, dumps de thread, as últimas linhas de log antes da falha. Ausente se a sessão não travou.

médico.json

Digitalização mais recente da página do médico em formato legível por máquina. Cada linha carrega o nome da verificação, o status (aprovado/aviso/falha/n/a) e a sequência de detalhes brutos. Isso nos permite ver o estado do seu médico sem que você precise colar capturas de tela.

sintonizáveis.yaml

Os valores do perfil de ajuste ativo no momento da exportação. Mesmo esquema de um perfil salvo. Usado para reproduzir a configuração exata da força que você estava voando.

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.

O que NÃO está no pacote

O construtor do pacote de suporte usa uma lista restrita de nomes de arquivos. Não incluirá nada fora dessa lista, mesmo que algo correspondente esteja presente no mesmo diretório. Em particular:

  • Nenhuma senha ou credencial salva. A ponte não armazena nenhum.
  • Nenhum arquivo de perfil além de o ativo.
  • Nenhum registro do sistema, diário ou qualquer coisa fora dos diretórios de dados da própria ponte.
  • Nenhuma captura de pacotes de rede.
  • Sem tokens de nuvem (a ponte não usa nenhum).

Processamento do lado do servidor

Quando você anexa um pacote a um relatório de feedback, o responsável pelo registro do site o analisa para extrair dados indexáveis úteis em nosso banco de dados:

  • Informações do sistema em uma linha de resumo para agrupamento (“quantos relatórios desta distribuição?”).
  • Linhas de aviso e erro do log, com assinaturas de erro estáveis, para que possamos ver rapidamente quantas pessoas encontraram o mesmo bug.
  • Os resultados da verificação médica são detalhados sobre o que está falhando na base de usuários.
  • O texto literal do arquivo de cada entrada na lista de permissões, armazenado para que possamos reler o contexto durante a triagem.

O pacote bruto em si é retido por um curto período (30 dias por padrão) para que possamos analisar novamente se nossa lógica de extração melhorar. Depois disso, os dados analisados ​​são mantidos; a bolha bruta é descartada.

Limites

LimiteValor
Tamanho total do pacote50 MB compactados
Tamanho não compactado por entrada5MB
Máximo de entradas30
Total descompactado20MB
CodificaçãoSomente arquivos de texto UTF-8 (mais o XML)

Na prática, um pacote normal tem menos de um megabyte. Esses limites existem para descartar uploads hostis, não para descartar relatórios reais.

Enviando sem o formulário de 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.