العودة إلى التحديثات
New releaseAug 3, 2026

DeepZero deepzero-v0.4.0

اعثر على ثغرات يوم الصفر بينما تنام. DeepZero هو إطار عمل آلي لأبحاث الثغرات يقوم بتحليل وتفكيك وفحص آلاف من برامج تشغيل نواة ويندوز للبحث عن IOCTLs قابلة للاستغلال بشكل أصلي باستخدام وكلاء الذكاء الاصطناعي.

مشاركة

DeepZero

محرك خط أنابيب مؤتمت لبحوث الثغرات الأمنية

عرّف خطوط الأنابيب في YAML، وعالج العينات بالتوازي، واستأنف التشغيلات المتوقفة.

CI License Docs Python Platform


لوحة تحكم الطرفية DeepZero

تقرير HTML من DeepZero لتدقيق الشيفرة المصدرية تقرير HTML من DeepZero لمراجعة برنامج تشغيل النواة
تقارير نموذجية باستخدام بيانات تجريبية.

English | 简体中文 | Français

  • خطوط أنابيب YAML - اجمع بين مراحل الاستيعاب والتصفية والتحويل وتقييم LLM.
  • تنفيذ متوازٍ - اضبط درجة التزامن لكل مرحلة.
  • حالة محفوظة - استأنف التشغيلات المتوقفة من النتائج الموجودة على القرص.
  • إعادة تشغيل تزايدية - تؤدي التغييرات في المطالبات أو القواعد أو التكوين إلى إعادة تشغيل المرحلة المتأثرة والمراحل اللاحقة.
  • خلفيات LLM - استخدم مطالبات Jinja2 مع LiteLLM أو Claude Code CLI.
  • تقارير HTML - أنشئ تقريرًا مكتفيًا بذاته باستخدام deepzero report.
  • معالجات مخصصة - اكتب فئات Python وأشر إليها بالمسار في YAML.
  • واجهة REST API تجريبية - استعلم عن حالة التشغيل وبيانات العينات عبر HTTP.

📚 التوثيق

البنية، وتكوين خط الأنابيب، ومرجع CLI، والمعالجات المخصصة.


⚡️ البدء السريع

يتطلب Python 3.11+. يستخدم العرض التجريبي ملفات نصية مضمّنة ولا يحتاج إلى مفاتيح API أو أدوات خارجية.

git clone https://github.com/416rehman/DeepZero.git
cd DeepZero
python -m pip install -e .
deepzero run pipelines/demo/samples -p pipelines/demo/pipeline.yaml
deepzero report -p pipelines/demo/pipeline.yaml --open

تعمل هذه الأوامر في PowerShell وأصداف POSIX. للحصول على تثبيت معزول، أنشئ بيئة Python افتراضية وفعّلها قبل التثبيت.

يحتفظ العرض التجريبي بملف نصي واحد، ويستبعد الملف الأصغر، ويُنشئ تقريرًا. كرّر أمر deepzero run للاستئناف من الحالة المحفوظة. راجع جولة العرض التجريبي للاطلاع على النتائج المتوقعة وخيارات التهيئة.

إعداد خط أنابيب الأمان

يحتاج خطّا أنابيب الأمان إلى مجموعة نصوص مستهدفة خاصة بك وأدوات إضافية. تابع من المستودع المستنسخ بعد العرض التجريبي؛ فهذه التكاملات اختيارية.

  1. تثبيت التكاملات الاختيارية

    python -m pip install -e ".[full]"
    

    يتضمن الخيار الإضافي full تحليل PE، ونماذج LLM المدعومة بواجهة API، وخادم API التجريبي. أما المحرك وحده فيحتاج فقط إلى python -m pip install -e ..

    نفّذ الأوامر أدناه من المستودع المستنسخ. تحتاج كلتا خطّي الأمان إلى Semgrep على PATH (python -m pip install semgrep) وإلى خلفية LLM. كما يحتاج تدقيق المصدر إلى Git. وتحتاج خطوة التشغيل إلى Ghidra، وإلى JDK المدعوم لديها، وإلى GHIDRA_INSTALL_DIR الذي يشير إلى تثبيتك. ثبّت هذه الأدوات في البيئة التي يعمل فيها DeepZero؛ وإذا كنت تستخدم WSL، فاستخدم بيئته Linux باستمرار.

  2. تهيئة البيئة

    cp .env.example .env
    

    في PowerShell، استخدم Copy-Item .env.example .env. عيّن مسار Ghidra الخاص بك في .env لتحليل برامج التشغيل.

