Skip to content

README-V11.md

Latest commit

 

History

History
366 lines (292 loc) · 8.28 KB

README-V11.md

File metadata and controls

366 lines (292 loc) · 8.28 KB
Raw

Mestre do PC V11 - Resumo da Atualização

🎉 Bem-vindo à Versão 11!

Esta atualização traz melhorias completas em todas as áreas do Mestre do PC, transformando a ferramenta em uma solução enterprise-ready para gerenciamento e manutenção de sistemas Windows.

📊 Resumo das Mudanças

Categoria V10 V11 Crescimento
Operações PowerShell ~80 ~113 +33 (+41%)
Ferramentas MCP ~25 ~36 +11 (+44%)
Integrações 0 3 Discord, Teams, Slack
Níveis de Log 0 7 Sistema completo
Testes Automatizados ~5 ~12 +7 (+140%)

🚀 Novas Funcionalidades Principais

1. +33 Novas Operações PowerShell

Backup e Recuperação

  • Backup completo do registro do Windows
  • Exportação de drivers instalados
  • Backup de configurações de rede
  • Backup de programas instalados

Monitoramento de Hardware

  • Leitura de temperatura da CPU
  • Monitoramento contínuo (10 leituras)
  • Temperatura de GPU (com OpenHardwareMonitor)
  • Alerta sonoro de temperatura crítica

Gestão de Drivers

  • Listar todos os drivers
  • Atualizar via Windows Update
  • Reinstalar dispositivo
  • Rollback de versão
  • Exportar lista em CSV

Apps UWP (Windows Store)

  • Listar todos os apps
  • Reinstalar apps padrão
  • Reset de app específico
  • Limpar cache de apps
  • Diagnóstico de apps corrompidos

SSD e Armazenamento

  • Otimizar TRIM em todos os drives
  • Verificar saúde completa (SMART)
  • Histórico de uso
  • Verificar alinhamento de partições
  • Otimizar Windows para SSD

Relatórios e Tarefas

  • Exportar relatório completo em HTML
  • Agendar limpeza diária automática

2. IA Avançada no MCP Server

RAG (Retrieval-Augmented Generation)

perguntar_ia_com_contexto(pergunta, contexto)

Envia contexto adicional (logs, código, documentos) junto com a pergunta para respostas mais precisas.

Chain-of-Thought

resolver_problema_passo_a_passo(problema)

Divide problemas complexos em passos lógicos e fornece solução detalhada.

Comparação de Modelos

comparar_modelos_ia(pergunta, modelos)

Compara respostas de múltiplos modelos (ex: qwen, llama, mistral) para validar consistência.

Análise de Código PowerShell

analisar_codigo_powershell(codigo)

Fornece explicação, sugestões de melhoria e notas de segurança para scripts.

Sugestão de Comandos

ia_comando_sugerir(tarefa)

Descreva uma tarefa e a IA sugere o comando PowerShell exato.

3. Integrações com Plataformas de Comunicação

Discord Webhook

enviar_webhook_discord(webhook_url, titulo, mensagem, cor)
  • Embed formatado com título, descrição, cor
  • Timestamp automático
  • Ideal para alertas e notificações

Microsoft Teams Webhook

enviar_webhook_teams(webhook_url, titulo, mensagem, tema)
  • MessageCard formatado
  • Temas: Information, Warning, Danger, Success
  • Integração corporativa

Slack Webhook

enviar_webhook_slack(webhook_url, mensagem, canal, emoji)
  • Mensagem formatada
  • Emoji personalizado
  • Canal específico

Monitoramento com Alertas Automáticos

monitorar_e_notificar(webhook_url, cpu_limite, ram_limite, disco_limite, plataforma)

Monitora CPU, RAM e disco em tempo real e envia alerta se ultrapassar limites.

4. Sistema Completo de Auditoria

Módulo audit-logger.js

7 Níveis de Log:

  • INFO - Informações gerais
  • WARNING - Avisos
  • ERROR - Erros
  • SECURITY - Eventos de segurança
  • COMMAND_EXEC - Execução de comandos
  • IA_OPERATION - Operações de IA
  • WEBHOOK - Envio de webhooks

Recursos:

  • Rotação automática (10MB, 30 dias)
  • Sanitização de dados sensíveis
  • Redaction de tokens e senhas
  • Consultas filtradas
  • Exportação em Markdown

Ferramentas MCP:

consultar_logs_auditoria(level, action, limit)
exportar_relatorio_auditoria(start_date, end_date, limit)

🔧 Melhorias Técnicas

MCP Server

Auditoria Integrada

  • Todas as execuções de comandos são logadas
  • Webhooks registram envio e falhas
  • Erros categorizados por severidade
  • Logs assíncronos não bloqueiam

