SysDoctor: anatomia de um utilitário de manutenção Windows em C#/.NET

Todo mundo que cuida de máquinas Windows já colecionou aquela pasta de scripts .bat e .ps1 soltos — cada um resolvendo uma coisa, nenhum conversando com o outro. O SysDoctor nasceu de juntar esse conhecimento em um único utilitário de console coeso: diagnóstico e otimização de Windows em C# 12 / .NET 10, com uma interface de terminal que qualquer técnico usa sem decorar comando. Este é um passeio pela engenharia por trás dele.

Manutenção de sistema pede uma ferramenta que rode em qualquer máquina, sem instalar um mundo de dependências e sem interface pesada. Um console app self-contained (win-x64) resolve isso: um executável, zero setup. C# 12 sobre .NET 10 dá acesso nativo ao Windows via System.Management (WMI) e um ecossistema maduro para I/O assíncrono — e a Spectre.Console entrega uma TUI com tabelas, cores e status que faz o terminal parecer produto, não prompt cru.

O coração é simples e deliberado: um Program.cs que só orquestra o menu, e uma pasta Scripts/ onde cada operação é um módulo isolado (InfoMachine.cs, ClearDisk.cs, ClearRAM.cs…). Adicionar uma função nova é criar um arquivo e registrar uma entrada — sem tocar no resto. Um GlobalUsings.cs centraliza os namespaces e mantém cada módulo enxuto.

A ferramenta organiza dezessete operações em duas colunas — a divisão que separa entender a máquina de agir sobre ela:

• Diagnóstico — hardware/OS, verificação de integridade do Windows, teste de velocidade da internet, ping, temperatura do processador, pontos de restauração, updates e mapa de conexões de rede.
• Otimização & manutenção — limpeza de temporários, liberação de RAM, limpeza de cache de rede, otimização de latência, ajustes de Wi-Fi, tunings do Windows, setup pós-instalação e execução do Windows Defender.

• Async por padrão — operações de I/O (rede, disco, WMI) usam async/await, então a TUI nunca congela enquanto um teste de velocidade ou uma limpeza roda.
• Privilégio sob controle — o app detecta se está elevado e mostra o status; funciona sem admin, e as funções que ganham com elevação avisam em vez de falhar silenciosamente.
• Falha tratada, não estourada — UnauthorizedAccessException e afins são capturados com mensagem clara; o usuário entende o que aconteceu, não vê um stack trace.
• UTF-8 e caracteres especiais — a saída é pensada para render correto de acentuação e símbolos, coisa que a maioria dos scripts de manutenção ignora.

SysDoctor é um projeto open source, mas carrega a mesma disciplina que aplico nos sistemas de produção da Meta Dados: separar orquestração de execução, tratar erro como parte do contrato, e projetar para quem opera — não só para quem escreve o código. Ferramenta boa é a que some para o problema aparecer.