Темы
Выберите встроенную тему или создайте свою собственную.
С OpenCode вы можете выбрать одну из нескольких встроенных тем, использовать тему, которая адаптируется к теме вашего терминала, или создать свою собственную пользовательскую тему.
По умолчанию OpenCode использует нашу собственную тему opencode.
Требования к терминалу
Для корректного отображения тем с полной цветовой палитрой ваш терминал должен поддерживать truecolor (24-битный цвет). Большинство современных терминалов поддерживают это по умолчанию, но вам может потребоваться включить его:
- Проверка поддержки: Выполните
echo $COLORTERM- должно вывестиtruecolorили24bit - Включение truecolor: Установите переменную окружения
COLORTERM=truecolorв профиле вашей оболочки - Совместимость терминала: Убедитесь, что ваш эмулятор терминала поддерживает 24-битный цвет (большинство современных терминалов, таких как iTerm2, Alacritty, Kitty, Windows Terminal и последние версии GNOME Terminal, поддерживают)
Без поддержки truecolor темы могут отображаться с пониженной точностью цветов или использовать ближайшее приближение из 256 цветов.
Встроенные темы
OpenCode поставляется с несколькими встроенными темами.
| Название | Описание |
|---|---|
system | Адаптируется к цвету фона вашего терминала |
tokyonight | На основе темы Tokyonight (opens in a new tab) |
everforest | На основе темы Everforest (opens in a new tab) |
ayu | На основе тёмной темы Ayu (opens in a new tab) |
catppuccin | На основе темы Catppuccin (opens in a new tab) |
catppuccin-macchiato | На основе темы Catppuccin (opens in a new tab) |
gruvbox | На основе темы Gruvbox (opens in a new tab) |
kanagawa | На основе темы Kanagawa (opens in a new tab) |
nord | На основе темы Nord (opens in a new tab) |
matrix | Хакерская тема: зелёный на чёрном |
one-dark | На основе тёмной темы Atom One (opens in a new tab) |
И другие, мы постоянно добавляем новые темы.
Системная тема
Тема system разработана для автоматической адаптации к цветовой схеме вашего терминала. В отличие от традиционных тем, использующих фиксированные цвета, тема system:
- Генерирует шкалу серого: Создаёт пользовательскую шкалу серого на основе цвета фона вашего терминала, обеспечивая оптимальный контраст.
- Использует цвета ANSI: Использует стандартные цвета ANSI (0-15) для подсветки синтаксиса и элементов интерфейса, которые соответствуют цветовой палитре вашего терминала.
- Сохраняет настройки терминала: Использует
noneдля цветов текста и фона, чтобы сохранить нативный внешний вид вашего терминала.
Системная тема предназначена для пользователей, которые:
- Хотят, чтобы OpenCode соответствовал внешнему виду их терминала
- Используют пользовательские цветовые схемы терминала
- Предпочитают единообразный вид во всех терминальных приложениях
Использование темы
Вы можете выбрать тему, открыв выбор тем командой /theme. Или вы можете указать её в вашей конфигурации.
{
"$schema": "https://opencode.ai/config.json",
"theme": "tokyonight"
}Пользовательские темы
OpenCode поддерживает гибкую систему тем на основе JSON, которая позволяет пользователям легко создавать и настраивать темы.
Иерархия
Темы загружаются из нескольких директорий в следующем порядке, где более поздние директории переопределяют более ранние:
- Встроенные темы - Они встроены в бинарный файл
- Директория конфигурации пользователя - Определена в
~/.config/opencode/themes/*.jsonили$XDG_CONFIG_HOME/opencode/themes/*.json - Корневая директория проекта - Определена в
<project-root>/.opencode/themes/*.json - Текущая рабочая директория - Определена в
./.opencode/themes/*.json
Если несколько директорий содержат тему с одинаковым именем, будет использована тема из директории с более высоким приоритетом.
Создание темы
Чтобы создать пользовательскую тему, создайте JSON-файл в одной из директорий тем.
Для пользовательских тем:
mkdir -p ~/.config/opencode/themes
vim ~/.config/opencode/themes/my-theme.jsonИ для тем, специфичных для проекта.
mkdir -p .opencode/themes
vim .opencode/themes/my-theme.jsonФормат JSON
Темы используют гибкий формат JSON с поддержкой:
- Hex-цвета:
"#ffffff" - Цвета ANSI:
3(0-255) - Ссылки на цвета:
"primary"или пользовательские определения - Варианты тёмный/светлый:
{"dark": "#000", "light": "#fff"} - Без цвета:
"none"- Использует цвет терминала по умолчанию или прозрачный
Определения цветов
Раздел defs является необязательным и позволяет определять многоразовые цвета, на которые можно ссылаться в теме.
Значения терминала по умолчанию
Специальное значение "none" может использоваться для любого цвета, чтобы наследовать цвет терминала по умолчанию. Это особенно полезно для создания тем, которые органично сочетаются с цветовой схемой вашего терминала:
"text": "none"- Использует цвет переднего плана терминала по умолчанию"background": "none"- Использует цвет фона терминала по умолчанию
Пример
Вот пример пользовательской темы:
{
"$schema": "https://opencode.ai/theme.json",
"defs": {
"nord0": "#2E3440",
"nord1": "#3B4252",
"nord2": "#434C5E",
"nord3": "#4C566A",
"nord4": "#D8DEE9",
"nord5": "#E5E9F0",
"nord6": "#ECEFF4",
"nord7": "#8FBCBB",
"nord8": "#88C0D0",
"nord9": "#81A1C1",
"nord10": "#5E81AC",
"nord11": "#BF616A",
"nord12": "#D08770",
"nord13": "#EBCB8B",
"nord14": "#A3BE8C",
"nord15": "#B48EAD"
},
"theme": {
"primary": {
"dark": "nord8",
"light": "nord10"
},
"secondary": {
"dark": "nord9",
"light": "nord9"
},
"accent": {
"dark": "nord7",
"light": "nord7"
},
"error": {
"dark": "nord11",
"light": "nord11"
},
"warning": {
"dark": "nord12",
"light": "nord12"
},
"success": {
"dark": "nord14",
"light": "nord14"
},
"info": {
"dark": "nord8",
"light": "nord10"
},
"text": {
"dark": "nord4",
"light": "nord0"
},
"textMuted": {
"dark": "nord3",
"light": "nord1"
},
"background": {
"dark": "nord0",
"light": "nord6"
},
"backgroundPanel": {
"dark": "nord1",
"light": "nord5"
},
"backgroundElement": {
"dark": "nord1",
"light": "nord4"
},
"border": {
"dark": "nord2",
"light": "nord3"
},
"borderActive": {
"dark": "nord3",
"light": "nord2"
},
"borderSubtle": {
"dark": "nord2",
"light": "nord3"
},
"diffAdded": {
"dark": "nord14",
"light": "nord14"
},
"diffRemoved": {
"dark": "nord11",
"light": "nord11"
},
"diffContext": {
"dark": "nord3",
"light": "nord3"
},
"diffHunkHeader": {
"dark": "nord3",
"light": "nord3"
},
"diffHighlightAdded": {
"dark": "nord14",
"light": "nord14"
},
"diffHighlightRemoved": {
"dark": "nord11",
"light": "nord11"
},
"diffAddedBg": {
"dark": "#3B4252",
"light": "#E5E9F0"
},
"diffRemovedBg": {
"dark": "#3B4252",
"light": "#E5E9F0"
},
"diffContextBg": {
"dark": "nord1",
"light": "nord5"
},
"diffLineNumber": {
"dark": "nord2",
"light": "nord4"
},
"diffAddedLineNumberBg": {
"dark": "#3B4252",
"light": "#E5E9F0"
},
"diffRemovedLineNumberBg": {
"dark": "#3B4252",
"light": "#E5E9F0"
},
"markdownText": {
"dark": "nord4",
"light": "nord0"
},
"markdownHeading": {
"dark": "nord8",
"light": "nord10"
},
"markdownLink": {
"dark": "nord9",
"light": "nord9"
},
"markdownLinkText": {
"dark": "nord7",
"light": "nord7"
},
"markdownCode": {
"dark": "nord14",
"light": "nord14"
},
"markdownBlockQuote": {
"dark": "nord3",
"light": "nord3"
},
"markdownEmph": {
"dark": "nord12",
"light": "nord12"
},
"markdownStrong": {
"dark": "nord13",
"light": "nord13"
},
"markdownHorizontalRule": {
"dark": "nord3",
"light": "nord3"
},
"markdownListItem": {
"dark": "nord8",
"light": "nord10"
},
"markdownListEnumeration": {
"dark": "nord7",
"light": "nord7"
},
"markdownImage": {
"dark": "nord9",
"light": "nord9"
},
"markdownImageText": {
"dark": "nord7",
"light": "nord7"
},
"markdownCodeBlock": {
"dark": "nord4",
"light": "nord0"
},
"syntaxComment": {
"dark": "nord3",
"light": "nord3"
},
"syntaxKeyword": {
"dark": "nord9",
"light": "nord9"
},
"syntaxFunction": {
"dark": "nord8",
"light": "nord8"
},
"syntaxVariable": {
"dark": "nord7",
"light": "nord7"
},
"syntaxString": {
"dark": "nord14",
"light": "nord14"
},
"syntaxNumber": {
"dark": "nord15",
"light": "nord15"
},
"syntaxType": {
"dark": "nord7",
"light": "nord7"
},
"syntaxOperator": {
"dark": "nord9",
"light": "nord9"
},
"syntaxPunctuation": {
"dark": "nord4",
"light": "nord0"
}
}
}