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 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
Inicio Rápido
Descarga
Descargar SuperDiagnosticTool.exe - Ejecutable independiente (no requiere Python)
Requisitos
Primer Uso
- Descarga y ejecuta
SuperDiagnosticTool.exe
- 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
pip install psutil google-generativeai rich
Ejecutar desde el Código Fuente
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
set GEMINI_API_KEY=tu_clave_api_aqui
Opción C: Archivo de Clave Manual
Crea gemini.key en el mismo directorio:
Modos de Escaneo
Flujo de Trabajo Ejemplo
# 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
- Regenera la clave en https://makersuite.google.com/app/apikey
Error "No se Ejecuta como Administrador"
- Haz clic derecho en el ejecutable y selecciona "Ejecutar como administrador"
- O permite la solicitud de UAC cuando la herramienta se autoeleve
Error "Módulo No Encontrado" (versión Python)
pip install --upgrade psutil google-generativeai rich
El Script de PowerShell Falla
- Asegúrate de estar ejecutando Windows PowerShell 5.1 o posterior
- Comprueba que la política de ejecución permita la ejecución de scripts
- Revisa el script en
AI_Reports/remediation.ps1 para ver errores
Compilación desde el Código Fuente
Compilaciones Automatizadas (Recomendado)
El proyecto usa GitHub Actions para compilar automáticamente ejecutables de Windows cuando se envía una etiqueta de versión:
- Envía tus cambios a la rama principal
- Crea y envía una etiqueta de versión:
git tag -a v1.0.2 -m "Notas de la versión" && git push origin v1.0.2
- GitHub Actions compilará automáticamente el .exe y creará un lanzamiento
- Descarga desde la página de Lanzamientos
Consulta RELEASE_PROCESS.md para obtener instrucciones detalladas.
Compilación Manual (Para Pruebas)
En Windows:
pip install pyinstaller
pip install -r requirements.txt
python build.py
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
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
