SuperDiagnosticTool

AI-संचालित विंडोज डायग्नोस्टिक और स्व-उपचार उपकरण

SuperDiagnosticTool एक बुद्धिमान सिस्टम डायग्नोस्टिक उपयोगिता है जो वास्तविक समय हार्डवेयर टेलीमेट्री को Google Gemini AI के साथ जोड़कर विंडोज सिस्टम समस्याओं का विश्लेषण, निदान और स्वचालित रूप से सुधार करती है। सुरक्षा-प्रथम आर्किटेक्चर के साथ निर्मित, यह किसी भी विंडोज कॉन्फ़िगरेशन के लिए उत्पादन-ग्रेड डायग्नोस्टिक्स प्रदान करता है।

स्क्रीनशॉट

स्कैन मोड चयन और समस्या विवरण इनपुट दिखाता मुख्य इंटरफ़ेस

प्रमुख विशेषताएँ

सार्वभौमिक हार्डवेयर समर्थन

• डायनामिक स्केलिंग: किसी भी CPU कॉन्फ़िगरेशन (1-128+ कोर) में स्वचालित रूप से ढल जाता है
• हार्डवेयर-अज्ञेय तर्क: लीगेसी सिस्टम (Intel Pentium) से लेकर हाई-एंड वर्कस्टेशन (AMD Threadripper, Intel Xeon) तक निर्बाध कार्य करता है
• ग्रेसफुल फ़ॉलबैक: असमर्थित सुविधाओं (CPU फ़्रीक्वेंसी, बैटरी डिटेक्शन, स्वैप मेमोरी) का सुरक्षित प्रबंधन
• लो-स्पेक ऑप्टिमाइज्ड: संसाधन-सीमित हार्डवेयर पर भी सिस्टम लैग से बचने के लिए हल्का निष्पादन

बुद्धिमान AI विश्लेषण

• Google Gemini इंटीग्रेशन: उन्नत AI-संचालित सिस्टम विश्लेषण और निदान
• संदर्भ-जागरूक अनुशंसाएँ: उपयोगकर्ता द्वारा रिपोर्ट की गई समस्याओं को सिस्टम टेलीमेट्री से जोड़ता है
• सुरक्षा ऑडिटिंग: संदिग्ध प्रक्रियाओं, संसाधन लीक और संभावित मैलवेयर के लिए स्कैन करता है
• फिक्स के बाद सत्यापन: यह दिखाने के लिए पूर्णता रिपोर्ट तैयार करता है कि क्या ठीक किया गया बनाम किस पर मैन्युअल ध्यान देने की आवश्यकता है

सुरक्षा-प्रथम आर्किटेक्चर

उत्पादन-ग्रेड सुरक्षा (85%)

बहु-स्तरीय सत्यापन

• नॉलेज बेस मिलान: AI समाधानों को सफलता दर वाले 5 परीक्षणित, ज्ञात समाधानों से मान्य करता है
• ड्राई-रन सिमुलेशन: निष्पादन से पहले सभी परिवर्तनों का पूर्वावलोकन (सेवाएँ, फ़ाइलें, रजिस्ट्री)
• बहु-स्तरीय स्क्रिप्ट सत्यापन: ब्लैकलिस्ट, व्हाइटलिस्ट और जोखिम स्कोरिंग (0-100)
• सिस्टम रिस्टोर पॉइंट: किसी भी संशोधन से पहले स्वचालित रिस्टोर पॉइंट निर्माण

उन्नत निगरानी

• पूर्व/पश्चात निष्पादन स्नैपशॉट: परिवर्तनों से पहले और बाद में पूर्ण सिस्टम स्थिति कैप्चर
• परिवर्तन का पता लगाना: सभी संशोधनों (सेवाएँ, रजिस्ट्री, स्टार्टअप आइटम) का स्वचालित ट्रैकिंग
• रोलबैक जनरेशन: यदि आवश्यक हो तो परिवर्तनों को पूर्ववत करने के लिए स्व-निर्मित स्क्रिप्ट
• निष्पादन लॉगिंग: सभी कार्यों के व्यापक लॉग

PowerShell सुरक्षा

• एडमिन विशेषाधिकार सत्यापन: सभी सुधार स्क्रिप्ट में एलिवेशन जाँच शामिल
• वेरिएबल सैनिटाइजेशन: त्रुटियों को रोकने के लिए Regex-आधारित एस्केपिंग, $env: वेरिएबल्स को सुरक्षित रखता है
• सेवा सुरक्षा जाँच: कार्यों से पहले सेवा अस्तित्व का सत्यापन
• सैंडबॉक्स निष्पादन: टाइमआउट सुरक्षा के साथ निगरानी वातावरण
• त्रुटि प्रबंधन: सुरक्षा उपायों के साथ व्यापक try-catch ब्लॉक

