Скины и темы

Скины управляют визуальными представлениями CLI Hermes: цвета баннера, голоса и глаголы спиннера, метки блоков ответов, инструмент брендинга текста и префикс активности.

Разговорный стиль и визуальный стиль — разные понятия:

• Личность меняет тон и формулирует агента.
• Скин меняет внешний вид CLI.

Смена скинов

/skin                # показать текущий скин и список доступных скинов
/skin ares           # переключиться на встроенный скин
/skin mytheme        # переключиться на пользовательский скин из ~/.hermes/skins/mytheme.yaml

Или установите скин по умолчанию в ~/.hermes/config.yaml:

display:
  skin: default

Встроенные скины

Полный список настраиваемых ключей

Цвета (colors:)

Управляет всеми цветовыми значениями в CLI. Значения — строки шестнадцатеричных цветов.

Спиннер (spinner:)

Управляет анимированным спиннером, показываемым во время ожидания ответов API.

Когда значения спиннера пусты (как в default и mono), используются жестко заданные значения по умолчанию из display.py.

Брендинг (branding:)

Текстовые строки, используемые во всем интерфейсе CLI.

Другие ключи верхнего уровня

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

Создавайте YAML-файлы в ~/.hermes/skins/. Пользовательские скины наследуют отсутствующие значения из встроенного скина default, поэтому вам нужно указать только те ключи, которые вы хотите изменить.

Полный шаблон пользовательского скина YAML

# ~/.hermes/skins/mytheme.yaml
# Полный шаблон скина — показаны все ключи. Удалите те, которые не нужны;
# отсутствующие значения автоматически наследуются из скина 'default'.

name: mytheme
description: Моя пользовательская тема

colors:
  banner_border: "#CD7F32"
  banner_title: "#FFD700"
  banner_accent: "#FFBF00"
  banner_dim: "#B8860B"
  banner_text: "#FFF8DC"
  ui_accent: "#FFBF00"
  ui_label: "#4dd0e1"
  ui_ok: "#4caf50"
  ui_error: "#ef5350"
  ui_warn: "#ffa726"
  prompt: "#FFF8DC"
  input_rule: "#CD7F32"
  response_border: "#FFD700"
  session_label: "#DAA520"
  session_border: "#8B8682"
  status_bar_bg: "#1a1a2e"
  voice_status_bg: "#1a1a2e"
  selection_bg: "#333355"
  completion_menu_bg: "#1a1a2e"
  completion_menu_current_bg: "#333355"
  completion_menu_meta_bg: "#1a1a2e"
  completion_menu_meta_current_bg: "#333355"

spinner:
  waiting_faces:
    - "(⚔)"
    - "(⛨)"
    - "(▲)"
  thinking_faces:
    - "(⚔)"
    - "(⌁)"
    - "(<>)"
  thinking_verbs:
    - "обрабатываю"
    - "анализирую"
    - "вычисляю"
    - "оцениваю"
  wings:
    - ["⟪⚡", "⚡⟫"]
    - ["⟪●", "●⟫"]

branding:
  agent_name: "Мой Агент"
  welcome: "Добро пожаловать в Моего Агента! Введите сообщение или /help для команд."
  goodbye: "Увидимся! ⚡"
  response_label: " ⚡ Мой Агент "
  prompt_symbol: "⚡"
  help_header: "(⚡) Доступные команды"

tool_prefix: "┊"

# Переопределение эмодзи для отдельных инструментов (опционально)
tool_emojis:
  terminal: "⚔"
  web_search: "🔮"
  read_file: "📄"

# Пользовательские ASCII-арт баннеры (опционально, поддерживается Rich разметка)
# banner_logo: |
#   [bold #FFD700] МОЙ АГЕНТ [/]
# banner_hero: |
#   [#FFD700]  Пользовательское искусство здесь  [/]

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

поскольку все наследуется от «по умолчанию», новая кожа должна изменяться только в том, что отличается:

name: cyberpunk
description: Неоновая тема терминала

colors:
  banner_border: "#FF00FF"
  banner_title: "#00FFFF"
  banner_accent: "#FF1493"

spinner:
  thinking_verbs: ["подключаюсь", "расшифровываю", "загружаю"]
  wings:
    - ["⟨⚡", "⚡⟩"]

branding:
  agent_name: "Кибер Агент"
  response_label: " ⚡ Кибер "

tool_prefix: "▏"

Hermes Mod — Визуальный редактор скинов

Hermes Mod — это веб-интерфейс, созданный сообществом, для визуального создания и управления скинами. Вместо написания YAML вручную вы в первую очередь добавляете редактор с указателем и исследовательской мышью с предварительным просмотром.

Что он делает:

• Пересчитывает все встроенные и пользовательские скины
• Открывает любой скин в визуальном редакторе со всеми полами скинов Hermes (цвета, спиннер, брендинг, инструмент префикса, инструменты эмодзи)
• Генерирует текстовое искусство banner_logo из текстового промпта
• Преобразует загруженные изображения (PNG, JPG, GIF, WEBP) в ASCII-арте banner_hero с несколькими стилями рендеринга (Брайль, ASCII-рамка, блоки, точки)
• Сохран находится непосредственно в ~/.hermes/skins/
• Активирует скин, обновляя ~/.hermes/config.yaml
• Показывает сгенерированный YAML и предварительный просмотр в первое время.

Установка

Вариант 1 — Пинокио (1 клик):

Найдите на pinokio.computer и установите в один клик.

Вариант 2 — npx (самый быстрый из терминала):

npx -y hermes-mod

Вариант 3 — Вручную:

git clone https://github.com/cocktailpeanut/hermes-mod.git
cd hermes-mod/app
npm install
npm start

Использование

1. Запустите приложение (через Pinokio или терминал).
2. Откройте Skin Studio.
3. Выберите встроенный или пользовательский скин для редактирования.
4. Сгенерируйте логотип из текста и/или загрузите изображение для героического искусства. Выберите стиль рендеринга и надежность.
5. Отредактируйте цвета, спиннер, брендинг и другие поля.
6. Нажмите Сохранить, чтобы записать скин YAML в ~/.hermes/skins/.
7. Нажмите Активировать, чтобы установить его как текущий скин (обновляет display.skin в config.yaml).

Hermes Mod наблюдает за переменным окружением HERMES_HOME, поэтому он также работает с профилями.

Операционные заметки

• Встроенные скины загружаются из hermes_cli/skin_engine.py.
• Неизвестные скины автоматически возвращаются к значению «по умолчанию».
• /skin мгновенно обновляет CLI активной темы для текущей сессии.
• Пользовательские скины в ~/.hermes/skins/ имеют приоритет над компонентами скинов с тем же именем.
• Изменения скина через /skin происходят только в рамках сессии. Чтобы сделать скин по умолчанию, установите его в config.yaml.
• Поля banner_logo и banner_hero требуют разметки Rich консоли (например, [bold #FF0000]text[/]) для цветного ASCII-арта.