Sobre o projeto

Este plugin é um cliente de terceiros especialmente projetado para o framework AstrBot, voltado ao quadro de classificação DPS ZMDLogs de *Arknights: Endfield*, com o objetivo de oferecer aos jogadores serviços convenientes de consulta e visualização de dados dentro do chat. ### Funcionalidades principais - **Consulta de quadros de classificação**: Permite visualizar todos os quadros públicos e os três primeiros colocados, ou os N primeiros de um quadro específico. Suporta filtros por personagem, atributo e classe, além de classificação pelo critério rDPS. Oferece análise de taxas de uso de formações, formações comuns e distribuição dos principais causadores de dano. - **Relatórios de batalha e comparação**: Exibe detalhadamente a contribuição de combate, curvas de DPS, cobertura de buffs, ritmo de conjuração, equipamentos e fontes de dano de cada jogador. Suporta exibição de palavras-chave de Contrato de Crise, estatísticas de habilidades, eixos de habilidades em página inteira (planejamento de rotação), bem como comparação lado a lado de dois relatórios do mesmo chefe. - **Personagens e contas**: Consulta a melhor colocação de equipes contendo um personagem específico em todos os quadros, o quadro de campeões de personagens e a distribuição de DPS de personagens de seis estrelas (gráfico de caixa). Suporta visualização dos melhores registros de contas públicas para cada chefe, rankings de jogadores e tendências de posição de contas seguidas. - **Social e vinculação**: Permite vinculação segura por meio de códigos gerados no site (cada pessoa pode vincular até 5 contas). Suporta visualização dos rankings de membros vinculados no grupo. É possível seguir contas ou quadros; quando a posição de um item seguido cai ou um novo recorde aparece no top 3, o plugin envia ativamente uma notificação no grupo. ### Interação e visual - **Imagens longas no estilo Endfield**: Todos os resultados de consulta são renderizados como uma única imagem PNG de 1280px de largura, com estilo visual unificado. Se o Chromium integrado não estiver disponível, o plugin pode recorrer ao serviço de texto para imagem do AstrBot. - **Ferramentas de modelo de linguagem natural**: Ao integrar um modelo de grande porte e habilitar chamadas de função, os membros do grupo podem fazer perguntas diretamente em linguagem natural. O plugin oferece 4 ferramentas dedicadas (quadro, relatório, personagem, conta), com o modelo interpretando automaticamente a intenção e gerando gráficos e interpretações textuais. - **Otimização para bot oficial do QQ**: Para o adaptador de bot oficial do QQ, fornece botões de lista de candidatos, links diretos para imagens de resultados e função de geração de imagem em um clique (modo de retorno), melhorando significativamente a conveniência de operação no bot oficial. ### Detalhes técnicos e configuração - **Mecanismo de execução**: Após a inicialização, cria em memória um índice de classificação de todos os quadros (aproximadamente 5 MB). Em segundo plano, relê periodicamente os dados para manter a atualização; em estado estável, gera apenas cerca de 3 solicitações upstream por minuto. - **Dependências**: Desenvolvido em Python 3.11+, utiliza Playwright para renderização HTML, exigindo instalação manual do Chromium. - **Configurabilidade**: Oferece uma ampla gama de opções de configuração, incluindo endereço da API, TTL de cache, tempo limite de renderização, limite de correspondência difusa, intervalo de notificação de mudanças de posição, botões do bot oficial do QQ e alternância de modo de retorno, permitindo ajuste fino conforme o ambiente de implantação.