व्यापक सिस्टम स्कैनिंग

• प्रदर्शन मीट्रिक्स: CPU उपयोग (कुल + प्रति कोर), मेमोरी ब्रेकडाउन, शीर्ष संसाधन उपभोक्ता
• नेटवर्क इंटेलिजेंस: सक्रिय इंटरफ़ेस, DNS कॉन्फ़िगरेशन, Wi-Fi सिग्नल शक्ति, कनेक्टिविटी परीक्षण
• सुरक्षा अखंडता: एंटीवायरस स्थिति, फ़ायरवॉल प्रोफ़ाइल, Windows Update इतिहास
• हार्डवेयर स्वास्थ्य: डिस्क SMART स्थिति, GPU जानकारी, बैटरी स्थिति (लैपटॉप)
• सिस्टम सेवाएँ: स्टार्टअप एप्लिकेशन, विफल सेवाएँ, महत्वपूर्ण इवेंट लॉग
• प्रक्रिया ऑडिटिंग: संसाधन उपयोग और स्थान के आधार पर संदिग्ध प्रक्रियाओं की पहचान

मानव-केंद्रित रिपोर्टिंग

• पेशेवर HTML रिपोर्ट: दृश्य मीट्रिक्स के साथ डार्क-थीम, उत्तरदायी डायग्नोस्टिक रिपोर्ट
• भूतकाल में पूर्णता भाषा: रिपोर्ट पूर्ण कार्यों को दिखाने के लिए [FIXED], [CLEANED], [DISABLED] टैग का उपयोग करती है
• मैन्युअल ध्यान अनुभाग: स्वचालित सुधारों को उन वस्तुओं से स्पष्ट रूप से अलग करता है जिनमें उपयोगकर्ता हस्तक्षेप की आवश्यकता है
• टाइमस्टैम्प्ड आर्काइव: ऐतिहासिक ट्रैकिंग के लिए सभी रिपोर्ट AI_Reports/ निर्देशिका में सहेजी गईं

त्वरित आरंभ

डाउनलोड

SuperDiagnosticTool.exe डाउनलोड करें - स्टैंडअलोन निष्पादन योग्य (Python की आवश्यकता नहीं)

आवश्यकताएँ

• Windows 10 या Windows 11
• प्रशासक विशेषाधिकार
• Google Gemini API कुंजी (मुफ्त कुंजी प्राप्त करें)

पहला रन

1. SuperDiagnosticTool.exe डाउनलोड करें और चलाएँ
2. संकेत मिलने पर अपनी Google Gemini API कुंजी दर्ज करें
3. अपनी सिस्टम समस्या का वर्णन करें
4. स्कैन मोड चुनें (त्वरित/गहरा/पूर्ण)
5. AI विश्लेषण और सुधार स्क्रिप्ट की समीक्षा करें
6. फिक्स निष्पादित करें या विस्तृत HTML रिपोर्ट देखें

इंस्टॉलेशन (डेवलपर्स के लिए)

पूर्वापेक्षाएँ

• Python 3.8 या उच्चतर
• pip पैकेज मैनेजर

निर्भरताएँ स्थापित करें

pip install psutil google-generativeai rich

स्रोत से चलाएँ

python super_diagnose_v2.py

उपयोग

API कुंजी सेटअप

विकल्प A: इंटरएक्टिव इनपुट (पहली बार उपयोगकर्ताओं के लिए अनुशंसित)

• टूल पहले रन पर आपको अपनी API कुंजी दर्ज करने के लिए संकेत देगा
• कुंजी भविष्य में उपयोग के लिए स्थानीय रूप से gemini.key में सहेजी जाती है

विकल्प B: पर्यावरण चर

set GEMINI_API_KEY=your_api_key_here

विकल्प C: मैन्युअल कुंजी फ़ाइल उसी निर्देशिका में gemini.key बनाएँ:

your_api_key_here

स्कैन मोड

उदाहरण कार्यप्रवाह

# 1. टूल चलाएँ
SuperDiagnosticTool.exe

# 2. अपनी समस्या का वर्णन करें
> उच्च CPU उपयोग और धीमा प्रदर्शन

# 3. स्कैन मोड चुनें
> 3 (पूर्ण सिस्टम स्कैन)

# 4. AI विश्लेषण की प्रतीक्षा करें
[सिस्टम परतों को स्कैन कर रहा है...]
[टेलीमेट्री तर्क प्रसंस्करण...]

# 5. सुधार स्क्रिप्ट की समीक्षा करें
[PowerShell स्क्रिप्ट प्रदर्शित]
> निष्पादित करें? (y/n)

