---

# OBSIDIAN GLASS ANIME EDITION
# STAGE 02 — PREMIUM VISUAL FOUNDATION
## KDE Plasma 6.8 / Arch Linux / Wayland

Ты продолжаешь проект Obsidian Glass Anime Edition.

Stage 01 завершён. Пользователь предоставил скриншот и подтвердил, что основная функциональность панели работает.

Теперь необходимо исправить обнаруженные визуальные проблемы и создать полноценную эстетическую основу будущего рабочего стола.

**ВАЖНО: пользователь ожидает качественный законченный результат, а не формальное выполнение команд.**

Приоритет — визуальное качество, отсутствие регрессий, согласованность деталей и возможность отката.

Не переходи к Stage 03 самостоятельно.

---

# 0. ИСХОДНОЕ СОСТОЯНИЕ

Система по предыдущей диагностике:

- Arch Linux.
- KDE Plasma 6.8.2.
- KDE Frameworks 6.31.
- Qt 6.12.
- Wayland / KWin.
- Монитор 1920×1080, 60 Hz.
- Intel Pentium 6805.
- Intel integrated GPU + NVIDIA MX130.
- RAM 7.5 GiB.

Актуальность значений перепроверь перед работой.

Stage 01 уже реализовал:

- Одну нативную верхнюю Plasma-панель.
- Высоту 40 px.
- Floating=true.
- Автоматическое скрытие отключено.
- Пять виртуальных рабочих столов.
- Meta+1…Meta+5.
- Meta+A для launcher.
- Icons-Only Task Manager.
- System Tray.
- Wi-Fi, Bluetooth, часы.
- Отображение Happ и Throne.
- Отключение Waybar в KDE-сессии.

Текущий backup:

`~/.local/state/obsidian-glass/backups/20261102T151737-stage01`

**Не изменяй и не перезаписывай этот backup.**

Создай новый независимый backup Stage 02 перед модификациями.

# 1. НЕИЗМЕНЯЕМЫЕ ТРЕБОВАНИЯ

Все эти решения приняты пользователем.

1. Ровно ОДНА панель.
2. Панель расположена СВЕРХУ.
3. Только нативная KDE Plasma.
4. Никакой Waybar или нижней dock-панели.
5. Пять виртуальных рабочих столов, Meta+1…5.
6. Floating Launcher по Meta+A.
7. Тёмная палитра Abyss Black.
8. Subtle Glass — умеренная прозрачность.
9. Refined Borders.
10. Строгие скругления около 6–8 px.
11. Rich Color — качественные цветные иконки.
12. Плавные, сдержанные анимации.
13. Сохранение настроек Happ, Throne, Wi-Fi и Bluetooth.
14. Никакого глобального сброса KDE.

Не предлагай две панели.

Не заменяй выбранный пользователем минималистичный стиль на чрезмерно округлый, неоновый или перегруженный интерфейс.

Если отдельное требование невозможно реализовать без нестабильного решения, сообщи об ограничении и предложи альтернативу. Не меняй дизайн молча.

# 2. ИСПРАВЛЕНИЕ PAGER — ПРИОРИТЕТ №1

Пользователь обнаружил следующую особенность:

Когда первый рабочий стол содержит открытое окно, внутри тайла `01` появляется светло-серый прямоугольник.

Если переключиться на `02`, второй рабочий стол становится активным, но прямоугольник внутри `01` остаётся.

Это не ошибка переключения. Штатный Pager показывает геометрию окон через параметр Show window outlines.

## Задача

Отключи отображение контуров окон внутри Pager.

Для штатного `org.kde.plasma.pager` проверь актуальную конфигурационную схему.

Возможный параметр:

`showWindowOutlines = false`

Не применяй его вслепую. Убедись, что ключ действительно используется установленным плазмоидом.

Предпочитай официальный способ конфигурации Plasma.

Если есть параметр показа иконок внутри превью окон, проверь, не нужен ли его сброс для чистого визуального представления.

## Желаемое поведение

Пять компактных тайлов:

`01  02  03  04  05`

