Пакеты поддержки

Пакет поддержки — это один ZIP-архив, в котором сохраняется состояние FFB-Bridge на момент возникновения проблемы. Это единственный файл, который мы попросим прислать при разборе обращения. На этой странице точно описано, что в него входит, чтобы вы знали, что отправляете.

Как экспортировать пакет

1. Откройте FFB-Bridge и перейдите на страницу Поддержка (боковая панель), затем на вкладку Диагностика этой страницы.
2. Нажмите Пакет поддержки (в правом верхнем углу карточки «Диагностика»).
3. Через некоторое время появится баннер с именем и размером файла, ссылкой на форму обратной связи и, если доступно, кнопкой Показать файл.
4. Откройте форму обратной связи и приложите ZIP-архив, если хотите его отправить.

Отправка отчета из приложения

Выберите «Сообщить о проблеме» на боковой панели. После подтверждения FFB-Bridge создает диагностический пакет и сразу отправляет его, показывая ход выполнения в приложении; параметр «Пропустить подтверждение в следующий раз» действует для последующих отчетов. Пока идет отправка, введите описание, а затем нажмите «Отправить описание», чтобы добавить его к тому же отчету. Если отправка пакета или описания не удалась, ваш текст сохраняется для повторной попытки; «Новый отчет» собирает свежие диагностические данные, а кнопка «Пакет поддержки» в разделе «Поддержка → Диагностика» по-прежнему сохраняет локальный ZIP-архив, ничего не отправляя.

Адрес электронной почты указывать необязательно, но без него служба поддержки не сможет ответить. Параметр «Запомнить адрес на этом компьютере» по умолчанию выключен; если его включить, ваш адрес будет подставляться в будущие отчеты, а если снять флажок, сохраненный адрес будет удален. Запомненный адрес никогда не включается в диагностический пакет. Отчеты, отправленные из приложения, обрабатываются так же, как пакеты, приложенные к отзыву, — см. описание ниже.

После сбоя окно при запуске может открыть встроенную форму «Сообщить о проблеме» с данными сбоя. Проверьте сообщение и подтверждение загрузки диагностики; локальный экспорт доступен, если вы хотите сохранить пакет или загрузка не удалась.

Что входит в пакет

Пакет — это обычный ZIP-архив. Приведенные ниже имена файлов составляют полный список разрешенных — пакет никогда не будет содержать ничего за пределами этого набора.

sysinfo.txt

Метаданные системы. Обычный текст, строки вида ключ:значение. Поля:

• os-name — «Windows», «Linux» или «macOS».
• os-version — версия ядра, строка сборки Windows или версия macOS.
• distro — в Linux, из /etc/os-release PRETTY_NAME.
• cpu-model, cpu-cores — из /proc/cpuinfo или Win32_Processor.
• ram-total-mb — из /proc/meminfo или Win32_ComputerSystem.
• dotnet-version — версия среды выполнения встроенного .NET.
• platform — явный ключ для ветвления Linux / Windows.
• locale — текущая локаль пользователя.
• bridge-version, build-hash — версия FFB-Bridge и git SHA на момент сборки.

session.log

Полный журнал событий текущего сеанса. Он содержит события того же типа, что и полоса журнала на вкладке «Диагностика», и включает все записи с момента запуска, в том числе вышедшие за пределы видимого окна. UTF-8.

last-crash.log

Если предыдущий запуск завершился сбоем, сюда попадает журнал сбоя: трассировка стека, дампы потоков и несколько последних строк журнала перед сбоем. Отсутствует, если сеанс не завершался сбоем.

previous-session.log

Ротированный журнал предыдущего запуска, если он есть. После отчета о сбое с последующим перезапуском именно этот файл часто показывает, что произошло до перезапуска.

doctor.json

