hermes-hub/docs/ARCHITECTURE.md
2026-08-20 00:17:11 +07:00

2 KiB
Raw Permalink Blame History

Архитектура Hermes Hub

1. Концепция и назначение

Hermes Hub — централизованная панель управления и отказоустойчивый роутер запросов для Hermes Agent.

graph TD
    A[Пользователь / Hermes Agent CLI] --> B[Multi-Provider Router Engine]
    C[HermesHub.exe / Web UI] --> D[FastAPI Backend :8765]
    D --> B
    B --> E{Logical Role Policies}
    E -->|Tier 1| F[OpenAI Codex Pool (3 slots)]
    E -->|Tier 2| G[Antigravity OAuth Pool (10 slots)]
    E -->|Tier 3| H[OpenCode Go API Pool (3 slots)]
    B --> I[Health & Quota Tracker]
    B --> J[Session Affinity Engine]
    B --> K[Concurrency Lease Manager]

2. Ключевые компоненты

  • Router Engine (router_engine.py): Сопоставляет роль задачи (orchestrator, coder-primary, reviewer, research, fast) с цепочкой профилей и выполняет failover при исчерпании квот.
  • Session Affinity (session_affinity.py): Удерживает единый профиль и модель на протяжении диалоговой сессии пользователя.
  • Health & Quota Tracker (health_tracker.py): Отслеживает доступность семейств моделей (gemini, claude, gpt, deepseek) и выставляет экспоненциальный cooldown (300s -> 3600s).
  • Auto Assignment Engine (auto_assigner.py): Автоматически распределяет новые аккаунты по свободным слотам ролей.
  • GUI Server (gui_server.py) & UI (gui_cockpit.html): Предоставляет темный дашборд «Команда Hermes».
  • Launcher (HermesHub.exe): Нативный C# лаунчер с health check gate (HTTP 200) и Edge App Mode.
  • Setup Installer (HermesHubSetup.exe): Мастер установки с pre-flight проверками Hermes Agent 0.20.4+.