guettaf-hossam/superdiagnostictoolأداة تشخيص وإصلاح ذاتي تعمل بنظام Windows مدعومة بالذكاء الاصطناعي باستخدام Google Gemini. اكتشاف الأعطال، تحسين الأداء، فحص البرامج الضارة، وإنشاء نصوص PowerShell العلاجية. دعم شامل للأجهزة (1-128+ نواة). مجانية ومفتوحة المصدر.
أداة تشخيص وإصلاح لنظام Windows مدعومة بالذكاء الاصطناعي
تجمع SuperDiagnosticTool بيانات القياس عن بُعد الخاصة بالعتاد في الوقت الفعلي، وترسلها إلى واجهة Google Gemini API للتحليل، وتولّد نصوص PowerShell البرمجية للإصلاح لمعالجة المشكلات المكتشفة. وتتضمن طبقات تحقق متعددة يجب أن يجتازها أي نص برمجي مولّد قبل أن يُطلب من المستخدم تنفيذه.
الواجهة الرئيسية تعرض اختيار وضع الفحص وإدخال وصف المشكلة
تمر النصوص البرمجية التي يولّدها Gemini عبر أربعة فحوصات متتالية قبل أن يُطلب من المستخدم الموافقة على التنفيذ:
ScriptValidator): فحص من ثلاثة مستويات — القائمة السوداء (حظر صارم للأنماط المدمّرة)، واكتشاف الأنماط المشبوهة (مع مراعاة الأسماء المستعارة والتعتيم)، وتقييم المخاطر على مقياس من 0 إلى 100CriticalPathInterceptor): بوابة انعدام ثقة توقف أي نص برمجي يمس مفاتيح السجل HKLM/HKCU أو مسارات System32 حتى يؤكد المستخدم ذلك صراحةً%TEMP%\superdiagnostic_execution_*.log$env: دون أخطاء في الصياغةsubprocess.run مع مهلة قصوى صارمة مدتها 5 دقائق، والتقاط كامل لمخرجات stdout/stderr، وتنظيف تلقائي للملفات المؤقتة. هذا تنفيذ مباشر على مستوى المضيف، وليس عزلاً عبر جهاز افتراضي أو حاوية. طبقات التحقق أعلاه هي الحد الأمني الأساسي.[FIXED] و[CLEANED] و[DISABLED] لتعكس الإجراءات المكتملةAI_Reports/ للتتبع التاريخيتنزيل SuperDiagnosticTool.exe — ملف تنفيذي مستقل (لا يتطلب Python)
الملف التنفيذي غير موقَّع. سيعرض Windows SmartScreen تحذيراً عند التشغيل الأول. راجع TRUST_GUIDE.md لمعرفة كيفية المتابعة. إذا كنت تفضل التحقق قبل التشغيل، فقم بالبناء من المصدر بدلاً من ذلك.
SuperDiagnosticTool.exe وشغّلهأنشئ بيئة افتراضية بحيث تبقى تبعيات الأداة معزولة عن مشاريع Python الأخرى:
python -m venv .venv
فعّله في موجّه أوامر Windows، ثم ثبّت التبعيات المذكورة في المستودع:
.venv\Scripts\activate
pip install -r requirements.txt
في PowerShell، فعّل البيئة باستخدام:
.\.venv\Scripts\Activate.ps1
إذا كان PowerShell يحظر سكربت التنشيط، فافتح PowerShell كمستخدمك وشغّل Set-ExecutionPolicy -Scope CurrentUser RemoteSigned مرة واحدة، ثم جرّب أمر التنشيط مرة أخرى.
python super_diagnose_v2.py
للتأكد من أن شجرة المصدر والاعتماديات جاهزة قبل بدء الفحص، شغّل:
python -m compileall src super_diagnose_v2.py
يجب أن ينتهي الأمر دون أخطاء. لا تزال الأداة تتطلب Windows وصولاً إدارياً عند تشغيلها، لأن العديد من التشخيصات تستخدم PowerShell ومعلومات النظام المحمية.
الخيار أ: الإدخال التفاعلي (موصى به للاستخدام الأول)
keyring) عند توفرهالخيار ب: متغير البيئة موجه الأوامر:
set GEMINI_API_KEY=your_api_key_here
PowerShell:
$env:GEMINI_API_KEY = "your_api_key_here"
الخيار C: ملف مفتاح يدوي
أنشئ gemini.key في دليل الأداة:
your_api_key_here
| الوضع | ما يفحصه | حالة الاستخدام |
|---|---|---|
| فحص سريع | CPU، RAM، معلومات أساسية | فحص سريع للأداء |
| فحص عميق | النظام، الشبكة، الأمان، السجلات، Bluetooth، العمليات | استكشاف شامل للأعطال |
| فحص كامل | كل ما سبق + صحة القرص، GPU، تطبيقات بدء التشغيل | تدقيق كامل للنظام |
1. Run the tool
> SuperDiagnosticTool.exe