USB Repair Pro - Advanced USB Diagnostic & Repair Suite

أداة تشخيص وإصلاح USB المتقدمة

The most comprehensive USB diagnostic and repair toolkit for Windows. أشمل مجموعة أدوات لتشخيص وإصلاح USB على Windows.

---

Quick Start / البدء السريع

Recommended (All-in-One Hub)

run_all_in_one_hub.bat

Simple Emergency (if you want something basic)

run_usb_emergency_simple.bat

Other Options

Launcher	Description
run_disk_pro.bat	Disk Diagnostic Pro (USB/SSD/HDD)
run_usb_tool.bat	Simple USB Diagnostic Tool
run_as_admin.bat	USB Tool as Administrator

---

Features / الميزات

Diagnosis / التشخيص

Feature	Description
Chip Detection	Identify USB controller chip (VID/PID lookup)
Health Score	Calculate 0-100 health rating for your USB
Speed Benchmark	Full speed test (Sequential + Random 4K)
Bad Sector Scan	Detect and map bad sectors
Failure Prediction	AI-powered failure probability analysis

Repair / الإصلاح

Feature	Description
Smart Repair	Multi-stage repair (least to most aggressive)
Fix RAW Drive	Repair corrupted/unreadable drives
CHKDSK	File system check & repair
Format	Quick/Full format (FAT32/NTFS/exFAT)
One-Click Rescue	Automatic scan + fix workflow

Recovery / الاستعادة

Feature	Description
File Recovery	Recover deleted files by signature
Recover FOUND.000	Recover chkdsk recovered files
Bad Sector Recovery	Sector-level data recovery

Monitoring / المراقبة

Feature	Description
USB Monitor	Real-time insert/remove detection
Auto-Fix	Automatic check on USB insertion
System Snapshot	Capture current system state

AI Assistant / المساعد الذكي

Feature	Description
AI Diagnosis	Smart problem detection and analysis
AI Chat	Interactive troubleshooting assistant
Solution Plans	Step-by-step repair plans with success probability

---

Available Tools / الأدوات المتوفرة

File	Description
all_in_one_repair_hub.py	Main hub - launch all tools from one place
usb_diagnostic_tool.py	Primary USB diagnostic & repair tool
disk_diagnostic_pro.py	Multi-disk tool (USB/SSD/HDD)
usb_emergency_simple.py	Minimal 3-button emergency tool
usb_algorithms.py	Core algorithms library
usb_ai.py	AI diagnostic engine
usb_advanced_engine.py	Advanced USB detection engine
chip_genius.py	Chip detection (like ChipGenius)
usb_deep_info.py	Comprehensive USB information
usb_monitor.py	Real-time USB monitoring
usb_recovery.py	Data recovery engine
usb_firmware_database.py	Comprehensive firmware/controller DB
usb_firmware_db.py	Compact VID/PID lookup table
usb_mptool_integration.py	Mass Production Tool management

---

Algorithms / الخوارزميات

1. USBChipDetector

Multi-layer chip identification: VID:PID database lookup (500+ devices), USBSTOR PNP ID parsing, model string analysis, firmware tool recommendation.

2. USBHealthAnalyzer

Comprehensive health scoring based on: speed analysis, filesystem integrity, bad sector detection, response time measurement.

3. SmartRepairAlgorithm

Progressive repair stages:

1. Clear dirty bit
2. CHKDSK read-only
3. CHKDSK /F
4. CHKDSK /F /R
5. DISKPART clean (last resort)

4. SpeedAnalyzer

Full benchmark suite: Sequential Read/Write, Random 4K Read/Write, Latency test, Performance grading (A-F).

5. AI Diagnostic Engine

Knowledge base with problem patterns, symptom analysis, smart recommendations, failure prediction, and solution planning.

---

Requirements / المتطلبات

• Windows 10/11
• Python 3.x (installer auto-detects)
• Administrator privileges (for repair features like CHKDSK, format)

No external dependencies required - uses only Python standard library!

---

How to Use / كيفية الاستخدام

Basic Workflow

1. Run the app: Double-click run_all_in_one_hub.bat
2. Select drive: Choose your USB drive from the dropdown
3. Scan: Click "Quick Scan" or "Deep Diagnosis"
4. Fix: Use Smart Repair or One-Click Rescue
5. Save report: Export results for reference

For Advanced Users

• Use the Tool Center to launch specific tools
• Configure external tools (ChipGenius, MiniTool, etc.)
• Export diagnostic bundles as ZIP archives

---

Important Notes / ملاحظات مهمة

1. Always backup data before repair operations احتفظ بنسخة احتياطية من ملفاتك قبل أي عملية إصلاح
2. Run as Administrator for repair/format features شغل التطبيق كمسؤول للحصول على صلاحيات الإصلاح الكاملة
3. RAW drives are detected automatically with warning الأقراص التالفة يتم كشفها تلقائياً مع تحذير
4. External tools (ChipGenius, etc.) need to be downloaded separately الأدوات الخارجية تحتاج تحميلها بشكل منفصل

---

Troubleshooting / حل المشاكل

Problem	Solution
USB not detected	Try different USB port, check Device Manager
Shows as RAW	Use "Fix RAW Drive" or Smart Repair
Permission denied	Run as Administrator
Unknown VID/PID	Use ChipGenius for detection
Format fails	Try diskpart clean method

---

.bat Launchers / ملفات التشغيل

File	Launches	Admin?
run_all_in_one_hub.bat	All-in-One Repair Hub	No
run_usb_repair_pro.bat	USB Repair Pro	No
run_usb_repair_admin.bat	USB Repair Pro	Yes
run_usb_tool.bat	USB Diagnostic Tool	No
run_disk_pro.bat	Disk Diagnostic Pro	No
run_usb_emergency_simple.bat	USB Emergency Simple	No
run_as_admin.bat	USB Diagnostic Tool	Yes

---

External Tools / أدوات خارجية

Tool	Purpose
ChipGenius	Detailed USB chip detection
Phison MPALL	Phison controller firmware repair
SMI MPTool	Silicon Motion firmware repair
Recuva	Easy file recovery
PhotoRec	Deep file recovery
TestDisk	Partition recovery

---

Made with ❤️ for USB troubleshooting