تعتمد كلا خطي الأمان الافتراضيين على claude-code، الذي يستخدم النموذج الافتراضي لـ Claude Code CLI الخاص بك. ثبّت ذلك الـ CLI وسجّل الدخول بحسابك الخاص أولاً. لاستخدام نموذج مدعوم بواجهة API بدلاً من ذلك، عيّن مفتاح API الخاص به وDEEPZERO_MODEL في .env، أو مرّر -m، على سبيل المثال -m openai/gpt-4o.

  1. تشغيل خط معالجة

    # kernel drivers on disk
    deepzero run ./drivers -p pipelines/loldrivers/pipeline.yaml --preflight
    
    # or source code, from a manifest of repositories or a directory of checkouts
    deepzero run repos.txt -p pipelines/source_audit/pipeline.yaml --preflight
    

    استبدل ./drivers بمجموعة برامج التشغيل الخاصة بك، أو أنشئ repos.txt يحتوي على عنوان URL واحد لكل سطر لعمليات تدقيق المصدر. هذه مدخلات أمثلة؛ لا يتم تضمين أي منهما في المستودع.

    تحقق من متطلبات الأداة والخط المسبقة قبل البدء: deepzero validate pipelines/loldrivers/pipeline.yaml (أو pipelines/source_audit/pipeline.yaml). يتحقق --preflight من الواجهة الخلفية لنموذج اللغة الكبير (LLM) قبل بدء المعالجة.

  2. اقرأ النتائج

    deepzero report -p loldrivers --open
    

    يمكن إنشاء التقارير أثناء التشغيل أو بعده. يسرد deepzero runs عمليات التشغيل ضمن work/، أو أي دليل آخر يُمرَّر باستخدام --work-dir. عند عدم تمرير أي وسائط، يستخدم deepzero report عملية التشغيل الوحيدة ضمن work/ أو يطلب منك الاختيار إذا وُجدت عدة عمليات. استخدم --work-dir لاختيار عملية تشغيل في السكربتات.

بالنسبة لخطوط أنابيب الأمان، اتبع دليل الإعداد الكامل ومتطلبات خط الأنابيب المسبقة. تتطلب عمليات التكامل الاختيارية تبعياتها وإعداداتها الخاصة.

أبلغ عن الأخطاء أو اقترح التغييرات في متتبع المشكلات.


📁 بنية المستودع

src/deepzero/
├── cli.py               # click command group (run, report, runs, status, validate, ...)
├── api/                 # REST API (starlette)
├── engine/              # orchestration, state persistence, pipeline execution
└── stages/              # built-in processors (map, reduce, ingest)

processors/              # external processors (shipped as examples)
├── ghidra_decompile/    # ghidra headless decompiler (MapProcessor)
├── git_ingest/          # git repository discovery and cloning (IngestProcessor)
├── loldrivers_filter/   # loldrivers.io hash exclusion filter (MapProcessor)
├── pe_ingest/           # PE header parser and driver metadata extractor (IngestProcessor)
└── semgrep_scanner/     # semgrep batch scanner (BulkMapProcessor)

pipelines/
├── demo/                # local first run with harmless text files; no API keys
│   ├── pipeline.yaml
│   └── samples/
├── loldrivers/          # BYOVD kernel driver vulnerability research pipeline
│   ├── pipeline.yaml
│   ├── assessment.j2    # LLM prompt template
│   └── rules/           # semgrep rules
└── source_audit/        # source code audit over git repositories
    ├── pipeline.yaml
    ├── assessment.j2    # LLM prompt template
    └── rules/           # 136 semgrep rules across eight languages

docs/                    # Jekyll-based GitHub Pages documentation
tests/                   # pytest suite

🤝 المساهمة

الفئات