SuperDiagnosticTool

# SuperDiagnosticTool

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/11160/8b0da1a673733dc9731164bd4d4a3ecc6a137e583d070725852e8173311ef7fc.png" alt="SuperDiagnosticTool आइकन" width="200"/>
</p>

<p align="center">
  <strong>AI-संचालित Windows निदान एवं उपचार उपकरण</strong>
</p>

<p align="center">
  <a href="https://github.com/Guettaf-hossam/SuperDiagnosticTool/releases"><img src="https://img.shields.io/github/v/release/Guettaf-hossam/SuperDiagnosticTool?style=flat-square" alt="Release"></a>
  <a href="https://github.com/Guettaf-hossam/SuperDiagnosticTool/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-GPL%20v3.0-blue.svg?style=flat-square" alt="License"></a>
  <a href="https://github.com/Guettaf-hossam/SuperDiagnosticTool/stargazers"><img src="https://img.shields.io/github/stars/Guettaf-hossam/SuperDiagnosticTool?style=flat-square" alt="Stars"></a>
</p>

SuperDiagnosticTool वास्तविक समय में हार्डवेयर टेलीमेट्री एकत्र करता है, विश्लेषण के लिए इसे Google Gemini API को भेजता है, और पाई गई समस्याओं के समाधान हेतु PowerShell रेमेडिएशन स्क्रिप्ट उत्पन्न करता है। इसमें कई सत्यापन परतें शामिल हैं जिन्हें उत्पन्न स्क्रिप्ट को उपयोगकर्ता से निष्पादन की अनुमति मांगने से पहले पास करना होता है।

---

## स्क्रीनशॉट

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/11160/eb10d4e2a86193e87d0face0e034418d7a5977df9057fb6fed97b0ea705e4442.png" alt="मुख्य इंटरफ़ेस" width="800"/>
</p>

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

---

## मुख्य विशेषताएँ

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

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

### बहु-स्तरीय सुरक्षा संरचना

Gemini द्वारा उत्पन्न स्क्रिप्ट उपयोगकर्ता से निष्पादन की स्वीकृति मांगने से पहले चार क्रमिक जाँचों से गुज़रती हैं:

#### सत्यापन पाइपलाइन
- **नॉलेज बेस मिलान:** AI समाधानों को परीक्षित, ज्ञात-अच्छे रेमेडिएशन पैटर्न के सेट के साथ क्रॉस-रेफ़रेंस करता है
- **ड्राई-रन सिमुलेशन:** किसी भी संशोधन से पहले सभी इच्छित परिवर्तनों (सेवाएँ, फ़ाइलें, रजिस्ट्री) का पूर्वावलोकन करता है
- **स्क्रिप्ट सत्यापन (`ScriptValidator`):** तीन-स्तरीय जाँच — ब्लैकलिस्ट (विनाशकारी पैटर्न पर पूर्ण रोक), संदिग्ध पैटर्न पहचान (एलियास और ऑब्फस्केशन-जागरूक), और 0-100 पैमाने पर जोखिम स्कोरिंग
- **क्रिटिकल पाथ इंटरसेप्शन (`CriticalPathInterceptor`):** ज़ीरो-ट्रस्ट गेट जो HKLM/HKCU रजिस्ट्री कुंजियों या System32 पथों को छूने वाली किसी भी स्क्रिप्ट को तब तक रोकता है जब तक उपयोगकर्ता स्पष्ट रूप से पुष्टि न करे

#### सुरक्षा सीमाएँ
- **सिस्टम रिस्टोर पॉइंट:** किसी भी संशोधन से पहले स्वचालित रूप से बनाए जाते हैं
- **निष्पादन-पूर्व/पश्चात स्नैपशॉट:** किए गए प्रत्येक परिवर्तन का पता लगाने और लॉग करने के लिए पूर्ण सिस्टम स्थिति कैप्चर
- **रोलबैक जनरेशन:** निष्पादन विफल होने पर स्वचालित रूप से एक चयनात्मक रोलबैक स्क्रिप्ट उत्पन्न करता है
- **निष्पादन लॉगिंग:** प्रत्येक क्रिया को टाइमस्टैम्प के साथ `%TEMP%\superdiagnostic_execution_*.log` में लॉग किया जाता है