Активный стол:
- отчётливый акцентный фон;
- хорошо читаемая цифра;
- тонкая граница;
- визуальное отличие от всех остальных.

Неактивный стол:
- тёмный нейтральный фон;
- приглушённая цифра;
- никаких изображений окон внутри.

Hover:
- небольшое изменение яркости;
- не должен выглядеть как второй активный стол.

Открытие и закрытие окон не должно создавать дополнительные прямоугольники внутри тайлов.

## Acceptance tests

Проверь состояния:

A. Нет открытых окон.

B. Открыто окно на столе 01.

C. Активен стол 02, окно осталось на столе 01.

D. Есть окна одновременно на 01 и 02.

E. Переключение с помощью Meta+1…5.

F. Переключение мышью.

G. Hover на неактивном столе.

H. Возврат на 01.

**Критерий:** всегда ровно одна активная плитка, никаких контуров окон, переключение работает.

Это обязательно проверить до дальнейшего оформления.

# 3. DESIGN SYSTEM — ABYSS BLACK

Создай локальную, воспроизводимую и легко изменяемую дизайн-систему.

Название:

`Obsidian Glass — Abyss Black`

Не используй полный сторонний Global Look-and-Feel, который способен сбросить панель или пользовательские настройки.

Предпочтительная архитектура:

- отдельная KDE Color Scheme;
- отдельный локальный Plasma Style на основе совместимых компонентов Breeze;
- оформление панели через штатный механизм SVG;
- отдельная тема иконок;
- сохранение существующих shortcuts и layout.

## Основная палитра

| Элемент | HEX |
|---|---|
| Deep Background | #080A0F |
| Secondary Background | #10141C |
| Window Surface | #151A23 |
| Elevated Surface | #1C2330 |
| Primary Text | #E7EDF6 |
| Secondary Text | #9BAABD |
| Muted Text | #75849A |
| Primary Accent | #87B7D8 |
| Accent Hover | #A1CBE8 |
| Border | #303D50 |
| Subtle Divider | #252F3D |
| Selection Background | #263E52 |

Эти значения задают визуальный ориентир.

При реализации разрешается немного скорректировать оттенки для контраста и совместимости с KDE, но не менять характер палитры.

Не использовать текущий фиолетовый #814DDE как главный акцент базовой темы.

Для будущих аниме-профилей будет разработана система адаптивных акцентных цветов.

## Контраст и читаемость

- Текст должен оставаться хорошо читаемым.
- Активное окно должно отличаться от неактивного.
- Выделение файлов и текста не должно сливаться с фоном.
- Не допускай светлого текста на светлой полупрозрачной поверхности.
- Не делай окна полностью прозрачными.
- Не добавляй неоновые рамки вокруг всего интерфейса.

Стиль — сдержанный, холодный, профессиональный.

# 4. PLASMA STYLE

Исследуй официальную документацию KDE Plasma 6 по локальным Plasma Styles.

Используй поддерживаемый формат пакета, включая metadata.json и необходимые SVG-компоненты.

Предпочтительное пользовательское расположение:

`~/.local/share/plasma/desktoptheme/`

Создай собственный идентификатор темы, не конфликтующий с системным Breeze.

Не редактируй файлы системного Breeze в `/usr/share` напрямую.

Не копируй весь системный стиль без необходимости.

Предпочитай минимальный набор изменяемых SVG с корректным наследованием отсутствующих компонентов.

Особое внимание:

- widgets/panel-background.svg
- dialogs/background.svg
- widgets/background.svg
- widgets/button.svg, если потребуется
- элементы выделения и наведения

Для каждого SVG:

- соблюдай соглашения KDE по ID элементов;
- учитывай правильную отрисовку углов;
- проверяй девятичастные background frames;
- не используй неподдерживаемые SVG-фильтры;
- избегай графических артефактов на границах;
- проверяй отрисовку на фактическом DPI.

Если создание собственного стиля приводит к регрессиям, используй проверенный Breeze как основу и исправляй компоненты последовательно.

