Тема меняет весь внешний вид CubicLauncher: цвета, типографику, фон, иконки и детали интерфейса. Ничего не нужно компилировать или трогать код лаунчера: тема — это два текстовых файла и, при желании, несколько изображений и шрифтов.
Это руководство собирает настоящую тему от начала до конца, короткими шагами, с контрольной точкой после каждого. В итоге у вас будет устанавливаемый и опубликованный ZIP.
- Текстовый редактор и программа для создания ZIP-архивов.
- Недавняя версия CubicLauncher.
- Десять минут на первую рабочую тему.
Если вы хотите просто установить тему, сделанную другим автором, смотрите Как установить тему.
Как устроена темаредактировать
Лаунчер читает файлы темы, превращает их в CSS-переменные и применяет к интерфейсу. Поэтому почти всё настраивается объявлением значений, без написания селекторов:
Meta.toml → идентичность: имя, автор, версия, наследование
Definition.toml → внешний вид: цвета, фон, шрифты, иконки
Inject.css → детали, которых не хватает переменным (необязательно)
Layout.css → перестройка каркаса (необязательно)Каждый ключ в Definition.toml создаёт переменную с фиксированным префиксом. Например, accent = "#8FBF6A" в [colors] превращается в --accent, а primary = "#E6EFDC" в [text] — в --text-primary.
Существует две версии формата. В этом руководстве используется V2, текущая. V1 (theme.json) по-прежнему загружается для совместимости, но не поддерживает иконки, наследование и собственный CSS.
Шаг 1 — Создайте папку и манифестредактировать
Создайте папку для темы, например bosque, и внутри неё файл Meta.toml:
name = "Bosque"
author = "your_username"
version = "0.1.0"
description = "Тёмная тема с зелёным акцентом и лесным фоном."
format = 2
api_version = "2.1"С этими полями у вас уже есть корректная тема. format должен быть ровно 2, а api_version объявляет серию API, под которую написана тема: сейчас "2.1".
Затем добавьте Definition.toml с одной пустой секцией:
[colors]Сожмите папку в ZIP и перетащите его в окно лаунчера.
Контрольная точка: тема появляется в списке как Bosque, и при её активации интерфейс выглядит как прежде. Это правильно: вы ещё не изменили ни одного значения.
Лаунчер создаёт внутренний идентификатор из name и author: "Bosque" + "your_username" сохраняется как bosque_your_username в ~/.cubic/themes/. Именно этот идентификатор используется для наследования от другой темы.
Шаг 2 — Определите палитруредактировать
Тема держится на пяти цветах: фон, поверхность, текст, акцент и граница. Выберите их до того, как что-либо писать, — так остальное получится согласованным.
Добавьте эти две секции в Definition.toml:
[colors]
accent = "#8FBF6A"
accent-rgb = "143, 191, 106"
accent-hover = "#A5D182"
accent-text = "#0B120A"
bg-main = "#0B0F0B"
bg-sidebar = "#0F150F"
bg-card = "#131A13"
bg-input = "#080C08"
bg-item-active = "#1B261B"
bg-overlay = "rgba(5, 8, 5, 0.72)"
border-color = "rgba(143, 191, 106, 0.18)"
[text]
primary = "#E6EFDC"
secondary = "#AEBBA2"
muted = "#74806B"Что делает каждый из них:
| Ключ | Эффект |
|---|---|
bg-main | Фон окна. |
bg-sidebar | Фон боковой панели, на ступень светлее фона. |
bg-card | Карточки, модальные окна и панели. |
bg-input | Текстовые поля, на ступень темнее. |
accent | Кнопки, фокус, ссылки и активные элементы. |
accent-text | Текст, который находится поверх акцента. |
border-color | Границы и разделители. |
Контрольная точка: лаунчер меняется сразу. Если какой-то цвет не применяется, проверьте, что ключ находится в правильной секции, и загляните в консоль: повторяющиеся имена вызывают предупреждение о конфликте.
accent-rgb должен быть тем же цветом, что и accent, записанным как R, G, B без rgb(). Интерфейс использует его в rgba(var(--accent-rgb), 0.15) для свечений и границ. Если о нём забыть, эти детали сохранят исходный белый.
surface-rgb работает так же, но для полупрозрачных поверхностей. В тёмной теме он равен 255, 255, 255 (по умолчанию); в светлой теме он должен быть 0, 0, 0, иначе границы станут светлее, а не темнее.
Шаг 3 — Настройте границы, тени и размерыредактировать
Когда палитра готова, определите формы. Эти секции необязательны, но именно они делают тему законченной, а не просто перекрашенной:
[borders]
radius = "10px"
radius-sm = "6px"
radius-lg = "18px"
[shadows]
shadow-sm = "0 2px 8px rgba(0, 0, 0, 0.28)"
shadow-md = "0 10px 28px rgba(0, 0, 0, 0.36)"
shadow-lg = "0 18px 52px rgba(0, 0, 0, 0.50)"
[layout]
sidebar-width = "248px"
[spacing]
md = "12px"
lg = "16px"[borders] добавляет префикс --border-, [spacing] добавляет --space-, а [layout] не добавляет ничего: ключ — это полная переменная.
Контрольная точка: углы меняют радиус, карточки приобретают глубину, а боковая панель становится шире или уже.
Шаг 4 — Добавьте фоновое изображениередактировать
Фон придаёт больше всего индивидуальности. Положите изображение в папку темы и укажите его относительным путём:
[background]
reference_path = "bg.webp"
image_blur = 12.0
image_opacity = 0.32
mode = "cover"
position = "center"
brightness = 0.45| Ключ | Что контролирует | Полезный диапазон |
|---|---|---|
reference_path | Путь к изображению относительно темы. | — |
image_blur | Размытие в пикселях. | 0–24 |
image_opacity | Прозрачность слоя. | 0.2–0.6 |
mode | Кадрирование: cover, contain. | — |
position | center, top, bottom left… | — |
brightness | Яркость изображения. | 0.3–0.7 |
Чем ниже brightness и выше непрозрачность, тем лучше читается текст, но тем меньше видно изображение. Оптимальная точка обычно находится в диапазоне brightness от 0.35 до 0.5 и image_opacity около 0.35.
Контрольная точка: изображение видно за содержимым, размытое и затемнённое, не мешая чтению.
Изображение не может превышать 25 МБ и должно быть настоящим файлом изображения. Лаунчер проверяет заголовок файла, а не расширение: .png, который на самом деле является текстом, будет отклонён.
Используйте относительные пути. Абсолютные пути и file: работают на вашей машине, но ломают тему на любой другой.
Шаг 5 — Собственная типографикаредактировать
Вы можете использовать любой шрифт, который находится внутри пакета. Скопируйте файлы в fonts/ и объявите каждый вариант:
[[fonts]]
family = "Inter"
src = "fonts/Inter-Regular.woff2"
weight = "400"
style = "normal"
[[fonts]]
family = "Inter"
src = "fonts/Inter-SemiBold.woff2"
weight = "600"
style = "normal"
[typography]
family = "Inter, system-ui, sans-serif"
size_base = "14px"
line_height = "1.5"Важное правило: [typography].family должен упоминать то же семейство, которое объявлено в [[fonts]]. Если имя не совпадает, шрифт загружается, но интерфейс продолжает использовать типографику по умолчанию.
Контрольная точка: заголовки и текст меняют вид. Если ничего не изменилось, проверьте имя семейства и наличие пути src внутри ZIP.
Достаточно одного или двух семейств. Свыше 12 список показывает предупреждение, а лаунчер загружает только первые 20 вариантов.
Шаг 6 — Иконкиредактировать
Иконки объявляются по группам. Итоговый ключ — группа:имя, и он должен точно совпадать с именем, которое запрашивает компонент.
[icons]
preview = "icons/preview.png"
[icons.nav]
settings = "icons/nav/settings.svg"
create = "icons/nav/create.svg"
[icons.ui]
play = "icons/ui/play.svg"preview — изображение, представляющее вашу тему в списке; лучше, чтобы это был снимок лаунчера с применённой темой.
SVG используются как маска: они окрашиваются в цвет текста, поэтому монохромная иконка работает и в светлых, и в тёмных темах. PNG, WEBP и JPG отрисовываются своими собственными цветами.
Контрольная точка: иконки боковой панели меняются. Если какая-то иконка не меняется, ключ не совпадает с реальным именем: полный список находится в Справочнике по токенам.
Шаг 7 — Тонкие детали с помощью CSSредактировать
Переменные покрывают почти всё, но есть вещи, которые решаются только через CSS: псевдоэлементы, анимации, разделители. Для этого существует Inject.css.
Объявите секцию в Definition.toml и создайте файл:
[inject]
path = "Inject.css"
enabled = true
layer = "theme"/* Inject.css */
[data-part="sidebar"] {
border-right: 1px solid var(--border-color);
}
[data-part="sidebar"] .sidebar-header {
letter-spacing: 0.04em;
text-transform: uppercase;
}Ключевой момент — layer:
theme(по умолчанию) оборачивает ваш CSS в@layer cubic.theme. Он побеждает глобальные стили лаунчера, но проигрывает стилям каждого компонента.unlayeredоставляет CSS без слоя. Он соревнуется по специфичности со всем, включая компоненты. Это мощнее и хрупче.
Контрольная точка: изменение применяется без перезапуска. Если эффекта нет, попробуйте layer = "unlayered", прежде чем считать, что селектор неверен.
Избегайте зависимости от классов, сгенерированных Svelte (тех, что заканчиваются хешем), и от внутренних структур. Атрибуты data-part стабильны; остальное может меняться между версиями.
Шаг 8 — Упаковка, установка и проверкаредактировать
- В папке должны быть
Meta.tomlиDefinition.tomlв корне вместе с ресурсами. - Сожмите её в ZIP. Файлы могут лежать в корне ZIP или внутри одной папки-контейнера.
- Измените расширение на
.cbth, если хотите использовать формат пакета тем: это тот же ZIP под другим именем. - Установите его, перетащив в окно лаунчера или через Настройки → Темы → Импорт темы.
- Выберите его в списке.
Как лаунчер обрабатывает пакет:
- Ищет
Meta.tomlв корне или в папке-контейнере. Если находит больше одного, отклоняет ZIP. - Если присутствуют и
Meta.toml, иtheme.json, побеждает V2. .zipсначала проверяется как V1, затем как V2;.cbthинтерпретируется только как V2.- Установка атомарна: архив распаковывается во временную папку и перемещается в место назначения. Если проверка не прошла, ничего не остаётся в полусобранном виде.
- Место назначения —
~/.cubic/themes/<id>/. Повторный импорт темы с тем же именем и автором заменяет предыдущую версию.
Проверка изменений без повторного импортаредактировать
Пока тема активна, лаунчер следит за её папкой и перезагружает её сам. Редактируйте файлы в ~/.cubic/themes/<id>/ и смотрите результат в реальном времени: это гораздо быстрее, чем сжимать и заново импортировать при каждой правке.
Панель диагностики в списке тем сообщает о трёх вещах, которые не блокируют загрузку, но влияют на производительность: более 12 шрифтов, CSS больше 256 КиБ и фон больше 4096×4096 пикселей.
Шаг 9 — Публикация в каталогередактировать
Пользовательские темы живут в CubicLauncherDevs/Themes и появляются на cubiclauncher.org/themes.
src/
└── TuAutor/
└── TuTema/
├── theme.md # описание темы
├── vflag.txt # необязательно, только staff: помечает тему как проверенную
└── V1/
├── Meta.toml
├── Definition.toml
├── bg.webp
├── Showcase.png # необязательно, снимок для каталога
└── fonts/- Сделайте форк репозитория.
- Создайте
src/TuAutor/TuTema/theme.mdс кратким описанием. - Создайте
src/TuAutor/TuTema/V1/сMeta.toml,Definition.tomlи ресурсами. - Откройте Pull Request.
Непрерывная интеграция оптимизирует изображения, генерирует предпросмотр, загружает двоичные файлы в хранилище каталога и обновляет themes.json. Двоичные файлы не хранятся в Git.
Оптимизация темыредактировать
Тема читается при каждой активации: лаунчер разбирает оба манифеста, проверяет фон, открывая файл, просматривает каждую иконку, разрешает каждый шрифт и загружает CSS в память. Затем фронтенд декодирует изображение и регистрирует типографику, прежде чем показать интерфейс полностью. Тяжёлая тема выглядит не лучше: она просто появляется дольше.
Вот решения с наибольшим влиянием, от большего к меньшему.
Фон: самое большое изображение и то, что меньше всего нуждается в деталяхредактировать
Изображение отрисовывается размытым и с низкой непрозрачностью, поэтому разрешение почти не заметно. Фон 1600×900 выглядит так же, как 4K после размытия, но весит в восемь раз меньше и декодируется мгновенно.
| Практика | Почему |
|---|---|
| Экспортируйте в WebP с качеством 75–85. | Тот же вид, что у PNG, за долю веса. |
| Снизьте разрешение до 1600×900 или 1920×1080. | Размытие скрывает недостаток деталей. |
| Стремитесь к размеру менее 500 КБ. | Предел — 25 МБ, но реальная цель другая. |
Размывайте изображение в редакторе и используйте низкий image_blur. | Размытие в реальном времени пересчитывается по всему окну. |
| Избегайте размеров больше 4096×4096. | Список предупреждает о расходе памяти при декодировании. |
Высокий image_blur поверх большого изображения — самая дорогая комбинация: размытие оплачивается при каждой перерисовке. Если изображение уже размыто, image_blur = 0 даёт тот же результат без затрат.
Шрифты: только то, что используетсяредактировать
Каждый объявленный файл скачивается, регистрируется и применяется. Семейство с четырьмя начертаниями добавляет четыре файла.
- Используйте WOFF2. Это самый маленький формат и с наилучшей поддержкой.
- Объявляйте только те начертания, которые теме действительно нужны: обычно
400и600. - Предпочитайте шрифты с латинским подмножеством; шрифт с кириллицей, греческим и CJK может весить в десять раз больше.
- Два семейства — разумный максимум. Одного хорошо выбранного достаточно почти для всего.
Иконки: SVG и только те, что меняютсяредактировать
SVG весят несколько КБ и окрашиваются сами. Растровые (PNG, WEBP, JPG) загружаются со своими цветами и обычно весят гораздо больше.
- Заменяйте только иконки, которые придают индивидуальность. Каждая запись проверяется при загрузке темы, даже если она никогда не показывается.
- Не включайте иконку, если исходная вас устраивает.
- Если используете растровые изображения, держите их меньше 64×64 и 50 КБ: предел — 2 МБ, но иконка на 2 МБ появляется долго.
CSS: сначала переменные, потом селекторыредактировать
Inject.css загружается и интерпретируется при каждой активации. Всё, что решается переменной, должно решаться переменной.
- Если цвет, радиус или тень можно изменить из
Definition.toml, не пишите CSS. - Держите
Inject.cssменьше 16 КБ; рекомендуемый предел — 256 КиБ. - Не анимируйте
filter,backdrop-filterиbox-shadow: это самые дорогие для перерисовки свойства. - Избегайте
!important. Если он нужен, селектор выбран неправильно. - Не дублируйте в CSS то, что уже делает
Layout.css.
Токены: не повторяйте значения по умолчаниюредактировать
Каждая объявленная переменная вставляется в таблицу стилей. Повторение значения по умолчанию ничего не меняет и затрудняет чтение темы.
- Объявляйте только те токены, которые отличаются от лаунчера.
- Если два ключа создают одну и ту же переменную, оставьте один: другой вызовет предупреждение о конфликте.
- Для вариантов цвета используйте
extendsвместо копирования всей палитры. - Объявите
--color-scheme("dark"или"light") в[others], чтобы полосы прокрутки и нативные элементы управления соответствовали теме.
Целевые размерыредактировать
| Ресурс | Цель | Технический предел |
|---|---|---|
| Полный ZIP | менее 3 МБ | — |
| Фоновое изображение | менее 500 КБ | 25 МБ |
| Шрифты | менее 300 КБ суммарно | 12 рекомендуемых, 20 загружаемых |
| Иконки | менее 20, SVG | 100 предзагруженных |
Inject.css | менее 16 КБ | 256 КиБ рекомендуемый |
| Объявленные токены | от 25 до 40 ключей | — |
Как измерятьредактировать
- Смотрите на размер ZIP перед публикацией: это число видит тот, кто его скачивает.
- Панель диагностики в списке тем сообщает, если фон слишком большой, шрифтов слишком много или CSS превышает размер.
- Если тема долго появляется при переключении между темами, проблема почти всегда в фоновом изображении или количестве шрифтов.
Полный примерредактировать
Готовые к копированию Meta.toml и Definition.toml со всем из предыдущих шагов. Ресурсы (bg.webp, fonts/, icons/, Inject.css) необязательны: если их нет, лаунчер игнорирует их и продолжает с остальной частью темы.
# Meta.toml
name = "Bosque"
author = "your_username"
version = "1.0.0"
description = "Тёмная тема с зелёным акцентом и лесным фоном."
format = 2
api_version = "2.1"# Definition.toml
[colors]
accent = "#8FBF6A"
accent-rgb = "143, 191, 106"
accent-hover = "#A5D182"
accent-text = "#0B120A"
bg-main = "#0B0F0B"
bg-sidebar = "#0F150F"
bg-card = "#131A13"
bg-input = "#080C08"
bg-item-active = "#1B261B"
bg-overlay = "rgba(5, 8, 5, 0.72)"
border-color = "rgba(143, 191, 106, 0.18)"
[text]
primary = "#E6EFDC"
secondary = "#AEBBA2"
muted = "#74806B"
[borders]
radius = "10px"
radius-sm = "6px"
radius-lg = "18px"
[shadows]
shadow-sm = "0 2px 8px rgba(0, 0, 0, 0.28)"
shadow-md = "0 10px 28px rgba(0, 0, 0, 0.36)"
shadow-lg = "0 18px 52px rgba(0, 0, 0, 0.50)"
[layout]
sidebar-width = "248px"
[background]
reference_path = "bg.webp"
image_blur = 12.0
image_opacity = 0.32
mode = "cover"
position = "center"
brightness = 0.45
[[fonts]]
family = "Inter"
src = "fonts/Inter-Regular.woff2"
weight = "400"
style = "normal"
[[fonts]]
family = "Inter"
src = "fonts/Inter-SemiBold.woff2"
weight = "600"
style = "normal"
[typography]
family = "Inter, system-ui, sans-serif"
size_base = "14px"
line_height = "1.5"
[icons]
preview = "icons/preview.png"
[icons.nav]
settings = "icons/nav/settings.svg"
create = "icons/nav/create.svg"
[inject]
path = "Inject.css"
enabled = true
layer = "theme"Справочник полейредактировать
Meta.tomlредактировать
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
name | string | Да | Видимое имя. Не может быть пустым. |
author | string | Рекомендуется | Автор. Показывается в нижнем регистре и входит в идентификатор. |
version | string | Рекомендуется | Версия, желательно МАЖОР.МИНОР.ПАТЧ. |
description | string | Необязательно | Описание в одну строку для каталога. |
format | целое число | Да | Должно быть ровно 2. |
api_version | string | Необязательно | Серия API: "2.1". Допустимо любое значение 2.x; другое значение вызывает предупреждение. |
injects_css | логическое | Необязательно | Если false, Inject.css не загружается. |
extends | string | Необязательно | Идентификатор установленной темы V2, от которой наследовать. |
Идентификатор вычисляется при импорте: нижний регистр, пробелы заменяются на _, формат имя_автор. Максимум 64 символа, без :, / и обратной косой черты.
Как ключи превращаются в переменныередактировать
| Секция | Создаваемая переменная | Пример ключа | Результат |
|---|---|---|---|
[colors] | --{ключ} | accent = "#8FBF6A" | --accent |
[text] | --text-{ключ} | primary = "#E6EFDC" | --text-primary |
[borders] | --border-{ключ} | radius = "10px" | --border-radius |
[layout] | --{ключ} | sidebar-width = "248px" | --sidebar-width |
[shadows] | --{ключ} | shadow-md = "0 10px 28px #0006" | --shadow-md |
[backgrounds] | --bg-{ключ} | input = "#080C08" | --bg-input |
[backdrop] | --backdrop-blur-{ключ} | modal = 8.0 | --backdrop-blur-modal: 8px |
[others] | --{ключ} | icon-filter = "invert(1)" | --icon-filter |
[typography] | фиксированная таблица | size_base = "14px" | --font-size-base |
[spacing] | --space-{ключ} | lg = "16px" | --space-lg |
[motion] | --transition-{ключ} | fast = "0.15s" | --transition-fast |
[components.nombre] | --component-nombre-{ключ} | — | Зарезервировано |
[tokens] | буквально | "--bg-image-blur" = "12px" | --bg-image-blur |
Правила приоритета:
- Секции применяются в порядке таблицы, а
[tokens]идёт последним, поэтому всегда побеждает. - Если два ключа создают одну и ту же переменную, побеждает последний, и выдаётся предупреждение
Key collision.[colors] bg-mainи[backgrounds] main— это одна и та же переменная. [tokens]— это путь для переменных без собственной секции, таких как--bg-image-blurили--font-family-mono. Ключ должен начинаться с--.[components]превращается в переменные--component-*, но пока ни один компонент их не использует.
Значения копируются в CSS как есть: если CSS нужна единица измерения, включите её в значение ("12px", а не "12").
Typographyредактировать
| Поле | Переменная |
|---|---|
family | --font-family |
size_base | --font-size-base |
size_sm | --font-size-sm |
size_lg | --font-size-lg |
size_control | --font-size-control |
size_label | --font-size-label |
weight_normal | --font-weight-normal |
weight_medium | --font-weight-medium |
weight_bold | --font-weight-bold |
line_height | --line-height |
Наследование с extendsредактировать
Тема может наследовать токены другой установленной темы V2:
name = "Светлый лес"
author = "your_username"
version = "1.0.0"
format = 2
extends = "bosque_your_username"extendsсодержит установленный идентификатор, а не видимое имя. Префиксuser:допускается и отбрасывается.- Базовая тема должна быть установлена и быть V2.
- Максимальная глубина: 8 уровней. Цикл является ошибкой.
- Дочерняя тема побеждает ключ за ключом: то, что она не определяет, она наследует.
| Наследуется | Не наследуется |
|---|---|
colors, text, borders, layout, shadows | fonts |
backgrounds, backdrop, others, tokens | icons |
spacing, motion, components | [inject] |
typography поле за полем | [layout_pack] |
[background] поле за полем | background.reference_path |
Ресурсы не наследуются, потому что пути относительны к теме, которая их объявляет.
Layout packредактировать
Layout.css загружается в конце, без слоя, и служит для перестройки каркаса через стабильные атрибуты:
[layout_pack]
path = "Layout.css"
enabled = truedata-part | Элемент |
|---|---|
app | Корневой контейнер. |
sidebar | Контейнер боковой панели. |
sidebar-panel | Внутренняя панель (обычная или компактная). |
sidebar-header | Заголовок боковой панели. |
sidebar-content | Содержимое боковой панели. |
sidebar-sections | Список секций. |
content | Основная область. |
background-overlay | Слой фонового изображения. |
/* Layout.css — плавающая боковая панель */
[data-part="sidebar"] {
margin: 8px;
border-radius: var(--border-radius-lg);
border: 1px solid var(--border-color);
overflow: hidden;
}Пределы и проверкиредактировать
| Ресурс | Предел | Если превышен |
|---|---|---|
| Фоновое изображение | 25 МБ, корректное изображение | Фон игнорируется. |
| Растровые иконки | 2 МБ, SVG/PNG/WEBP/JPG | Иконка игнорируется. |
| Количество иконок | 100 рекомендуемых | Предзагружаются только первые 100. |
| Шрифты | 12 рекомендуемых, 20 загружаемых | Предупреждение; остальные не загружаются. |
Inject.css | 256 КиБ рекомендуемых | Предупреждение; всё равно загружается. |
| Разрешение фона | 4096×4096 | Предупреждение из-за памяти. |
Глубина extends | 8 уровней | Ошибка; тема не устанавливается. |
| Идентификатор | 64 символа | Ошибка; тема не устанавливается. |
Частые ошибкиредактировать
| Сообщение или симптом | Причина | Решение |
|---|---|---|
Meta.toml или theme.json не найден | В ZIP нет манифеста ни в корне, ни в папке-контейнере. | Проверьте структуру ZIP. |
Недопустимый Meta.toml | Некорректный TOML: незакрытые кавычки, повторяющаяся таблица. | Проверьте TOML любым линтером. |
format X не поддерживается; ожидался 2 | format отсутствует или не равен 2. | Добавьте format = 2. |
базовая тема 'x' не установлена или не является V2 | extends указывает на несуществующий идентификатор. | Используйте идентификатор установленной темы V2. |
Цикл наследования | A → B → A. | Уберите один из extends. |
Наследование слишком глубоко | Больше 8 уровней. | Упростите цепочку. |
| Цвета не меняются | Ключ в неправильной секции или несуществующая переменная. | Проверьте таблицу соответствия и консоль. |
| Один цвет остался прежним | Вы изменили accent, но не accent-rgb. | Обновите триплет. |
| Фон не появляется | Неверный путь, больше 25 МБ или файл не является изображением. | Используйте относительный путь и корректное изображение. |
| Шрифт не применяется | --font-family не упоминает семейство или src не существует. | Проверьте family, src и [typography].family. |
| Иконка не меняется | Ключ не совпадает с группа:имя. | Скопируйте точное имя из справочника. |
Inject.css не действует | Отсутствует [inject] или селектор проигрывает из-за слоя. | Объявите [inject] и попробуйте layer = "unlayered". |
Контрольный списокредактировать
Перед тем как поделиться темой:
format = 2и непустойname.- ZIP открывается с
Meta.tomlиDefinition.tomlв корне или в папке-контейнере. accent-rgbсовпадает сaccent;surface-rgbсоответствует светлой или тёмной теме.- Контраст не менее 4.5:1 между
--text-primaryи--bg-main. - Фон весит менее 25 МБ и использует относительный путь.
- Шрифты находятся внутри пакета, с совместимой лицензией, и
--font-familyих упоминает. - Иконки используют точные ключи
группа:имя. - Если вы используете
extends, базовая тема — V2 и установлена. - Вы проверили обычное, компактное и развёрнутое окно.
- Тема устанавливается с нуля на чистой копии лаунчера.
Дизайн тем с помощью ИИредактировать
Агент может написать полноценную тему, если получит точный формат, имена токенов и ограничения. Без этого он придумывает несуществующие переменные, и результат не применяется. А без бюджета веса он склонен заполнять тему ресурсами, которые ничего не добавляют.
Контракт форматаредактировать
Минимальная сводка, которую нужно дать модели:
- Два обязательных файла:
Meta.tomlиDefinition.toml. Meta.toml:name,author,version,description,format = 2,api_version = "2.1".Definition.toml: секции[colors],[text],[borders],[shadows],[layout],[backdrop],[others],[typography],[spacing],[motion],[tokens].- Префиксы:
[colors]и[layout]без префикса;[text]→--text-,[borders]→--border-,[spacing]→--space-,[motion]→--transition-. accent-rgbиsurface-rgb— это триплетыR, G, Bбезrgb().- Значения включают единицу измерения, когда она нужна CSS.
- Существуют только токены из справочника: новые имена не придумываются.
- Минимальный контраст 4.5:1 для основного текста.
Правила оптимизацииредактировать
Тема, сгенерированная ИИ, склонна к перегрузке: объявляет все 60 переменных, хотя меняются только 20, добавляет ненужный Inject.css и предлагает фон 4K. Эти ограничения предотвращают это:
- Минимум жизнеспособного: только ключи, которые меняют результат. Если значение совпадает с лаунчером, оно не нужно.
- Без CSS, если не запрошено явно: всё, что решается токенами, решается токенами.
- Пять ролей цвета: фон, поверхность, текст, акцент и граница. Больше ничего.
- Без выдуманных ресурсов: не просите изображения или шрифты, которых у пользователя нет. Если нужен фон, укажите размеры вместо файла.
- Бюджет веса: фон < 500 КБ, шрифты < 300 КБ, иконки < 20,
Inject.css< 16 КБ. - Стабильный порядок: всегда одни и те же секции, в одном и том же порядке, с комментарием на секцию. Так файл просматривается с одного взгляда.
Базовый промптредактировать
Создай тему V2 для CubicLauncher: чистую, минималистичную и оптимизированную.
Верни два блока кода: Meta.toml и Definition.toml.
Meta.toml, в этом порядке:
name, author, version, description, format = 2, api_version = "2.1"
Definition.toml:
- Используй только эти секции: [colors], [text], [borders], [shadows], [layout],
[typography], [tokens].
- Пиши только те ключи, которые меняют результат. Не повторяй значения
по умолчанию и не добавляй ключи, которые не будешь использовать.
- Каждая секция сопровождается однострочным комментарием, объясняющим её назначение.
- Не создавай Inject.css, Layout.css и файлы ресурсов.
Палитра, пять ролей и ничего больше:
фон <цвет>, поверхность <цвет>, текст <цвет>, акцент <цвет>, граница <цвет>
Обязательные правила:
- accent-rgb повторяет accent как "R, G, B". surface-rgb — это "255, 255, 255"
в тёмных темах и "0, 0, 0" в светлых.
- Минимальный контраст 4.5:1 между --text-primary и --bg-main.
- Все значения включают единицу измерения, когда она нужна CSS (px, rem, s).
- Не выдумывай переменные: используй только токены, которые есть в справочнике.
- Если объявляешь [background], используй относительный путь и консервативные
значения: image_opacity от 0.25 до 0.4, brightness от 0.35 до 0.5, image_blur от 0 до 12.
Вне блоков добавь три строки:
1. Рекомендуемое типографическое семейство и необходимые начертания.
2. Идеальные размеры и формат для фона.
3. Что сократить, если тема получилась тяжёлой.Как избежать шаблонных результатовредактировать
- Выберите цвета до промпта. Модель склонна возвращать один и тот же фиолетовый на сером, если не дать ей направление.
- Просите роли, а не отдельные значения. «Почти чёрный фон с зелёным оттенком, обесцвеченные поверхности, насыщенный лаймово-зелёный акцент» даёт лучшие результаты, чем «зелёная тема».
- Зафиксируйте контраст как требование. Без этого ограничения вторичные тексты становятся нечитаемыми.
- Проверяйте триплеты. Это самая частая ошибка в сгенерированных темах:
accentменяется, аaccent-rgbостаётся белым. - Итерируйте по файлу, а не по промпту. Попросите тему, установите её и настраивайте конкретные значения; это быстрее, чем переписывать инструкцию.
- Просите бюджет, а не только палитру. «Фон 1600×900 в WebP, два начертания одного семейства, без лишнего CSS» не даст результату прийти с двенадцатью мегабайтами ресурсов.