#### PowerShell निष्पादन
- **व्यवस्थापक विशेषाधिकार सत्यापन:** स्क्रिप्ट आगे बढ़ने से पहले एलिवेशन की जाँच करती हैं
- **चर सैनिटाइज़ेशन:** Regex-आधारित एस्केपिंग `$env:` चरों को सिंटैक्स त्रुटियों के बिना सुरक्षित रखती है
- **सेवा सुरक्षा जाँच:** किसी भी Start/Stop/Set संचालन से पहले सेवा के अस्तित्व का सत्यापन करती है
- **निगरानीयुक्त निष्पादन:** स्क्रिप्ट `subprocess.run` के माध्यम से कठोर 5-मिनट टाइमआउट, पूर्ण stdout/stderr कैप्चर, और स्वचालित अस्थायी-फ़ाइल सफ़ाई के साथ चलती हैं। यह सीधा होस्ट-स्तरीय निष्पादन है, VM या कंटेनर आइसोलेशन नहीं। ऊपर दी गई सत्यापन परतें ही प्राथमिक सुरक्षा सीमा हैं।
- **त्रुटि प्रबंधन:** PowerShell रैपर में प्रति-पंक्ति त्रुटि रिपोर्टिंग के साथ try/catch/finally ब्लॉक शामिल हैं

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

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

---

## त्वरित शुरुआत

### डाउनलोड

