Hermes Control Center 🏛️

Централизованный локальный воркспейс для управления, мониторинга, бэкапов и оперативного решения задач по автономному ИИ-ассистенту Hermes (Гера) и связанным сервисам на мини-ПК.

---

📌 Быстрая сводка (Quick Reference)

Параметр	Значение
Хост (Мини-ПК)	192.168.0.33:22 (Ubuntu Linux x86_64)
Пользователь / Пароль	minipc / Gfh4943Tujh
Стек на мини-ПК	/opt/stacks/hermes
Папка данных	/opt/stacks/hermes/data (внутри контейнера: /opt/data)
Web Dashboard	http://192.168.0.33:3200 или https://hermes.mikaby.ru
Логин / Пароль Dashboard	admin / 762440ce60af542733d534013fd4b878
Основная модель	gemini-3.8-flash-tiered (Antigravity google-antigravity, аккаунт 1)
Аккаунты Antigravity	3 шт. (Acc 1/2/3), квоты независимые, по 9 моделей каждый
Fallback-цепочка	11 звеньев: Acc 1/2/3 × Gemini/Claude/GPT, затем Cline и Cursor
Кастомный overlay	/opt/stacks/hermes/antigravity-overlay (образ hermes-agent:antigravity-overlay)
Исходящий прокси	VPS DE 31.57.13.110:49150 (sing-box, логин egor); резерв — VPS TR 82.27.118.15, NL 31.58.220.232
VPS DE (база)	31.57.13.110 (Франкфурт, 43 мс), SSH по ключу, alias ssh vps-de. Гайд: docs/vps-de-supercombo.md
Доступ к мини-ПК	ssh minipc-de (через туннель DE :22222, по умолчанию) · ssh minipc-tr (резерв)
Долговременная память	Hindsight (отдельный стек /opt/stacks/hindsight, API: http://192.168.0.33:8888, UI: https://hindsight.mikaby.ru)
Синхронизация бэкапов	Syncthing: C:\Users\u4iha\Documents\homelab-sync-configs\minipc\backups\hermes\

---

📂 Структура воркспейса

E:\work\hermes-workspace\
├── README.md                     # Главный дашборд и документация воркспейса
├── AGENTS.md                     # Инструкция для ИИ-агента: правила, грабли, конвенции
├── promt-to-test-vps.md          # Каноничные требования к новой VPS
├── .gitattributes                # LF для .sh/.py (иначе bash ломается на Linux)
├── docs/
│   ├── architecture.md           # Архитектура: Hermes, Hindsight, Proxy, Fallbacks
│   ├── antigravity-overlay.md    # Кастомный Antigravity: контуры, патчи, пересборка
│   ├── cheatsheet.md             # Шпаргалка по частым SSH и docker-командам
│   ├── cron-jobs.md              # Расписание и описание регламентных задач Геры
│   ├── disaster-recovery.md      # Пошаговое восстановление системы при сбое диска
│   ├── links.md                  # Каталог ссылок, портов и веб-интерфейсов homelab
│   ├── maintenance-guide.md      # Обслуживание, очистка диска, права на credentials
│   ├── vps-screening.md          # Скоринг новой VPS: доступ, репутация IP, гео-блокировки
│   ├── vps-tr-incident.md        # Инцидент TR: Гермес закрыла SSH и сломала прокси
│   ├── vps-tr-guide.md           # VPS-TR: как работать с AWG и sing-box (без 3x-ui)
│   ├── vps-tr-state.md           # Эталонный снимок состояния, сервисов и портов VPS TR (Окт 2026)
│   ├── memory-and-hindsight.md   # Устройство памяти: USER.md, MEMORY.md, Hindsight
│   ├── models-and-fallbacks.md   # Модели, квоты и 11-уровневая цепочка отказоустойчивости
│   └── audit/                    # Архивные аудиты и отчёты об инцидентах
│       └── 092026/
│           ├── hermes-audit-2026-09-24.md      # Плановый аудит (cron, память, Hindsight)
│           └── hermes-incident-2026-09-30-antigravity-quota.md
│                                                    # Инцидент: суточный лимит Antigravity,
│                                                    # курсор/клин, память, гео-блок
├── scripts/
│   ├── connect.ps1               # Быстрый SSH вход на мини-ПК
│   ├── status.ps1                # Комплексный чек аптайма, контейнеров, памяти и диска
│   ├── check-models.ps1          # Проверка активной модели и 11 fallback-провайдеров
│   ├── check-memory.ps1          # Проверка статуса Hindsight и записей USER.md
│   ├── check-quota.py            # Живая проверка квот Acc 1/2/3 (запускать от hermes!)
│   ├── cron-status.ps1           # Просмотр статуса регламентных фоновых задач
│   ├── exec-cmd.ps1              # Выполнение произвольной команды на мини-ПК
│   ├── logs.ps1                  # Стриминг логов Hermes в реальном времени
│   ├── restart.ps1               # Быстрый перезапуск контейнера Hermes
│   ├── pull-backup.ps1           # Копирование свежего бэкапа из Syncthing в backups/
│   ├── check-vps.ps1             # Скоринг новой VPS: доступ, DNSBL, гео, блокировки
│   ├── antigravity-geo-test.py   # Проверка Antigravity-аккаунтов с egress проверяемой VPS
│   ├── tr-recover.sh             # Восстановление TR VPS: SSH, ufw, AWG, чистка sing-box
│   ├── awg-add-client.sh         # Добавить клиента AWG на TR (с параметрами обфускации)
│   └── minipc-reverse-tunnel-tr.service  # Обратный туннель мини-ПК → TR (доступ снаружи)
├── backups/                      # Локальные копии бэкапов (hermes_data + hindsight)
└── secrets/                      # Токены, пароли, учетные записи
    └── credentials.md            # Пароли хоста, дашборда и API-ключи провайдеров

---

⚡ Быстрые действия через PowerShell (из этой папки)

# 1. Проверить общее здоровье системы (аптайм, контейнеры, диск)
.\scripts\status.ps1

# 2. Проверить модели и резервную цепочку LLM
.\scripts\check-models.ps1

# 3. Живая проверка квот всех трёх аккаунтов Antigravity
.\scripts\exec-cmd.ps1 "docker exec -u hermes --workdir /opt/hermes --env PYTHONPATH=/opt/hermes hermes python3 -u /opt/data/scripts/check-quota.py"

# 4. Проверить память Геры (Hindsight + последние факты в USER.md)
.\scripts\check-memory.ps1

# 5. Посмотреть расписание фоновых регламентных задач
.\scripts\cron-status.ps1

# 6. Стянуть самый свежий бэкап
.\scripts\pull-backup.ps1

# 7. Запустить live-логи
.\scripts\logs.ps1

# 8. Выполнить команду на мини-ПК
.\scripts\exec-cmd.ps1 "df -h /"

---

⚠️ Три грабли, на которые уходит время

1. docker exec без -u hermes идёт от root. Если такой процесс обновит токен Antigravity, файл станет root:root 0600 и Геря выдаст «No Antigravity OAuth credentials found. Run hermes login». Логин не нужен — лечится docker exec hermes chown -R 10000:10000 /opt/data/auth. Подробнее: maintenance-guide.md §3.

2. Мост на :8655 — не Hermes. Он обслуживает llm-new-api (OpenAI-контур) и имеет собственный порядок аккаунтов 3 → 2 → 1. Правки Геры его не касаются. Подробнее: antigravity-overlay.md §1.

3. cursor-cli бывает unhealthy и блокирует docker compose up для hermes. Обходим через docker compose up -d --no-deps hermes. Подробнее: maintenance-guide.md §5.