About this project

This plugin is a third-party client for the Arknights: Endfield DPS speedrun leaderboard ZMDLogs, designed specifically for the AstrBot framework, aiming to provide players with convenient in-chat data querying and visualization services. ### Core Features - **Leaderboard Queries**: View all public leaderboards and top 3, or top N of a specified leaderboard. Supports filtering by character, element, and class, as well as ranking by rDPS metric. Provides team composition appearance rates, common team compositions, and main DPS distribution analysis. - **Battle Reports & Comparison**: Detailed display of battle contributions, DPS curves, BUFF coverage, cast rhythm, each member's build and damage sources. Supports Contingency Contract tag display, skill statistics, full-page skill timeline (rotation planning), and side-by-side comparison of two battle reports against the same boss. - **Characters & Accounts**: Query the best rankings of teams containing a specific character across all leaderboards, character champion leaderboards, and 6-star character DPS distribution (box plots). Supports viewing public accounts' best records per boss, player rankings, and ranking trends for followed accounts. - **Social & Binding**: Secure binding via binding codes generated by the website (up to 5 accounts per person), supports viewing group leaderboard rankings of bound members within the group. Can follow accounts or leaderboards; when a followed account's rank drops or a new record appears in the top 3 of a leaderboard, the plugin will proactively send a notification in the group. ### Interaction & Visuals - **Endfield-style Long Images**: All query results are rendered as a single 1280px-wide PNG image with a unified visual style. If the built-in Chromium is unavailable, it can fall back to AstrBot's built-in text-to-image service. - **Natural Language LLM Tools**: After connecting to a large language model and enabling function calling, group members can directly ask questions in natural language. The plugin provides 4 dedicated tools (leaderboard, battle report, character, account), with the model automatically parsing intent and generating charts and text interpretations. - **QQ Official Bot Optimization**: For the QQ official bot adapter, provides candidate list buttons, result image direct links, and one-click image generation (callback mode), greatly improving operational convenience on official bots. ### Technical Details & Configuration - **Operating Mechanism**: After startup, builds a ranking index of all leaderboards in memory (approximately 5 MB), periodically re-reads in the background to maintain data freshness, and under steady state generates only about 3 upstream requests per minute. - **Dependencies**: Developed based on Python 3.11+, relies on Playwright for HTML rendering, requires manual installation of Chromium. - **Configurability**: Provides rich configuration options, including API address, cache TTL, render timeout, fuzzy matching threshold, rank notification interval, QQ official bot button and callback switches, etc., facilitating tuning according to actual deployment environments.