added adaptive quickshell
This commit is contained in:
1 parent
6eb56d2065
commit
5b33a73fd8
189 files changed
+8678
-15
No files matched your search
@@ -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 относятся к сессии конкретного клиента, а общий поиск может
|
||||
продолжаться, пока его используют другие клиенты.
|
||||
Reference in new issue
Block a user