# 5. ВЕРХНЯЯ ПАНЕЛЬ — ОБНОВЛЕНИЕ ВИЗУАЛА

## Цель

Сделать существующую верхнюю панель визуально похожей на дорогую плавающую тёмную панель, а не на стандартную полосу KDE.

Примерный характер:

- Dark Obsidian.
- Высота около 40 px.
- Аккуратные внутренние отступы.
- Строгие скругления.
- Мягкая тень.
- Едва заметная холодная граница.
- Умеренная прозрачность, если не ухудшает читаемость.
- Единая высота и выравнивание элементов.

## Floating Panel

По итогам Stage 01:

- floating=true;
- lengthMode=fill;
- панель фактически занимает всю ширину.

Ранее эксперименты с custom length приводили к асимметричному расположению.

Не повторяй те же неудачные эксперименты без новой технической гипотезы.

Исследуй:

1. Поддерживаемое изменение длины панели в Plasma 6.8.
2. Режим Fit content, если он доступен.
3. Правильное центральное выравнивание.
4. Возможности штатного визуального floating через Plasma Style.
5. Оформление floating background и соответствующих margin hints.

Разделяй:

- настоящую геометрию панели;
- её фоновое изображение;
- прозрачные визуальные поля.

Пользователь хочет плавающий вид с симметричными отступами.

Однако не допускается делать невидимые области, которые неожиданно перекрывают клики или создают неправильное поведение окон.

Если настоящий симметричный inset невозможно безопасно получить, сохрани стабильную геометрию и предложи честный визуальный компромисс.

**Не выдавай визуальную имитацию за изменение реальной геометрии.**

## Компоновка

Слева:
- Launcher.
- Pager 01–05.

Центр:
- Icons-Only Task Manager.

Справа:
- System Tray.
- Wi-Fi.
- Bluetooth.
- Happ.
- Throne.
- Звук.
- Уведомления.
- Часы.

Поскольку экран 1920×1080, оставь резерв пространства для будущих метрик и музыкального визуализатора.

Не добавляй их сейчас.

## Контроль размеров

- Панель ориентировочно 38–42 px.
- Равномерные отступы между иконками.
- Без обрезанных значков.
- Без слишком маленьких текстовых индикаторов.
- Без огромного пустого промежутка, визуально ломающего баланс.
- Popup-окна не должны перекрываться верхней границей экрана.
- Порядок закреплённых приложений не менять без необходимости.

# 6. FLOATING LAUNCHER — META+A

Пользователь выбрал вариант C — Floating Launcher.

Это НЕ центральный Spotlight и НЕ полноэкранный Dashboard.

## Желаемый результат

Небольшое красивое выпадающее меню, привязанное к launcher в верхней панели.

Требования:

- тёмный фон;
- лёгкая прозрачность, если поддерживается;
- строгие скругления 6–8 px;
- тонкая рамка;
- красивые цветные иконки;
- поиск приложений;
- избранное;
- категории при необходимости;
- открытие Meta+A;
- управление клавиатурой;
- Enter для запуска;
- Esc для закрытия;
- быстрый отклик.

Визуальный характер — Abyss Black.

## Размер

Ориентировочный диапазон:
- ширина 360–480 px;
- высота 380–520 px.

Это не обязательные фиксированные размеры. Подстрой под содержимое, доступные штатные настройки и экран 1920×1080.

Меню не должно занимать половину экрана без необходимости.

## Выбор реализации

Сравни совместимые варианты:

1. Штатный Kickoff с настройкой внешнего вида.
2. Штатный Application Menu / Kicker.
3. Другие проверенные решения Plasma 6, если они действительно нужны.

Выбирай не по количеству визуальных эффектов, а по соответствию требованиям.

Критерии:
- стабильность на Plasma 6.8;
- компактный popup;
- быстрый поиск;
- управление клавиатурой;
- поддержка Favorites;
- интеграция с Plasma;
- возможность стилизации;
- низкий расход ресурсов.

Если Kicker лучше соответствует выбранному стилю, разрешается предложить его как основного кандидата.

