Files
dotfiles/docs/quickshell/README.md
T
2026-11-17 18:15:16 +07:00

404 lines
41 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 относятся к сессии конкретного клиента, а общий поиск может
продолжаться, пока его используют другие клиенты.