¡Herramientas de Hacking, PenTest y Ciberseguridad para tu Arsenal de Seguridad!
SuperDiagnosticTool — Herramienta de diagnóstico y autorreparación de Windows impulsada por IA utilizando Google Gemini. Detecta fallos, optimiza el rendimiento, escanea en busca de malware y genera scripts de corrección de PowerShell. Soporte universal de hardware (1-128+ núcleos). Gratuita y de código abierto. | Kitploit
Herramienta de diagnóstico y autorreparación de Windows impulsada por IA utilizando Google Gemini. Detecta fallos, optimiza el rendimiento, escanea en busca de malware y genera scripts de corrección de PowerShell. Soporte universal de hardware (1-128+ núcleos). Gratuita y de código abierto.
Compartir
SuperDiagnosticTool
Herramienta de Diagnóstico y Autocuración para Windows impulsada por IA
SuperDiagnosticTool es una utilidad de diagnóstico inteligente para sistemas que combina telemetría de hardware en tiempo real con Google Gemini AI para analizar, diagnosticar y corregir automáticamente problemas del sistema Windows. Construida con una arquitectura centrada en la seguridad, proporciona diagnósticos de grado profesional para cualquier configuración de Windows.
Capturas de Pantalla
Interfaz principal mostrando la selección del modo de escaneo y la entrada de descripción del problema
Características Clave
Soporte Universal de Hardware
Escalado Dinámico: Se adapta automáticamente a cualquier configuración de CPU (1-128+ núcleos)
Lógica Independiente del Hardware: Funciona sin problemas en sistemas heredados (Intel Pentium) hasta estaciones de trabajo de alta gama (AMD Threadripper, Intel Xeon)
Fallos Controlados: Manejo seguro de características no soportadas (frecuencia de CPU, detección de batería, memoria de intercambio)
Optimizado para Bajos Recursos: Ejecución ligera que evita ralentizaciones del sistema incluso en hardware con recursos limitados
Análisis Inteligente con IA
Integración con Google Gemini: Análisis y diagnóstico avanzado del sistema impulsado por IA
Recomendaciones Contextuales: Correlaciona problemas reportados por el usuario con la telemetría del sistema
Auditoría de Seguridad: Escanea procesos sospechosos, fugas de recursos y posible malware
Verificación Posterior a la Corrección: Genera informes de finalización que muestran lo que se arregló vs. lo que requiere atención manual
Arquitectura Centrada en la Seguridad
Seguridad de Grado Profesional (85%)
Validación Multinivel
Coincidencia con Base de Conocimiento: Valida soluciones de IA contra 5 soluciones conocidas probadas con tasas de éxito
Simulación de Prueba (Dry-Run): Previsualiza todos los cambios antes de ejecutarlos (servicios, archivos, registro)
Validación de Scripts Multinivel: Lista negra, lista blanca y puntuación de riesgo (0-100)
Puntos de Restauración del Sistema: Creación automática de puntos de restauración antes de cualquier modificación
Monitoreo Mejorado
Instantáneas Pre/Post Ejecución: Captura completa del estado del sistema antes y después de los cambios
Detección de Cambios: Seguimiento automático de todas las modificaciones (servicios, registro, elementos de inicio)
Generación de Reversión: Scripts generados automáticamente para deshacer cambios si es necesario
Registro de Ejecución: Registros completos de todas las operaciones
Seguridad en PowerShell
Verificación de Privilegios de Administrador: Todos los scripts de corrección incluyen comprobaciones de elevación
Sanitización de Variables: Escape basado en expresiones regulares para prevenir errores preservando variables $env:
Comprobaciones de Seguridad de Servicios: Verifica la existencia del servicio antes de las operaciones
Ejecución en Entorno Aislado: Entorno monitoreado con protección por tiempo de espera
Manejo de Errores: Bloques try-catch exhaustivos con salvaguardas
Escaneo Integral del Sistema
Métricas de Rendimiento: Uso de CPU (global + por núcleo), desglose de memoria, principales consumidores de recursos
Inteligencia de Red: Interfaces activas, configuración DNS, intensidad de señal Wi-Fi, pruebas de conectividad
Integridad de Seguridad: Estado del antivirus, perfiles de firewall, historial de Windows Update
Salud del Hardware: Estado SMART del disco, información de GPU, estado de la batería (portátiles)
Servicios del Sistema: Aplicaciones de inicio, servicios fallidos, registros de eventos críticos
Auditoría de Procesos: Identifica procesos sospechosos basándose en el uso de recursos y ubicación
Informes Centrados en el Ser Humano
Informes HTML Profesionales: Informes de diagnóstico con tema oscuro y métricas visuales
Lenguaje de Finalización en Tiempo Pasado: Los informes usan etiquetas [FIXED], [CLEANED], [DISABLED] para mostrar acciones completadas
Sección de Atención Manual: Separa claramente las correcciones automatizadas de los elementos que requieren intervención del usuario
Archivos con Marca de Tiempo: Todos los informes se guardan en el directorio AI_Reports/ para seguimiento histórico
Ingresa tu clave API de Google Gemini cuando se te solicite
Describe el problema de tu sistema
Selecciona el modo de escaneo (Rápido/Profundo/Completo)
Revisa el análisis de IA y el script de corrección
Ejecuta las correcciones o visualiza el informe HTML detallado
Instalación (Para Desarrolladores)
Prerrequisitos
Python 3.8 o superior
Administrador de paquetes pip
Instalar Dependencias
root@kitploit:~
pip install psutil google-generativeai rich
Ejecutar desde el Código Fuente
root@kitploit:~
python super_diagnose_v2.py
Uso
Configuración de la Clave API
Opción A: Entrada Interactiva (Recomendada para usuarios primerizos)
La herramienta te pedirá que ingreses tu clave API en el primer uso
La clave se guarda localmente en gemini.key para usos futuros
Opción B: Variable de Entorno
root@kitploit:~
set GEMINI_API_KEY=tu_clave_api_aqui
Opción C: Archivo de Clave Manual
Crea gemini.key en el mismo directorio:
root@kitploit:~
tu_clave_api_aqui
Modos de Escaneo
Modo
Escaneos
Caso de Uso
Escaneo Rápido
CPU, RAM, Información Básica
Comprobación rápida de rendimiento
Escaneo Profundo
Sistema, Red, Seguridad, Registros, Bluetooth, Procesos
Solución de problemas exhaustiva
Escaneo Completo
Todo lo anterior + Salud del Disco, GPU, Aplicaciones de Inicio
Auditoría completa del sistema
Flujo de Trabajo Ejemplo
root@kitploit:~
# 1. Ejecuta la herramienta
SuperDiagnosticTool.exe
# 2. Describe tu problema
> Alto uso de CPU y rendimiento lento
# 3. Selecciona el modo de escaneo
> 3 (Escaneo Completo del Sistema)
# 4. Espera el análisis de IA
[Escaneando capas del sistema...]
[Procesando lógica de telemetría...]
# 5. Revisa el script de corrección
[Script de PowerShell mostrado]
> ¿Ejecutar? (s/n)
# 6. Visualiza el informe HTML
> ¿Abrir informe detallado? (s/n)
Detalles Técnicos
Arquitectura del Código
Diseño modular con funciones separadas para cada categoría de diagnóstico
Manejo exhaustivo de errores con bloques try-except
Consultas independientes del hardware con fallos controlados
Docstrings profesionales y nombres de variables claros
Generación de Scripts de PowerShell
Verificación de privilegios de administrador antes de la ejecución
Escape de variables basado en expresiones regulares para prevenir errores de sintaxis
Variables de entorno ($env:TEMP, $env:PATH) preservadas correctamente
Gestión segura de servicios con comprobaciones de existencia
Supresión de errores usando -ErrorAction SilentlyContinue
Integración con Gemini AI
Prompts estructurados para un análisis de salida consistente
Secciones delimitadas ([ANALYSIS_START], [FIX_START]) para extracción fiable
Análisis contextual basado en la telemetría del sistema
Informes en tiempo pasado para acciones de corrección completadas
Seguridad y Privacidad
Sin Recopilación de Datos: Todo el análisis ocurre localmente; solo la telemetría del sistema se envía a la API de Gemini
Seguridad de la Clave API: Las claves se almacenan localmente y nunca se envían al control de versiones
Transparencia del Administrador: El usuario debe aprobar explícitamente todos los scripts de corrección
No Destructivo: Sin eliminación de archivos o modificaciones del registro sin consentimiento del usuario
Código Abierto: Código fuente completo disponible para auditoría de seguridad
Consulta SECURITY.md para obtener información detallada sobre seguridad.
Solución de Problemas
Error "Clave API Inválida"
Verifica que tu clave API sea correcta y esté activa
Comprueba si hay caracteres ocultos o espacios en blanco
Asegúrate de que la clave tenga habilitado el acceso a la API de Gemini
Esto crea dist/SuperDiagnosticTool.exe con el icono y las dependencias incluidas.
Nota: Si ves una advertencia de "Windows protegió tu PC", lee TRUST_GUIDE.md para una solución rápida o para agregar la aplicación a la lista blanca permanentemente.
Nota: Compilar en Linux/Mac creará binarios específicos de la plataforma, no archivos .exe de Windows. Usa GitHub Actions para lanzamientos oficiales de Windows.
Estructura de Archivos
root@kitploit:~
SuperDiagnosticTool/
├── super_diagnose_v2.py # Script de diagnóstico principal
├── build.py # Script de compilación para crear EXE
├── icon.ico # Icono de la aplicación
├── .github/workflows/ # Flujos de trabajo de GitHub Actions
│ └── release.yml # Compilación y lanzamiento automatizados
├── docs/
│ ├── icon.png # Icono para el README
│ └── screenshot_main.png # Captura de pantalla de la interfaz principal
├── src/ # Módulos fuente
│ ├── safety/ # Módulos de seguridad y validación
│ └── security/ # Características de seguridad
├── AI_Reports/ # Informes HTML generados
├── README.md # Este archivo
├── RELEASE_PROCESS.md # Documentación del proceso de lanzamiento
├── LICENSE # Licencia GPL-3.0
├── SECURITY.md # Documentación de seguridad
└── .gitignore # Reglas de ignorado de Git
Descargo de Responsabilidad
IMPORTANTE: Advertencia sobre Modificaciones del Sistema
Esta herramienta genera y ejecuta scripts de PowerShell que modifican servicios, configuraciones y opciones del sistema. Aunque está diseñada con principios centrados en la seguridad:
Revisa siempre el script de PowerShell generado antes de ejecutarlo
Realiza una copia de seguridad de los datos críticos antes de ejecutar correcciones automatizadas
Prueba en sistemas que no sean de producción primero si es posible
Comprende los cambios que se están realizando en tu sistema
El autor no se hace responsable de ningún daño al sistema, pérdida de datos o consecuencias no deseadas resultantes del uso de esta herramienta. Úsala bajo tu propio riesgo.
Contribuciones
¡Las contribuciones son bienvenidas! Por favor:
Haz un fork del repositorio
Crea una rama de funcionalidad (git checkout -b feature/mejora)
Confirma tus cambios (git commit -m 'Añadir mejora')
Empuja a la rama (git push origin feature/mejora)
Abre una Solicitud de Extracción
Licencia
Este proyecto está licenciado bajo la GNU General Public License v3.0 - consulta el archivo LICENSE para más detalles.
Copyright (C) 2026 GUETTAF HOUSSEM EDDINE
Autor
Knight
Estudiante de Ingeniería en Electrotécnica
Universidad Akli Mohand Oulhadj, Bouira, Argelia
Email: [email protected]
GitHub: @Guettaf-hossam
Agradecimientos
Google Gemini AI por el análisis inteligente del sistema
psutil librería para monitoreo multiplataforma del sistema
Rich librería para una hermosa salida en terminal
Versión 1.0 | Última actualización: Enero 2026
Hecho con dedicación por Knight | Universidad Akli Mohand Oulhadj
guettaf-hossam/superdiagnostictool
