hermes-hub/docs/brand/BRAND_GUIDELINES.md
2026-08-20 10:53:49 +07:00

104 lines
8.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Hermes Hub — Brand Guidelines (Официальный брендбук)
## 1. Назначение и миссия
**Hermes Hub** — единый центр управления (Control Hub) мульти-агентной и мульти-провайдерной экосистемой Hermes.
Приложение обеспечивает координацию автономных агентов (оркестраторы, кодеры, ревьюеры, исследователи), маршрутизацию запросов к языковым моделям через адаптеры (Google Antigravity, OpenAI Codex, OpenCode Go), контроль квот, отказоустойчивость (failover) и управление безопасностью учетных записей.
---
## 2. Философия и символика логотипа
Официальный знак Hermes Hub представляет собой гармоничную органическо-технологическую эмблему в золотом исполнении на благородном тёмно-зелёном фоне.
- **Центральная литера «H»** — ядро системы: Hermes Hub как центральный координирующий узел.
- **Корневая система (нижняя часть)** — фундаментальная инфраструктура Hermes, надежность, стабильность и локальное хранилище данных.
- **Ветви и плетения (верхняя часть)** — органический рост экосистемы, масштабируемость и взаимодействие мульти-агентных команд.
- **Функциональные узлы (сферы/точки на ветвях)** — специализированные субагенты, адаптеры провайдеров и сервисы.
- **Взаимосвязанная сеть линий** — динамическая маршрутизация запросов, session affinity, failover и потоки данных.
- **Внешний замкнутый круг** — целостность, безопасность, суверенность локального окружения пользователя и fail-closed защита.
---
## 3. Фирменная палитра (Brand Color Palette)
Интерфейс Hermes Hub строится по принципу **Dark-First** с глубокими природно-технологическими оттенками хвои, мха и благородного золота.
### 3.1. Основные цвета (Core Brand Colors)
| Токен | HEX | Название | Назначение |
|---|---|---|---|
| `PRIMARY` | `#0F1510` | Obsidian Forest | Глубокий базовый фон приложения (Window Background) |
| `DARK` | `#1A2A1F` | Deep Pine | Фон панелей, бокового меню (Sidebar), модальных окон |
| `SECONDARY` | `#2F4A36` | Moss Slate | Карточки (Cards), поверхности элементов, разделители |
| `LIGHT` | `#F7F1E3` | Warm Ivory | Основной цвет текста, контрастные заголовки, светлые акценты |
| `ACCENT` | `#CDAA64` | Ancient Gold | Акцентные кнопки, маркеры MAIN/Orchestrator, фокусы |
### 3.2. Семантические цвета состояний (Semantic & Operational Tokens)
Operational-цвета оптимизированы для мгновенного считывания статуса оператором, сохраняя гармонию с бренд-палитрой:
| Статус | HEX | Индикатор | Значение |
|---|---|---|---|
| `STATUS_HEALTHY` | `#2E7D32` | 🟢 Здоровый | Профиль/адаптер в строю, проверки пройдены |
| `STATUS_WARNING` | `#D97706` | 🟡 Внимание | Заканчивается квота, rate limit, деградация |
| `STATUS_ERROR` | `#DC2626` | 🔴 Ошибка | Сбой авторизации, недоступность сервиса, ошибка сети |
| `STATUS_AUTH_REQ` | `#E67E22` | 🔑 Требуется вход | Учетные данные отсутствуют или устарели |
| `STATUS_DISABLED` | `#5A6B5D` | ⚪ Отключен | Профиль деактивирован пользователем |
| `STATUS_FAILOVER` | `#3B82F6` | 🔄 Failover | Активный переход на резервный профиль |
| `STATUS_MAIN` | `#CDAA64` | ⭐ Основной | Главный аккаунт провайдера |
| `STATUS_ORCH` | `#E5C158` | 👑 Оркестратор | Главный координатор команды агентов |
---
## 4. Типографика (Typography)
### 4.1. Шрифтовые гарнитуры
- **Display / Акцидентный заголовок**: `Cinzel` / `Cinzel Decorative` (fallback: `Georgia`, `Cambria`, `Times New Roman`).
- Используется строго для: логотипа, Splash Screen, диалога «О программе», главных заголовков экранов верхнего уровня.
- **UI / Основной интерфейс**: `Inter` (fallback: `Segoe UI`, `SF Pro Display`, `Arial`, `system-ui`).
- Используется для всего рабочего интерфейса: навигация, кнопки, списки аккаунтов, карточки ролей, таблицы маршрутизации, метки состояний и журналы.
- **Моноширинный**: `JetBrains Mono` / `Consolas` / `Cascadia Code`.
- Используется для: model identifiers, profile IDs, JSON, логов и маскированных email/ключей.
### 4.2. Иерархия размеров
- **Title Hero**: 2226pt, Bold, `Cinzel` / `Segoe UI` (Accent Gold / Warm Ivory)
- **Section Heading (H1)**: 1820pt, SemiBold (Warm Ivory)
- **Subheading (H2)**: 1416pt, SemiBold (Warm Ivory / Gold)
- **Body Regular**: 1213pt, Regular (Warm Ivory)
- **Body Secondary / Caption**: 1011pt, Regular (`#889988` / Text Muted)
- **Badges & Micro**: 910pt, Bold (Text on Accent / Status)
---
## 5. Правила использования логотипа (Logo Usage Rules)
### 5.1. Допустимое использование
- Использование утверждённого символа `Hermes Hub.png` в высоком разрешении.
- Пропорциональное масштабирование с сохранением прозрачности или на фирменном фоне (`#0F1510` / `#1A2A1F`).
- Размещение на Splash Screen, в шапке окна «О программе», инсталляторе и официальной документации.
- Использование упрощённого контура для мелких иконок (16x1648x48) с высокой читаемостью буквы «H».
### 5.2. Строго запрещено (Prohibited)
- ❌ Заменять центральную литеру «H» на другой символ или шрифт.
- ❌ Добавлять посторонние элементы (луну, солнце, шестерёнки, облака, не утверждённые брендбуком).
- ❌ Искажать пропорции (растягивать по горизонтали/вертикали).
- ❌ Перекрашивать золото в синие, фиолетовые или неоновые оттенки generic SaaS.
- ❌ Использовать мелкий детализированный логотип в местах, где он превращается в нечитаемый шум.
---
## 6. Windows-интеграция и ассеты иконок
Для нативного приложения сгенерирован единый контейнер `HermesHub.ico`, содержащий слои:
- `16x16` (Taskbar small, Tray, File details)
- `24x24` (Taskbar standard 125% DPI)
- `32x32` (Taskbar 100% DPI, Window title icon)
- `48x48` (Alt+Tab, Explorer medium tiles)
- `64x64` (Explorer large tiles, Start menu)
- `128x128` (High-DPI display, Start Menu large)
- `256x256` (Extra Large Icons, Master Windows layer)
Master PNG: `assets/branding/logo/logo_master.png` (1024x1024).