3. Разработка целостных скинов Hermes CLI: от палитры до полноценных художественных тем
Полное практическое руководство по системе оформления Hermes на основе YAML, модели наследования, дизайну с использованием спиннеров, брендингу, эмодзи для инструментов, расширенной разметке и способам поддержки тем.
Как создавать собственные скины Hermes, которые действительно выглядят крутоБольшинство людей относятся к скинам Hermes как к способу смены цветовой гаммы.
Это самый быстрый способ создать посредственную тему.Хороший скин для Hermes — это не просто палитра.
Это визуальная система: цвета, анимация, брендинг, результаты работы инструментов и оформление баннеров — все это работает как единое целое.
Если вы хотите создавать собственные скины Hermes что ж, вот вам техническое и практическое руководство.
На данный момент в Hermes реализована одна из самых чистых систем оформления интерфейса командной строки в инструментах с открытым исходным кодом.
Это важно, потому что большинство систем оформления окон попадают в одну из двух ловушек: либо они слишком строгие и скучные, либо настолько свободные, что любая пользовательская тема превращается в визуальный хаос.
Hermes — это золотая середина. Он предоставляет уровень оформления на основе YAML, с помощью которого можно управлять:
- Цвет
- вращающиеся грани
- вращающиеся глаголы
- фирменный текст
- префикс активности инструмента
- эмодзи для каждого инструмента
- пользовательский логотип в формате ASCII
- изготовленное на заказ искусство героя
Ключевой дизайнерский ход заключается в следующем: отсутствующие значения наследуются от встроенной темы оформления по умолчанию.
Благодаря этому решению скины Hermes стало гораздо проще создавать и гораздо сложнее испортить.
Для начала разберемся, что такое скин Hermes
Кожа Hermes меняет только внешний вид. Она не меняет:
- личность
- поведение системы
- инструментальная логика
- стиль подсказки
В официальной документации Hermes это различие четко обозначено: характер влияет на то, как Hermes говорит, а цвет кожи — на то, как Hermes выглядит в терминале.Это важно, потому что многие путают брендинг и поведение.
Оболочка — это пользовательский интерфейс. А не когнитивная функция.Это значит, что ваша цель не в том, чтобы «сделать Hermes в стиле киберпанк».
А в том, чтобы «визуально сделать терминал целостным».Вывод: Относитесь к скинам как к дизайну интерфейса, а не как к дизайну персонажа.
Где живут пользовательские скины
Гермес собирает шкуры в двух местах:
- Встроенные скины в Hermes
- Пользовательские скины в ~/.hermes/skins/<имя>.yaml
Пользовательские скины имеют приоритет над встроенными.Это означает, что основной рабочий процесс прост:
- создайте файл YAML
- сохраните его в ~/.hermes/skins/
- переключитесь на него с помощью команды /skin <название>
Пример: /skin mythemeИли сделайте его постоянным в файле ~/.hermes/config.yaml:yamldisplay:skin: mythemeЭто одна из самых удобных частей системы. Путь активации достаточно прост, поэтому можно быстро вносить изменения.Вывод: Самый быстрый рабочий процесс - редактировать YAML > / название скина> проверить> настроить.
Основная архитектура - это наследование
Это самое важное с технической точки зрения. Скины Hermes наследуют недостающие значения от встроенного скина по умолчанию.
На практике это означает, что вам не нужно писать полноценную тему, если только вы не хотите получить полный контроль над процессом.Вы можете сделать:
- Минималистичный скин с несколькими цветовыми изменениями
- средний скин с индивидуальным брендингом и спиннерами
- Полная версия с пользовательским баннером в формате ASCII с расширенной разметкой и набором эмодзи для каждого инструмента
Эта модель наследования предлагает три эффективные стратегии проектирования.
Стратегия 1: скин только с палитройИзмените только цвета. Оставьте стандартное поведение, макет и фирменный стиль. Лучше всего подходит для тонкой персонализации и подбора цветовой схемы рабочего стола.
Стратегия 2: узнаваемый скинМеняйте цвета, спиннеры и брендинг. Лучше всего подходит для ролевых тем или эстетичных скинов, таких как «Бегущий по сети», «Ноус» или «Скайнет» Джоуи.
Стратегия 3: полностью художественная обработка кожиИзмените цвета, спиннер, логотип, эмодзи инструментов, banner_logo и banner_hero.
Лучше всего подходит для демонстрации скинов, тематических дистрибутивов и скинов, достойных публикации в репозитории.
Вывод: Не начинайте с полноэкранного режима, если не определились с визуальным оформлением.
Что вы на самом деле можете настроить
Судя по официальной схеме и шаблону Джоуи, возможности для кастомизации шире, чем кажется на первый взгляд.Основными группами являются:
- Цвета Эти элементы управления отвечают за баннер, подсказки, метки, предупреждения, границы ответов, метки сеансов и многое другое. Важные ключи: banner_border, banner_title, banner_accent, ui_accent, prompt, response_border и т. д.
- СпиннерУправляет анимацией интерфейса командной строки, пока Гермес размышляет. Ключи: waiting_faces, thinking_faces, thinking_verbs, wings. Здесь скин начинает оживать.
- Фирменный стиль Определяет текстовую идентичность: имя_агента, приветствие, прощание, метка_ответа, символ_запроса, заголовок_справки.
- Представление инструментаВы можете переопределить: tool_prefix, tool_emojis. Сопоставление эмодзи для каждого инструмента делает интерфейс командной строки более целостным.
- БаннерВы можете заменить: banner_logo, banner_hero. Они поддерживают расширенную разметку консоли, а цветные изображения в формате ASCII можно добавлять прямо в YAML.
Вывод: Если после подбора цвета ваша кожа по-прежнему выглядит заурядно, скорее всего, вам не хватает брендинга, спиннера и эмодзи-инструментов.
Самая большая ошибка новичков — чрезмерное усложнение дизайна
Именно здесь большинство пользовательских скинов дают сбой.Пользователи открывают полную версию и сразу же пытаются все настроить под себя: каждый цвет, каждый глагол, каждый эмодзи, огромные баннеры, сложные градиенты, новые символы повсюду.Обычно результат впечатляет в течение 15 секунд и утомляет уже через 15 минут.Хорошие скины сдержанны. Официальная модель наследования Hermes в целом поощряет сдержанность.У Джоуи репо Это тоже хорошо видно: самые сильные скины не случайны, они строго соответствуют тематике.Например:
- «Бегущий по лезвию» целостен, потому что цветовая гамма, глаголы, символы и художественное оформление поддерживают единый стиль киберпанка.
Nous целостен, потому что его цветовая гамма и фирменный стиль соответствуют единой концепции Nous
Skynet работает, потому что красно-черная цветовая гамма, директивный язык и фирменный стиль машин — все это работает на одну цель.
Урок прост: выберите одну визуальную историю и выстраивайте все остальные слои в соответствии с ней.Вывод: Кожа должна быть однородной, прежде чем она станет «умной».
Как создать хорошую обложку: пошаговая инструкция
Если бы я создавал кастомную обложку для Hermes с нуля, я бы сделал это в таком порядке:
- Определите стильОтвет: каким должен быть этот скинна ощупь? (чистым и строгим, в стиле киберпанк, с острыми углами, мифическим, витиеватым и т. д.) Если вы не можете описать стиль одним предложением, значит, скин не готов к разработке.
- Сначала создайте палитруНачните с banner_border, banner_title, banner_accent, banner_text, prompt, response_border. Не начинайте с ASCII-графики. Начните с удобочитаемости.
- Добавьте язык спиннеровЗатем выберите лица, глаголы, крылья. Совет: подбирайте глаголы для спиннеров в соответствии с миром скина (например, киберпанк: «взламывать систему ICE», исследование: «делать выводы», мистика: «угадывать закономерности»).
- Тщательно продумайте брендингПри необходимости настройте agent_name, response_label, prompt_symbol, текст приветствия/помощи. Не делайте их слишком длинными или вычурными. Вам все равно придется пользоваться этим интерфейсом.
- Добавьте эмодзи с инструментами, если скин этого заслуживает.Используйте их, когда они усиливают смысл. А не просто потому, что можете.
- Добавьте banner_logo и banner_hero в самом конце.Крупные изображения следует добавлять только после того, как скин будет готов к использованию в качестве пользовательского интерфейса. Изображения — это то, что проще всего подогнать под шаблон, но сложнее всего поддерживать.
Рекомендации на вынос: Правильный порядок: айдентика> палитра> спиннер> брендинг> сведения об инструменте > арт.
Репозиторий Джоуи полезен тем, что содержит примеры, а не только правила
https://github.com/joeynyc/hermes-skinsРепо дает вам:
- Файл README с инструкциями по установке и активации
- SCHEMA.md с полным списком ключей
- template.yaml в качестве шаблона для копирования
- Несколько готовых скинов с разными эстетическими подходами
Три особенно полезные ссылки:
- template.yaml для структуры
- SCHEMA.md о том, что на самом деле делает каждое поле
- отполированные скины, такие как netrunner.yaml, nous.yaml и skynet.yaml, для логики тем
Главное — не копировать их слепо. Нужно изучить, как в каждом из них соблюдается визуальная целостность.Вывод: Используйте репозиторий Джоуи как образец дизайна, а не просто как файловую библиотеку.
Разметка и ASCII-графика — мощные инструменты, но ими легко злоупотребить
Hermes поддерживает расширенную разметку в banner_logo, banner_hero, welcome и goodbye.Это значит, что вы можете использовать цветной текст, выделенные жирным шрифтом фрагменты, градиенты, пользовательские логотипы в кодировке ASCII и большие иллюстрации.Это одна из самых интересных частей системы кожи. И в то же время та часть, которая чаще всего выходит из строя.Лучшие практики:
- чтобы баннер был виден на всю ширину терминала
- чтобы цветовая палитра рисунка сочеталась с остальной кожей
- избегайте гигантских арт-блоков, которые доминируют в стартапах
- используйте градиенты экономно
- Протестируйте на своей реальной теме оформления терминала, а не только в теории
В репозитории Джоуи можно найти полезный пример: лучшее изображение не «больше», а лучше интегрировано в фирменный стиль.Вывод: Баннер должен дополнять оформление, а не затмевать его.
Минимальные скины недооцениваются
Пожалуй, это самый важный практический совет во всем руководстве.Поскольку Hermes наследует настройки по умолчанию, минималистичные скины часто оказываются лучше полноценных.Минимальные изменения коснутся только кожи:
- несколько основных цветов
- метка с одним ответом
- один символ подсказки
- может быть, один или два глагола, образованных от существительных
Этого может быть достаточно.Почему минимализм работает: меньше затрат на обслуживание, меньше визуального шума, меньше возможностей для неуместного контраста, привычный макет Hermes по умолчанию, который проще дорабатывать.Вывод: Чистая часть кожи обычно стареет медленнее, чем перегруженная.
Лучшие ресурсы
Официальные рекомендации Hermes
- Официальные документы по скинам: https://hermes-agent.nousresearch.com/docs/user-guide/features/skins
- Документы конфигурации Hermes (дисплей.скин)
- Встроенные определения скинов Hermes находятся в исходном коде (skin_engine.py)
Репо Джоуи
- https://github.com/joeynyc/hermes-skins
- README: отличное краткое руководство и примеры
- SCHEMA.md: полная ссылка на поле
- template.yaml: лучшая отправная точка
- skins/ папка: отполированные скины, такие как netrunner, nous, skynet, sakura, pirate и neonwave
Предлагаемый рабочий процесс
- Ознакомьтесь с официальными документами по скинам
- Прочитайте файл SCHEMA.md Джоуи
- Начать с template.yaml
- Сначала создайте минимальную версию
- Расширяйте только в том случае, если идентификатору по-прежнему требуется дополнительная информация
Заключение
Скины Hermes хороши тем, что их можно комбинировать.Вы можете создать небольшую тему, которая просто дополнит вашу палитру. Или полноценную художественную тему с пользовательскими эмодзи, спиннером и фирменным оформлением.
Но все лучшие скины подчиняются одному правилу: они выглядят продуманными, а не просто украшенными.
Если вы хотите, чтобы ваш пользовательский скин Hermes хорошо выглядел при повседневном использовании, начните с малого, придерживайтесь единого стиля и позвольте наследованию сделать больше, чем вам кажется.