Об этом проекте

Этот плагин — сторонний клиент таблицы рекордов DPS-скорклиров ZMDLogs для игры «Arknights: Endfield», разработанный специально для фреймворка AstrBot и предназначенный для удобного запроса данных и их визуализации прямо в чате. ### Основные функции - **Запрос рейтингов**: просмотр всех публичных таблиц и топ-3, либо топ-N указанной таблицы. Поддержка фильтрации по персонажу, элементу, классу, а также ранжирование по метрике rDPS. Анализ частоты появления составов, типичных команд и распределения основных DPS-персонажей. - **Боевые отчёты и сравнение**: детальное отображение боевого вклада, кривых DPS, покрытия баффов, ритма применения навыков, экипировки и источников урона каждого участника. Поддержка отображения модификаторов кризисных контрактов, статистики навыков, полной шкалы навыков (таймлайн), а также параллельного сравнения двух боевых отчётов против одного босса. - **Персонажи и аккаунты**: запрос лучших позиций команд с определённым персонажем во всех таблицах, рейтинг чемпионов по персонажам, распределение DPS шестизвёздочных персонажей (ящиковая диаграмма). Поддержка просмотра лучших результатов публичных аккаунтов по каждому боссу, ранга игрока и тренда позиций отслеживаемых аккаунтов. - **Социальные функции и привязка**: безопасная привязка через код, сгенерированный сайтом (до 5 аккаунтов на пользователя), просмотр группового рейтинга привязанных участников. Возможность подписки на аккаунты или таблицы — при понижении позиции отслеживаемого объекта или появлении нового рекорда в топ-3 плагин автоматически отправляет уведомление в группу. ### Взаимодействие и визуальное оформление - **Длинные изображения в стиле Endfield**: все результаты запросов рендерятся в одно PNG-изображение шириной 1280px с единым визуальным стилем. При недоступности встроенного Chromium возможен откат на встроенный в AstrBot сервис текст-в-изображение. - **Инструменты на базе больших языковых моделей**: после подключения LLM и включения function calling участники группы могут задавать вопросы естественным языком. Плагин предоставляет 4 специализированных инструмента (рейтинги, боевые отчёты, персонажи, аккаунты) — модель автоматически определяет намерение и генерирует графики и текстовые пояснения. - **Оптимизация для официального QQ-бота**: для адаптера официального QQ-бота предусмотрены кнопки списка вариантов, прямые ссылки на изображения с результатами и функция мгновенной генерации изображений (режим callback), что значительно повышает удобство работы с официальным ботом. ### Технические детали и конфигурация - **Механизм работы**: при запуске в памяти строится индекс ранжирования всех таблиц (около 5 МБ), фоновый процесс периодически перечитывает данные для поддержания актуальности — в установившемся режиме около 3 запросов к вышестоящему API в минуту. - **Зависимости**: разработан на Python 3.11+, использует Playwright для рендеринга HTML, требуется ручная установка Chromium. - **Настраиваемость**: богатый набор параметров конфигурации, включая адрес API, TTL кэша, тайм-аут рендеринга, порог нечёткого сопоставления, интервал уведомлений о смене позиций, переключатели кнопок и callback для официального QQ-бота и др., позволяющий тонко настраивать плагин под реальную среду развёртывания.