KillerBench.Engine
Os guias detalhados vinculados nesta página estão em inglês.
KillerBench.Engine é uma biblioteca de diagnóstico e reparo do Windows para aplicativos que precisam de evidências estruturadas, em vez de um conjunto de scripts opacos. Alimenta as ferramentas de desktop e linha de comando do KillerBench e pode ser incorporado em outro aplicativo hospedeiro .NET.
O que oferece
- Fluxos de diagnóstico delimitados para manutenção do Windows, dispositivos, armazenamento, rede, impressão, segurança, aplicativos, perfis e outras áreas do sistema
- Evidências tipadas com estados explícitos de completo, incompleto, desconhecido e histórico
- Receitas de reparo que exigem evidências atuais exatas antes da execução
- Diários persistentes para verificar reparos e recuperar execuções interrompidas
- Callbacks de progresso para exibições ao vivo, como atividades de manutenção
- Resultados em texto, JSON, HTML e .NET estruturado para relatórios e integrações
- Pacotes de conhecimento versionados para códigos de erro, identificadores de hardware, fornecedores e referências de suporte
Projetado para rastreabilidade
Cada constatação está ligada às evidências que a produziram. Eventos históricos continuam sendo históricos. Dados ausentes não viram um parecer de integridade. Uma falha do provedor não vira um resultado vazio. O Engine informa os limites do que examinou, para que o aplicativo hospedeiro explique o que se sabe e o que permanece desconhecido.
Diagnóstico primeiro
A maioria das operações do Engine é somente leitura. O suporte a reparos é intencionalmente mais restrito que a cobertura dos diagnósticos. Um reparo exige uma receita compatível, evidências atuais de elegibilidade, autorização explícita do aplicativo hospedeiro, um registro persistente da preparação, uma ação nativa delimitada e verificação após a ação.
A verificação completa do sistema é apenas diagnóstica, mesmo quando um fluxo específico permite reparos automáticos. Capturas salvas e eventos históricos nunca autorizam um reparo. A validação dos reparos nativos se limita às evidências preservadas de máquinas Windows descartáveis, registradas no arquivo do repositório VM-VALIDATION.md.
Aplicativo hospedeiro de desktop
A interface de desktop apresenta a saída do Engine nas exibições Saída bruta e Relatório legível. As confirmações e os diálogos Abrir, Salvar e Pasta seguem o tema ativo do aplicativo. Esses controles pertencem ao aplicativo hospedeiro de desktop; um aplicativo que incorpore o Engine deve oferecer sua própria interface de revisão e autorização, preservando os controles de evidências, pré-requisitos, diários e verificação do Engine.
Estado atual
O Engine tem como alvo .NET 10 e Windows. Está em desenvolvimento ativo e é usado atualmente por meio de uma referência de projeto dentro do repositório KillerBench. Um pacote público ainda não foi lançado.
Escolha um guia
- Primeiros passos mostra um primeiro fluxo somente leitura.
- Fluxos de diagnóstico explica verificações específicas e a verificação completa do sistema.
- Evidências e resultados explica estados, diários, progresso e relatórios.
- Reparos e segurança descreve os controles de evidências e o modelo de recuperação.
- Guia da CLI aborda a descoberta de comandos, saída de texto e saída JSON.
- Guia de API apresenta os principais pontos de entrada públicos.
- Arquitetura explica os limites do Engine e as camadas internas.
- Pacotes de conhecimento aborda dados de referência atualizáveis.
