
DeepZero deepzero-v0.4.0
اعثر على ثغرات يوم الصفر بينما تنام. DeepZero هو إطار عمل آلي لأبحاث الثغرات يقوم بتحليل وتفكيك وفحص آلاف من برامج تشغيل نواة ويندوز للبحث عن IOCTLs قابلة للاستغلال بشكل أصلي باستخدام وكلاء الذكاء الاصطناعي.
محرك خط أنابيب مؤتمت لبحوث الثغرات الأمنية
عرّف خطوط الأنابيب في YAML، وعالج العينات بالتوازي، واستأنف التشغيلات المتوقفة.
![]() |
![]() |
- خطوط أنابيب 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 للاستئناف من الحالة المحفوظة. راجع جولة العرض التجريبي للاطلاع على النتائج المتوقعة وخيارات التهيئة.
إعداد خط أنابيب الأمان
يحتاج خطّا أنابيب الأمان إلى مجموعة نصوص مستهدفة خاصة بك وأدوات إضافية. تابع من المستودع المستنسخ بعد العرض التجريبي؛ فهذه التكاملات اختيارية.
-
تثبيت التكاملات الاختيارية
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 باستمرار. -
تهيئة البيئة
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.
-
تشغيل خط معالجة
# 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) قبل بدء المعالجة. -
اقرأ النتائج
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