**[SuperDiagnosticTool.exe डाउनलोड करें](https://github.com/Guettaf-hossam/SuperDiagnosticTool/releases/latest)** — स्टैंडअलोन निष्पादन योग्य (Python की आवश्यकता नहीं)

> निष्पादन योग्य फ़ाइल अहस्ताक्षरित है। पहली बार चलाने पर Windows SmartScreen एक चेतावनी दिखाएगा। आगे बढ़ने का तरीका जानने के लिए [TRUST_GUIDE.md](https://github.com/guettaf-hossam/superdiagnostictool/blob/main/TRUST_GUIDE.md) देखें। यदि आप चलाने से पहले सत्यापित करना पसंद करते हैं, तो इसके बजाय स्रोत से बिल्ड करें।

### आवश्यकताएँ

- Windows 10 या Windows 11
- व्यवस्थापक विशेषाधिकार (सिस्टम टेलीमेट्री और उपचार के लिए आवश्यक)
- Google Gemini API Key ([मुफ़्त कुंजी प्राप्त करें](https://aistudio.google.com/app/apikey))

### पहला रन

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

---

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

### पूर्वापेक्षाएँ
- Python 3.8 या उच्चतर
- pip पैकेज प्रबंधक

### निर्भरताएँ इंस्टॉल करें

एक वर्चुअल एनवायरनमेंट बनाएँ ताकि टूल की निर्भरताएँ
अन्य Python प्रोजेक्ट्स से अलग रहें:

```bash
python -m venv .venv
```

Windows Command Prompt में इसे सक्रिय करें, फिर रिपॉज़िटरी द्वारा सूचीबद्ध निर्भरताएँ इंस्टॉल करें:

```bat
.venv\Scripts\activate
pip install -r requirements.txt
```

PowerShell में, पर्यावरण को इसके साथ सक्रिय करें:

```powershell
.\.venv\Scripts\Activate.ps1
```

यदि PowerShell सक्रियण स्क्रिप्ट को ब्लॉक करता है, तो PowerShell को अपने उपयोगकर्ता के रूप में खोलें और
एक बार `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` चलाएँ, फिर सक्रियण कमांड
को दोबारा आज़माएँ।

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

```bash
python super_diagnose_v2.py
```

यह पुष्टि करने के लिए कि स्कैन शुरू करने से पहले स्रोत ट्री और निर्भरताएँ तैयार हैं, चलाएँ:

```bash
python -m compileall src super_diagnose_v2.py
```

कमांड बिना किसी त्रुटि के पूरा होना चाहिए। टूल को चलाने के समय अभी भी Windows और
व्यवस्थापक विशेषाधिकारों की आवश्यकता होती है, क्योंकि कई निदान PowerShell और
संरक्षित सिस्टम जानकारी का उपयोग करते हैं।

---

## उपयोग

### API कुंजी सेटअप

**विकल्प A: इंटरैक्टिव इनपुट (पहली बार उपयोग के लिए अनुशंसित)**
- टूल पहली बार चलने पर API कुंजी के लिए संकेत देता है
- उपलब्ध होने पर कुंजी Windows DPAPI (`keyring`) के माध्यम से सुरक्षित रूप से संग्रहीत की जाती है

**विकल्प B: पर्यावरण चर**
Command Prompt:
```bat
set GEMINI_API_KEY=your_api_key_here
```

PowerShell:
```powershell
$env:GEMINI_API_KEY = "your_api_key_here"
```

**विकल्प C: मैन्युअल कुंजी फ़ाइल**
टूल निर्देशिका में `gemini.key` बनाएं:
```
your_api_key_here
```

### स्कैन मोड

| मोड | स्कैन करता है | उपयोग का मामला |
|------|-------|----------|
| **क्विक स्कैन** | CPU, RAM, बेसिक जानकारी | त्वरित प्रदर्शन जाँच |
| **डीप स्कैन** | सिस्टम, नेटवर्क, सुरक्षा, लॉग, ब्लूटूथ, प्रोसेस | व्यापक समस्या-निवारण |
| **कम्प्लीट स्कैन** | उपरोक्त सभी + डिस्क हेल्थ, GPU, स्टार्टअप ऐप्स | पूर्ण सिस्टम ऑडिट |

### उदाहरण वर्कफ़्लो

```
1. Run the tool
   > SuperDiagnosticTool.exe

2. Describe your issue
   > High CPU usage and slow performance

3. Select scan mode
   > 3 (Complete System Scan)

4. Wait for AI analysis
   [Scanning system layers...]
   [Processing telemetry...]

5. Review the generated remediation script
   > Execute? (y/n)

6. View the HTML report
   > Open detailed report? (y/n)
```

---

## तकनीकी विवरण

### कोड आर्किटेक्चर
- मॉड्यूलर डिज़ाइन — प्रत्येक डायग्नोस्टिक श्रेणी एक पृथक फ़ंक्शन है
- पूरे कोड में try/except ब्लॉक के साथ व्यापक त्रुटि प्रबंधन
- असमर्थित सुविधाओं के लिए सुगम फ़ॉलबैक के साथ हार्डवेयर-अज्ञेय क्वेरीज़
- सभी सार्वजनिक क्लासों और मेथड्स पर मानक Python डॉकस्ट्रिंग्स

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

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

---

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

### आपकी मशीन पर क्या रहता है
- सभी सिस्टम स्कैनिंग और विश्लेषण स्थानीय रूप से चलते हैं।
- इस टूल द्वारा बाहरी सर्वर पर कोई टेलीमेट्री संग्रहीत नहीं की जाती है।

### बाहरी रूप से क्या भेजा जाता है
- AI सिफ़ारिशें उत्पन्न करने के लिए, एक टेलीमेट्री स्नैपशॉट (CPU लोड, मेमोरी, प्रोसेस नाम, इवेंट लॉग प्रविष्टियाँ, नेटवर्क स्थिति) **Google के Gemini API** को प्रेषित किया जाता है।
- आपकी API कुंजी Google को प्रत्येक अनुरोध के साथ शामिल की जाती है।
- उनके छोर पर इस डेटा को कैसे संभाला जाता है, इसके लिए [Google की गोपनीयता नीति](https://policies.google.com/privacy) देखें।

### अन्य सुरक्षा विशेषताएँ
- **API कुंजी संग्रहण:** उपलब्ध होने पर Windows DPAPI (`keyring`) के माध्यम से संग्रहीत। कभी भी वर्ज़न कंट्रोल में कमिट नहीं की जाती।
- **एडमिन पारदर्शिता:** प्रत्येक उपचार स्क्रिप्ट पूर्ण रूप से प्रदर्शित की जाती है और निष्पादन से पहले स्पष्ट उपयोगकर्ता अनुमोदन आवश्यक है।
- **डिफ़ॉल्ट रूप से गैर-विनाशकारी:** रजिस्ट्री और फ़ाइल संशोधनों के लिए `CriticalPathInterceptor` पास करना और स्पष्ट उपयोगकर्ता पुष्टि आवश्यक है।
- **ओपन सोर्स:** GPL v3.0 के अंतर्गत स्वतंत्र समीक्षा के लिए पूर्ण स्रोत कोड उपलब्ध।

अतिरिक्त सुरक्षा दस्तावेज़ीकरण के लिए [SECURITY.md](https://github.com/guettaf-hossam/superdiagnostictool/blob/main/SECURITY.md) देखें।

---

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

### "API Key Invalid" त्रुटि
- सत्यापित करें कि कुंजी सही और सक्रिय है [Google AI Studio](https://aistudio.google.com/app/apikey) पर
- कुंजी में छिपे हुए व्हाइटस्पेस या न्यूलाइन वर्णों की जाँच करें
- सुनिश्चित करें कि कुंजी में Gemini API पहुँच सक्षम है

### "Not Running as Administrator"
- एक्ज़ीक्यूटेबल पर राइट-क्लिक करें और "Run as Administrator" चुनें
- या जब टूल एलिवेशन का अनुरोध करे तो UAC प्रॉम्प्ट की अनुमति दें

### "Module Not Found" त्रुटि (Python संस्करण)
```bash
pip install --upgrade psutil google-generativeai rich
```

### PowerShell स्क्रिप्ट विफल होती है
- सुनिश्चित करें कि Windows PowerShell 5.1 या बाद का संस्करण इंस्टॉल है
- जनरेट की गई स्क्रिप्ट `AI_Reports/remediation.ps1` में सहेजी जाती है — त्रुटियों के लिए इसे मैन्युअल रूप से समीक्षा करें

---

## स्रोत से बिल्ड करना

### स्वचालित बिल्ड (अनुशंसित)

यह प्रोजेक्ट संस्करण टैग पुश पर Windows एक्ज़ीक्यूटेबल्स बिल्ड करने के लिए GitHub Actions का उपयोग करता है:

1. अपने परिवर्तनों को मुख्य ब्रांच में पुश करें
2. एक संस्करण टैग बनाएं और पुश करें:
   ```bash
   git tag -a v1.0.2 -m "Release notes" && git push origin v1.0.2
   ```
3. GitHub Actions `.exe` बनाता है और स्वचालित रूप से एक रिलीज़ बनाता है
4. [Releases पृष्ठ](https://github.com/Guettaf-hossam/SuperDiagnosticTool/releases) से डाउनलोड करें

रिलीज़ वर्कफ़्लो कॉन्फ़िगरेशन के लिए [`.github/workflows/release.yml`](https://github.com/guettaf-hossam/superdiagnostictool/blob/main/.github/workflows/release.yml) देखें।

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

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

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

### फ़ाइल संरचना

```
SuperDiagnosticTool/
├── super_diagnose_v2.py       # Main entry point and diagnostic logic
├── build.py                   # PyInstaller build script
├── icon.ico                   # Application icon
├── .github/workflows/
│   └── release.yml            # Automated build and release workflow
├── docs/
│   ├── icon.png
│   └── screenshot_main.png
├── src/
│   ├── safety/                # Script validation and monitored execution
│   │   ├── validator.py       # ScriptValidator + CriticalPathInterceptor
│   │   ├── sandbox.py         # SandboxExecutor (monitored subprocess runner)
│   │   ├── dry_run.py         # DryRunSimulator
│   │   ├── restore_point.py   # RestorePointManager
│   │   ├── enhanced_monitoring.py
│   │   └── knowledge_base.py
│   └── security/              # CredentialVault (DPAPI-backed key storage)
├── AI_Reports/                # Generated HTML reports and remediation scripts
├── README.md
├── SECURITY.md
├── TRUST_GUIDE.md
├── LICENSE                    # GPL-3.0
└── .gitignore
```

## अस्वीकरण

यह टूल PowerShell स्क्रिप्ट्स उत्पन्न और निष्पादित करता है जो सिस्टम सेवाओं, कॉन्फ़िगरेशन और रजिस्ट्री मानों को संशोधित करती हैं। किसी भी रेमेडिएशन स्क्रिप्ट को स्वीकृत करने से पहले:

- **पूरी स्क्रिप्ट पढ़ें** — निष्पादन की अनुमति देने से पहले इसे प्रदर्शित किया जाता है
- स्वचालित रेमेडिएशन चलाने से पहले **महत्वपूर्ण डेटा का बैकअप लें**
- यदि परिवर्तन का दायरा स्पष्ट न हो तो **किसी गैर-महत्वपूर्ण सिस्टम पर परीक्षण करें**

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

---

## योगदान

योगदान का स्वागत है। योगदान देने के लिए:

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

---

## लाइसेंस

यह प्रोजेक्ट **GNU General Public License v3.0** के अंतर्गत लाइसेंस प्राप्त है — विवरण के लिए [LICENSE](https://github.com/guettaf-hossam/superdiagnostictool/blob/main/LICENSE) फ़ाइल देखें।

Copyright (C) 2026 GUETTAF HOUSSEM EDDINE

---

## लेखक

**Guettaf Houssem Eddine**
इलेक्ट्रोटेक्निक्स इंजीनियरिंग छात्र
अकली मोहंद औलहादज विश्वविद्यालय, बुइरा, अल्जीरिया
ईमेल: [email protected]
GitHub: [@Guettaf-hossam](https://github.com/Guettaf-hossam)

---

## आभार

- सिस्टम विश्लेषण क्षमताओं के लिए **Google Gemini AI**
- क्रॉस-प्लेटफ़ॉर्म सिस्टम टेलीमेट्री के लिए **psutil**
- टर्मिनल UI रेंडरिंग के लिए **Rich**

---

<p align="center">
  <strong>संस्करण 1.0</strong> | अंतिम अद्यतन: अगस्त 2026
</p>

<p align="center">
  अकली मोहंद औलहादज विश्वविद्यालय, बुइरा, अल्जीरिया
</p>