Security Reforçada

  • Sanitização de dados sensíveis
  • Validação de parâmetros
  • Detecção de prompt injection
  • Redaction automático

Performance

  • Timeout configurável por operação
  • Rotação de logs previne disco cheio
  • Consultas otimizadas

📋 Variáveis de Ambiente

Variável Padrão Descrição
MESTRE_AUDIT_LOG_DIR logs/audit Diretório dos logs de auditoria
MESTRE_BASE_URL http://127.0.0.1:7777 URL do Launcher
OLLAMA_URL http://127.0.0.1:11434 URL do Ollama (auto: cloud se API key)
OLLAMA_API_KEY - API key para Ollama Cloud
OLLAMA_MODEL qwen2.5-coder:3b-instruct Modelo padrão
OLLAMA_MODEL_PROFILE balanced Perfil (fast, balanced, agent, coding, reasoning)
OLLAMA_NUM_CTX 8192 Contexto máximo (tokens)
OLLAMA_TEMPERATURE 0.7 Criatividade (0-2)

🚀 Quick Start

1. Instalar Dependências

cd Mestre-do-PC-V10-clean\mcp-server
npm ci
npm test

2. Validar Scripts

.\validate-v11.ps1 -Verbose

3. Iniciar Servidor

# Launcher (Admin)
.\MestreDoPC-Launcher.ps1

# MCP Server (em outro terminal)
cd mcp-server
npm start

4. Testar Nova Funcionalidade

// Exemplo: Enviar alerta Discord
{
  "name": "enviar_webhook_discord",
  "arguments": {
    "webhook_url": "https://discord.com/api/webhooks/...",
    "titulo": "Teste V11",
    "mensagem": "Mestre do PC V11 instalado com sucesso!",
    "cor": "00ff00"
  }
}

🔐 Segurança

Logs de Auditoria

  • ✅ Todos os comandos registrados
  • ✅ Dados sensíveis redactados
  • ✅ Rotação automática (30 dias)
  • ✅ Consultas filtradas

Webhooks

  • ✅ URLs não logadas em claro
  • ✅ Mensagens pré-visualizadas
  • ✅ Falhas registradas com status

IA

  • ✅ Detecção de prompt injection
  • ✅ Contexto sanitizado
  • ✅ Respostas validadas

📊 Exemplos de Uso

Monitorar e Notificar Alerta

{
  "name": "monitorar_e_notificar",
  "arguments": {
    "webhook_url": "https://discord.com/api/webhooks/...",
    "cpu_limite": 80,
    "ram_limite": 80,
    "disco_limite": 90,
    "plataforma": "discord"
  }
}

IA com Contexto (RAG)

{
  "name": "perguntar_ia_com_contexto",
  "arguments": {
    "pergunta": "Qual o erro mais crítico?",
    "contexto": "[cole aqui os logs do Event Viewer]"
  }
}

Resolver Problema Passo a Passo

{
  "name": "resolver_problema_passo_a_passo",
  "arguments": {
    "problema": "Windows Update falhando com erro 0x80070005"
  }
}

Consultar Logs de Auditoria

{
  "name": "consultar_logs_auditoria",
  "arguments": {
    "level": "SECURITY",
    "action": "webhook",
    "limit": 20
  }
}

Comparar Modelos de IA

{
  "name": "comparar_modelos_ia",
  "arguments": {
    "pergunta": "Como otimizar SSD no Windows?",
    "modelos": "qwen2.5-coder:3b,llama3.1:8b,mistral:7b"
  }
}

🧪 Testes

Executar Testes

cd mcp-server
npm test

Validação PowerShell

.\validate-v11.ps1 -Verbose

📝 Arquivos Novos/Modificados

Novos Arquivos

  • mcp-server/audit-logger.js - Módulo de auditoria
  • mcp-server/test/v11-security.test.js - Testes de segurança
  • validate-v11.ps1 - Validação de scripts
  • CHANGELOG-V11.md - Changelog completo
  • README-V11.md - Este arquivo

Arquivos Modificados

  • v10/allowed-operations.json - +33 operações
  • mcp-server/index.js - +11 ferramentas MCP

🔮 Futuro (V12)

Roadmap planejado:

  • Suporte a Azure Functions
  • Integração AWS Lambda
  • Dashboard web em tempo real
  • Gráficos de histórico
  • Alertas por e-mail (SMTP)
  • Criptografia de logs sensíveis

📞 Suporte

  • Documentação: docs/
  • Changelog: CHANGELOG-V11.md
  • Security: SECURITY.md
  • Contribuição: CONTRIBUTING.md

Mestre do PC V11 - Desenvolvido por JEAN
Versão: 11.0.0 | Data: Agosto 2026