Не заменяй существующий launcher без предварительной проверки, что Meta+A останется рабочим.

Сохраняй возможность возврата к Kickoff.

Не устанавливай сторонние QML-плазмоиды без отдельного подтверждения.

Не изменяй системные файлы Kickoff/Kicker для изменения размеров popup.

## Тесты

- Meta+A открывает меню.
- Повторное нажатие корректно закрывает или переключает его.
- Сразу после открытия можно вводить текст поиска.
- Поиск находит Kitty, Firefox, Dolphin, Kate, VS Code.
- Enter запускает выбранное приложение.
- Esc закрывает меню.
- Favorites работают.
- Клик вне меню закрывает его.
- Popup появляется в правильном месте относительно верхней панели.
- Нет конфликтов с Meta+1…5.
- После повторного открытия сохраняются параметры и размеры.

Если отдельные тесты требуют участия пользователя, выдай понятный короткий чеклист.

# 7. RICH COLOR ICONS

Пользователь окончательно выбрал полноценные цветные иконки.

Breeze Dark не должен оставаться конечным вариантом только потому, что он установлен по умолчанию.

Исследуй 2–3 актуальных набора иконок, совместимых с Plasma 6.

Например, рассмотри Papirus, Fluent или другие качественные варианты, но не считай их автоматически лучшими.

Оцени:

- единообразие;
- цветовую насыщенность;
- поддержку основных приложений;
- поддержку файловых типов;
- тёмный интерфейс;
- соответствие Abyss Black;
- читаемость на 40 px панели;
- наличие значков приложений разработчика;
- качество иконок каталогов в Dolphin.

Желаемые цвета:

- умеренные, насыщенные;
- холодные оттенки преобладают;
- красочные иконки приложений сохраняют узнаваемость;
- нет ощущения случайного набора из нескольких тем.

Не меняй иконки Happ/Throne вручную и не подменяй их состояние.

При необходимости установки пакетов сначала предоставь краткое сравнение и запроси согласие.

Для сторонних пакетов проверь происхождение и актуальность.

Не запускай скрипты установки из неизвестных источников.

# 8. WINDOW DECORATIONS

Не забывай о первоначальном требовании:

**Refined Borders + строгие скругления 6–8 px.**

Проверь штатные возможности установленного Breeze и KWin.

Отсутствие отдельного KWin-эффекта roundedcorners не означает, что оконная декорация вообще не умеет скруглять углы.

Сначала используй безопасные штатные возможности.

Если собственная форма окон требует сторонней декорации, отдельно оцени совместимость с Plasma 6.8, Wayland и NVIDIA.

Не устанавливай стороннюю декорацию автоматически.

Требования:

- тонкая холодная рамка;
- заметная, но мягкая активная подсветка;
- читаемые кнопки управления;
- минималистичный titlebar;
- отсутствие чрезмерных радиусов;
- отсутствие артефактов на углах.

Не ухудшай работу окон приложений с собственными заголовками.

# 9. АНИМАЦИИ И ПРОИЗВОДИТЕЛЬНОСТЬ

Оборудование ограничено, поэтому качество важнее количества эффектов.

Пользователь хочет плавный интерфейс, а не максимально эффектный набор анимаций.

Требования:

- Не включать множество сторонних KWin effects.
- Не создавать постоянные фоновые анимации без необходимости.
- Не увеличивать blur до уровня, ухудшающего читаемость.
- Не запускать постоянные демоны для декоративных функций.
- Не изменять глобальные NVIDIA-переменные и драйверы.
- Не вмешиваться в настройки производительности всей системы.

Проверь нагрузку до и после изменений.

Если CPU уже сильно нагружен или температура повышена, не делай вывод, что причина исключительно в темах.

Измерения должны быть сопоставимыми и сопровождаться указанием условий.

# 10. ПРЕДОТВРАЩЕНИЕ РЕГРЕССИЙ

Это обязательный раздел.

В Stage 01 возникла ситуация, когда технически рабочий Pager визуально воспринимался как неисправный.

