Просмотр blackbox-логов

⚗️ Экспериментально · предальфа. Экран показывает то, что уже
декодировано из вашего лога, и ничего не выдумывает: сигнал, которого в
логе нет (например датчика тока), честно объявляется отсутствующим, а не
подставляется нулём.

Инструмент /tools/blackbox открывает blackbox-лог полёта (файл .bbl,
записанный INAV) двумя способами: как ленту событий прошивки (armed, смена
режима, failsafe, disarm, конец записи) и как графики телеметрии с общим
курсором. Это чтение уже загруженного файла — сам разбор лога и хранение
происходят при загрузке трека полёта в Ангар, здесь только просмотр.

Как открыть

• Из карточки события — если к событию привязан blackbox-лог, на его
  странице есть кнопка «Открыть в просмотрщике blackbox».
• Из раздела «Инструменты» — /tools/blackbox без параметров открывает
  список ваших blackbox-логов по всем бортам, включая архивные: лог
  разбившегося борта — типовой предмет разбора, поэтому архивация борта его
  не прячет.

Чужой или несуществующий лог — при прямом переходе по ссылке — экран
отдаёт как «не найдено», не раскрывая, существует он вообще или нет.

Лента событий — первым экраном

Сразу под шапкой лога стоит лента событий прошивки, а не графики: разбор
обычно начинается с поиска МОМЕНТА (когда сработал failsafe, когда сменился
режим), а уже потом смотрят, что происходило вокруг него. Клик по событию в
ленте переносит курсор графиков на этот момент.

Показываются: старт записи (arm), disarm, смена режима полёта, конец лога,
возобновление записи, ошибка IMU, sync-beep и переходы фазы failsafe. Если
фаза failsafe за короткий промежуток менялась несколько раз, лента не
дробит это на отдельные строки, а показывает одну запись с интервалом
времени («0,90–1,90 с»), внутри которого произошли эти переходы: показывать
точный момент там, где известна только его нижняя и верхняя граница, было
бы неточностью, поданной как точность.

Если переходы failsafe не удалось загрузить (например разорвалась связь),
над лентой появляется отдельная пометка — событий прошивки при этом
по-прежнему видно, а не «как будто failsafe не было».

Графики телеметрии

Кривые ключуются пресетами:

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

Непрерывный сигнал рисуется лентой минимум…максимум с линией среднего
(выброс в один отсчёт остаётся виден даже при масштабе в минуты записи);
дискретный (режимы, флаги) — ступенькой по фактическим значениям, без
интерполяции между ними.

Масштаб и курсор

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

Курсор общий для всех графиков и для ленты событий: подведите его к точке
на любом графике (или кликните по записи в ленте) — под графиками
появляются момент времени и значение каждой построенной кривой в эту
секунду.

Несколько полётов в одном файле

Один файл лога может содержать несколько сессий (несколько полётов подряд
без перезаписи карты). Если сессий больше одной, над графиками появляется
переключатель сессии — выбор пересобирает и ленту событий, и графики под
выбранный полёт.

Частичный разбор

Очень длинные записи (десятки минут на высокой частоте) разбираются не
целиком — есть бюджет на объём обрабатываемых данных. Если разбор
остановился на этом бюджете, экран честно говорит, какой участок записи
показан, и отдельно уточняет: сам файл лога при этом цел — ограничение
наше, не повреждение. Если часть кадров лога не читается (файл повреждён
или обрезан), это отдельная новость, и обе новости показываются вместе,
если применимы обе, — «уложились в бюджет» и «часть кадров повреждена» не
исключают друг друга, и одна не гасит другую.

Если в файле больше полётов (сессий), чем мы разбираем, отдельная строка
так и говорит: «показаны не все полёты этого файла».

Приватность

Разбор лога выполняется на сервере (файл уже загружен как трек полёта в
Ангар), а сам просмотрщик — обычная страница, читающая уже готовый разбор
через API; сторонних сервисов при просмотре не задействуется.

Для агента (MCP)

Отдельного MCP-инструмента для просмотра blackbox-логов пока нет — это не
CRUD над сущностью и не готовый ответ на осмысленный вопрос агента о логе,
поэтому заводить инструмент только ради выдачи «сырых» рядов для графика
было бы копированием представления экрана, а не помощью агенту.