أداة استخراج عالمية لنظام ويندوز تكتشف الملفات غير المعروفة وتوجّهها إلى أداة الاستخراج المضمّنة الصحيحة.
Magic Extractor هو أداة استخراج شاملة لنظام Windows تحدد الملف باستخدام عدة كواشف وتوجّهه إلى أداة الاستخراج المضمّنة المناسبة. ويهدف إلى تغطية صيغ الضغط الشائعة، وبرامج التثبيت التي تراها فعليًا اليوم، ومجموعة من أدوات الأرشفة الأقل شيوعًا.
يكتشف تلقائيًا أكثر من 80 صيغة — الأرشيفات، وبرامج التثبيت، وصور الأقراص، وصور
التحليل الجنائي (EWF/AFF/AD1)، وصور الأقراص الضوئية، ومخازن البريد، والترميزات الحديثة. راجع
formats.md للاطلاع على القائمة الكاملة.
نزّل أحدث إصدار، وفك ضغطه، ثم شغّل:
magic-extractor.exe extract mystery.bin
راجع الأمثلة للاطلاع على identify وlist وcarve و--recursive و--bruteforce.
src/cli: أداة سطر الأوامر.
bin: ملفات الكشف والاستخراج التنفيذية المضمّنة.
detectors: DIE وMagika وbinwalk (تُحوَّل تعريفات TrID إلى data/signatures.json).extractors: 7-Zip (إضافةً إلى 7-Zip ZS كخيار احتياطي)، وunrar، وunace، وunshield، وlessmsi،
وdark (WiX)، وغيرها.data: بيانات التوجيه المولّدة من المعالجات (انظر أدناه).formats: وحدة معالج واحدة لكل عائلة صيغ.src/gui: واجهة أمامية اختيارية بـ tkinter تغلّف أداة سطر الأوامر (انظر GUI).
icons: أيقونات Fluent محوّلة إلى ملفات PNG للوضعين الفاتح والداكن.test: اختبارات الوحدة، وحزم اختبار الصيغ والمحرّك، وملفات عيّنة لكل صيغة.tools: أدوات المطوّرين — generate_data.py (يبني بيانات التوجيه من
المعالجات) وgenerate_icons.py (يحوّل أيقونات واجهة GUI).update: إعدادات المُحدِّث والسكربتات التي تحدّث الملفات التنفيذية المضمّنة.docs: الصيغ المدعومة، وكيفية إضافة معالج، وإشعارات الأطراف الثالثة.يُبقي البناء المُجمَّع مجلدات bin/ وdata/ وملف config.ini خارج الملف التنفيذي
حتى يمكن تحديثها باستبدال الملفات؛ ويجدها cli_paths.py بجوار الملف
التنفيذي (في النسخة المُجمَّدة) أو تحت src/cli/ (في بيئة التطوير).
في الاستخراج العادي، تعمل أدوات الكشف بهذا الترتيب مع الخروج المبكر — أول أداة تُنتج معالجًا معروفًا تفوز (الأرخص أولًا، لذا يُتخطّى نموذج التعلّم الآلي عادةً):
data/signatures.json؛ تسمّي
أدوات الأرشفة التي تفوتها المحرّكات (bcm، dgca، kgb، uharc، alzip، freearc، ...) دون
عملية خارجية.تساهم كل أداة كشف بشكل فريد (فهي متكاملة لا متكررة): قاعدة بيانات التوقيعات تسمّي أدوات الأرشفة التي تفوتها المحرّكات، وDIE يتعامل مع برامج التثبيت وPE، وbinwalk يلتقط بعض الأنواع التي تفوتها الأخريات، وpuremagic/Magika يغطيان MIME.
يوفّر PureMagic 2.x أيضًا فحصًا عميقًا واعيًا بالمحتوى عندما يتلقى الملف
كاملًا. تحليل الملف الكامل هو الافتراضي؛ ويُمرّر المعدّل الاختياري --fast-check
أول 64 كيبي بايت فقط عندما تكون سرعة بدء التشغيل أهم من الفحص العميق.
يعلن كل معالج مؤشراته الخاصة عبر detection_mimes() /
detection_names() / detection_signatures()؛ ويُجمّعها tools/generate_data.py
في data/handlers.json وdata/signatures.json (مع دمج ملف اختياري
data/extra_detections.json فوقهما). لا يُستخدم TrID.
ملاحظة: أي صيغة يغيب توقيعها من
magic_data.jsonالخاص بـ puremagic (أو التي يبلّغ عنها puremagic فقط كـapplication/octet-streamعام) يجب أن تعلن مدخلdetection_signatures()مخصصًا في معالجها — وإلا فلن تُكتشف بالمحتوى.
--bruteforce الخروج المبكر: تعمل كل أدوات الكشف ويُجرَّب كل معالج
مكتشَف بدوره (مفيد عندما يكون التخمين الأول خاطئًا).carve إضافةً إلى ذلك خريطة إزاحات binwalk لاستخراج الأرشيفات
المضمّنة عند إزاحات عشوائية (مثلًا داخل صور البرامج الثابتة).توجد خريطة التوجيه من الكشف إلى المعالج في data/handlers.json (مولّدة، وتُحمَّل
عند التشغيل). يمكن لمفتاح واحد أن يُوجَّه إلى عدة معالجات، تُجرَّب بالترتيب حتى ينجح أحدها:
مثلًا 7-Zip أولًا، ثم 7-Zip ZS لما لا يستطيع 7-Zip الرئيسي فتحه (SquashFS مع
LZ4، وNSIS مع ZSTD). توجد قائمة حظر للرموز العامة في data/detection_blacklist.json.
راجع formats.md للاطلاع على القائمة الكاملة للصيغ ومعالجاتها.
لإضافة دعم لصيغة جديدة، راجع docs/adding-a-handler.md — الدليل الشامل من البداية إلى النهاية (فئة المعالج، إعلان الكشف، البحث عبر DIE/TrID، تواقيع السحر، إعادة توليد بيانات التوجيه، تجميع الأداة، والاختبار).
معظم المستخدمين يقومون فقط بتنزيل الإصدار (راجع البدء السريع). للتشغيل من المصدر: يتطلب Python 3.12 أو أحدث.
git clone <repo-url>
cd magic-extractor
pip install -r src/cli/requirements.txt
يستخدم Magic Extractor أوامر فرعية:
python src/cli/main.py extract <path> [output_dir] [options] # detect and extract
python src/cli/main.py identify <path> # report type + candidate handlers
python src/cli/main.py list <path> # list archive contents
python src/cli/main.py carve <path> [output_dir] [options] # carve embedded archives (binwalk offsets)
المسار المجرد بدون أمر فرعي يُعامل افتراضيًا كـ extract (متوافق مع الإصدارات السابقة)، ويمكن أن تأتي الخيارات قبل المسار أو الأمر الفرعي:
python src/cli/main.py <path> <output_dir> [options]
python src/cli/main.py --debug <path>
python src/cli/main.py --version
يعمل --debug و--fast-check مع كل الأوامر الفرعية؛ ويعمل --password مع
extract وlist وcarve.
يمكن أن يكون <path> مجلدًا لكل أمر فرعي: تُعالَج ملفاته (وليس مجلداته الفرعية)
واحدًا تلو الآخر. يحصل كل ملف على مجلد إخراج خاص به: <stem>_extracted
(بجوار الملف، أو تحت output_dir عند تحديده)، أو <name>_extracted عندما
يتشارك ملفان الجذر نفسه.
إذا كان مجلد الإخراج يحتوي بالفعل على ملفات، يكتب extract إلى مجلد جديد
<folder>_<YYYYmmdd-HHMMSS> بدلًا من الخلط مع النتيجة السابقة أو الكتابة فوقها؛
أما --merge-output فيستخرج إلى المجلد الموجود بدلًا من ذلك، مع الكتابة فوق
الملفات والمجلدات ذات الأسماء نفسها (تفعل واجهة GUI ذلك عندما يكون الوجهة
مقفلة). لا تتم الكتابة فوق الأرشيف الجاري استخراجه أبدًا. تعمل كل محاولة معالج
في مجلد مؤقت خاص بها، لذا لا تترك أي محاولة فاشلة ملفات جزئية خلفها.
رموز الخروج: 0 نجاح؛ 1 فشل — تعذّر استخراج أي شيء، أو فشل ملف في تشغيل
مجلد، أو لم يكن في المجلد أي ملفات، أو تعذّر على --delete-source حذف
المصدر؛ 2 وسائط غير صالحة؛ 3 استُخرج مع أخطاء — أبلغت الأداة عن فشل لكن
استُخرج معظم المحتوى (مثلًا: لا يمكن إنشاء روابط رمزية في صورة Linux على
Windows)، لذا يُحتفظ به في مجلد الإخراج ولا يُحذف المصدر. مع --recursive،
تُبلَّغ الأرشيفات المتداخلة التي يتعذّر استخراجها كتحذيرات ولا تغيّر رمز
الخروج (تبدو ملفات كثيرة مستخرجة، مثلًا كل DLL في مثبّت، كمرشّحات).