# 6. HTML रिपोर्ट देखें
> विस्तृत रिपोर्ट खोलें? (y/n)

तकनीकी विवरण

कोड आर्किटेक्चर

• प्रत्येक डायग्नोस्टिक श्रेणी के लिए अलग-अलग फ़ंक्शन के साथ मॉड्यूलर डिज़ाइन
• try-except ब्लॉक के साथ व्यापक त्रुटि प्रबंधन
• ग्रेसफुल फ़ॉलबैक के साथ हार्डवेयर-अज्ञेय क्वेरी
• पेशेवर डॉकस्ट्रिंग और स्पष्ट वेरिएबल नामकरण

PowerShell स्क्रिप्ट जनरेशन

• निष्पादन से पहले एडमिन विशेषाधिकार सत्यापन
• सिंटैक्स त्रुटियों को रोकने के लिए Regex-आधारित वेरिएबल एस्केपिंग
• एनवायरनमेंट वेरिएबल ($env:TEMP, $env:PATH) सही ढंग से संरक्षित
• अस्तित्व जाँच के साथ सुरक्षित सेवा प्रबंधन
• -ErrorAction SilentlyContinue का उपयोग करके त्रुटि दमन

Gemini AI इंटीग्रेशन

• सुसंगत आउटपुट पार्सिंग के लिए संरचित प्रॉम्प्ट
• विश्वसनीय निष्कर्षण के लिए सीमांकित अनुभाग ([ANALYSIS_START], [FIX_START])
• सिस्टम टेलीमेट्री पर आधारित संदर्भ-जागरूक विश्लेषण
• पूर्ण सुधार कार्यों के लिए भूतकाल रिपोर्टिंग

सुरक्षा और गोपनीयता

• कोई डेटा संग्रह नहीं: सभी विश्लेषण स्थानीय रूप से होते हैं; केवल सिस्टम टेलीमेट्री Gemini API को भेजी जाती है
• API कुंजी सुरक्षा: कुंजी स्थानीय रूप से संग्रहीत होती है और कभी भी संस्करण नियंत्रण में प्रतिबद्ध नहीं होती
• एडमिन पारदर्शिता: उपयोगकर्ता को सभी सुधार स्क्रिप्ट को स्पष्ट रूप से स्वीकृत करना होगा
• गैर-विनाशकारी: उपयोगकर्ता की सहमति के बिना कोई फ़ाइल विलोपन या रजिस्ट्री संशोधन नहीं
• ओपन सोर्स: सुरक्षा ऑडिटिंग के लिए पूर्ण स्रोत कोड उपलब्ध

विस्तृत सुरक्षा जानकारी के लिए SECURITY.md देखें।

समस्या निवारण

"API कुंजी अमान्य" त्रुटि

• सत्यापित करें कि आपकी API कुंजी सही और सक्रिय है
• छिपे हुए वर्णों या व्हाइटस्पेस की जाँच करें
• सुनिश्चित करें कि कुंजी में Gemini API एक्सेस सक्षम है
• https://makersuite.google.com/app/apikey पर कुंजी पुनः उत्पन्न करें

"प्रशासक के रूप में नहीं चल रहा" त्रुटि

• निष्पादन योग्य पर राइट-क्लिक करें और "व्यवस्थापक के रूप में चलाएँ" चुनें
• या जब टूल स्वचालित रूप से उन्नत हो तो UAC प्रॉम्प्ट की अनुमति दें

"मॉड्यूल नहीं मिला" त्रुटि (Python संस्करण)

pip install --upgrade psutil google-generativeai rich

PowerShell स्क्रिप्ट विफल

• सुनिश्चित करें कि आप Windows PowerShell 5.1 या बाद का संस्करण चला रहे हैं
• जाँच करें कि निष्पादन नीति स्क्रिप्ट निष्पादन की अनुमति देती है
• त्रुटियों के लिए AI_Reports/remediation.ps1 में स्क्रिप्ट की समीक्षा करें

स्रोत से निर्माण

स्वचालित निर्माण (अनुशंसित)

प्रोजेक्ट विंडोज निष्पादन योग्य को स्वचालित रूप से बनाने के लिए GitHub Actions का उपयोग करता है जब कोई संस्करण टैग पुश किया जाता है:

1. अपने परिवर्तनों को main ब्रांच में पुश करें
2. एक संस्करण टैग बनाएँ और पुश करें: git tag -a v1.0.2 -m "Release notes" && git push origin v1.0.2
3. GitHub Actions स्वचालित रूप से .exe बनाएगा और एक रिलीज़ बनाएगा
4. रिलीज़ पेज से डाउनलोड करें

विस्तृत निर्देशों के लिए RELEASE_PROCESS.md देखें।

