404 lines
41 KiB
Markdown
404 lines
41 KiB
Markdown
# 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 относятся к сессии конкретного клиента, а общий поиск может
|
||
продолжаться, пока его используют другие клиенты.
|