Outil de diagnostic et d'auto-réparation Windows alimenté par l'IA
SuperDiagnosticTool est un utilitaire de diagnostic système intelligent qui combine la télémétrie matérielle en temps réel avec Google Gemini AI pour analyser, diagnostiquer et corriger automatiquement les problèmes du système Windows. Conçu avec une architecture axée sur la sécurité, il fournit des diagnostics de qualité professionnelle pour toute configuration Windows.
Captures d'écran
Interface principale montrant la sélection du mode d'analyse et la saisie de la description du problème
Fonctionnalités clés
Prise en charge matérielle universelle
- Mise à l'échelle dynamique : S'adapte automatiquement à toute configuration CPU (1 à 128+ cœurs)
- Logique indépendante du matériel : Fonctionne parfaitement sur les systèmes anciens (Intel Pentium) jusqu'aux stations de travail haut de gamme (AMD Threadripper, Intel Xeon)
- Replis gracieux : Gestion sécurisée des fonctionnalités non prises en charge (fréquence CPU, détection de batterie, mémoire swap)
- Optimisé pour les configurations faibles : Exécution légère évitant les ralentissements système même sur du matériel à ressources limitées
Analyse IA intelligente
- Intégration Google Gemini : Analyse et diagnostic système avancés alimentés par l'IA
- Recommandations contextuelles : Corrélation des problèmes signalés par l'utilisateur avec la télémétrie système
- Audit de sécurité : Recherche de processus suspects, fuites de ressources et malwares potentiels
- Vérification post-correction : Génération de rapports d'achèvement montrant ce qui a été réparé par rapport à ce qui nécessite une intervention manuelle
Architecture axée sur la sécurité
Sécurité de niveau production (85%)
Validation multicouche
- Correspondance avec la base de connaissances : Valide les solutions IA par rapport à 5 solutions connues testées avec des taux de réussite
- Simulation à blanc : Prévisualisez toutes les modifications avant exécution (services, fichiers, registre)
- Validation de script multiniveau : Liste noire, liste blanche et score de risque (0-100)
- Points de restauration système : Création automatique d'un point de restauration avant toute modification
Surveillance renforcée
- Instantanés avant/après exécution : Capture complète de l'état du système avant et après les modifications
- Détection des changements : Suivi automatique de toutes les modifications (services, registre, éléments de démarrage)
- Génération de restauration : Scripts générés automatiquement pour annuler les modifications si nécessaire
- Journalisation d'exécution : Journaux complets de toutes les opérations
Sécurité PowerShell
- Vérification des privilèges administrateur : Tous les scripts de correction incluent des contrôles d'élévation
- Assainissement des variables : Échappement basé sur des expressions régulières pour éviter les erreurs tout en préservant les variables
$env:
- Vérifications de sécurité des services : Vérifie l'existence du service avant les opérations
- Exécution en bac à sable : Environnement surveillé avec protection par délai d'attente
- Gestion des erreurs : Blocs try-catch complets avec mesures de protection
Analyse système complète
- Métriques de performance : Utilisation CPU (globale + par cœur), répartition de la mémoire, principaux consommateurs de ressources
- Intelligence réseau : Interfaces actives, configuration DNS, force du signal Wi-Fi, tests de connectivité
- Intégrité de la sécurité : Statut de l'antivirus, profils de pare-feu, historique des mises à jour Windows
- Santé matérielle : Statut SMART des disques, informations GPU, état de la batterie (ordinateurs portables)
- Services système : Applications au démarrage, services défaillants, journaux d'événements critiques
- Audit des processus : Identifie les processus suspects en fonction de l'utilisation des ressources et de l'emplacement
Rapports centrés sur l'humain
- Rapports HTML professionnels : Rapports de diagnostic réactifs au thème sombre avec métriques visuelles
- Langage d'achèvement au passé : Les rapports utilisent les balises
[CORRIGÉ], [NETTOYÉ], [DÉSACTIVÉ] pour montrer les actions effectuées
- Section d'attention manuelle : Sépare clairement les corrections automatisées des éléments nécessitant une intervention de l'utilisateur
- Archives horodatées : Tous les rapports sont enregistrés dans le répertoire
AI_Reports/ pour un suivi historique
Démarrage rapide
Téléchargement
Télécharger SuperDiagnosticTool.exe - Exécutable autonome (Python non requis)
Prérequis
Premier lancement
- Téléchargez et exécutez
SuperDiagnosticTool.exe
- Saisissez votre clé API Google Gemini lorsque vous y êtes invité
- Décrivez votre problème système
- Sélectionnez le mode d'analyse (Rapide/Approfondie/Complète)
- Examinez l'analyse IA et le script de correction
- Exécutez les correctifs ou consultez le rapport HTML détaillé
Installation (Pour les développeurs)
Prérequis
- Python 3.8 ou supérieur
- Gestionnaire de paquets pip
Installer les dépendances
pip install psutil google-generativeai rich
Exécuter à partir des sources
python super_diagnose_v2.py
Utilisation
Configuration de la clé API
Option A : Saisie interactive (Recommandée pour les nouveaux utilisateurs)
- L'outil vous demandera de saisir votre clé API au premier lancement
- La clé est sauvegardée localement dans
gemini.key pour une utilisation future
Option B : Variable d'environnement
set GEMINI_API_KEY=votre_clé_api_ici
Option C : Fichier de clé manuel
Créez gemini.key dans le même répertoire :
Modes d'analyse
| Mode | Analyses | Cas d'utilisation |
|---|
Exemple de flux de travail
# 1. Lancez l'outil
SuperDiagnosticTool.exe
# 2. Décrivez votre problème
> Utilisation CPU élevée et performances lentes
# 3. Sélectionnez le mode d'analyse
> 3 (Analyse système complète)
# 4. Attendez l'analyse IA
[Analyse des couches système...]
[Traitement de la logique de télémétrie...]
# 5. Examinez le script de correction
[Script PowerShell affiché]
> Exécuter ? (o/n)
# 6. Consultez le rapport HTML
> Ouvrir le rapport détaillé ? (o/n)
Détails techniques
Architecture du code
- Conception modulaire avec des fonctions séparées pour chaque catégorie de diagnostic
- Gestion complète des erreurs avec des blocs try-except
- Requêtes indépendantes du matériel avec replis gracieux
- Docstrings professionnelles et dénomination claire des variables
Génération de scripts PowerShell
- Vérification des privilèges administrateur avant exécution
- Échappement des variables basé sur des expressions régulières pour éviter les erreurs de syntaxe
- Les variables d'environnement (
$env:TEMP, $env:PATH) sont correctement préservées
- Gestion sécurisée des services avec vérification d'existence
- Suppression des erreurs à l'aide de
-ErrorAction SilentlyContinue
Intégration Gemini AI
- Invites structurées pour un analyse de sortie cohérente
- Sections délimitées (
[ANALYSIS_START], [FIX_START]) pour une extraction fiable
- Analyse contextuelle basée sur la télémétrie système
- Rapports au passé pour les actions de correction terminées
Sécurité et confidentialité
- Aucune collecte de données : Toute l'analyse se fait localement ; seule la télémétrie système est envoyée à l'API Gemini
- Sécurité de la clé API : Les clés sont stockées localement et jamais incluses dans le contrôle de version
- Transparence administrative : L'utilisateur doit approuver explicitement tous les scripts de correction
- Non destructif : Aucune suppression de fichier ou modification du registre sans le consentement de l'utilisateur
- Open source : Le code source complet est disponible pour un audit de sécurité
Voir SECURITY.md pour des informations de sécurité détaillées.
Dépannage
Erreur "Clé API invalide"
- Vérifiez que votre clé API est correcte et active
- Recherchez les caractères cachés ou les espaces
- Assurez-vous que l'accès à l'API Gemini est activé pour la clé
- Régénérez la clé sur https://makersuite.google.com/app/apikey
"Non exécuté en tant qu'administrateur"
- Faites un clic droit sur l'exécutable et sélectionnez "Exécuter en tant qu'administrateur"
- Ou acceptez l'invite UAC lorsque l'outil s'élève automatiquement
Erreur "Module introuvable" (version Python)
pip install --upgrade psutil google-generativeai rich
Échec du script PowerShell
- Assurez-vous d'exécuter Windows PowerShell 5.1 ou ultérieur
- Vérifiez que la politique d'exécution autorise l'exécution de scripts
- Examinez le script dans
AI_Reports/remediation.ps1 pour les erreurs
Compilation à partir des sources
Compilations automatisées (Recommandé)
Le projet utilise GitHub Actions pour compiler automatiquement les exécutables Windows lorsqu'une balise de version est poussée :
- Poussez vos modifications sur la branche principale
- Créez et poussez une balise de version :
git tag -a v1.0.2 -m "Notes de version" && git push origin v1.0.2
- GitHub Actions compilera automatiquement le .exe et créera une version
- Téléchargez depuis la page des versions
Voir RELEASE_PROCESS.md pour des instructions détaillées.
Compilation manuelle (Pour les tests)
Sur Windows :
pip install pyinstaller
pip install -r requirements.txt
python build.py
Ceci crée dist/SuperDiagnosticTool.exe avec l'icône intégrée et les dépendances.
Remarque : Si vous voyez un avertissement "Windows a protégé votre PC", veuillez lire TRUST_GUIDE.md pour une solution rapide ou comment autoriser définitivement l'application.
Remarque : La compilation sur Linux/Mac créera des binaires spécifiques à la plateforme, pas des fichiers .exe Windows. Utilisez GitHub Actions pour les versions Windows officielles.
Structure des fichiers
SuperDiagnosticTool/
├── super_diagnose_v2.py # Script de diagnostic principal
├── build.py # Script de compilation pour créer l'EXE
├── icon.ico # Icône de l'application
├── .github/workflows/ # Flux de travail GitHub Actions
│ └── release.yml # Compilation et version automatisées
├── docs/
│ ├── icon.png # Icône pour le README
│ └── screenshot_main.png # Capture d'écran de l'interface principale
├── src/ # Modules sources
│ ├── safety/ # Modules de sécurité et de validation
│ └── security/ # Fonctionnalités de sécurité
├── AI_Reports/ # Rapports HTML générés
├── README.md # Ce fichier
├── RELEASE_PROCESS.md # Documentation du processus de version
├── LICENSE # Licence GPL-3.0
├── SECURITY.md # Documentation de sécurité
└── .gitignore # Règles d'ignorance Git
Avertissement
IMPORTANT : Avertissement concernant les modifications système
Cet outil génère et exécute des scripts PowerShell qui modifient les services, configurations et paramètres système. Bien qu'il soit conçu avec des principes de sécurité :
- Vérifiez toujours le script PowerShell généré avant exécution
- Sauvegardez les données critiques avant d'exécuter une correction automatisée
- Testez d'abord sur des systèmes non critiques si possible
- Comprenez les modifications apportées à votre système
L'auteur n'est pas responsable des dommages système, pertes de données ou conséquences imprévues résultant de l'utilisation de cet outil. Utilisez-le à vos propres risques.
Contribution
Les contributions sont les bienvenues ! Merci de :
- Forker le dépôt
- Créer une branche de fonctionnalité (
git checkout -b feature/amelioration)
- Commiter vos modifications (
git commit -m 'Ajout d'une amélioration')
- Pousser la branche (
git push origin feature/amelioration)
- Ouvrir une Pull Request
Licence
Ce projet est sous licence GNU General Public License v3.0 - voir le fichier LICENSE pour plus de détails.
Copyright (C) 2026 GUETTAF HOUSSEM EDDINE
Auteur
Knight
Étudiant en électrotechnique
Université Akli Mohand Oulhadj, Bouira, Algérie
Email : [email protected]
GitHub : @Guettaf-hossam
Remerciements
- Google Gemini AI pour l'analyse intelligente du système
- psutil pour la surveillance multiplateforme du système
- Rich pour un affichage magnifique dans le terminal
Version 1.0 | Dernière mise à jour : Janvier 2026
Réalisé avec dévouement par Knight | Université Akli Mohand Oulhadj
guettaf-hossam/superdiagnostictool
