ErisPulse-App

ErisPulse-App — это официальный многоплатформенный клиент, поддерживаемый напрямую ErisDev (выпущены версии для Android / Windows / Linux / macOS),
предоставляющий полностью нативный графический интерфейс управления: создание, запуск и управление несколькими экземплярами ботов на телефоне или компьютере,
без необходимости использования терминала и отдельной установки среды Python.

Функциональные возможности

• Управление несколькими экземплярами: создание/запуск/остановка/удаление нескольких экземпляров, автоматическое распределение портов и токенов доступа, поддержка новых сред или клонирование существующих
• Панель инструментов: статистика адаптеров/модулей/онлайн-роботов/общего количества событий, изменение цвета индикаторов при превышении использования CPU/памяти
• Магазин модулей: поиск и фильтрация по тегам, установка/обновление/удаление одним нажатием, установка определённой версии, поддержка pip-реестров и Git-пакетов
• Поток событий + конструктор событий: просмотр событий в реальном времени, визуальное построение тестовых событий и отправка их адаптеру
• Мониторинг: объединённый вид логов/жизненного цикла/аудита
• Управление командами: глобальные настройки префиксов и псевдонимов, включение/отключение и чёрные/белые списки платформ
• Обзор роботов/конфигурация/управление файлами: прямое управление экземплярами через родной интерфейс
• Работа в фоновом режиме: фоновый сервис для Android для поддержания активности; Windows минимизируется в системный трей, закрытие окна не прерывает экземпляр
• Динамическое окно модуля: автоматическое появление страниц, зарегистрированных модулем, в боковом навигационном меню (в той же группе, что и Dashboard), переход по клику

Поддерживаемые платформы

Все установочные пакеты можно скачать на GitHub Releases, выберите нужный по своему усмотрению:

Один код Flutter-приложения поддерживает все платформы.

Способы установки (Android / запуск напрямую с телефона)

Скачайте APK-файл с GitHub Releases и установите его. Существует два варианта сборки:

Оба варианта имеют одинаковые шаги установки:

1. Скачайте и установите APK-файл, при запуске разрешите разрешение на уведомления (необходимо для поддержания работы фоновых сервисов)
2. После появления на главной странице баннера инициализации нажмите "Запустить" для выполнения первой инициализации (с прогресс-баром и логами)
3. Создайте экземпляр и запустите его
4. Настройте адаптеры и API-ключ модели в встроенном интерфейсе управления приложения

Оффлайн-пакет автономный — после установки не требуется подключение к интернету. Если при первом запуске загрузка медленная или ненадежная, можно переключить источник загрузки на зеркало (ghfast / gh-proxy) в настройках.

Способы установки (десктоп: Windows / Linux / macOS)

1. Скачайте установочный пакет для соответствующей платформы с GitHub Releases (Windows setup.exe или безустановочный zip, Linux tar.gz, macOS zip)
2. Установите и запустите
3. На странице приветствия выберите версию ErisPulse SDK для установки (по умолчанию последняя) и установите её
4. Создайте экземпляр и запустите его

Принцип работы

┌────────────────────────────────────────────────────┐
│  ErisPulse-App (Flutter)                            │
│                                                    │
│  Нативный интерфейс ── REST / WebSocket API панели │
│       │                                            │
│       ├── Android: фоновый сервис + proot + Ubuntu rootfs│
│       │        + Python + экземпляр ErisPulse       │
│       └── Десктоп: встроенный Python + прямое управление процессами │
└────────────────────────────────────────────────────┘

• Android: экземпляр запускается в фоновом сервисе (background isolate), обёрнутом в proot (chroot в пользовательском режиме) после закрытия интерфейса бот продолжает работать, при падении автоматически перезапускается
• Десктоп: экземпляр запускается как прямой дочерний процесс приложения; поддержка Windows в минимизированном состоянии в системной панели (закрытие окна не прерывает экземпляр), при перезапуске приложения автоматически восстанавливает управление экземплярами, которые продолжают работать, при выходе из приложения останавливает все экземпляры
• Нативный интерфейс на всех платформах взаимодействует с экземпляром через REST / WebSocket API по адресу 127.0.0.1:<port>/Dashboard/*, используя тот же API, что и ErisPulse-Dashboard

Отношение к SDK

• Встроенный в приложение ErisPulse SDK: Android-версия упакована в образ Ubuntu, десктопная версия устанавливается из PyPI
  (при выборе версии на начальном экране, по умолчанию — последняя)
• Экземпляры в приложении эквивалентны экземплярам, созданным с помощью командной строки epsdk, можно использовать одинаковые модули / адаптеры
• Разработчики модулей могут зарегистрировать собственные страницы через окно Dashboard:
  Окно автоматически появится в боковой навигации приложения (группировка соответствует Dashboard), при нажатии происходит переход на соответствующую страницу и рендеринг

Связанные ссылки

• Репозиторий на GitHub: https://github.com/ErisPulse/ErisPulse-App
• Скачать: GitHub Releases
• Обсуждение: Discussions