SuperDiagnosticTool

أداة تشخيص وإصلاح ذاتي لنظام Windows مدعومة بالذكاء الاصطناعي

SuperDiagnosticTool هي أداة تشخيص نظام ذكية تجمع بين بيانات الأجهزة في الوقت الفعلي و Google Gemini AI لتحليل وتشخيص وإصلاح مشكلات نظام Windows تلقائيًا. تم بناؤها بهندسة تركز على السلامة أولاً، وهي توفر تشخيصًا بمستوى إنتاجي لأي تكوين Windows.

---

لقطات الشاشة

الواجهة الرئيسية تظهر اختيار وضع المسح وإدخال وصف المشكلة

---

الميزات الرئيسية

دعم الأجهزة الشامل

• التحجيم الديناميكي: يتكيف تلقائيًا مع أي تكوين CPU (1-128+ نواة)
• منطق مستقل عن الأجهزة: يعمل بسلاسة على الأنظمة القديمة (Intel Pentium) إلى محطات العمل عالية الأداء (AMD Threadripper، Intel Xeon)
• تراجعات سلسة: معالجة آمنة للميزات غير المدعومة (تردد CPU، اكتشاف البطارية، الذاكرة التبادلية)
• محسّن للمواصفات المنخفضة: التنفيذ الخفيف يمنع بطء النظام حتى على الأجهزة محدودة الموارد

تحليل ذكي بالذكاء الاصطناعي

• دمج Google Gemini: تحليل وتشخيص متقدم للنظام باستخدام الذكاء الاصطناعي
• توصيات واعية بالسياق: يربط المشكلات التي أبلغ عنها المستخدم مع بيانات النظام
• تدقيق أمني: يفحص العمليات المشبوهة وتسريبات الموارد والبرامج الضارة المحتملة
• التحقق بعد الإصلاح: ينشئ تقارير إتمام تظهر ما تم إصلاحه مقابل ما يتطلب اهتمامًا يدويًا

هندسة السلامة أولاً

أمان بمستوى إنتاجي (85%)

التحقق متعدد الطبقات

• مطابقة قاعدة المعرفة: يتحقق من حلول الذكاء الاصطناعي مقابل 5 حلول معروفة ومختبرة مع معدلات نجاح
• محاكاة التشغيل الجاف: معاينة جميع التغييرات قبل التنفيذ (الخدمات، الملفات، السجل)
• التحقق من النصوص البرمجية متعدد المستويات: القائمة السوداء، القائمة البيضاء، وتقييم المخاطر (0-100)
• نقاط استعادة النظام: إنشاء نقطة استعادة تلقائيًا قبل أي تعديلات

المراقبة المحسّنة

• لقطات قبل/بعد التنفيذ: التقاط كامل لحالة النظام قبل التغييرات وبعدها
• كشف التغييرات: تتبع تلقائي لجميع التعديلات (الخدمات، السجل، عناصر بدء التشغيل)
• إنشاء التراجع: نصوص مُنشأة تلقائيًا للتراجع عن التغييرات إذا لزم الأمر
• تسجيل التنفيذ: سجلات شاملة لجميع العمليات

سلامة PowerShell

• التحقق من صلاحيات المسؤول: تتضمن جميع نصوص الإصلاح فحص رفع الصلاحيات
• تعقيم المتغيرات: هروب قائم على التعبيرات النمطية يمنع الأخطاء مع الحفاظ على متغيرات $env:
• فحوصات سلامة الخدمات: يتحقق من وجود الخدمة قبل العمليات
• التنفيذ في بيئة معزولة: بيئة مراقبة مع حماية المهلة الزمنية
• معالجة الأخطاء: كتل try-catch شاملة مع ضمانات

المسح الشامل للنظام

• مقاييس الأداء: استخدام CPU (إجمالي + لكل نواة)، تحليل الذاكرة، أكبر مستهلكي الموارد
• ذكاء الشبكة: الواجهات النشطة، تكوين DNS، قوة إشارة Wi-Fi، اختبارات الاتصال
• سلامة الأمان: حالة برنامج مكافحة الفيروسات، ملفات تعريف جدار الحماية، سجل تحديثات Windows
• صحة الأجهزة: حالة 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. راجع تحليل الذكاء الاصطناعي ونص الإصلاح
6. نفذ الإصلاحات أو اعرض تقرير HTML المفصل

---

التثبيت (للمطورين)

المتطلبات الأساسية

• Python 3.8 أو أعلى
• مدير الحزم pip

تثبيت التبعيات

pip install psutil google-generativeai rich

التشغيل من المصدر

python super_diagnose_v2.py

---

الاستخدام

إعداد مفتاح API

الخيار أ: الإدخال التفاعلي (موصى به للمستخدمين الجدد)

• ستطلب منك الأداة إدخال مفتاح API الخاص بك عند التشغيل الأول
• يتم حفظ المفتاح محليًا في gemini.key للاستخدام المستقبلي

الخيار ب: متغير البيئة

set GEMINI_API_KEY=your_api_key_here

الخيار ج: ملف مفتاح يدوي أنشئ gemini.key في نفس الدليل:

your_api_key_here

أوضاع المسح

الوضع	المسح	حالة الاستخدام
مسح سريع	CPU، RAM، معلومات أساسية	فحص أداء سريع
مسح عميق	النظام، الشبكة، الأمان، السجلات، Bluetooth، العمليات	استكشاف الأخطاء وإصلاحها الشامل
مسح كامل	كل ما سبق + صحة القرص، 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 logic...]

# 5. Review remediation script
[PowerShell script displayed]
> Execute? (y/n)

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

---

التفاصيل التقنية

بنية الكود

• تصميم معياري مع وظائف منفصلة لكل فئة تشخيصية
• معالجة شاملة للأخطاء باستخدام كتل try-except
• استعلامات مستقلة عن الأجهزة مع تراجعات سلسة
• توثيق احترافي للوظائف وتسمية واضحة للمتغيرات

توليد نصوص PowerShell

• التحقق من صلاحيات المسؤول قبل التنفيذ
• هروب المتغيرات باستخدام التعبيرات النمطية لمنع أخطاء الصياغة
• متغيرات البيئة ($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

"لا يعمل كمسؤول"

• انقر بزر الماوس الأيمن على الملف التنفيذي واختر "Run as Administrator"
• أو اسمح بمطالبة UAC عند رفع الأداة صلاحياتها تلقائيًا