added adaptive quickshell

This commit is contained in:
wt committed 2026-11-17 18:15:16 +07:00
1 parent 6eb56d2065
commit 5b33a73fd8
189 files changed
+8678 -15

No files matched your search

File diff suppressed because it is too large. Load diff
+403
View File
@@ -0,0 +1,403 @@
# Adaptive Shell: состояние реализации
Desktop-этап реализации задания из `docs/prompt/hyprland_quickshell_adaptive_shell.md`.
Проверено 17 ноября 2026 на Quickshell 0.3.2, Qt 6.12 и работающей Wayland-сессии Hyprland.
Это ещё не завершённая конвергентная оболочка по всем критериям мастер-промпта.
## Реализовано
- `quickshell/shell.qml`: один процесс, общий набор сервисов, IPC для открытия экранов.
- Панель на каждом выходе, рабочие пространства, заголовок активного окна, часы,
системный трей и реальные аккумуляторы через UPower; доступ к аудиоустройствам,
состоянию/заглушению микрофона и меню питания. IPC открывает панели на мониторе
с фокусом Hyprland; физическая проверка нескольких мониторов ещё предстоит.
- Launcher: XDG DesktopEntries, фильтрация, сетка, клавиатурная навигация,
выполнение через DesktopEntry.execute(), без исполнения поисковой строки.
Избранное сохраняется по Desktop Entry ID, история ограничена 50 записями;
в выдаче сначала избранное, затем последние запуски, затем алфавит.
Кнопка ★ и Пробел на выбранном приложении переключают закрепление.
- Desktop Settings — отдельное управляемое окно с изменяемым размером, боковой
навигацией и компактным переключателем разделов при узком окне. Повторный вызов
открывает то же окно. Секция звука доступна также из панели и Quick Settings.
- Quick Settings: NetworkManager через Quickshell.Networking, отдельные интерфейсы,
Wi-Fi с учётом аппаратной блокировки; адаптеры BlueZ; PipeWire volume/mute,
микрофон; MPRIS. Для расширенного редактирования подключений и сопряжения
открываются nm-connection-editor и blueman-manager. Это временные внешние инструменты,
а не собственные страницы Settings. Выбор устройства ввода/вывода, mute и громкость
каждого устройства уже реализованы внутри Settings через PipeWire/WirePlumber.
Изменения устройств отслеживаются общей моделью без polling.
- Статические обои: отдельный Background-слой на каждом мониторе без захвата ввода
и резервирования рабочей области. Выбор через FileDialog/локальный путь, предпросмотр,
общий фон и отдельные настройки выходов, включая сохранённые отключённые мониторы.
При ошибке декодирования новый файл не подменяет последние загруженные обои.
Есть отключение слоя и возврат к общему фону; настройки переживают restart и QML reload.
Без выбора обоев фоновые поверхности не создаются. Hyprpaper пока сохранён для отката.
- Отдельная страница «Сеть»: каждый интерфейс отдельно, MAC, состояние управления,
Ethernet carrier/link speed, Wi-Fi сети/уровень сигнала/защита. Native connect для
сохранённых, открытых/OWE и PSK-сетей, подтверждение disconnect интерфейса,
ошибки/тайм-ауты и защита от повторного запроса. PSK-поле очищается при отправке,
закрытии страницы и успешном подключении; секреты не пишутся в preferences JSON.
Сканирование Wi-Fi включено только при активной странице с доступным radio.
- Отдельная Bluetooth-страница: адаптеры, реальные устройства/состояния,
включение/выключение radio, connect/disconnect и удаление сопряжения с подтверждением.
Discovery — явный поиск до минуты, прекращающийся при закрытии страницы;
helper удерживает собственную BlueZ discovery session. Ошибки возвращаются в UI.
Сопряжение с PIN/passkey пока выполняется через системный диалог Blueman.
- Settings: общая и индивидуальная для мониторов компоновка, light/dark/AMOLED,
ручное указание сенсорного режима, reduced motion и диагностика доступных backend.
- Настройки в `Quickshell.statePath("preferences.json")`: схема v1, проверка значений,
атомарная запись и наблюдение за внешними изменениями. Повреждённый или более новый
файл не перезаписывается; Settings показывает его путь. Хранение секретов отсутствует.
- Desktop/tablet/phone layout по логической ширине и ручной настройке touch;
нижняя кнопочная навигация в мобильных режимах. Автообнаружение touchscreen пока отсутствует.
- Recent: настоящие окна через Wayland ToplevelManager, переключение и закрытие.
Миниатюры не имитируются.
- Экспериментальный Notifications backend: получение, изображения, actions,
удаление, clear all, группировка по desktop entry/имени приложения, всплывающая карточка,
сохранённый DND без повторного показа старых всплывающих карточек, лимит 100 текущих уведомлений.
История на диске ограничена 100 записями, доступна после перезапуска, имеет отключение
и очистку; transient-уведомления не сохраняются и не появляются в центре.
Изображения и клиентские actions не записываются в историю. Архивные карточки
не восстанавливают мёртвые D-Bus-действия.
Тайм-ауты: клиентское положительное значение в миллисекундах, 0 — без автоистечения,
default — 3 с для low и 6 с для normal; critical требует явного закрытия.
Изменившаяся replacement-посылка перезапускает таймер и обновляет существующую запись.
Мягкий QML reload не дублирует историю и не воспроизводит старую всплывающую карточку.
По умолчанию выключен, SwayNC продолжает работать.
- Меню питания: доступность действий через logind, явное подтверждение выхода,
перезагрузки, выключения и сна; ожидание, ошибки backend и блокировка повторных запросов.
Перед сном backend ожидает compositor-confirmed lock через Hyprland lock-notify.
Settings использует то же меню вместо отдельной detached-команды блокировки.
- Опциональное подключение из существующего Lua startup; старые команды сохранены
как профиль по умолчанию. Установщик Settings entry не меняет сессию и пакеты.
Цвета основаны на фиксированной палитре Material 3; Dynamic Color, полная типографика
и полный набор Material-компонентов пока не реализованы. QtQuick Controls запускаются
со стилем Material через wrapper. Reduced motion сохранён в настройках; текущие экраны
не используют собственные анимации.
## Запуск и возврат
Из корня репозитория, внутри Wayland-сессии:
```sh
./hypr/bin/adaptive-shell start
```
Это предварительный запуск рядом с действующей панелью, без отключения Waybar/SwayNC.
В другом терминале:
```sh
./hypr/bin/adaptive-shell settings
./hypr/bin/adaptive-shell launcher
./hypr/bin/adaptive-shell recent
./hypr/bin/adaptive-shell stop
```
Wrapper для открытия страницы запускает процесс, если он отсутствует.
Для подключения вместо Waybar в **следующей сессии** запусти из TTY:
```sh
ADAPTIVE_SHELL=1 start-hyprland
```
Привязки Alt+D, XF86LaunchB, Alt+Shift+P и Alt+Z используют новую оболочку.
SwayNC остаётся сервером уведомлений, Hyprpaper — исходным/резервным фоном, SwayOSD — OSD.
При выборе обоев в Settings новый Background-слой Quickshell отображается поверх прежнего фона.
Hyprlock, Hypridle, lxpolkit, Clipse, Sherlock и пользовательские приложения сохраняются.
Переменная должна быть установлена при запуске композитора, а не только Quickshell.
Возврат: выйди из сессии и запусти `start-hyprland` без `ADAPTIVE_SHELL`.
При аварии оболочки внутри активного нового профиля можно вручную запустить `waybar`,
а приложения открывать из терминала; постоянные настройки Hyprland профилем не меняются.
Notifications backend пока остаётся экспериментальным: ещё нужны проверки приватности
при lock/suspend, inline replies, поведения нескольких одновременных всплывающих карточек
и безопасной миграции владельца D-Bus. SwayNC по умолчанию сохранён. В тесте эта переменная используется с отдельной
D-Bus-шиной. При включении в новом профиле startup не запускает SwayNC; уже запущенный
SwayNC автоматически не завершается. Не запускай два notification server на одной шине.
Установка команды и `.desktop` файла Settings (с резервными копиями существующих файлов):
```sh
python quickshell/install.py # показать пути
python quickshell/install.py --apply # записать launcher и desktop entry
```
Установщик не устанавливает пакеты, не создаёт автологин, не включает systemd services,
не запускает `install_scripts/install-arch.sh`. Конфигурация запускается прямо из репозитория,
поэтому перемещение репозитория требует повторной установки launcher.
## Проверки
```sh
QT_QPA_PLATFORM=offscreen /usr/lib/qt6/bin/qmltestrunner -input quickshell/tests -o -,txt
lua quickshell/tests/test_lua.lua 0 0
lua quickshell/tests/test_lua.lua 1 0
lua quickshell/tests/test_lua.lua 1 1
python quickshell/tests/smoke.py
python quickshell/tests/notifications.py
python quickshell/tests/wallpapers.py
python -m unittest discover -s quickshell/tests -p 'test_power_backend.py' -v
python quickshell/tests/power_controller.py
python quickshell/tests/network_controller.py
python -m unittest discover -s quickshell/tests -p 'test_bluetooth_backend.py' -v
python quickshell/tests/bluetooth_controller.py
```
QtTest: 27 успешных проверок, включая границы режимов, отбрасывание некорректной схемы,
ранжирование приложений, лимит/уникальность истории и избранное, notification timeout policy
и валидацию notification history, локальные file URL, наследование обоев и совместимость схемы.
Lua: проверены три комбинации старого/нового профиля и notifications без исполнения команд.
Wayland smoke: загрузка всех страниц, включая native audio, IPC, проверка Settings
в списке управляемых окон Hyprland, смена трёх режимов, темы, запись JSON,
подхват внешних настроек, защита повреждённого JSON от перезаписи и восстановление,
отправка уведомления на частной D-Bus-шине. Тест временно показывает панель и экраны,
не останавливает текущие компоненты, использует временное хранилище.
Python-тесты сами создают частную D-Bus-шину, даже при прямом запуске, и используют
временное хранилище. Lifecycle-тест требует PyGObject (`python-gobject` на Arch).
Он проверяет replacement, причины закрытия 1/2/3, ActionInvoked, DND, critical/transient,
группировку, сохранение/очистку/отключение истории, права каталога, QML reload,
перезапуск процесса и продолжение доставки при повреждённом файле истории.
Wallpaper-тест проверяет загрузку PNG с Unicode/пробелами/спецсимволами в пути,
настоящие Background-слои через Hyprland IPC, переопределение выхода, запрет удалённых URL,
сохранение прежнего изображения при отсутствующем файле, отключение слоя, наследование,
сохранение настройки отключённого выхода и восстановление после restart/QML reload.
Тест не останавливает Hyprpaper и в конце снимает свои фоновые поверхности.
Используй Qt 6 tools: `/usr/bin/qmllint` на этой машине относится к Qt 5.
Qt 6 qmllint сообщает предупреждения о метаданных Quickshell PanelWindow и динамических
моделях, а также о неквалифицированных обращениях в delegates; чистый lint пока не заявлен.
При runtime-проверке остаются предупреждения внешних SVG-иконок и Wayland text input.
BlueZ на этой машине не предоставляет доступный object manager; отсутствие контроллера
обработано, но реальное Bluetooth-сопряжение не проверено.
Изолированный headless Hyprland здесь не запускается: отсутствует `/dev/dri`,
Aquamarine сообщает `CBackend::create() failed`. Smoke проверен в существующей сессии.
## Следующие обязательные этапы
1. Полноценная дизайн-система: токены, шрифты, Material Symbols, Dynamic Color,
системная тема, motion, доступность и адаптивная навигация Settings.
2. Собственные расширенные страницы профилей сети/IP/DNS/VPN и pairing-agent Bluetooth, обработка
оставшихся ошибок/авторизации (базовая native страница сети уже реализована),
яркость, power profiles, модемы/SIM и расширенные состояния HardwareCapabilityService.
Сейчас отсутствие backend и отсутствие оборудования не везде различимы.
3. Уведомления: inline replies, privacy lock/suspend, очередь всплывающих карточек,
безопасное переключение владельца D-Bus и оставшиеся ограничения reload/replacement,
перечисленные ниже. Базовые history/grouping/timeout/close/action тесты уже реализованы.
4. Home Screen с папками, dock, drag-and-drop, избранным и сохранением состояния;
Desktop Actions и тесты всех полей Desktop Entry в launcher (история и избранное уже есть).
5. Глобальные touchscreen-жесты через проверенную интеграцию с композитором;
маршрутизация Back, удержание для Recent, safe areas, экранная клавиатура, landscape.
Нижние кнопки текущей реализации не считаются реализацией этих жестов.
6. Slideshow, видеообои, отдельные lock-screen обои и аппаратные проверки multi-output/hotplug
(статический Wallpaper engine с per-output настройками уже реализован);
расширенные страницы мониторов с подтверждением/откатом и политики композитора.
Глобальные gaps/borders нельзя менять независимо для мониторов без проверки API.
7. Безопасная блокировка ext-session-lock-v1, PAM/fprintd и аппаратная проверка.
До этого Hyprlock остаётся обязательным блокировщиком. Новый helper `lock-session`
не меняет обои/конфиг, но действующие lock bindings и idle-конфигурация не переписаны.
Сохранение Hyprlock не доказывает выполнение всех требований fail-closed/suspend.
8. Исправление существующей опечатки `brightnesctl` в Hypridle после проверки реального
пути конфигурации, единый lock entrypoint, проверка inhibitor перед suspend/resume.
9. Безопасные backup/import/export/reset/migrations, автоматический rollback,
обновлённые общие инструкции установки и окончательная миграция компонентов.
10. Mock-тесты hotplug и всех комбинаций оборудования, реальные multi-monitor,
touchscreen, ARM64/телефон, suspend/resume, fingerprint и замеры CPU/RAM/энергии.
До завершения этих этапов критерии готовности раздела 27 мастер-промпта не выполнены.
## Порядок дальнейшей разработки
Приоритет — завершить и стабилизировать desktop. Phone сохраняется как архитектурная
цель, но физические проверки телефона начнутся после desktop-этапа. Переключение
layout на desktop в smoke-тесте не считается проверкой phone, touchscreen или ARM64.
На текущем desktop обнаружены два устройства вывода и одно устройство ввода. Проверены
построение native audio UI и подписка на модель; автоматический тест не меняет громкость,
mute и выбранные устройства пользователя. Переключение/отключение физических устройств
и реальное Bluetooth-сопряжение остаются ручными проверками.
## История уведомлений и ограничения Quickshell
История хранится в `Quickshell.statePath("notification-history/notifications.json")`.
Подкаталог создаётся с правами `0700` через одноразовый вызов GNU `install`; периодического
опроса и постоянно работающего вспомогательного процесса нет. Это локальный JSON с текстом
уведомлений. Переключатель «Сохранять историю» позволяет прекратить запись и очистить её.
Повреждённый файл не перезаписывается автоматически: ошибка отображается в центре,
новые уведомления продолжают поступать. Для восстановления после остановки оболочки
перенеси повреждённый файл в резервную копию и запусти оболочку снова.
Для Quickshell 0.3.2 тайм-аут проверен прямым D-Bus-вызовом с 250 мс. Реальный backend
передаёт миллисекунды; описание `expireTimeout` в онлайн-документации на момент работы
указывает секунды. При обновлении Quickshell повторяй lifecycle-тест, не меняй единицы
только по тексту документации. Использованы [Notification API](https://quickshell.org/docs/v0.3.2/types/Quickshell.Services.Notifications/Notification/)
и [исходники backend](https://github.com/quickshell-mirror/quickshell/blob/master/src/services/notifications/notification.cpp).
У Quickshell 0.3.2 новый `notification` signal не приходит для replacement существующего
объекта; оболочка отслеживает изменения его свойств. Полностью идентичная replacement-посылка
без изменений свойств пока не обнаруживается и не сбрасывает таймер. Это ограничение API
нужно закрыть upstream-хуком или отдельной проверенной интеграцией перед окончательной миграцией.
Для transient-уведомлений оставшееся время после QML reload может отсчитываться заново:
намеренно не сохраняются их данные на диск. История обычных уведомлений сохраняет deadline
для восстановления при мягком reload. Полный перезапуск процесса восстанавливает только
архивный текст, а не активные уведомления/клиентские actions.
## Статические обои на desktop
Открыть страницу можно из Settings → «Обои» или командой:
```sh
./hypr/bin/adaptive-shell wallpapers
```
Выбери общий фон или конкретный выход, затем файл и «Применить». Имя монитора хранится
как ключ настройки, поэтому порядок подключённых выходов не влияет на выбор.
Для отключённого выхода доступна настройка будущего подключения; фиктивное окно для него
не создаётся. «Использовать общие обои» удаляет override, а «Использовать прежний фон»
отключает слой для выбранного выхода (или общий фон, если выбран общий пункт).
Принимаются только абсолютные локальные пути и локальные `file:///` URL. Текст пути
не передаётся shell-команде. Новые поля `wallpapers` необязательны в прежней схеме v1.
Предпросмотр и рендер используют Qt Image; доступность формата зависит от Qt-плагинов.
Декодирование фонового изображения ограничено 4096 пикселями по каждой оси, crop сохраняет
соотношение сторон. Dynamic Color, slideshow и видео этим этапом не реализованы.
Последнее успешное изображение удерживается в памяти текущего процесса, пока грузится
новое или показывается ошибка. Если ошибочный путь сохранён и процесс перезапущен,
прежнее изображение из памяти не восстанавливается: остаётся исходный фон Hyprpaper.
Полное отключение Hyprpaper и гарантированный fallback без него требуют отдельного этапа
миграции. Физическое подключение/отключение нескольких мониторов пока не проверено;
на текущем desktop проверен один реальный выход и сохранение настройки отключённого.
FileDialog загружается вместе со страницей; ручной выбор файла через системный диалог
пока не входит в автоматический smoke-тест.
## Меню питания desktop
Меню доступно из панели, Alt+Shift+P в новом профиле и Settings → «Оболочка» →
«Блокировка и питание…». В нём есть lock, suspend, logout, reboot и poweroff.
Возможности перечитываются при открытии и по кнопке обновления; постоянного опроса нет.
Неизвестные/недоступные действия отключены с причиной, а состояние `challenge` для
reboot/poweroff обозначено как требующее авторизации. Меню не закрывается при ошибке.
Ожидание имеет тайм-аут, но его сообщение не утверждает, что уже отправленное действие
обязательно отменено. Закрытие меню сбрасывает неподтверждённый выбор.
Одноразовый `backend/power.py` использует системную D-Bus-шину logind, не root-shell.
Вызовы CanSuspend/CanReboot/CanPowerOff предшествуют действиям. Reboot/poweroff разрешают
обычную авторизацию polkit. Для suspend требуется `CanSuspend=yes`; `challenge` пока
отключает этот пункт: полноценная авторизация до блокировки — отдельная будущая работа.
После подтверждения блокировки Suspend вызывается без интерактивной авторизации,
чтобы не открывать скрытый polkit-диалог под lock screen. Force/ignore-inhibitors флаги
не используются. Logout отправляет фиксированный IPC-dispatch текущему Hyprland,
не вызывает killall и не завершает остальные пользовательские сессии.
LockObserver сначала подписывается на `hyprland-lock-notify-v1`, затем при необходимости
запускает Hyprlock с `--grace 0` и ждёт `locked`. Наличие процесса или logind LockedHint
не считается подтверждением. При отсутствующем протоколе, завершившемся locker, тайм-ауте
или полученном unlock запрос Suspend не отправляется. Helper не владеет session lock
и не уничтожает lock client при ошибке/завершении наблюдения. Существующие Hypridle,
Alt+B, PAM и настройки Hyprlock этим этапом не переписаны.
Зависимости runtime для меню: Python 3, `python-gobject`, `python-pywayland`, Hyprlock,
Hyprland с lock-notify и logind. Если зависимость недоступна, это отражается в меню.
Vendored XML и сгенерированные bindings находятся в `backend/protocols/`; сохранены
исходная лицензия, URL и hash XML. Повторная генерация не требует сетевого доступа.
Ориентиры: [logind API](https://www.freedesktop.org/software/systemd/man/latest/org.freedesktop.login1.html)
и [исходный протокол Hyprland](https://github.com/hyprwm/hyprland-protocols/blob/main/protocols/hyprland-lock-notify-v1.xml).
Проверки: 19 Python unit-тестов с внедрёнными backend/observer, 7 сценариев настоящего
Quickshell Process-controller с явно переданным fake-helper (success, denied, ошибка,
повреждённый ответ, watchdog, неверное действие, отсутствующий helper). Они не вызывают
реальных действий питания. Offscreen fixture запускается отдельно от production shell,
не имеет power IPC и не выбирается через переменную окружения обычного пользователя.
QtTest не загружает статически встроенные плагины Quickshell, поэтому controller проверяется
отдельным runner `power_controller.py`, а не имитацией Process в QtTest.
В текущей desktop-сессии выполнено только чтение возможностей: logind и lock-notify доступны.
Реальные lock/suspend/resume, logout, reboot/poweroff и интерактивный polkit ещё не проверены.
Проверка порядка вызовов на mock-backend не заменяет проверку блокировки на всех физических
выходах и сна/пробуждения на реальном оборудовании.
## Сетевые подключения desktop
```sh
./hypr/bin/adaptive-shell network
```
Раздел также доступен в Settings и из Quick Settings. Состояния берутся из общей
модели Quickshell.Networking/NetworkManager, без shell-парсинга `nmcli` и без таймерного
опроса. Отсутствующий backend отличается от пустого списка адаптеров; Wi-Fi switch
не появляется без адаптера и сохраняется для существующего выключенного/blocked устройства.
IP/DNS/VPN, выбор между несколькими сохранёнными профилями, enterprise/EAP/WEP и сертификаты
пока открываются через `nm-connection-editor`. Bluetooth доступен в Quick Settings и отдельной странице Settings;
собственный pairing agent ещё не готов.
WPA/WPA2-Personal и SAE используют native `connectWithPsk`; пароль передаётся непосредственно
API, не попадает в argv, preferences, диагностический текст или собственный файл оболочки.
NetworkManager может сохранить его в своём хранилище профилей. Поле скрывает ввод и
запрещает предиктивный ввод. Новая enterprise-сеть не получает неподходящий PSK-переключатель.
Для сохранённых сетей сначала пробуется подключение без повторного запроса пароля.
При NoSecrets поле появляется только для поддерживаемых PSK-типов и активной страницы.
Операция остаётся ожидающей до обновления реального состояния или ошибки. Disconnect
требует подтверждения; 45-секундный timeout сообщает о неподтверждённом результате и
не пытается отключить/отменить соединение автоматически. Удаление интерфейса и потеря
управления учитываются контроллером. Отключённая/скрытая страница не продолжает сканирование.
Сложные случаи polkit/secret agent и ошибки radio toggle ещё требуют доработки и ручной проверки.
`network_controller.py`: 9 сценариев с явно переданными QML fake-устройствами и реальным
NetworkController, включая правильный адаптер, connect/disconnect, duplicate prevention,
NoSecrets, timeout, удаление/неуправляемое устройство, передачу синтетического PSK и очистку
настоящего TextField при закрытии/подключении. Fixture изолирована от production entrypoint
и не создаёт Networking singleton. На desktop smoke-тесте проверена загрузка страницы
с реальными интерфейсами; connect/disconnect и Wi-Fi switch тестом не вызываются.
Открытие страницы может включать обновление списка сетей, если доступен Wi-Fi-адаптер.
Реальное WPA/EAP-подключение, ввод credentials через OSK и USB-hotplug ещё не проверены.
API сверено с [Quickshell Network](https://quickshell.org/docs/v0.3.2/types/Quickshell.Networking/Network/),
[WifiNetwork](https://quickshell.org/docs/v0.3.2/types/Quickshell.Networking/WifiNetwork/)
и установленными qmltypes 0.3.2. Скорость Ethernet — физический link speed, не измерение
скорости доступа к Интернету.
## Bluetooth desktop
```sh
./hypr/bin/adaptive-shell bluetooth
```
Страница показывает адаптеры из общей Quickshell.Bluetooth модели и не создаёт mock-устройств
при отсутствии оборудования. Состояние заблокированного/выключенного адаптера не скрывает
сам адаптер. Включение, выключение, connect/disconnect и forget используют одноразовый
`backend/bluetooth.py` с BlueZ D-Bus, проверкой object paths и структурированными ошибками.
Выключение адаптера, отключение устройства и удаление сопряжения требуют подтверждения.
UI ждёт ответ backend, повторные запросы блокируются; состояние устройства читается из BlueZ,
а не устанавливается оптимистично. Страница не меняет Discoverable, Pairable и Trusted.
«Найти устройства» запускает временный helper с собственной системной D-Bus connection,
вызывает StartDiscovery и удерживает discovery session. StopDiscovery вызывается тем же
клиентом после закрытия страницы, остановки или тайм-аута до 60 секунд. При зависшем старте
или завершении helper принудительно закрывается; соединение не остаётся живым после процесса.
Поиск, уже выполняющийся другим клиентом, не останавливается. В простое отдельного Bluetooth
процесса нет. Readiness перечитывается при открытии страницы и явном обновлении, без polling.
Первичное сопряжение, PIN/passkey, Numeric Comparison и подтверждение доверия пока делегированы
`blueman-manager`: оболочка не регистрирует агент, который автоматически принимает запросы.
Встроенный connect предназначен для уже сопряжённых устройств. Дополнительный Quick Settings
switch пока остаётся прямым API Quickshell; полная обработка его отказов ещё предстоит.
Зависимости helper: Python 3, `python-gobject` и работающий BlueZ. Тестовые backend явно
передаются отдельным fixtures и не выбираются через переменную обычной сессии.
Проверки: 10 Python unit-тестов (пути, маршрутизация, ошибки, lifetime discovery), 14 сценариев
настоящих QML/Process controllers с fake helper (включая watchdog, закрытие до старта,
неудачный старт, отсутствие executable, ограничение времени, смену адаптера и чужой поиск),
desktop smoke с загрузкой Bluetooth-страницы без изменения radio и без реального сопряжения.
В текущей системе read-only вызов BlueZ вернул NameHasNoOwner: проверен экран недоступного
сервиса. Реальные adapter hotplug, поиск, power/rfkill, профили connect/disconnect и pairing
на оборудовании ещё не проверены. Доступного через BlueZ контроллера для этих проверок пока нет; отсутствие самого оборудования
этим не доказано.
Семантика discovery сверена с [официальным BlueZ Adapter API](https://github.com/bluez/bluez/blob/master/doc/org.bluez.Adapter.rst):
StartDiscovery/StopDiscovery относятся к сессии конкретного клиента, а общий поиск может
продолжаться, пока его используют другие клиенты.