Темы

Qwen Code поддерживает множество тем для настройки своей цветовой схемы и внешнего вида. Вы можете изменить тему по своему вкусу с помощью команды /theme или параметра конфигурации "ui.theme".

Доступные темы

Qwen Code поставляется с набором предопределённых тем, которые можно просмотреть с помощью команды /theme в CLI:

Тёмные темы:
- ANSI
- Atom One
- Ayu
- Default
- Dracula
- GitHub
- Qwen Dark
- Shades Of Purple
Светлые темы:
- ANSI Light
- Ayu Light
- Default Light
- GitHub Light
- Google Code
- Qwen Light
- Xcode

Смена темы

Введите /theme в Qwen Code.
Появится диалог или подсказка выбора, в котором перечислены доступные темы.
С помощью клавиш-стрелок выберите тему. В некоторых интерфейсах может показываться предварительный просмотр или подсветка при выборе.
Подтвердите выбор, чтобы применить тему.

Примечание: Если тема определена в вашем файле settings.json (по имени или пути к файлу), необходимо удалить настройку "ui.theme" из этого файла, прежде чем вы сможете изменить тему с помощью команды /theme.

Сохранение темы

Выбранные темы сохраняются в конфигурации Qwen Code, поэтому ваши предпочтения запоминаются между сеансами.

Автоматическое определение темы

Если тема установлена в "auto" (или не задана), Qwen Code автоматически определяет, использует ли ваш терминал тёмный или светлый фон, и выбирает соответствующую тему Qwen (Qwen Dark или Qwen Light).

Как включить

Установите тему в "auto" в settings.json:


{
  "ui": {
    "theme": "auto"
  }
}

Или выберите Auto в диалоге /theme. Это поведение по умолчанию, когда явная тема не указана.

Методы определения

Qwen Code использует несколько методов определения, которые применяются по цепочке. При запуске (асинхронный путь) порядок следующий:

Приоритет	Метод	Платформа	Как работает
1	`COLORFGBG`	Все	Читает переменную окружения `COLORFGBG` (задаётся терминалами iTerm2, rxvt, Konsole)
2	OSC 11	Все (TTY)	Отправляет терминалу запрос `ESC]11;?` и извлекает цвет фона из ответа (~200 мс)
3	Внешний вид macOS	только macOS	Выполняет `defaults read -g AppleInterfaceStyle`, чтобы проверить, активен ли тёмный режим macOS
4	По умолчанию	Все	Использует тёмную тему, если ни один из методов не сработал

Первый метод, вернувший результат, побеждает. Определённое значение кэшируется на время сеанса, так что последующие обращения к теме (например, повторный выбор Auto в диалоге /theme) остаются согласованными.

Когда использовать Auto

Большинству пользователей — Auto работает хорошо, если фон вашего терминала соответствует внешнему виду ОС или если ваш терминал задаёт COLORFGBG / поддерживает OSC 11.
Пользователям tmux / screen — OSC 11 может не проходить через мультиплексоры. В этом случае определение срабатывает по COLORFGBG или внешнему виду macOS. Если ни то, ни другое недоступно, используется тёмная тема по умолчанию. Если автоопределение даёт неверный результат, укажите конкретную тему.
SSH-сессии — определение зависит от удалённого окружения. Если COLORFGBG не пересылается, а удалённый терминал не отвечает на OSC 11, используется тёмная тема по умолчанию.

Пользовательские цветовые темы

Qwen Code позволяет создавать собственные цветовые темы, указывая их в файле settings.json. Это даёт полный контроль над палитрой цветов, используемой в CLI.

Как определить пользовательскую тему

Добавьте блок customThemes в файл settings.json пользователя, проекта или системы. Каждая пользовательская тема определяется как объект с уникальным именем и набором цветовых ключей. Например:


{
  "ui": {
    "customThemes": {
      "MyCustomTheme": {
        "name": "MyCustomTheme",
        "type": "custom",
        "Background": "#181818",
        ...
      }
    }
  }
}

Цветовые ключи:

Background
Foreground
LightBlue
AccentBlue
AccentPurple
AccentCyan
AccentGreen
AccentYellow
AccentRed
Comment
Gray
DiffAdded (опционально, для добавленных строк в диффах)
DiffRemoved (опционально, для удалённых строк в диффах)
DiffModified (опционально, для изменённых строк в диффах)

Обязательные свойства:

name (должно совпадать с ключом в объекте customThemes и быть строкой)
type (должно быть строкой "custom")
Background
Foreground
LightBlue
AccentBlue
AccentPurple
AccentCyan
AccentGreen
AccentYellow
AccentRed
Comment
Gray

Для любого значения цвета можно использовать как шестнадцатеричные коды (например, #FF0000), так и стандартные названия цветов CSS (например, coral, teal, blue). Полный список поддерживаемых названий см. в CSS color names . Вы можете определить несколько пользовательских тем, добавив больше записей в объект customThemes.

Загрузка тем из файла

Помимо определения пользовательских тем в settings.json, вы можете загрузить тему напрямую из JSON-файла, указав путь к файлу в вашем settings.json. Это удобно для обмена темами или хранения их отдельно от основной конфигурации.

Чтобы загрузить тему из файла, установите свойство ui.theme в вашем settings.json на путь к файлу темы:


{
  "ui": {
    "theme": "/path/to/your/theme.json"
  }
}

Файл темы должен быть корректным JSON-файлом, который соответствует той же структуре, что и пользовательская тема, определенная в settings.json.

Пример my-theme.json:


{
  "name": "My File Theme",
  "type": "custom",
  "Background": "#282A36",
  "Foreground": "#F8F8F2",
  "LightBlue": "#82AAFF",
  "AccentBlue": "#61AFEF",
  "AccentPurple": "#BD93F9",
  "AccentCyan": "#8BE9FD",
  "AccentGreen": "#50FA7B",
  "AccentYellow": "#F1FA8C",
  "AccentRed": "#FF5555",
  "Comment": "#6272A4",
  "Gray": "#ABB2BF",
  "DiffAdded": "#A6E3A1",
  "DiffRemoved": "#F38BA8",
  "DiffModified": "#89B4FA",
  "GradientColors": ["#4796E4", "#847ACE", "#C3677F"]
}

Замечание по безопасности: В целях вашей безопасности Qwen Code будет загружать только файлы тем, которые находятся в вашей домашней директории. Если вы попытаетесь загрузить тему из-за пределов домашней директории, будет показано предупреждение, и тема не загрузится. Это сделано для предотвращения загрузки потенциально вредоносных файлов тем из ненадёжных источников.

Пример пользовательской темы

Использование вашей пользовательской темы

Выберите свою пользовательскую тему с помощью команды /theme в Qwen Code. Ваша пользовательская тема появится в диалоге выбора темы.
Или установите её по умолчанию, добавив "theme": "MyCustomTheme" в объект ui вашего settings.json.
Пользовательские темы могут быть установлены на уровне пользователя, проекта или системы и следуют тому же приоритету конфигурации, что и другие настройки.