Руководство по миграции: с AstrBot на ErisPulse

Начнём с главного: подключения платформ, модели, персона и база знаний переносятся; плагины AstrBot перенести нельзя — API плагинов у обеих систем совершенно разные, поэтому плагины придётся переписать в соответствии со спецификацией модулей ErisPulse. Данные не переносятся автоматически.

Сопоставление концепций

Этапы миграции

1. Создание каркаса: инициализируйте проект согласно руководству быстрого старта (подходит как Docker, так и pip) и установите Dashboard
2. Подключение платформ: с помощью epsdk install установите адаптеры платформ, которые вы использовали ранее (для экосистемы QQ — адаптер OneBot, для Telegram — адаптер Telegram…); выбор способа входа и реализации протокола такой же, как и во времена AstrBot
3. Установка агента: выполните epsdk install ErisPulse-QvQChat и укажите в пуле моделей прежние Base URL / API Key / название модели
4. Перенос персоналий и базы знаний: создайте персоналии по одной на странице персоналий QvQChat; документы базы знаний импортируйте заново
5. Переписывание плагинов: руководствуясь таблицей соответствия из следующего раздела, переведите логику «команда → обработка» исходных плагинов в модули ErisPulse

Сравнение переработки плагинов

Один и тот же плагин «получил /ping — отвечает pong», написанный на обеих сторонах:

Плагин AstrBot (пример, точную информацию см. в документации AstrBot):

from astrbot.api.event import filter, AstrMessageEvent

@filter.command("ping")
async def ping(self, event: AstrMessageEvent):
    yield event.plain_result("pong")

Модуль ErisPulse (полностью рабочий, см. Введение в разработку модулей):

from ErisPulse.Core.Event import command

@command("ping", help="проверить, отвечает ли бот")
async def ping_handler(event):
    await event.reply("pong")

Ключевые отличия:

• Модель событий: в AstrBot у каждой платформы свой объект события; в ErisPulse — единое событие OneBot12, event.reply / SendDSL работают одинаково на всех платформах
• Структура пакета: модуль ErisPulse — это стандартный Python-пакет, генерируемый с помощью скаффолда epsdk create module, публикуется на PyPI + в маркетплейсе модулей
• Планировщик задач / хранилище: установите модуль Cron или используйте встроенный в фреймворк API хранилища, без привлечения сторонних зависимостей

Рекомендуемая стратегия миграции

Параллельный запуск двух систем: сначала подключите бота ErisPulse к тестовой группе и проверьте работу всех функций; убедившись, что ничего не упущено, переключайте его на основную группу. Системы учётных записей обеих платформ независимы друг от друга (каждая использует собственную реализацию протокола/Token), они не конфликтуют между собой, поэтому стоимость откката минимальна.

Следующие шаги

• Систематическое изучение разработки модулей: Введение в разработку модулей → Основные концепции
• Если хотите более детально настроить AI-часть: Универсальный агент QvQChat
• Всё ещё сомневаетесь, стоит ли переходить: Сравнение: AstrBot и LangBot