Sobre o projeto

O mcode-monitor é um painel local de monitoramento de uso voltado para o MiniMax Code, disponibilizado no formato de Mini App. O repositório oficial de Mini Apps já inclui este projeto; este repositório corresponde à versão principal de desenvolvimento, e todas as atualizações são enviadas de forma sincronizada para o repositório oficial. Sua principal finalidade é permitir a visualização do consumo de tokens do MiniMax Code. Após a instalação, é possível abrir o «Painel de Uso de Tokens» pelo ponto de entrada de Mini Apps do MiniMax Code, para consultar os dados de uso a qualquer momento. Funcionalidades: - Visão geral de KPIs: consumo de tokens, entrada/saída/leitura de cache, taxa de acerto de cache, número de solicitações, velocidade média de saída - Série temporal de consumo de tokens: agrupamento automático por intervalo de tempo, com gráfico de barras empilhadas para cache e entrada, acompanhado da curva de saída - Filtro por modelo/sessão: menu suspenso de seleção múltipla, com as sessões sendo referenciadas pelos arquivos de sessão reais, aplicando-se em tempo real a todos os gráficos e tabelas - Separação por modelo: é possível alternar com um único clique para visualizar a curva de saída de cada modelo - Comparação entre modelos: gráfico de barras do volume total de entrada, acompanhado de curvas duplas para número de chamadas e velocidade de saída - Velocidade de tokens: gráfico de linhas com o valor de tok/s de cada uma das últimas 60 solicitações - Detalhamento e resumo das chamadas recentes: horário, modelo, sessão, tokens, tempo decorrido, velocidade - As condições de filtro, intervalo de tempo, intervalo de atualização e tema são armazenados para recuperação posterior - Temas claro e escuro, com acompanhamento automático da configuração do sistema - Intervalos de tempo disponíveis: última 1 hora, 24 horas (padrão), 7 dias, 30 dias, todo o período - Atualização automática: 5s, 10s, 30s, ou modo manual A instalação requer que a máquina local possua Python 3.8 ou superior, sendo desnecessária a instalação de qualquer pacote de dependências via pip. Basta colocar a pasta miniapps/mcode-usage-monitor do repositório no diretório ~/.minimax/plugins/: no Windows, o caminho correspondente é C:\Users\nome do usuário\.minimax\plugins\mcode-usage-monitor; no macOS/Linux, o caminho é ~/.minimax/plugins/mcode-usage-monitor. Para desinstalar, basta excluir essa pasta. A leitura de dados é feita em modo somente leitura no banco de dados local, sem interferir no funcionamento do MiniMax Code que está sendo utilizado no momento. O pacote acompanha documentação explicativa em inglês e chinês. Definição de indicadores: o consumo de tokens corresponde à soma de entrada, leitura de cache e saída; a taxa de acerto de cache é a proporção de conteúdo do prompt que é atendido diretamente pelo cache; a velocidade de saída é a média ponderada obtida pela divisão dos tokens de saída pelo tempo decorrido. Os valores de cobrança e cota são referenciados pela página de uso exibida dentro do produto MiniMax Code. A descrição do projeto informa que o código e a documentação são gerados e iterados pelo MiniMax Code (assistente de programação com IA), sendo o autor responsável pela definição de requisitos, decisões de direção e validação. A ideia original tem como referência o projeto zcode-monitor. O componente de terceiros utilizado é o ECharts (licença Apache 2.0), que foi empacotado localmente para permitir o uso offline. O projeto adota a licença MIT.