1531 lines
75 KiB
Markdown
1531 lines
75 KiB
Markdown
# MASTER PROMPT — Adaptive Material 3 Linux Shell
|
||
|
||
## Полная адаптивная оболочка Hyprland + Quickshell для Desktop, Tablet и Phone
|
||
|
||
Ты — senior Linux systems engineer, Wayland compositor developer, Qt 6/QML architect, Rust developer и специалист по мобильным Linux-окружениям.
|
||
|
||
Твоя задача — превратить мою **существующую конфигурацию Hyprland** в полноценное конвергентное Linux-окружение на базе **Quickshell и Google Material Design 3**, одинаково пригодное для компьютеров, планшетов и телефонов.
|
||
|
||
Требуется не прототип, не набор демонстрационных QML-экранов, а работоспособная, оптимизированная, интегрированная оболочка.
|
||
|
||
**Главное требование: не создавай новую конфигурацию Hyprland вместо существующей. Изучи мои текущие настройки и аккуратно модифицируй их, сохранив всю функциональность, которую я уже использую.**
|
||
|
||
Продолжай реализацию по этапам, проверяй результат, исправляй ошибки и документируй технические ограничения.
|
||
|
||
---
|
||
|
||
# 1. Исходная система
|
||
|
||
Документ — задание на будущую реализацию, а не описание готовой Quickshell-оболочки. Срез рабочего дерева репозитория обновлён **17 ноября 2026 года**. Перед реализацией повторно сверь его с файлами: локальные изменения могут отличаться от последнего коммита.
|
||
|
||
Заявленные целевые платформы:
|
||
|
||
- Arch Linux на desktop, архитектура x86_64.
|
||
- Arch Linux ARM на телефоне, архитектура aarch64.
|
||
- Сенсорный ввод на телефоне, внешние мониторы и отпечаток пальца на поддерживаемом оборудовании.
|
||
- Ручной запуск desktop-сессии из TTY без обязательного Display Manager.
|
||
|
||
Наличие телефона, датчиков, сканера, конкретного аудиосервера и установленные версии компонентов нельзя установить по одним dotfiles. Подтверди их отдельным аудитом целевой машины.
|
||
|
||
## 1.1. Фактическая структура репозитория
|
||
|
||
Основная конфигурация композитора — **`hypr/hyprland.lua`**, использующая API `hl.*`. Не создавай вместо неё новый `hyprland.conf` и не переноси настройки обратно в conf-синтаксис без обоснованной необходимости.
|
||
|
||
| Файлы | Текущее назначение |
|
||
| --- | --- |
|
||
| `hypr/hyprland.lua` | Подключает `keybinds`, `windowrules`, `startup`, `monitors`, `environment`, `keyboard`, `gestures`, `decoration`, `animation`; задаёт общие параметры композитора |
|
||
| `hypr/keybinds.lua`, `hypr/programs.lua` | Привязки клавиш и команды приложений; `programs` подключается из `keybinds` |
|
||
| `hypr/startup.lua` | Автозапуск через обработчик `hl.on("hyprland.start", ...)` |
|
||
| `hypr/monitors.lua` | В текущем рабочем дереве: `DP-1`, `3440x1440@165.00Hz`, позиция `0x0`, scale `1`; это профиль desktop, а не универсальная настройка |
|
||
| `hypr/keyboard.lua`, `hypr/gestures.lua` | Раскладки, устройства ввода и трёхпальцевые жесты тачпада |
|
||
| `hypr/decoration.lua`, `hypr/animation.lua`, `hypr/windowrules.lua` | Оформление, анимации, правила окон и слоёв |
|
||
| `hypr/hypridle.conf`, `hypr/hyprlock.conf`, `hypr/hyprpaper.conf` | Отдельные конфигурации соответствующих демонов; выясни реальные пути загрузки в сессии |
|
||
| `hypr/hypridle.lua`, `hypr/hyprlock.lua`, `hypr/hyprpaper.lua` | Результаты `hyprconf2lua` с предупреждениями/TODO; основной `hyprland.lua` их не подключает. Не считай их рабочей заменой `.conf` |
|
||
| `hypr/monitors.conf`, `hypr/workspaces.conf` | В текущем рабочем дереве пустые; основной Lua entrypoint их не подключает |
|
||
| `waybar/config.jsonc`, `waybar/style.css`, `waybar/scripts/` | Текущая панель и вспомогательные скрипты |
|
||
| `swaync/config.json`, `swaync/style.css` | Центр уведомлений |
|
||
| `rofi/launcher/`, `rofi/powermenu/`, `rofi/emoji/`, `rofi/clipboard/` | Лаунчер, питание, emoji и отдельный clipboard-сценарий |
|
||
| `hypr/bin/` | Скрипты обоев, блокировки, экранной клавиатуры, обновления и перезапуска компонентов |
|
||
| `shell/source.sh` | PATH, Flatpak XDG data paths, alias `H='start-hyprland'` |
|
||
|
||
**Каталога `quickshell/`, реализации Material 3 Settings и общего HardwareCapabilityService пока нет.** Их нужно создать в рамках будущей реализации. Конфигурации `niri/` и `mako/` также присутствуют, но текущий Hyprland startup запускает SwayNC; наличие каталога не доказывает запуск сервиса.
|
||
|
||
## 1.2. Автозапуск и интеграции, которые нужно сохранить
|
||
|
||
`hypr/startup.lua` запускает:
|
||
|
||
- `hyprpaper`, затем с задержкой `hypr/bin/background.sh`.
|
||
- `waybar`, `swaync`, `hypridle`, `swayosd-server`.
|
||
- `lxpolkit`, `nm-applet --indicator`, `uxplay`, `unclutter`, `clipse -listen`.
|
||
- Настройку GTK-темы `MacTahoe-Dark`, icon theme `MacTahoe-dark`, курсора `Bibata-Modern-Ice` размера 24 и тёмной цветовой схемы.
|
||
- Импорт `WAYLAND_DISPLAY` и `XDG_CURRENT_DESKTOP` через `dbus-update-activation-environment --systemd` и `systemctl --user import-environment`.
|
||
|
||
Сохраняй polkit agent, clipboard manager и пользовательские приложения. SwayOSD, сетевой апплет и прежние визуальные компоненты отключай только после проверки соответствующей замены. Проверь отсутствие дублирования OSD и конкуренции за D-Bus notifications name. Не запускай Quickshell одновременно из Lua startup и нового systemd unit; выбери один способ с корректным завершением вместе с сессией.
|
||
|
||
## 1.3. Существующие сценарии управления
|
||
|
||
- Основной модификатор — **Alt**, не Super. Сохрани привязки и их привычные действия.
|
||
- `Alt+Return` — Kitty, `Alt+T` — Thunar, `Alt+D` и `XF86LaunchB` — Rofi launcher.
|
||
- `Alt+Space` — отдельный лаунчер `sherlock`; не удаляй его при замене Rofi без согласованной замены сценария.
|
||
- `Alt+B` — `hypr/bin/hyprlock-background.sh`; `Alt+Shift+P` — Rofi power menu.
|
||
- `Alt+Z` — открыть SwayNC, `Alt+Shift+R` — перечитать его конфигурацию. При миграции перенаправь эти действия на эквиваленты оболочки.
|
||
- `Alt+C` — `kitty clipse`; `Alt+E` — Rofimoji. Скрипт `rofi/clipboard/clipboard.sh` использует Greenclip, но это отдельный сценарий, не текущий clipboard bind.
|
||
- `Alt+Shift+O` — переключение `wvkbd-mobintl` через `hypr/bin/toggle_keyboard.sh`.
|
||
- Громкость, mute, микрофон, яркость и media keys используют `swayosd-client`; клавиатурная подсветка — `brightnessctl` с устройством `smc::kbd_backlight`. Не переноси это имя на все устройства.
|
||
- Сохрани скриншоты через Grim/Slurp/wl-copy, запуск обновлений, навигацию и перемещение окон, workspaces 1–10, special workspace `magic` и resize submap.
|
||
- Ввод: `us,ru`, переключение `grp:win_space_toggle`, repeat rate 50, delay 500; touchpad natural scroll и scroll factor 0.2.
|
||
- Текущие жесты: три пальца horizontal → workspace, up → fullscreen, pinchout → float. Это не реализация глобальных touchscreen-жестов.
|
||
- Исходное desktop-оформление: dwindle, gaps 5/5, border 1, rounding 20, blur и shadow выключены. При возврате из мобильного режима восстанавливай пользовательские значения.
|
||
|
||
## 1.4. Что перенести из панели и уведомлений
|
||
|
||
Waybar сейчас показывает launcher, CPU/RAM/temperature/disk, заголовок окна, workspaces, звук/микрофон, MPRIS, подсветку, состояния клавиатуры, язык, батареи, часы, tray и питание. Часы настроены на `Asia/Tomsk`: сохрани настройку как пользовательское предпочтение.
|
||
|
||
Сохрани возможность просмотра обновлений и запуска `hypr/bin/startupdate.sh` (Kitty + `sudo pacman -Syu`). Не запускай обновления из UI без пользовательского действия и не выдавай успех при ошибке команды.
|
||
|
||
Различай объявления модулей и их включение в `modules-left/center/right`: `network`, `bluetooth`, `privacy`, `custom/onscreenkeyboard`, `cava` и `custom/spotify` описаны, но в текущие списки не включены. `custom/weather` включён в список, но его определения закомментированы. Не считай эти функции подтверждённо работающими. Две записи батарей, включая `BAT2`, не доказывают наличие двух аккумуляторов.
|
||
|
||
В SwayNC включены title/clear all, DND, MPRIS, volume, backlight и notifications; тайм-ауты 6 секунд для обычных, 3 для low, 0 для critical. Есть настройки inline replies и 2FA actions. `buttons-grid` описан, но не включён в `widgets`; старый путь `/home/alien/...` не является зависимостью новой оболочки.
|
||
|
||
## 1.5. Известные места для проверки при реализации
|
||
|
||
Это наблюдения по исходникам, а не результаты проверки работающей сессии:
|
||
|
||
- `hypr/hypridle.conf`: lock command `pidof hyprlock || hyprlock`, перед сном `loginctl lock-session`, после сна DPMS on. Тайм-ауты: 150 — приглушение подсветки, 6000 — lock, 7200 — DPMS off, 8000 — suspend (секунды). В командах подсветки написано `brightnesctl`; проверь и исправь опечатку при реализации, сохранив осознанно выбранные интервалы.
|
||
- Ручной lock bind использует wrapper со случайными обоями, idle lock запускает Hyprlock напрямую. Объедини поведение через проверенную точку входа, сохранив защиту от повторного запуска и блокировку перед сном.
|
||
- `hypr/bin/hyprlock-background.sh` меняет `hypr/hyprlock.conf` через широкий `sed` по строкам `Pictures`. Для новой реализации не используй изменение отслеживаемого конфига как хранилище runtime-состояния.
|
||
- `hypr/bin/background.sh` выбирает случайные обои из `~/Pictures/wallpaper` для мониторов и вызывает Hyprpaper IPC. Учти пустой каталог, пути с пробелами, hotplug и независимые обои выходов.
|
||
- `hypr/bin/toggle_keyboard.sh` хранит флаг в `~/.keyboard_started`; он может расходиться с состоянием процесса. Сохрани возможность ручного вызова клавиатуры, добавь проверку реального состояния и совместимости с полями ввода/lock screen.
|
||
- В Waybar MPRIS есть ссылка на `~/dotfiles/ags/media/toggle_media`, но каталога `ags/` в репозитории нет. Не делай отсутствующий AGS обязательной зависимостью.
|
||
- `README.md` и `INSTALL.md` содержат старые пути `.conf`, упоминания Mako/Greenclip/PulseAudio, отсутствующего `install_scripts/install.sh` и инструкции Display Manager. При расхождении опирайся на текущий код и аудит сессии; обнови инструкции в ходе миграции.
|
||
- Реальный `install_scripts/install-arch.sh` устанавливает ОС с разметкой/форматированием диска; это не установщик оболочки. Для миграции создай отдельный безопасный механизм установки dotfiles и зависимостей.
|
||
|
||
Цель — единая оболочка для всех устройств с сохранением этих сценариев, а не три независимых окружения.
|
||
|
||
## Обязательный предварительный аудит
|
||
|
||
Сначала изучи исходники в корне этого репозитория, затем сопоставь их с реально загруженными файлами и симлинками в пользовательской сессии. Проверь также `git status`: сохраняй существующие локальные изменения, включая неотслеживаемые файлы; не выполняй автоматический reset/checkout и не включай посторонние правки в свои коммиты.
|
||
|
||
Перед изменениями изучи:
|
||
|
||
- `~/.config/hypr/`
|
||
- `~/.config/waybar/`
|
||
- `~/.config/swaync/`
|
||
- `~/.config/rofi/`
|
||
- `~/.config/quickshell/`
|
||
- `~/.config/hypr/hypridle.conf`
|
||
- `~/.config/hypr/hyprlock.conf`
|
||
- пользовательские скрипты
|
||
- systemd user services
|
||
- PAM-конфигурацию, относящуюся к блокировке
|
||
- текущие способы запуска Hyprland
|
||
- установленные версии Hyprland, Quickshell и Qt
|
||
- существующие правила окон, рабочих пространств и мониторов
|
||
|
||
Не предполагай, что конфигурационные файлы находятся только в стандартных местах. Проверь реальные пути и подключаемые конфигурации.
|
||
|
||
Сделай резервные копии изменяемых файлов.
|
||
|
||
Если проект находится под Git, используй существующую структуру и сохраняй понятную историю изменений.
|
||
|
||
Не удаляй существующие пакеты и конфигурации до успешного завершения миграции.
|
||
|
||
---
|
||
|
||
# 2. Целевая архитектура
|
||
|
||
Создай одну оболочку Quickshell с общей системой сервисов и адаптивными представлениями.
|
||
|
||
Архитектура:
|
||
|
||
```text
|
||
Hyprland
|
||
│
|
||
├── Quickshell
|
||
│ ├── Adaptive Shell
|
||
│ │ ├── Desktop UI
|
||
│ │ ├── Tablet UI
|
||
│ │ └── Phone UI
|
||
│ │
|
||
│ ├── Material 3 Design System
|
||
│ │ ├── Colors
|
||
│ │ ├── Typography
|
||
│ │ ├── Shapes
|
||
│ │ ├── Motion
|
||
│ │ └── Components
|
||
│ │
|
||
│ ├── System Bar
|
||
│ ├── Quick Settings
|
||
│ ├── Notification Center
|
||
│ ├── Application Launcher
|
||
│ ├── Home Screen
|
||
│ ├── Recent Apps
|
||
│ ├── Navigation Gestures
|
||
│ ├── Wallpaper Engine
|
||
│ ├── Secure Lock Screen
|
||
│ ├── Power Menu
|
||
│ └── Settings Application
|
||
│
|
||
├── Hypridle
|
||
├── NetworkManager
|
||
├── BlueZ
|
||
├── PipeWire / WirePlumber
|
||
├── UPower
|
||
├── systemd-logind
|
||
├── fprintd / libfprint
|
||
└── Linux kernel device interfaces
|
||
```
|
||
|
||
Quickshell должен быть основным процессом визуальной оболочки.
|
||
|
||
Не создавай отдельные постоянно работающие приложения там, где функциональность может быть реализована внутри Quickshell.
|
||
|
||
Допускается небольшой вспомогательный сервис на Rust, если он действительно необходим для безопасного доступа к системным API, обработки жестов или интеграции с аппаратным обеспечением.
|
||
|
||
Не дублируй сервисы между режимами.
|
||
|
||
---
|
||
|
||
# 3. Полный Google Material Design 3
|
||
|
||
Весь интерфейс должен быть выполнен в стиле Google Material Design 3 / Material You.
|
||
|
||
Официальные ориентиры:
|
||
|
||
https://m3.material.io/
|
||
|
||
https://m3.material.io/styles/color/system/overview
|
||
|
||
https://m3.material.io/foundations/layout/understanding-layout/overview
|
||
|
||
https://fonts.google.com/icons
|
||
|
||
Требования:
|
||
|
||
- Полноценная система Material 3 design tokens.
|
||
- Dynamic Color на основе обоев.
|
||
- Светлая тема.
|
||
- Тёмная тема.
|
||
- Системная тема.
|
||
- AMOLED-тема с настоящим чёрным фоном.
|
||
- Ручной выбор accent color.
|
||
- Material Symbols.
|
||
- Material 3 typography.
|
||
- Material 3 switches, sliders, buttons, menus и dialogs.
|
||
- Material 3 cards, navigation rail, navigation drawer и bottom navigation.
|
||
- Корректные состояния hover, pressed, focused, disabled.
|
||
- Плавные, но оптимизированные анимации.
|
||
- Поддержка reduced motion.
|
||
- Доступность и клавиатурная навигация.
|
||
- Корректное масштабирование интерфейса.
|
||
|
||
Используй единый набор компонентов.
|
||
|
||
Не создавай три разные темы для телефона, планшета и компьютера. Меняться должны layout, размеры, плотность и способы взаимодействия, а дизайн-система должна оставаться общей.
|
||
|
||
---
|
||
|
||
# 4. Адаптивная система режимов
|
||
|
||
Реализуй:
|
||
|
||
- `auto`
|
||
- `phone`
|
||
- `tablet`
|
||
- `desktop`
|
||
|
||
Режим должен определяться по сочетанию:
|
||
|
||
- размера доступной рабочей области
|
||
- масштаба дисплея
|
||
- наличия сенсорного ввода
|
||
- типа устройства
|
||
- пользовательских предпочтений
|
||
|
||
Не определяй режим исключительно по CPU architecture или физическому разрешению экрана.
|
||
|
||
Поддержи разные режимы на разных мониторах одновременно.
|
||
|
||
Например:
|
||
|
||
- Экран телефона: phone mode.
|
||
- Внешний монитор: desktop mode.
|
||
|
||
При подключении и отключении мониторов оболочка должна перестраиваться без перезапуска пользовательских приложений.
|
||
|
||
Добавь ручное переключение режима в Settings.
|
||
|
||
---
|
||
|
||
# 5. Замена Waybar
|
||
|
||
Полностью реализуй верхнюю системную панель в Quickshell.
|
||
|
||
Desktop:
|
||
|
||
- Верхняя панель.
|
||
- Часы и календарь.
|
||
- Рабочие пространства.
|
||
- Индикаторы приложений.
|
||
- Системный трей.
|
||
- Wi-Fi и Ethernet.
|
||
- Bluetooth.
|
||
- Громкость.
|
||
- Микрофон.
|
||
- Батарея.
|
||
- Яркость.
|
||
- Медиаплеер.
|
||
- Уведомления.
|
||
- Режим «Не беспокоить».
|
||
- Меню питания.
|
||
- Кнопка запуска приложений.
|
||
|
||
Tablet:
|
||
|
||
- Адаптивная системная панель.
|
||
- Сенсорные элементы.
|
||
- Упрощённые индикаторы.
|
||
- Быстрый доступ к многозадачности.
|
||
|
||
Phone:
|
||
|
||
- Компактная status bar.
|
||
- Время.
|
||
- Сигнал сети, если доступен соответствующий backend.
|
||
- Wi-Fi.
|
||
- Bluetooth при необходимости.
|
||
- Батарея.
|
||
- Индикаторы состояния.
|
||
- Поддержка вырезов и безопасных областей экрана, если информация о них доступна.
|
||
|
||
Не используй фиктивные значения сигналов, батареи или сети.
|
||
|
||
---
|
||
|
||
# 6. Замена SwayNC
|
||
|
||
Реализуй собственный сервер уведомлений через Freedesktop Notifications D-Bus API.
|
||
|
||
Обязательно:
|
||
|
||
- Получение уведомлений.
|
||
- Уведомления с иконками и изображениями.
|
||
- Action buttons.
|
||
- Замена уведомлений по ID.
|
||
- Группировка по приложениям.
|
||
- История уведомлений.
|
||
- Удаление свайпом.
|
||
- Очистка всех уведомлений.
|
||
- Приоритеты.
|
||
- Тайм-ауты.
|
||
- Do Not Disturb.
|
||
- Уведомления на экране блокировки с настройками приватности.
|
||
- Ограничение размера истории.
|
||
- Сохранение состояния.
|
||
- Корректная обработка закрытия и сигналов D-Bus.
|
||
|
||
В desktop mode используй компактный Notification Center.
|
||
|
||
В phone mode уведомления должны находиться в единой шторке с быстрыми настройками.
|
||
|
||
При переходе на новый сервер уведомлений не допускай одновременного запуска SwayNC.
|
||
|
||
---
|
||
|
||
# 7. Material 3 Quick Settings
|
||
|
||
Создай полноценный центр управления.
|
||
|
||
Функции:
|
||
|
||
- Wi-Fi.
|
||
- Ethernet.
|
||
- Bluetooth.
|
||
- Громкость.
|
||
- Выбор аудиоустройств.
|
||
- Яркость.
|
||
- Батарея.
|
||
- Энергосбережение.
|
||
- Do Not Disturb.
|
||
- Фонарик при наличии.
|
||
- Автоповорот при наличии датчиков.
|
||
- Медиаплеер через MPRIS.
|
||
- Настройки экрана.
|
||
- Быстрый переход в Settings.
|
||
|
||
Используй реальные системные интерфейсы:
|
||
|
||
- NetworkManager D-Bus.
|
||
- BlueZ D-Bus.
|
||
- PipeWire / WirePlumber.
|
||
- UPower.
|
||
- MPRIS.
|
||
- power-profiles-daemon или совместимый backend.
|
||
- iio-sensor-proxy при наличии.
|
||
|
||
Не создавай отдельные shell-скрипты для каждого переключателя, если доступен нормальный API.
|
||
|
||
Все переключатели должны показывать реальное состояние системы.
|
||
|
||
---
|
||
|
||
# 8. Замена Rofi
|
||
|
||
Реализуй собственный Application Launcher.
|
||
|
||
Desktop:
|
||
|
||
- Material 3 search popup.
|
||
- Поиск приложений.
|
||
- Клавиатурная навигация.
|
||
- Избранное.
|
||
- История запуска.
|
||
- Поиск файлов через доступный backend.
|
||
- Настраиваемые действия.
|
||
|
||
Tablet:
|
||
|
||
- Адаптивная сетка приложений.
|
||
- Поиск.
|
||
- Сенсорное управление.
|
||
|
||
Phone:
|
||
|
||
- Полноэкранный App Drawer.
|
||
- Сетка иконок.
|
||
- Поиск.
|
||
- Категории.
|
||
- Избранное.
|
||
- Поддержка экранной клавиатуры.
|
||
|
||
Используй XDG Desktop Entries.
|
||
|
||
Поддерживай Flatpak.
|
||
|
||
Корректно обрабатывай Desktop Entry `Exec`, `TryExec`, `NoDisplay`, `OnlyShowIn`, `NotShowIn` и Desktop Actions.
|
||
|
||
Не выполняй непроверенные строки поиска как shell-команды.
|
||
|
||
---
|
||
|
||
# 9. Домашний экран телефона
|
||
|
||
Реализуй настоящий Home Screen.
|
||
|
||
Функциональность:
|
||
|
||
- Сетка приложений.
|
||
- Перемещение иконок.
|
||
- Папки.
|
||
- Dock.
|
||
- Несколько страниц.
|
||
- Настраиваемые обои.
|
||
- Поиск.
|
||
- Виджеты при наличии backend.
|
||
- Контекстные меню.
|
||
- Сохранение состояния.
|
||
- Адаптация к повороту экрана.
|
||
|
||
Домашний экран должен оставаться доступным независимо от того, какие приложения открыты.
|
||
|
||
Не реализуй его обычным окном, которое случайно может оказаться поверх активных приложений или нарушить фокус.
|
||
|
||
Используй корректную интеграцию с композитором и слоями Wayland.
|
||
|
||
---
|
||
|
||
# 10. Recent Apps и многозадачность
|
||
|
||
Создай мобильный переключатель запущенных приложений.
|
||
|
||
Функции:
|
||
|
||
- Карточки открытых окон.
|
||
- Иконки приложений.
|
||
- Названия.
|
||
- Переключение на выбранное окно.
|
||
- Закрытие окна свайпом вверх.
|
||
- Закрытие нескольких окон.
|
||
- Поддержка полноэкранных приложений.
|
||
- Корректное восстановление фокуса.
|
||
- Поддержка нескольких окон одного приложения.
|
||
|
||
Для desktop реализуй обзор окон, если это возможно через поддерживаемые API Hyprland.
|
||
|
||
Для миниатюр используй реальный compositor-compatible механизм.
|
||
|
||
Не показывай поддельные скриншоты приложений.
|
||
|
||
Если миниатюры недоступны, используй карточки с иконками и названиями.
|
||
|
||
---
|
||
|
||
# 11. Мобильная жестовая навигация
|
||
|
||
Это критически важная функциональность.
|
||
|
||
Реализуй системные жесты, работающие поверх обычных и полноэкранных приложений.
|
||
|
||
| Жест | Действие |
|
||
| ------------------------------------ | ------------------------------------- |
|
||
| Свайп снизу вверх | Сразу домашний экран |
|
||
| Свайп снизу вверх с удержанием | Recent Apps |
|
||
| Свайп от левого края вправо | Назад |
|
||
| Свайп от правого края влево | Назад |
|
||
| Свайп сверху вниз | Шторка уведомлений и быстрых настроек |
|
||
| Свайп по нижней полоске влево/вправо | Переключение приложений |
|
||
| Свайп карточки вверх в Recent Apps | Закрытие окна |
|
||
| Свайп вверх по открытой шторке | Закрытие шторки |
|
||
|
||
## Особые требования
|
||
|
||
**Выход домой — простым свайпом снизу вверх, без удержания.**
|
||
|
||
Для открытия Recent Apps нужно сделать свайп снизу вверх и удержать палец.
|
||
|
||
Оба боковых края должны поддерживать жест «Назад».
|
||
|
||
Реализуй:
|
||
|
||
- Пороги распознавания.
|
||
- Настраиваемую чувствительность.
|
||
- Визуальную обратную связь.
|
||
- Отмену жеста.
|
||
- Защиту от ложных срабатываний.
|
||
- Поддержку landscape.
|
||
- Учёт DPI и масштабирования.
|
||
- Приоритет жестов на границах экрана.
|
||
- Поддержку настоящего touchscreen input.
|
||
|
||
Учитывай, что Linux-приложения не имеют универсального действия «Назад».
|
||
|
||
Создай маршрутизацию действия с учётом активного приложения, поддерживаемых API и настраиваемых fallback-клавиш.
|
||
|
||
Не отправляй произвольные сочетания клавиш в приложения, где это может привести к потере данных.
|
||
|
||
Не считай обычный QML MouseArea достаточной реализацией глобальных жестов.
|
||
|
||
Проверь возможности Hyprland и при необходимости реализуй отдельную compositor-level интеграцию.
|
||
|
||
---
|
||
|
||
# 12. Динамическая конфигурация Hyprland
|
||
|
||
Реализуй автоматическое переключение параметров композитора.
|
||
|
||
Phone:
|
||
|
||
- Нулевые отступы.
|
||
- Нулевые рамки.
|
||
- Без скруглений.
|
||
- Без размытия.
|
||
- Минимальные анимации.
|
||
- Одно основное приложение на экране.
|
||
|
||
Tablet:
|
||
|
||
- Небольшие отступы.
|
||
- Адаптивная многозадачность.
|
||
- Сенсорное управление.
|
||
|
||
Desktop:
|
||
|
||
- Настраиваемые gaps.
|
||
- Настраиваемые borders.
|
||
- Скругления.
|
||
- Анимации.
|
||
- Tiling и floating.
|
||
|
||
Не перезаписывай исходные пользовательские значения.
|
||
|
||
Сохраняй их как базовый профиль.
|
||
|
||
Применяй изменения через поддерживаемые API текущей версии Hyprland.
|
||
|
||
Учитывай, что глобальные параметры Hyprland могут влиять сразу на несколько мониторов. Для независимых режимов используй доступные правила рабочих пространств и окон, а ограничения документируй.
|
||
|
||
---
|
||
|
||
# 13. Замена Hyprpaper
|
||
|
||
Перенеси управление обоями в Quickshell.
|
||
|
||
Реализуй Wallpaper Engine.
|
||
|
||
Поддерживаемые форматы:
|
||
|
||
- JPG.
|
||
- JPEG.
|
||
- PNG.
|
||
- WebP.
|
||
- SVG.
|
||
- GIF.
|
||
- Видеообои через поддерживаемый мультимедийный backend.
|
||
|
||
Функциональность:
|
||
|
||
- Отдельные обои для разных мониторов.
|
||
- Отдельные обои Home Screen.
|
||
- Отдельные обои Lock Screen.
|
||
- Crop / Fit / Fill.
|
||
- Слайд-шоу.
|
||
- Автоматическая смена.
|
||
- Динамическая цветовая палитра Material You.
|
||
- Предпросмотр.
|
||
- Выбор из файлов.
|
||
- Настройка через Settings.
|
||
|
||
Для видеообоев реализуй приостановку декодирования, когда поверхность не видна или устройство переходит в энергосберегающий режим.
|
||
|
||
Не запускай тяжёлые видеообои на слабом ARM без возможности отключения.
|
||
|
||
Отключай Hyprpaper только после проверки корректного отображения новых обоев.
|
||
|
||
---
|
||
|
||
# 14. Замена Hyprlock
|
||
|
||
Создай собственный Material 3 Lock Screen в Quickshell.
|
||
|
||
Используй настоящий Wayland Session Lock Protocol `ext-session-lock-v1`.
|
||
|
||
Не используй обычное полноэкранное окно как механизм безопасности.
|
||
|
||
Lock Screen должен поддерживать:
|
||
|
||
- Часы.
|
||
- Дату.
|
||
- Обои.
|
||
- Батарею.
|
||
- Статус зарядки.
|
||
- Уведомления с настройками приватности.
|
||
- Поле пароля.
|
||
- PIN при наличии безопасного механизма проверки.
|
||
- Отпечаток пальца.
|
||
- Анимации разблокировки.
|
||
- Разные layout для desktop, tablet и phone.
|
||
- Корректную работу после suspend/resume.
|
||
|
||
Используй PAM для проверки учётных данных.
|
||
|
||
Не сохраняй пароль или PIN в конфигурации Quickshell.
|
||
|
||
Не реализуй собственную криптографию хранения паролей.
|
||
|
||
Обеспечь защиту от обхода блокировки при:
|
||
|
||
- Перезапуске Quickshell.
|
||
- Отключении монитора.
|
||
- Подключении нового монитора.
|
||
- Изменении разрешения.
|
||
- Сбое UI.
|
||
- Переключении TTY и возвращении в сессию.
|
||
- Suspend/resume.
|
||
|
||
Если безопасная реализация не готова, продолжай использовать Hyprlock.
|
||
|
||
Не отключай рабочий блокировщик до успешных проверок нового.
|
||
|
||
---
|
||
|
||
# 15. Touch ID / Fingerprint Unlock
|
||
|
||
Реализуй разблокировку по отпечатку пальца на телефоне и desktop.
|
||
|
||
Используй:
|
||
|
||
- fprintd.
|
||
- libfprint.
|
||
- PAM.
|
||
- Поддерживаемые аппаратные драйверы.
|
||
|
||
Требования:
|
||
|
||
- Разблокировка одним прикосновением.
|
||
- Без необходимости предварительно вводить пароль.
|
||
- Без необходимости нажимать Enter.
|
||
- Визуальный индикатор сканирования.
|
||
- Отображение ошибок.
|
||
- Повторная попытка.
|
||
- Возможность переключиться на пароль.
|
||
- Ограничение попыток согласно политике аутентификации.
|
||
- Безопасная обработка отсутствия устройства.
|
||
|
||
Создай раздел Fingerprint в Settings.
|
||
|
||
Функции:
|
||
|
||
- Проверка доступности сканера.
|
||
- Регистрация отпечатка через доверенный системный backend.
|
||
- Просмотр зарегистрированных отпечатков, если backend поддерживает.
|
||
- Удаление отпечатков после надлежащей авторизации.
|
||
- Включение/отключение разблокировки отпечатком.
|
||
- Диагностика устройства.
|
||
|
||
Не создавай собственную базу биометрических шаблонов.
|
||
|
||
Не считай успешное получение события от датчика подтверждением личности.
|
||
|
||
Разблокировка разрешена только после успешной проверки доверенным backend.
|
||
|
||
Если сканер телефона не поддерживается libfprint/fprintd, не имитируй поддержку. Документируй необходимые драйверы и возможные способы интеграции.
|
||
|
||
---
|
||
|
||
# 16. Сохранение Hypridle
|
||
|
||
Я уже использую Hypridle.
|
||
|
||
Не заменяй его без необходимости.
|
||
|
||
Изучи текущую конфигурацию и интегрируй с новым экраном блокировки.
|
||
|
||
Обеспечь:
|
||
|
||
- Блокировку по тайм-ауту.
|
||
- Блокировку перед suspend.
|
||
- Корректную работу после resume.
|
||
- Выключение дисплея.
|
||
- Настраиваемые интервалы.
|
||
- Отдельные профили desktop и phone.
|
||
- Настройки через Material 3 Settings.
|
||
|
||
Используй `loginctl`, systemd-logind и поддерживаемые интерфейсы там, где это необходимо.
|
||
|
||
Не допускай ситуации, когда устройство засыпает до установки безопасной блокировки.
|
||
|
||
Сохрани рабочую интеграцию Hypridle + Hyprlock до проверки нового Lock Screen.
|
||
|
||
---
|
||
|
||
# 17. Запуск из TTY без Display Manager
|
||
|
||
На desktop я не использую Display Manager.
|
||
|
||
Я вручную вхожу в TTY и запускаю Hyprland. В `shell/source.sh` для этого есть alias `H='start-hyprland'`; сохрани его и проверь фактический механизм запуска на целевой машине.
|
||
|
||
**Сохрани этот способ запуска.**
|
||
|
||
Не устанавливай SDDM, GDM, LightDM или другой Display Manager.
|
||
|
||
После запуска Hyprland должен автоматически запускаться Quickshell.
|
||
|
||
Проверь:
|
||
|
||
- Правильную пользовательскую сессию.
|
||
- D-Bus user session.
|
||
- XDG_RUNTIME_DIR.
|
||
- systemd user services.
|
||
- Переменные Wayland.
|
||
- Корректное завершение оболочки при выходе из Hyprland.
|
||
|
||
На телефоне разрешается отдельный механизм автозапуска, но он не должен ослаблять безопасность входа.
|
||
|
||
Не настраивай автоматический вход без явного подтверждения пользователя.
|
||
|
||
---
|
||
|
||
# 18. Полноценное приложение Settings
|
||
|
||
Создай отдельное, реально работающее приложение настроек, тесно интегрированное с Quickshell и Hyprland.
|
||
|
||
Название приложения: **Settings**.
|
||
|
||
Дизайн: Google Material Design 3.
|
||
|
||
Settings должно быть доступно:
|
||
|
||
- Через лаунчер.
|
||
- Через Quick Settings.
|
||
- Через Home Screen.
|
||
- Через меню приложений.
|
||
- Через отдельный `.desktop` файл.
|
||
|
||
Допускается реализация отдельным QML-приложением или выделенным окном Quickshell, если выбранная архитектура обеспечивает правильную работу, независимое открытие, фокус и безопасность.
|
||
|
||
## Адаптивный дизайн Settings
|
||
|
||
### Phone
|
||
|
||
Используй стиль Android Material 3 Settings:
|
||
|
||
- Вертикальный список разделов.
|
||
- Крупные сенсорные элементы.
|
||
- Поиск настроек.
|
||
- Вложенные страницы.
|
||
- Кнопка «Назад».
|
||
- Поддержка боковых жестов.
|
||
- Корректная работа экранной клавиатуры.
|
||
|
||
### Tablet
|
||
|
||
- Navigation Rail.
|
||
- Двухпанельный интерфейс.
|
||
- Список разделов слева.
|
||
- Содержимое справа.
|
||
|
||
### Desktop
|
||
|
||
- Боковая навигация.
|
||
- Поиск.
|
||
- Настройки в основной области.
|
||
- Поддержка мыши и клавиатуры.
|
||
- Изменение размера окна.
|
||
- Многомониторность.
|
||
|
||
## Разделы Settings
|
||
|
||
### 18.1. Главная страница
|
||
|
||
Показывай:
|
||
|
||
- Название устройства.
|
||
- Версию Linux.
|
||
- Версию ядра.
|
||
- Архитектуру CPU.
|
||
- Версию Hyprland.
|
||
- Версию Quickshell.
|
||
- Состояние сети.
|
||
- Состояние батареи, если доступна.
|
||
|
||
### 18.2. Wi-Fi и сеть
|
||
|
||
- Wi-Fi on/off.
|
||
- Список доступных сетей.
|
||
- Подключение к сети.
|
||
- Сохранённые подключения.
|
||
- Ethernet.
|
||
- IP-адреса.
|
||
- DNS.
|
||
- Настройки прокси, если реализован соответствующий backend.
|
||
- VPN через NetworkManager, если поддерживается.
|
||
|
||
### 18.3. Bluetooth
|
||
|
||
- Включение.
|
||
- Поиск устройств.
|
||
- Сопряжение.
|
||
- Подключение.
|
||
- Отключение.
|
||
- Удаление сопряжения.
|
||
- Информация об устройстве.
|
||
|
||
### 18.4. Звук
|
||
|
||
- Громкость.
|
||
- Микрофон.
|
||
- Устройства вывода.
|
||
- Устройства ввода.
|
||
- Баланс при поддержке backend.
|
||
- Звуки уведомлений.
|
||
- Звук блокировки.
|
||
- Звуки интерфейса.
|
||
|
||
### 18.5. Дисплей
|
||
|
||
- Разрешение.
|
||
- Частота обновления.
|
||
- Масштабирование.
|
||
- Яркость.
|
||
- Поворот.
|
||
- Расположение мониторов.
|
||
- Основной монитор.
|
||
- Включение/отключение дисплеев.
|
||
- Автоматический поворот при наличии датчиков.
|
||
|
||
Не применяй неподдерживаемые режимы мониторов.
|
||
|
||
Предусмотри подтверждение опасных изменений с автоматическим откатом.
|
||
|
||
### 18.6. Обои и стиль
|
||
|
||
- Выбор обоев.
|
||
- Отдельные обои для Home Screen и Lock Screen.
|
||
- Видеообои.
|
||
- Слайд-шоу.
|
||
- Dynamic Color.
|
||
- Accent Color.
|
||
- Светлая/тёмная/системная тема.
|
||
- AMOLED.
|
||
- Размеры элементов.
|
||
- Шрифты.
|
||
- Анимации.
|
||
- Reduced Motion.
|
||
|
||
### 18.7. Home Screen
|
||
|
||
- Сетка приложений.
|
||
- Размер иконок.
|
||
- Dock.
|
||
- Количество страниц.
|
||
- Папки.
|
||
- Виджеты.
|
||
- Скрытие приложений из домашней сетки.
|
||
- Настройки App Drawer.
|
||
|
||
### 18.8. Жесты и навигация
|
||
|
||
- Включение жестовой навигации.
|
||
- Чувствительность.
|
||
- Зоны распознавания.
|
||
- Свайп домой.
|
||
- Recent Apps.
|
||
- Назад с левого края.
|
||
- Назад с правого края.
|
||
- Переключение приложений.
|
||
- Анимации.
|
||
- Тактильная отдача при наличии.
|
||
- Режим трёх навигационных кнопок как опциональная альтернатива, если реализован.
|
||
|
||
### 18.9. Уведомления
|
||
|
||
- Разрешения по приложениям.
|
||
- История.
|
||
- Группировка.
|
||
- Do Not Disturb.
|
||
- Звуки.
|
||
- Отображение на Lock Screen.
|
||
- Скрытие чувствительного содержимого.
|
||
- Всплывающие уведомления.
|
||
|
||
### 18.10. Панель и Quick Settings
|
||
|
||
- Положение панели.
|
||
- Высота.
|
||
- Автоскрытие.
|
||
- Состав индикаторов.
|
||
- Порядок Quick Settings.
|
||
- Размер переключателей.
|
||
- Состав быстрых действий.
|
||
- Поведение шторки.
|
||
|
||
### 18.11. Многозадачность
|
||
|
||
- Настройки Recent Apps.
|
||
- Анимации.
|
||
- Поведение окон.
|
||
- Tiling/Floating.
|
||
- Gaps.
|
||
- Borders.
|
||
- Скругления.
|
||
- Рабочие пространства.
|
||
- Правила отдельных приложений.
|
||
|
||
### 18.12. Блокировка и безопасность
|
||
|
||
- Способ блокировки.
|
||
- Время автоматической блокировки.
|
||
- Блокировка при suspend.
|
||
- Настройки Hypridle.
|
||
- Отпечатки пальцев.
|
||
- Приватность уведомлений.
|
||
- Настройки экрана блокировки.
|
||
|
||
Не позволяй отключать обязательную проверку личности без соответствующей авторизации.
|
||
|
||
### 18.13. Питание и батарея
|
||
|
||
- Процент заряда.
|
||
- Состояние зарядки.
|
||
- Профиль энергопотребления.
|
||
- Тайм-аут дисплея.
|
||
- Тайм-аут блокировки.
|
||
- Suspend.
|
||
- Настройки энергосбережения.
|
||
- Статистика батареи, если данные доступны.
|
||
|
||
### 18.14. Клавиатура и ввод
|
||
|
||
- Раскладки клавиатуры.
|
||
- Переключение языка.
|
||
- Повтор клавиш.
|
||
- Настройки мыши.
|
||
- Настройки тачпада.
|
||
- Сенсорный ввод.
|
||
- Экранная клавиатура.
|
||
- Скорость указателя.
|
||
- Жесты тачпада, если поддерживаются.
|
||
|
||
### 18.15. Приложения
|
||
|
||
- Список установленных приложений.
|
||
- Информация о приложениях.
|
||
- Настройки отображения в лаунчере.
|
||
- Приложения по умолчанию через XDG.
|
||
- Автозапуск пользовательских приложений.
|
||
- Разрешения Flatpak через подходящие системные инструменты, если доступны.
|
||
|
||
Не обещай универсальное управление разрешениями для обычных несандбоксированных Linux-приложений.
|
||
|
||
### 18.16. Система
|
||
|
||
- Информация об устройстве.
|
||
- CPU.
|
||
- RAM.
|
||
- GPU.
|
||
- Версия ядра.
|
||
- Версия Hyprland.
|
||
- Версия Quickshell.
|
||
- Информация о дисплеях.
|
||
- Диагностика оболочки.
|
||
- Экспорт конфигурации.
|
||
- Импорт конфигурации.
|
||
- Сброс настроек оболочки с подтверждением.
|
||
|
||
### 18.17. Developer Options
|
||
|
||
- Принудительный phone/tablet/desktop mode.
|
||
- Отображение FPS, если доступно.
|
||
- Отображение нагрузки CPU.
|
||
- Отображение RAM.
|
||
- Отладка жестов.
|
||
- Логи Quickshell.
|
||
- Логи интеграции Hyprland.
|
||
- Диагностика D-Bus.
|
||
- Проверка системных сервисов.
|
||
- Перезапуск пользовательской оболочки.
|
||
- Безопасный возврат к предыдущей конфигурации.
|
||
|
||
---
|
||
|
||
# 19. Настройки должны реально работать
|
||
|
||
Не создавай декоративное приложение Settings.
|
||
|
||
Каждый переключатель должен:
|
||
|
||
1. Читать реальное состояние.
|
||
2. Показывать его пользователю.
|
||
3. Изменять соответствующую настройку через поддерживаемый API.
|
||
4. Обрабатывать ошибки.
|
||
5. Сохранять пользовательские предпочтения там, где это необходимо.
|
||
6. Обновлять UI после изменения состояния извне.
|
||
|
||
Если функция не поддерживается устройством, скрывай её или показывай понятное состояние «Не поддерживается».
|
||
|
||
Не используй фиктивные данные.
|
||
|
||
Для операций, требующих привилегий, используй стандартные механизмы авторизации Linux, включая polkit, если это применимо.
|
||
|
||
Не запускай весь Settings от root.
|
||
|
||
---
|
||
|
||
# 20. Единое хранилище настроек
|
||
|
||
Создай общую систему конфигурации для Quickshell и Settings.
|
||
|
||
Требования:
|
||
|
||
- Сохранение настроек.
|
||
- Валидация значений.
|
||
- Версионирование схемы.
|
||
- Миграции.
|
||
- Атомарная запись.
|
||
- Защита от повреждения файла.
|
||
- Синхронизация между открытыми окнами Settings и оболочкой.
|
||
- Отдельные настройки дисплеев.
|
||
- Общие настройки темы.
|
||
- Профили phone/tablet/desktop.
|
||
- Экспорт и импорт.
|
||
- Сброс настроек.
|
||
|
||
Используй XDG Base Directory Specification.
|
||
|
||
Не храни секреты Wi-Fi, VPN, пароли или биометрические данные в обычном JSON-файле оболочки.
|
||
|
||
Для секретов используй соответствующие системные хранилища и сервисы.
|
||
|
||
---
|
||
|
||
# 21. Производительность
|
||
|
||
Целевые устройства включают слабые ARM64-телефоны с 4 ГБ RAM и GPU Mali-G52 MC2 под Mesa/Panfrost.
|
||
|
||
Оптимизируй:
|
||
|
||
- Потребление RAM.
|
||
- CPU в простое.
|
||
- Количество QML-объектов.
|
||
- Перерисовку.
|
||
- Загрузку иконок.
|
||
- Обработку изображений.
|
||
- Анимации.
|
||
- Видеообои.
|
||
- Работу с D-Bus.
|
||
- Обработку событий Hyprland.
|
||
|
||
Не создавай постоянный polling там, где доступны события.
|
||
|
||
Используй ленивую загрузку.
|
||
|
||
Не допускай, чтобы закрытый Settings продолжал выполнять тяжёлые операции.
|
||
|
||
Добавь режим снижения визуальных эффектов для слабых устройств.
|
||
|
||
Сравни фактические показатели с исходной конфигурацией Waybar + SwayNC + Rofi + Hyprpaper.
|
||
|
||
Не придумывай результаты бенчмарков.
|
||
|
||
---
|
||
|
||
# 22. Тестирование на компьютере
|
||
|
||
Обязательно реализуй возможность тестирования phone и tablet mode на desktop.
|
||
|
||
Создай скрипты:
|
||
|
||
```text
|
||
scripts/test-desktop.sh
|
||
scripts/test-tablet.sh
|
||
scripts/test-phone.sh
|
||
scripts/test-settings.sh
|
||
```
|
||
|
||
Используй вложенную тестовую сессию Hyprland, если она поддерживается установленной системой.
|
||
|
||
Примерные размеры:
|
||
|
||
- Phone: 390×844.
|
||
- Tablet: 768×1024.
|
||
- Desktop: 1920×1080.
|
||
|
||
Тестовая сессия не должна менять основную конфигурацию Hyprland.
|
||
|
||
Поддержи эмуляцию сенсорных жестов мышью для UI-тестов.
|
||
|
||
Отдельно документируй, какие проверки требуют настоящего сенсорного экрана.
|
||
|
||
---
|
||
|
||
# 23. Тестирование на телефоне
|
||
|
||
Проверь:
|
||
|
||
- Arch Linux ARM aarch64.
|
||
- Запуск Hyprland.
|
||
- Запуск Quickshell.
|
||
- Status Bar.
|
||
- Home Screen.
|
||
- App Drawer.
|
||
- Recent Apps.
|
||
- Свайп домой.
|
||
- Свайп назад с обоих краёв.
|
||
- Уведомления.
|
||
- Quick Settings.
|
||
- Settings.
|
||
- Экранную клавиатуру.
|
||
- Блокировку.
|
||
- Fingerprint Unlock, если драйвер поддерживается.
|
||
- Suspend/resume.
|
||
- Поворот экрана.
|
||
- Управление яркостью.
|
||
- Управление громкостью.
|
||
- Батарею.
|
||
- Производительность.
|
||
|
||
Не заявляй об успешном аппаратном тестировании без реального запуска на устройстве.
|
||
|
||
---
|
||
|
||
# 24. Безопасная миграция
|
||
|
||
Переход должен происходить постепенно.
|
||
|
||
Порядок:
|
||
|
||
1. Сохрани резервную копию.
|
||
2. Проверь зависимости.
|
||
3. Реализуй Quickshell.
|
||
4. Запусти его в тестовом режиме.
|
||
5. Проверь панель.
|
||
6. Проверь уведомления.
|
||
7. Проверь лаунчер.
|
||
8. Проверь Settings.
|
||
9. Проверь обои.
|
||
10. Проверь мобильную навигацию.
|
||
11. Проверь новый Lock Screen.
|
||
12. Проверь fingerprint authentication.
|
||
13. Проверь Hypridle.
|
||
14. Проверь suspend/resume.
|
||
15. Только после успешных проверок отключи старые компоненты.
|
||
|
||
Сохрани возможность отката к:
|
||
|
||
- Waybar.
|
||
- SwayNC.
|
||
- Rofi.
|
||
- Hyprpaper.
|
||
- Hyprlock.
|
||
|
||
Особенно важно: не отключай Hyprlock, пока новый блокировщик не прошёл проверки безопасности и восстановления после сбоев.
|
||
|
||
---
|
||
|
||
# 25. Документация
|
||
|
||
Создай:
|
||
|
||
```text
|
||
README.md
|
||
AGENTS.md
|
||
ARCHITECTURE.md
|
||
IMPLEMENTATION_STATUS.md
|
||
TESTING.md
|
||
MIGRATION.md
|
||
ROLLBACK.md
|
||
```
|
||
|
||
README должен содержать:
|
||
|
||
- Установку на Arch Linux.
|
||
- Установку на Arch Linux ARM.
|
||
- Зависимости.
|
||
- Запуск из TTY.
|
||
- Автозапуск Quickshell.
|
||
- Запуск Settings.
|
||
- Переключение режимов.
|
||
- Настройку жестов.
|
||
- Настройку отпечатка пальца.
|
||
- Проверку блокировки.
|
||
- Тестирование мобильного интерфейса на ПК.
|
||
- Диагностику проблем.
|
||
- Возврат к исходной конфигурации.
|
||
|
||
В `IMPLEMENTATION_STATUS.md` отмечай для каждого компонента:
|
||
|
||
- Реализовано.
|
||
- Протестировано на desktop.
|
||
- Протестировано на ARM64.
|
||
- Требует проверки на устройстве.
|
||
- Имеет технические ограничения.
|
||
|
||
Не называй непроверенную функцию полностью готовой.
|
||
|
||
---
|
||
|
||
# 26. Порядок разработки
|
||
|
||
Работай последовательно:
|
||
|
||
1. Аудит существующей конфигурации.
|
||
2. Резервное копирование.
|
||
3. Архитектура Quickshell.
|
||
4. Material 3 Design System.
|
||
5. Общие системные сервисы.
|
||
6. Desktop Panel.
|
||
7. Notification Center.
|
||
8. Quick Settings.
|
||
9. Application Launcher.
|
||
10. Home Screen.
|
||
11. Recent Apps.
|
||
12. Gesture Navigation.
|
||
13. Tablet Layout.
|
||
14. Phone Layout.
|
||
15. Wallpaper Engine.
|
||
16. Settings Application.
|
||
17. Secure Lock Screen.
|
||
18. Fingerprint Authentication.
|
||
19. Hypridle Integration.
|
||
20. Multi-monitor Convergence.
|
||
21. ARM64 Optimization.
|
||
22. End-to-end Testing.
|
||
23. Исправление ошибок.
|
||
24. Документация и миграция.
|
||
|
||
После каждого этапа выполняй доступные тесты.
|
||
|
||
Не переходи к опасной замене механизма блокировки, пока не готовы проверки и откат.
|
||
|
||
---
|
||
|
||
# 27. Критерии завершения
|
||
|
||
Проект считается завершённым, когда:
|
||
|
||
- Существующая конфигурация Hyprland сохранена и адаптирована.
|
||
- Quickshell заменяет Waybar.
|
||
- Quickshell заменяет SwayNC.
|
||
- Quickshell заменяет Rofi в согласованных сценариях.
|
||
- Quickshell заменяет Hyprpaper.
|
||
- Hypridle продолжает работать.
|
||
- Экран блокировки безопасен.
|
||
- Отпечаток пальца работает на поддерживаемом оборудовании.
|
||
- Домашний экран работает.
|
||
- App Drawer работает.
|
||
- Recent Apps работает.
|
||
- Жесты работают на настоящем сенсорном экране.
|
||
- Назад работает с обоих боковых краёв там, где приложение поддерживает соответствующее действие.
|
||
- Свайп снизу вверх возвращает домой без удержания.
|
||
- Свайп сверху вниз открывает шторку.
|
||
- Настройки доступны через полноценное Material 3 Settings.
|
||
- Настройки действительно изменяют систему.
|
||
- Поддерживаются desktop, tablet и phone.
|
||
- Есть тесты для мобильного режима на ПК.
|
||
- Есть инструкции для ARM64.
|
||
- Нет необходимости устанавливать Display Manager.
|
||
- Нет ненужных постоянно работающих процессов.
|
||
- Есть безопасный механизм отката.
|
||
|
||
---
|
||
|
||
# 28. Финальные инструкции агенту
|
||
|
||
Начни с повторной сверки раздела 1 с рабочим деревом: `hypr/hyprland.lua`, его Lua-модули, конфигурации отдельных демонов и скрипты. Затем проверь реально загруженную конфигурацию и установленные версии компонентов. Отделяй проверенное по коду, проверенное в сессии и ещё не проверенное на оборудовании.
|
||
|
||
Не переписывай всё с нуля.
|
||
|
||
Не ограничивайся генерацией примеров кода.
|
||
|
||
Изменяй реальные файлы.
|
||
|
||
Если в существующей конфигурации уже есть нужная функциональность, сохрани её и интегрируй с новой оболочкой.
|
||
|
||
Не делай предположений о поддержке конкретного API без проверки.
|
||
|
||
Не придумывай команды Hyprland, Quickshell или системных сервисов.
|
||
|
||
Не создавай фиктивные UI-элементы.
|
||
|
||
Не отключай действующие средства безопасности без полноценной проверенной замены.
|
||
|
||
Продолжай разработку и исправление ошибок до максимально полного рабочего результата.
|
||
|
||
Если некоторые возможности требуют реального телефона, аппаратного драйвера или дополнительной интеграции с композитором, реализуй всё, что возможно в доступной среде, и документируй оставшиеся проверки.
|
||
|
||
**Начинай с аудита. Затем переходи к реализации, тестированию и интеграции. Главная цель — единая, быстрая, безопасная и адаптивная Material 3 оболочка для Hyprland на desktop, tablet и phone, полностью управляемая через собственное приложение Settings.**
|
||
|
||
# Дополнение: Dynamic Hardware Capability Detection & Adaptive UI
|
||
|
||
## 1. Основная задача
|
||
|
||
Реализуй динамическую систему обнаружения аппаратных и программных возможностей устройства для всей оболочки Hyprland + Quickshell и приложения Material 3 Settings.
|
||
|
||
**Главное правило: отображай только те элементы управления, для которых существует реальное поддерживаемое оборудование или доступная системная функция.**
|
||
|
||
Не показывай несуществующие переключатели и не создавай фиктивные устройства.
|
||
|
||
Это правило должно действовать во всех интерфейсах:
|
||
|
||
- Desktop Panel.
|
||
- Phone Status Bar.
|
||
- Tablet Status Bar.
|
||
- Quick Settings.
|
||
- Notification Shade.
|
||
- Settings Application.
|
||
- Lock Screen.
|
||
- Power Management.
|
||
- Device Management.
|
||
|
||
## 2. Обнаружение оборудования
|
||
|
||
Создай единый `HardwareCapabilityService`, который отслеживает доступные возможности через системные API.
|
||
|
||
Используй:
|
||
|
||
- NetworkManager D-Bus — сетевые интерфейсы и подключения.
|
||
- ModemManager D-Bus — мобильные модемы, SIM, мобильная передача данных.
|
||
- BlueZ D-Bus — Bluetooth-контроллеры.
|
||
- PipeWire/WirePlumber — аудиоустройства.
|
||
- UPower — аккумуляторы и питание.
|
||
- sysfs и udev — аппаратные устройства.
|
||
- iio-sensor-proxy — датчики ориентации.
|
||
- Hyprland IPC — мониторы и устройства ввода.
|
||
- fprintd — поддерживаемые сканеры отпечатков.
|
||
- Поддерживаемые интерфейсы управления подсветкой.
|
||
- Доступные интерфейсы управления фонариком.
|
||
|
||
Не выполняй непрерывный polling, если можно подписаться на события D-Bus, udev или композитора.
|
||
|
||
## 3. Динамические сетевые элементы
|
||
|
||
### Wi-Fi
|
||
|
||
Если Wi-Fi-адаптер отсутствует:
|
||
|
||
- Не показывай Wi-Fi в Quick Settings.
|
||
- Не показывай индикатор Wi-Fi в системной панели.
|
||
- Не показывай переключатель Wi-Fi в Settings.
|
||
- Не отображай пустой список беспроводных сетей.
|
||
|
||
Если адаптер подключён, соответствующие элементы должны появиться автоматически.
|
||
|
||
Если адаптер существует, но Wi-Fi выключен, показывай переключатель в состоянии Off, а не скрывай его.
|
||
|
||
### Ethernet
|
||
|
||
Если существует один или несколько проводных интерфейсов:
|
||
|
||
- Показывай Ethernet в Quick Settings.
|
||
- Показывай соответствующий сетевой статус в системной панели.
|
||
- Показывай раздел проводных сетей в Settings.
|
||
- Поддерживай несколько физических и виртуальных интерфейсов.
|
||
- Отображай реальное состояние каждого интерфейса.
|
||
- Показывай IP, скорость соединения и другие параметры, если они доступны.
|
||
- Поддерживай DHCP и статическую конфигурацию через NetworkManager.
|
||
- Не объединяй разные Ethernet-интерфейсы в одно фиктивное устройство.
|
||
|
||
Если Ethernet-интерфейсов несколько, показывай компактную сводку и раскрываемый список интерфейсов.
|
||
|
||
### Mobile Data / SIM
|
||
|
||
Если в системе отсутствует поддерживаемый мобильный модем:
|
||
|
||
- Не показывай Mobile Data.
|
||
- Не показывай SIM Settings.
|
||
- Не показывай индикатор сотового сигнала.
|
||
- Не показывай настройки APN.
|
||
- Не показывай переключатель мобильной передачи данных.
|
||
|
||
Если модем обнаружен, но SIM отсутствует, показывай состояние «Нет SIM» в соответствующем разделе, а не скрывай модем полностью.
|
||
|
||
Если есть несколько SIM или eSIM-профилей, поддерживай их в пределах возможностей ModemManager и оборудования.
|
||
|
||
Не путай отсутствие модема с отключённой мобильной передачей данных.
|
||
|
||
## 4. Пример поведения
|
||
|
||
| Оборудование | Видимые сетевые элементы |
|
||
| ----------------------------- | --------------------------------------------------- |
|
||
| Desktop с одним Ethernet | Ethernet |
|
||
| Desktop с двумя Ethernet | Ethernet 1, Ethernet 2 |
|
||
| Desktop с Ethernet + Wi-Fi | Ethernet, Wi-Fi |
|
||
| Ноутбук с Wi-Fi | Wi-Fi |
|
||
| Телефон с Wi-Fi + LTE | Wi-Fi, Mobile Data, SIM |
|
||
| Телефон без доступного модема | Wi-Fi, если адаптер обнаружен |
|
||
| ПК без сетевых устройств | Общий статус сети без несуществующих переключателей |
|
||
|
||
Общий раздел «Сеть» в Settings можно сохранять для диагностики и настройки будущих подключений, даже если сейчас нет доступных адаптеров.
|
||
|
||
## 5. Обнаружение других компонентов
|
||
|
||
Применяй ту же логику ко всем аппаратным функциям.
|
||
|
||
| Возможность | Когда показывать |
|
||
| --------------------- | -------------------------------------------- |
|
||
| Bluetooth | Есть поддерживаемый контроллер |
|
||
| Батарея | Есть доступный аккумулятор |
|
||
| Яркость | Есть управляемая подсветка дисплея |
|
||
| Микрофон | Есть доступный источник аудиоввода |
|
||
| Динамики / аудиовыход | Есть доступный аудиовыход |
|
||
| Отпечаток пальца | Есть поддерживаемый сканер |
|
||
| Фонарик | Есть доступный и управляемый LED |
|
||
| Автоповорот | Есть поддерживаемые датчики ориентации |
|
||
| Камера | Есть доступное устройство камеры |
|
||
| Внешние мониторы | Hyprland обнаруживает соответствующие выходы |
|
||
| Power Profiles | Есть поддерживаемый backend |
|
||
| NFC | Есть поддерживаемый NFC-контроллер |
|
||
|
||
Не считай наличие устройства доказательством того, что все его функции поддерживаются. Проверяй конкретные операции.
|
||
|
||
## 6. Различай состояния оборудования
|
||
|
||
Для каждой возможности реализуй состояния:
|
||
|
||
- `unavailable` — оборудование отсутствует.
|
||
- `available` — оборудование обнаружено.
|
||
- `disabled` — оборудование есть, но функция отключена.
|
||
- `blocked` — аппаратная или программная блокировка.
|
||
- `unsupported` — устройство обнаружено, но необходимый backend не поддерживает функцию.
|
||
- `error` — ошибка доступа или инициализации.
|
||
|
||
Не скрывай устройство только потому, что оно временно отключено, не подключено к сети или заблокировано через rfkill.
|
||
|
||
Если устройство поддерживается, но действие требует дополнительных разрешений, показывай его и корректно запрашивай авторизацию.
|
||
|
||
## 7. Горячее подключение оборудования
|
||
|
||
Поддерживай изменения без перезапуска Quickshell:
|
||
|
||
- Подключение USB Wi-Fi.
|
||
- Отключение Wi-Fi.
|
||
- Подключение Ethernet.
|
||
- Подключение USB Ethernet.
|
||
- Подключение Bluetooth-адаптера.
|
||
- Подключение внешнего аудиоустройства.
|
||
- Подключение внешнего монитора.
|
||
- Подключение или отключение зарядки.
|
||
- Появление и исчезновение модема.
|
||
|
||
Используй событийную модель.
|
||
|
||
Обновляй состояние и доступные элементы интерфейса автоматически.
|
||
|
||
## 8. Адаптивная компоновка
|
||
|
||
При исчезновении недоступного элемента остальные элементы должны занимать освободившееся место.
|
||
|
||
Не оставляй пустые плитки, разделители или пробелы.
|
||
|
||
Desktop:
|
||
|
||
- Компактная системная панель.
|
||
- Только реальные индикаторы.
|
||
- Quick Settings без несуществующих устройств.
|
||
|
||
Tablet:
|
||
|
||
- Адаптивная сетка переключателей.
|
||
- Перестройка при изменении доступных функций.
|
||
|
||
Phone:
|
||
|
||
- Только доступные плитки.
|
||
- Компактная status bar.
|
||
- Корректная компоновка при повороте дисплея.
|
||
|
||
Сохраняй пользовательский порядок плиток даже при временном исчезновении оборудования.
|
||
|
||
## 9. Settings Application
|
||
|
||
Все разделы Settings должны использовать общий `HardwareCapabilityService`.
|
||
|
||
Не создавай отдельную несовместимую логику определения устройств для каждого экрана.
|
||
|
||
Например:
|
||
|
||
- Если Wi-Fi отсутствует, скрывай Wi-Fi-настройки из обычного пользовательского интерфейса.
|
||
- Если обнаружен только Ethernet, показывай настройки Ethernet.
|
||
- Если есть несколько Ethernet, показывай каждый интерфейс отдельно.
|
||
- Если нет Bluetooth-контроллера, скрывай обычные Bluetooth-переключатели.
|
||
- Если нет аккумулятора, не показывай фиктивный процент заряда.
|
||
- Если нет сканера отпечатка, не предлагай регистрацию отпечатка.
|
||
|
||
Добавь в Developer Options отдельный раздел **Hardware Capabilities**, где можно увидеть все обнаруженные и отсутствующие возможности, причины недоступности и ошибки backend.
|
||
|
||
## 10. Тестирование
|
||
|
||
Реализуй автоматические тесты со смоделированными состояниями оборудования:
|
||
|
||
1. Только Ethernet.
|
||
2. Несколько Ethernet-интерфейсов.
|
||
3. Только Wi-Fi.
|
||
4. Ethernet + Wi-Fi.
|
||
5. Wi-Fi + LTE.
|
||
6. Модем без SIM.
|
||
7. Отсутствие Bluetooth.
|
||
8. Отсутствие батареи.
|
||
9. Отсутствие датчика яркости или управляемой подсветки.
|
||
10. Отсутствие сканера отпечатка.
|
||
11. Подключение USB-адаптера во время работы.
|
||
12. Отключение устройства во время открытых Settings.
|
||
|
||
Проверь, что пользовательский интерфейс обновляется корректно, не падает и не отображает фиктивные элементы.
|
||
|
||
Для тестов используй mock-backend, но никогда не подменяй реальные данные mock-значениями в обычном режиме.
|
||
|
||
## 11. Критерии готовности
|
||
|
||
- Система определяет реальные аппаратные возможности.
|
||
- Не показывает несуществующие переключатели.
|
||
- Сохраняет элементы для существующих, но отключённых устройств.
|
||
- Поддерживает несколько Ethernet-интерфейсов.
|
||
- Поддерживает появление и исчезновение устройств.
|
||
- Корректно перестраивает Material 3 интерфейс.
|
||
- Использует единый backend для Shell и Settings.
|
||
- Работает на x86_64 и aarch64.
|
||
- Не требует перезапуска Quickshell при hotplug.
|
||
- Не создаёт дополнительную постоянную нагрузку на CPU.
|
||
|
||
**Интегрируй эту систему в существующую архитектуру Quickshell + Hyprland + Material 3 Settings. Не реализуй её как отдельное приложение. Все компоненты оболочки должны использовать единый источник информации об аппаратных возможностях.**
|