Результаты последнего сканирования на вкладке «Проверки состояния» в разделе «Поддержка» в машиночитаемом виде. Каждая строка содержит название проверки, статус (pass / info / warn / fail / ready / checking / n/a) и исходную строку с подробностями. Так мы видим состояние ваших проверок, и вам не нужно вставлять снимки экрана. Файл называется doctor.json по историческим причинам — раньше страница «Поддержка» называлась Doctor.

tunables.json

Значения активного профиля настройки на момент экспорта. Та же схема, что и у сохраненного профиля. Используется, чтобы воспроизвести точную конфигурацию усилий, с которой вы летали.

hardware-settings.json

— выбор физического устройства и способ воспроизведения, защитный предел, калибровка и полярность усилия, явные назначения органов управления и параметры совместимости на момент экспорта.

aircraft-profiles.json

Файл привязок профилей к воздушным судам; включается без изменений, если существует. В нем записано, какой сохраненный профиль автоматически применяется для каждого воздушного судна, чтобы поддержка могла понять, почему был выбран тот или иной профиль.

profiles-index.txt

Список сохраненных профилей на момент экспорта: имя файла, размер, время изменения, а также название, ID и ревизия каждого профиля. Само содержимое профилей остается на вашем компьютере.

simconnect.txt

Файл MSFS SimConnect.xml (если FFB-Bridge удалось его прочитать); IP-адреса, кроме localhost, в нем скрыты. Если файл не найден, в пакете об этом прямо сказано — без догадок.

Дополнительные файлы платформы

Пакеты для Windows включают hid-devices.txt для сопоставления записей устройств Plug and Play. Пакеты для Linux содержат usb.txt, evdev.txt, udev.txt, а также dmesg.txt для контекста стека USB / ввода. Каждый пакет также содержит README.txt со сводкой содержимого и примечанием о конфиденциальности.

Что НЕ входит в пакет

Сборщик пакета поддержки использует строгий список разрешенных имен файлов. Он не включит ничего, что не входит в этот список, даже если в том же каталоге есть похожие файлы. В частности:

• Файлы хранилищ учетных данных исключены, в том числе сохраненные учетные данные для доступа к AirframeDB.
• Никаких файлов профилей, кроме активного.
• Никакого сбора произвольных каталогов. Явные проверки платформы могут включать сведения о USB и устройствах ввода, а также отфильтрованные сообщения ядра Linux.
• Никаких перехватов сетевых пакетов.
• В разрешенные файлы пакета не входят ни токен доступа AirframeDB, ни учетные данные установки.

Обработка на сервере

Когда вы прикладываете пакет к отзыву, служба приема на сайте разбирает его и извлекает в нашу базу данных полезные индексируемые данные:

• Сведения о системе — в сводную строку для группировки («сколько отчетов пришло с этого дистрибутива?»).
• Строки предупреждений и ошибок из журнала со стабильными сигнатурами ошибок, чтобы мы сразу видели, сколько людей столкнулись с одной и той же ошибкой.
• Результаты проверок состояния — чтобы видеть, что именно не работает у пользователей в целом.
• Дословный текст каждого разрешенного файла, который сохраняется, чтобы при разборе обращения мы могли заново прочитать контекст.

Сам исходный пакет хранится недолго (по умолчанию 30 дней), чтобы мы могли разобрать его повторно, если улучшится наша логика извлечения. После этого разобранные данные сохраняются, а исходный архив удаляется.

Ограничения

На практике обычный пакет занимает меньше мегабайта. Эти ограничения блокируют вредоносные загрузки, оставляя достаточно места для настоящих отчетов.

Отправка без формы обратной связи

Если вы предпочитаете отправить пакет напрямую по электронной почте, напишите на 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.

Файл hardware-settings.json также содержит ограниченные по объему недавние данные об усилиях, автопилоте и защитной остановке по движению, если они доступны. Приложите пакет поддержки из сеанса, в котором возникла проблема, и укажите воздушное судно и версию симулятора, модель и прошивку устройства, а также действие, которое вызвало проблему. Экспортируйте пакет до очистки журналов или изменения нескольких параметров.