2026-03-22 — Переработка scan modal и доработки guidance

Два дня после релиза оркестратора были сфокусированы на поверхностях, с которыми операторы взаимодействуют чаще всего при настройке: обнаружение Bluetooth, guidance onboarding и отправка bug report. Десять RC-релизов по два стабильных тега доводили эти workflow до состояния, когда они ощущались как цельные, а не приклеенные сбоку.

Что было сделано

Scan modal был пересобран с нуля. Операторы теперь выбирают, каким Bluetooth-адаптером сканировать, включают явный фильтр только аудиоустройств и запускают повторное сканирование, не закрывая диалог. На системах с несколькими адаптерами — типичная HAOS-конфигурация с отдельными контроллерами hci0/hci1 — это устранило гадание, какой адаптер обнаруживает какое устройство.

Результаты сканирования остаются согласованными с выбранной областью обнаружения, а не-аудио Bluetooth-кандидаты честно показываются, когда фильтр только аудио отключён. Текст в modal теперь объясняет реальный операторский workflow вместо показа сырого вывода bluetoothctl.

Onboarding распознаёт установки с полностью отпущенными устройствами

Тонкий, но важный edge case: когда каждая настроенная колонка была вручную отпущена (передана другому bridge или освобождена для другого использования), система onboarding теперь обнаруживает это состояние и предлагает прямые действия по reclaim. Операторы могут возобновить воспроизведение, не копаясь в экранах конфигурации, чтобы выяснить, почему ничего не играет.

Auto-description bug report из диагностики

Диалог bug report теперь предзаполняет редактируемое описание, сгенерированное из прикреплённой диагностики. Оно суммирует недавние ошибки, состояние Bluetooth и устройств, статус daemon и подключение Music Assistant. Это означает, что issue report’ы начинаются с полезного контекста вместо пустого текстового поля, а операторы могут отредактировать или дополнить сгенерированное summary перед отправкой.

Разделение статуса и раскрытия guidance

Система onboarding guidance получила значительный UX-пересмотр. В шапке теперь отображается пассивный badge статуса настройки — всегда видимый, никогда не навязчивый. Видимость чеклиста управляется отдельно через явный переключатель Show checklist / Hide checklist. В свёрнутом виде summary-состояние отображается в стеке notice вместо того, чтобы чеклист полностью исчезал.

Это разделение важно, потому что предыдущий дизайн смешивал «настройка не завершена» (статус) с «покажи мне, что делать» (действие пользователя). Операторы, которые знали, что их настройка неполная, но не хотели держать чеклист открытым, были вынуждены повторно его закрывать.

Волна согласованности компактного UI

Компактная дизайн-система, введённая в 2.42.1, была расширена на экран логина, поверхности Bluetooth discovery, управление запаренными устройствами и badge’и результатов сканирования. Spacing, типографика, focus ring’и и action-меню теперь следуют общему дизайн-языку по всему интерфейсу.

Повторный вход в конфигурацию Music Assistant

Flow конфигурации MA стал проще для повторного входа после начальной настройки. Карточка статуса подключения теперь владеет действием Reconfigure, а секция sign-in/token остаётся скрытой, пока переконфигурация не запрошена явно. Это предотвратило случайную инвалидацию токена операторами, которые открывали настройки MA только для проверки статуса.

Фиксы аутентификации Home Assistant

Вошли два фикса auth-пути: HA login failures при обращении к Music Assistant теперь возвращают реальную причину bootstrap со стороны MA, когда HA OAuth недоступен, а standalone HA login к MA add-on’ам снова завершается после TOTP через fallback на прямой HA login flow и разрешение MA ingress через Supervisor API.

Почему это важно

v2.42.2 и v2.42.3 — это refinement-релизы, но они адресовали точки трения, на которые новые операторы натыкаются чаще всего: сканирование колонок, понимание состояния настройки и отправка bug report’ов. Одна только переработка scan modal устранила самый частый вопрос поддержки на multi-adapter HAOS-установках.

Что дальше

С стабилизацией discovery и onboarding следующая волна переместилась к метаданным комнат, интеграции с HA area registry и контрактам готовности к передаче, которые сделают multi-room handoff’ы практичными.