malware-check

pip install malware-check

pipx install malware-check

git clone https://github.com/momenbasel/malware-check.git
cd malware-check
pip install -e ".[dev]"

# أساسي + تحليل ثنائي + كشف ملفات بالذكاء الاصطناعي + YARA
pip install malware-check[full]

# أو تثبيت ما تحتاجه فقط
pip install malware-check[binary]
pip install malware-check[detect]
pip install malware-check[yara]

# أو تثبيت الإضافات يدويًا
pip install pefile lief magika yara-python

pip install malware-check[detect]

# يتطلب Docker - https://docs.docker.com/get-docker/
# بناء صورة الحماية (مرة واحدة)
malware-check build-sandbox

malware-check info

# تثبيت المهارة من GitHub
npx skills install momenbasel/malware-check --skill malware-check

# أو يدويًا: انسخ skill/SKILL.md إلى دليل المهارات الخاص بك
cp -r skill/ ~/.claude/skills/malware-check/

pip install malware-check pefile lief yara-python

# 1. تثبيت CLI
pip install malware-check pefile lief yara-python

# 2. أضف إلى تعليمات Codex (codex.md أو موجه النظام)
echo 'استخدم `malware-check scan <path> --verbose` لتحليل الملفات بحثًا عن برمجيات خبيثة.' >> AGENTS.md

# 3. أو قم بتثبيتها كمهارة Codex
cp -r skill/ .codex/skills/malware-check/

# 1. التثبيت
pip install malware-check

# 2. أضف إلى تعليمات الوكيل:
# "عند الطلب للتحقق من الشيفرة/الملفات الثنائية بحثًا عن برمجيات خبيثة، استخدم: malware-check scan <target> --verbose"
# "للتقارير: malware-check scan <target> --format html -o report.html"
# "لـ CI/CD: malware-check scan <target> --format sarif -o report.sarif --exit-code"

malware-check scan suspicious_file.py

# أفضل النتائج عند تثبيت malware-check[detect]
malware-check scan suspicious_payload --verbose

malware-check scan /path/to/project --verbose

# بناء الحماية أولاً (مرة واحدة)
malware-check build-sandbox

# مسح مع تحليل سلوكي
malware-check scan malware.exe --dynamic

malware-check scan /Applications/SuspiciousApp.app --dynamic --verbose

# تقرير JSON
malware-check scan target/ --format json -o report.json

# لوحة تحكم HTML
malware-check scan target/ --format html -o report.html

# SARIF لـ CI/CD
malware-check scan target/ --format sarif -o results.sarif

# الخروج برمز خطأ غير صفري عند وجود نتائج (لبوابات CI)
malware-check scan . --format sarif -o results.sarif --exit-code

malware-check info

name: فحص أمني
on: [push, pull_request]

jobs:
  malware-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: إعداد بايثون
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: تثبيت malware-check
        run: pip install malware-check

      - name: تشغيل المسح
        run: malware-check scan . --format sarif -o results.sarif --exit-code

      - name: رفع SARIF
        if: always()
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: results.sarif

malware-check/
├── src/malware_check/
│   ├── cli.py                 # نقطة الدخول CLI (Click)
│   ├── scanner.py             # المنسق + كشف الملفات الاختياري عبر Magika
│   ├── models.py              # نماذج بيانات Finding, FileAnalysis, ScanResult
│   ├── analyzers/
│   │   ├── code.py            # مطابقة أنماط الشيفرة المصدرية (40+ قاعدة)
│   │   ├── binary.py          # تحليل PE/Mach-O/ELF
│   │   ├── privacy.py         # المعلومات الشخصية، التتبع، الأذونات
│   │   ├── yara_engine.py     # تجميع ومسح قواعد YARA
│   │   └── dynamic.py         # تحليل سلوكي في حاوية Docker
│   └── reporters/
│       ├── console_reporter.py  # إخراج طرفية غني
│       ├── json_reporter.py     # تصدير JSON
│       ├── html_reporter.py     # لوحة تحكم HTML (Jinja2)
│       └── sarif_reporter.py    # SARIF 2.1.0 لـ CI/CD
├── rules/yara/                # قواعد YARA المضمنة
├── tests/                     # مجموعة اختبارات pytest
└── pyproject.toml             # بيانات المشروع

malware-check scan target/ --yara-rules /path/to/my/rules/

rule My_Custom_Rule {
    meta:
        description = "كشف نمط برمجية خبيثة مخصصة"
        severity = "critical"
        category = "backdoor"
        confidence = "0.90"
        mitre = "T1059"
        cwe = "CWE-94"
        recommendation = "إزالة الشيفرة الخبيثة"

    strings:
        $pattern = "suspicious_string"

    condition:
        $pattern
}

# استنساخ وتثبيت تبعيات التطوير
git clone https://github.com/momenbasel/malware-check.git
cd malware-check
pip install -e ".[dev]"

# اختياريًا: تضمين إضافات Magika و YARA والثنائية أثناء التطوير
pip install -e ".[dev,full]"

# تشغيل الاختبارات
pytest

# التدقيق
ruff check src/ tests/