Наша задача — предотвращать такие ситуации.

Перед изменением любого компонента:

1. Определи его назначение.
2. Изучи текущие настройки.
3. Выяви стандартное поведение, которое может выглядеть как ошибка.
4. Проверь доступные настройки.
5. Определи желаемое состояние.
6. Выполни минимальное необходимое изменение.
7. Проверь результат не только технически, но и визуально.

Не делай вывод о завершённости только потому, что скрипт выполнился успешно.

Для каждого компонента проверяй:

- обычное состояние;
- hover;
- active;
- inactive;
- popup;
- наличие открытых окон;
- несколько виртуальных рабочих столов;
- переключение приложений;
- сохранение конфигурации.

Не устраняй один визуальный дефект ценой появления другого.

# 11. BACKUP И ROLLBACK

Перед Stage 02:

- создай независимый snapshot пользовательских KDE-настроек, которые затронет этап;
- сохрани работающую конфигурацию единственной верхней панели;
- сохрани существующую тему, иконки и цвета;
- сохрани конфигурацию Launcher;
- сохрани конфигурацию Pager;
- сохрани используемые сочетания клавиш.

Каталог:

`~/.local/state/obsidian-glass/backups/<timestamp>-stage02/`

Подготовь:

- manifest;
- backup;
- rollback script;
- README по восстановлению.

Проверь синтаксис скриптов и целостность резервных данных.

Не запускай реальный rollback поверх рабочей системы только ради тестирования.

Если возможно, проверь восстановление на временной копии конфигурации.

Никогда не перезаписывай Stage 01 backup.

# 12. ПОРЯДОК РЕАЛИЗАЦИИ

Работай в таком порядке.

## Stage 02A — Pager

- Создать backup.
- Отключить outlines.
- Проверить active/hover.
- Проверить Meta+1…5.
- Сохранить результат.

## Stage 02B — Abyss Black Foundation

- Создать локальную цветовую схему.
- Подготовить Plasma Style.
- Проверить пакет темы.
- Применить компоненты.
- Проверить контраст и читаемость.

## Stage 02C — Panel Appearance

- Улучшить фон панели.
- Проверить floating appearance.
- Настроить отступы.
- Визуально выровнять элементы.
- Проверить popup и системный трей.

## Stage 02D — Floating Launcher

- Оценить штатные alternatives.
- Выбрать подходящий вариант.
- Настроить compact popup.
- Сохранить Meta+A.
- Проверить поиск и запуск.

## Stage 02E — Rich Color Icons & Windows

- Подобрать иконки.
- Согласовать установку при необходимости.
- Настроить иконки.
- Проверить оконные декорации.
- Проверить Dolphin и приложения.

## Stage 02F — Quality Assurance

Провести итоговые проверки, подготовить скриншоты и отчёт.

Если промежуточный этап не прошёл проверку, не переходи к следующему с заведомо сломанной конфигурацией.

Допускается самостоятельно выполнять безопасные, обратимые пользовательские изменения, входящие в этот этап, после создания резервной копии.

**Перед установкой сторонних пакетов, системными изменениями, опасным перезапуском сессии или потенциально необратимым действием обязательно запроси подтверждение.**

# 13. ВИЗУАЛЬНАЯ ПРОВЕРКА

Недостаточно просто сообщить, что цвета и тема применились.

Нужна настоящая проверка результата.

Желательно получить скриншоты:

1. Чистый рабочий стол.
2. Открытое меню Meta+A.
3. Активный рабочий стол 01, открыто одно окно.
4. Активный рабочий стол 02, окна есть на 01 и 02.
5. Dolphin.
6. Несколько открытых окон.
7. Popup системного трея.

Если у тебя есть доступный безопасный способ создания скриншотов, используй его только с учётом приватности пользователя.

Не захватывай пароли, токены и конфиденциальную информацию.

Если визуально проверить результат самостоятельно нельзя, попроси пользователя прислать скриншоты.

Не заявляй о прохождении визуальных тестов, которых фактически не проводил.