मैन्युअल निर्माण (परीक्षण के लिए)

Windows पर:

pip install pyinstaller
pip install -r requirements.txt
python build.py

यह एम्बेडेड आइकन और निर्भरताओं के साथ dist/SuperDiagnosticTool.exe बनाता है।

नोट: यदि आप "Windows protected your PC" चेतावनी देखते हैं, तो त्वरित समाधान या ऐप को स्थायी रूप से व्हाइटलिस्ट करने के तरीके के लिए कृपया TRUST_GUIDE.md पढ़ें।

नोट: Linux/Mac पर निर्माण करने से प्लेटफ़ॉर्म-विशिष्ट बाइनरी बनेगी, Windows .exe फ़ाइलें नहीं। आधिकारिक Windows रिलीज़ के लिए GitHub Actions का उपयोग करें।

फ़ाइल संरचना

SuperDiagnosticTool/
├── super_diagnose_v2.py    # मुख्य डायग्नोस्टिक स्क्रिप्ट
├── build.py                # EXE बनाने के लिए निर्माण स्क्रिप्ट
├── icon.ico                # एप्लीकेशन आइकन
├── .github/workflows/      # GitHub Actions वर्कफ़्लो
│   └── release.yml        # स्वचालित निर्माण और रिलीज़
├── docs/
│   ├── icon.png           # README के लिए आइकन
│   └── screenshot_main.png # मुख्य इंटरफ़ेस स्क्रीनशॉट
├── src/                    # स्रोत मॉड्यूल
│   ├── safety/            # सुरक्षा और सत्यापन मॉड्यूल
│   └── security/          # सुरक्षा सुविधाएँ
├── AI_Reports/             # उत्पन्न HTML रिपोर्ट
├── README.md               # यह फ़ाइल
├── RELEASE_PROCESS.md      # रिलीज़ प्रक्रिया दस्तावेज़ीकरण
├── LICENSE                 # GPL-3.0 लाइसेंस
├── SECURITY.md             # सुरक्षा दस्तावेज़ीकरण
└── .gitignore              # Git अनदेखा नियम

अस्वीकरण

महत्वपूर्ण: सिस्टम संशोधन चेतावनी

यह उपकरण PowerShell स्क्रिप्ट उत्पन्न और निष्पादित करता है जो सिस्टम सेवाओं, कॉन्फ़िगरेशन और सेटिंग्स को संशोधित करती हैं। जबकि सुरक्षा-प्रथम सिद्धांतों के साथ डिज़ाइन किया गया है:

• हमेशा समीक्षा करें निष्पादन से पहले उत्पन्न PowerShell स्क्रिप्ट की
• महत्वपूर्ण डेटा का बैकअप लें स्वचालित सुधार चलाने से पहले
• यदि संभव हो तो पहले गैर-उत्पादन प्रणालियों पर परीक्षण करें
• समझें कि आपके सिस्टम में किए जा रहे परिवर्तनों को

लेखक इस उपकरण के उपयोग से होने वाली किसी भी सिस्टम क्षति, डेटा हानि, या अनपेक्षित परिणामों के लिए जिम्मेदार नहीं है। अपने जोखिम पर उपयोग करें।

योगदान

योगदान का स्वागत है! कृपया:

1. रिपॉजिटरी को फोर्क करें
2. एक फीचर ब्रांच बनाएँ (git checkout -b feature/improvement)
3. अपने परिवर्तनों को कमिट करें (git commit -m 'Add improvement')
4. ब्रांच पर पुश करें (git push origin feature/improvement)
5. एक पुल रिक्वेस्ट खोलें

लाइसेंस

यह प्रोजेक्ट GNU जनरल पब्लिक लाइसेंस v3.0 के तहत लाइसेंस प्राप्त है - विवरण के लिए LICENSE फ़ाइल देखें।

कॉपीराइट (C) 2026 GUETTAF HOUSSEM EDDINE

लेखक

Knight
इलेक्ट्रोटेक्निक्स इंजीनियरिंग छात्र
अकली मोहंद औलहादज विश्वविद्यालय, बुइरा, अल्जीरिया
ईमेल: [email protected]
GitHub: @Guettaf-hossam

आभार

• Google Gemini AI बुद्धिमान सिस्टम विश्लेषण के लिए
• psutil लाइब्रेरी क्रॉस-प्लेटफ़ॉर्म सिस्टम मॉनिटरिंग के लिए
• Rich लाइब्रेरी सुंदर टर्मिनल आउटपुट के लिए

संस्करण 1.0 | अंतिम अद्यतन: जनवरी 2026

Knight द्वारा समर्पण के साथ बनाया गया | अकली मोहंद औलहादज विश्वविद्यालय