أدلة تركز على الهندسة العكسية للبرمجيات الخبيثة مع فحص عميق لملفات PE/.NET، وإعادة البناء عبر Ghidra، وفحوصات متقاطعة بالذكاء الاصطناعي، وYARA، وتصحيح أخطاء ELF
أداة سطر أوامر للهندسة العكسية تركّز على الأدلة. يطوّر Andrey Pautov واجهة المحلل بلغة Python، والفرز دون اتصال، واستخبارات النصوص، وفحص PE، وسير عمل إعداد التقارير. تُعدّ Capstone وGhidra وGDB ومزوّدو الذكاء الاصطناعي الاختياريون عمليات تكامل، وليست أدوات أصلية من تأليف هذا المشروع.
مدى ملاءمة الدور: فرز البرمجيات الخبيثة، وأدوات الهندسة العكسية، والتحليل الآمن بمساعدة الذكاء الاصطناعي، والتسليم بلغة Python.
شغّل العرض التجريبي المحلي الآمن وراجع نطاق التحقق · التحقق المحلي المسجّل
AIDebug هي أداة سطر أوامر وواجهة طرفية للهندسة العكسية للبرمجيات الخبيثة تركّز على الأدلة. وهي تجمع بين الفرز الحتمي دون اتصال، وفحص الملف كاملًا بالنظام السداسي عشري، والتحليل العميق لبنية PE، وتفكيك Capstone، وإعادة بناء Ghidra، والتحقق المتقاطع الاختياري بواسطة LLM، وتصحيح أخطاء ELF محليًا، وتمارين تعلّم مُجمّعة، وتقارير مراجعة المحلل.
إصدار المصدر الحالي: AIDebug 3.1.0. راجع ملاحظات إصدار 3.1.0.
يبقى أحدث إصدار منشور غير قابل للتغيير هو AIDebug v3.0.0، والمتاح باسم
1200km-aidebug، إلى أن تكتمل وسمة 3.1.0 المطابقة للإصدار وإصدار GitHub عبر سير عمل النشر المُتحقَّق منه.
ثبّت الحزمة المستقرة من PyPI عبر هذه الخطوات الثلاث:
python3 -m venv .venv
source .venv/bin/activate
شغّل bootstrap الآمن لـ pip المدرك للإصدارات في تلك البيئة. يحافظ على إصدارات pip الأحدث ويتحقق من تجزئة الـ wheel المثبّت عند الحاجة إلى ترقية. توقّف إذا فشل؛ لا تتابع إلى تثبيت الحزمة.
ثبّت الحزمة المستقرة:
python -m pip install 1200km-aidebug==3.0.0
aidebug --version
قم بتثبيت الإمكانات الاختيارية حسب الحاجة:
# LLM provider clients and local validation of AI-generated YARA candidates
python -m pip install "1200km-aidebug[ai]==3.0.0" "certifi>=2026.10.19"
# Frida dynamic instrumentation
python -m pip install "1200km-aidebug[dynamic]==3.0.0"
# All optional Python integrations
python -m pip install "1200km-aidebug[all]==3.0.0" "certifi>=2026.10.19"
تتطلب String Intelligence المصدر 3.1 حتى يتم نشر حزمتها. تُثبّت
مراجعة 3.1
المراجعة أدناه. كما يتطابق كود التشغيل الخاص بها مع مراجعة main المُدقَّقة بتاريخ 1 أكتوبر
80b0b7172b592814504c405a16bf4cc0ce4161eb.
git clone https://github.com/anpa1200/AIDebug.git
cd AIDebug
git checkout cd81ef242db0bcea3296970d45c241a4228d2d27
python3 -m venv .venv
source .venv/bin/activate
قبل تثبيت التبعيات، شغّل التمهيد الآمن لـ pip المدرك للإصدارات في هذه البيئة. لا يتضمن نسخ الشيفرة التاريخية أداة التمهيد الحالية. توقف إذا فشل التمهيد. لا تتابع إلا بعد نجاحه:
python -m pip install -e .
aidebug --version
من ذلك النسخة المستخرجة، أضف الإضافات باستخدام python -m pip install -e ".[ai]" "certifi>=2026.10.19"،
أو ".[dynamic]"، أو ".[all]" "certifi>=2026.10.19". أبقِ الإضافات على نفس مسار التثبيت:
تثبيت "1200km-aidebug[ai]==3.0.0" فوق المصدر 3.1 قد يستبدله
بحزمة 3.0 المنشورة.
للحصول على نسخة تطوير متغيرة:
git clone https://github.com/anpa1200/AIDebug.git
cd AIDebug
python3 -m venv .venv
source .venv/bin/activate
python scripts/bootstrap_pip.py
python -m pip install -e ".[dev,dynamic]"
تم قبول Ghidra وGDB وBubblewrap ومترجم C ومكوّنات هدف Frida كأدوات خارجية تُستخدم فقط من قبل سير العمل التي تتطلبها.
تم قبول AIDebug في REMnux في 7 أكتوبر 2026 عبر
PR #355، وأُدرج لأول مرة في
salt-states v2026.41.4.
تقوم الحالة المقبولة
بتثبيت 1200km-aidebug[ai] غير المثبّت بإصدار محدد من PyPI في /opt/aidebug، وتفعّل
الترقيات، وتتيح /usr/local/bin/aidebug. وكما تم التحقق في 8 أكتوبر 2026،
لا يزال PyPI يوفّر 3.0.0؛ وهذا لا يثبّت مصدر 3.1 غير المنشور ولا
الإضافة dynamic. استخدم --offline لإبقاء التحليل محليًا.
راجع إعداد REMnux وحدود الإصدارات.
افتح عينة PE أو ELF في واجهة الطرفية الرئيسية:
aidebug --binary /path/to/sample.exe --offline
شغّل التحليل الحتمي دون واجهة المستخدم بملء الشاشة وصدّر الأدلة:
aidebug --binary /path/to/sample.exe \
--offline --no-tui --report --json-export --yara \
--out-dir reports/
استخدم إعادة بناء Ghidra:
aidebug --binary /path/to/sample.exe --offline --no-tui --decompile
aidebug --binary /path/to/sample.exe --offline --no-tui \
--decompile-all reports/sample-reconstruction.c
حلّل وحدة ترجمة C واحدة عبر أثر ELF مؤقت غير قابل للتنفيذ:
aidebug --source /path/to/example.c --offline --no-tui
حدد أي ملف بشكل مستقل عن امتداد اسمه:
aidebug --identify /path/to/renamed-or-unknown-file --offline