# 14. КРИТЕРИИ ПРИЁМКИ

Stage 02 считается завершённым только при соблюдении следующих условий.

[ ] Ровно одна верхняя Plasma-панель.

[ ] Нет Waybar и нижнего dock.

[ ] Панель остаётся функциональной.

[ ] Pager показывает пять рабочих столов.

[ ] Нет прямоугольников открытых окон внутри Pager.

[ ] Активный стол визуально однозначен.

[ ] Meta+1…5 работают.

[ ] Meta+A открывает компактный Floating Launcher.

[ ] Поиск и запуск программ работают.

[ ] Панель оформлена в Abyss Black.

[ ] Цвета приложений согласованы с тёмной палитрой.

[ ] Иконки соответствуют Rich Color.

[ ] Popup-окна читаемы.

[ ] Оконные рамки соответствуют Refined Borders в пределах технической совместимости.

[ ] Нет очевидных визуальных артефактов.

[ ] Wi-Fi, Bluetooth и tray доступны.

[ ] Happ и Throne не затронуты.

[ ] Закреплённые приложения сохранились.

[ ] Отзывчивость системы не ухудшилась заметно.

[ ] Backup создан и проверен.

[ ] Rollback подготовлен.

[ ] Не осталось неописанных отклонений.

Для каждого пункта в финальном отчёте укажи один из статусов:

- PASS — проверено;
- FAIL — проверено, обнаружена проблема;
- NOT TESTED — не проверено;
- BLOCKED — невозможно завершить без согласования или зависимости.

Не отмечай PASS без подтверждения.

# 15. ЧТО НЕ ДЕЛАТЬ

На Stage 02 запрещено:

- Менять Ly на SDDM.
- Менять экран входа.
- Устанавливать CAVA.
- Создавать аудиовизуализатор.
- Создавать Theme Switcher.
- Изменять Kitty и Zsh prompt.
- Изменять конфигурацию VS Code.
- Скачивать аниме-обои.
- Создавать новые виртуальные рабочие столы.
- Менять Meta+1…5.
- Менять настройки прокси и VPN.
- Изменять драйверы или конфигурацию GPU.
- Устанавливать непроверенные Global Themes.
- Добавлять постоянные фоновые сервисы ради оформления.
- Переходить к Stage 03.

Все эти задачи относятся к другим этапам.

# 16. ИТОГОВЫЙ ОТЧЁТ

После выполнения предоставь результат на русском языке.

Структура:

## A. Выполненные изменения
Конкретно что изменилось.

## B. Конфигурационные файлы
Какие файлы созданы и изменены.

## C. Дизайн
Какие цвета, размеры, иконки и оформление использованы.

## D. Pager
Результаты проверки пяти рабочих столов.

## E. Floating Launcher
Выбранный вариант и результаты тестирования.

## F. Panel
Геометрия, floating, визуальные отступы, layout.

## G. Performance
Измеренные наблюдения до/после, без выдуманных цифр.

## H. Quality Assurance
Таблица всех критериев PASS / FAIL / NOT TESTED / BLOCKED.

## I. Backup / Rollback
Расположение, проверка и способ восстановления.

## J. Remaining Issues
Что не удалось, почему и как предлагаешь решить.

## K. Следующий этап
Кратко перечисли, что можно делать на Stage 03, но не начинай его.

# 17. ФИНАЛЬНОЕ ТРЕБОВАНИЕ

Не пытайся произвести впечатление количеством изменённых параметров.

**Цель — качественный, аккуратный, стабильный KDE rice, в котором каждый элемент выглядит как часть одной продуманной дизайн-системы.**

Наша целевая эстетика:

Premium dark workstation + Abyss Black + subtle sci-fi + anime art direction.

Не нужно копировать macOS, Windows 11 или случайные работы с r/unixporn.

Создавай собственное последовательное оформление Obsidian Glass.

Начинай с Stage 02A и продолжай этапы в указанном порядке, пока не встретишь действие, требующее отдельного согласования.

После выполнения Stage 02 остановись и дождись дальнейших инструкций.