ph4ntom Vitrum 🧪

In vitro («في الزجاج»): تفكيك ساكن آلي للبرمجيات الخبيثة خلف زجاج محكم — دون أي نبضة تنفيذ للعينة على المضيف (in vivo محظور)، محوّلاً «الصندوق الأسود» للملف الثنائي إلى زجاج شفاف عبر Telegram ووكلاء الذكاء الاصطناعي (Antigravity / OpenCode / Custom CLI) وIDA Pro 9.5 (ph4ntom-ida-bridge).

ترسل إلى البوت في Telegram أي ملف أو أرشيف (حتى 2 غيغابايت) ← يتحقق البوت من القائمة البيضاء user_id، ويُنزّل الملف إلى الحجر الصحي، ويُجري فرزاً أولياً سريعاً حتمياً، وعند الحاجة يُشغّل بنفسه IDA Pro 9.5 المعزول مع ph4ntom-ida-bridge، ويُجري الهندسة العكسية الساكنة وفك تشفير الإعدادات (execute_idapython + رمل AST المحلي) ويُرسل تقرير Markdown جاهزاً إلى الدردشة نفسها.

English Quickstart below ↓

---

الإمكانات

• استقبال أي ملفات وأرشيفات حتى 2 غيغابايت: العمل عبر MTProto (Telethon) يزيل قيد Bot API السحابي البالغ 20 ميغابايت دون Docker أو وكلاء خارجيين.
• فك ضغط ذكي وآمن: دعم ZIP (بما في ذلك WinZip AES-128/256 عبر pyzipper)، و7z، وRAR/RAR5 (البحث التلقائي عن 7z.exe/UnRAR.exe أو SEVENZIP_BIN/UNRAR_BIN الصريحة، مع الصمود أمام ترميزات OEM مثل CP866/CP1251)، وtar/gz/bz2/xz، وCAB، وISO؛ والاختيار التلقائي لكلمات المرور من توقيع الملف (pass: ...)، ومن الملفات النصية المجاورة المستخرجة (ПАРОЛЬ.txt، readme.txt بترميز UTF-8/CP1251/CP866) قبل التكرار إلى الأرشيفات المتداخلة، ومن كلمات المرور البرمجية الخبيثة القياسية (infected، malware، virus وغيرها)؛ والحماية من zip-slip والروابط الرمزية وقنابل zip؛ والحفاظ على .docm/.xlsm/.apk/.jar كحاويات مع الاستخراج المتوازي للملفات الثنائية المتداخلة.
• المرحلة 1 (دون استهلاك رموز الذكاء الاصطناعي): حساب التجزئات (MD5/SHA-1/SHA-256)، والإنتروبيا، وPE (pefile: الأقسام، وRWX، والاستيرادات حسب فئات التهديد، والطبقة الخارجية overlay، وTLS، وAuthenticode، و.NET، والفحص ذو الأولوية لـ .rdata/.data)، والكشف الحتمي لسلاسل المكدس ومخازن XOR أحادية البايت (mov byte ptr [rbp/rsp+disp], imm8)، وELF، وMach-O، وDEX، وماكروات Office VBA (oletools)، وPDF (/JavaScript، /OpenAction، /URI)، وWindows .lnk، وPowerShell -enc، ومستخرج IOC.
• المرحلة 1.5 (OSINT للمنسّق، اختيارياً حسب الملف الشخصي): عند تفعيل ORCHESTRATOR_INTERNET=1 (أو الملف الشخصي extended_static / full_local) يقوم الخادم بفحص SHA-256 والنطاقات وعناوين IP الخارجية من الفرز بشكل سلبي عبر MalwareBazaar وThreatFox وVirusTotal REST v3 (إذا تم تعيين VT_API_KEY) وDNS-over-HTTPS وRDAP دون الاتصال بخوادم المهاجمين الحية، مع حفظ jobs/<job_id>/osint_report.json. كما يحصل الوكيل الرئيسي على واجهة سطر الأوامر tools/osint_lookup.py (مع حماية SSRF).
• المرحلة 2 (الذكاء الاصطناعي + IDA Pro 9.5 + بوابة مكافحة الهلوسة + VirusTotal):
  • تشغيل معزول لـ ida.exe -A عبر tools/ida_session.py مع دليل staging معزول تلقائياً IDAUSR (لا يعتمد على أذونات sandbox على %APPDATA%\Hex-Rays\IDA Pro\plugins\)، وبحث ثنائي القفزات عن الدوال المخصصة عبر XREF النصية والتفكيك التلقائي للدالة الرئيسية، وربط صارم عبر PID/المنفذ في ~/.ph4ntom_ida_instances.json، وتسجيل أدلة الجلسة في ida_evidence.json وإنهاء مضمون للعملية — نوافذ IDA المفتوحة يدوياً لديك لا تتأثر.
  • حماية من مستويين ضد الهلوسة والكذب (core/report_verifier.py): يُلزم الـ prompt الذكاء الاصطناعي بتصنيف الادعاءات إلى [ПОДТВЕРЖДЕНО] / [ВЕРОЯТНО] / [НЕ ПОДТВЕРЖДЕНО] والإفصاح صراحةً عن حدود الثقة، بينما يقوم السكربت tools/send_telegram_report.py بمطابقة التقرير النهائي بشكل حتمي مع triage_report.json وida_evidence.json (مع حظر قيم SHA-256 المشوّهة، وsub_* / Hex-Rays المختلقة عند عدم تشغيل IDA، والأحكام غير المبرَّرة من نوع clean).
  • ملفات تعريف صلاحيات قابلة للتخصيص (core/permissions.py وtools/configure_permissions.py): يُستخدم افتراضيًا لـ GitHub العام الوضع الآمن safe_static (قائمة أوامر بيضاء صارمة وبيئة AST معزولة)، لكن بنقرة واحدة يمكن تفعيل extended_static (+ الإنترنت/OSINT) أو full_local (PowerShell كامل + الإنترنت لجهاز تحليلي مخصص).
  • دعم سكربتات ثابتة مخصصة لفك تشفير النصوص/الإعدادات: execute_idapython في IDA والبيئة المعزولة المحلية tools/run_static_decoder.py (مرشّح AST + sys.addaudithook يمنعان تشغيل العمليات والسجل والكتابة خارج jobs/<id>/decoded/، مع خيارات --allow-network / --unrestricted-imports الاختيارية عند تفعيل full_local).
• بنية متعددة الخلفيات والتبديل الساخن (backends/): تعمل جاهزةً مع Antigravity، ووكيل ذكاء اصطناعي محلي مستقل (local — Ollama / qwen2.5-coder:7b / LM Studio / vLLM مع تحكم تدفقي في التوليد، وتشغيل تلقائي لـ ollama serve وسياق 16K) وOpenCode (opencode run + إعداد جاهز opencode.json.example)، ويتم التبديل بين antigravity السحابي والنموذج المحلي مباشرةً في Telegram بالأمر /mode local ↔ /mode antigravity (أو بوسم لمرة واحدة #local في تعليق الملف) دون إعادة تشغيل البوت.
• تحكم صارم في الوصول: يعمل البوت فقط في الرسائل الخاصة لـ user_id الموثوقين (data/allowed_users.json). يُتجاهل المستخدمون الغرباء تمامًا؛ ويدير المالك الوصول عبر /allow و/revoke.

البنية

[Доверенный user_id в Telegram]
       │  (любой файл / архив до 2 ГБ, опционально пароль в подписи)
       ▼
[bot_daemon.py (Telethon MTProto + Keepalive)]
  ├─ Белый список: data/allowed_users.json (/whoami, /allow, /revoke, /users, /status, /mode, /reset)
  ├─ Очередь (MAX_CONCURRENT_JOBS=1) → скачивание в jobs/<job_id>/sample/
  ├─ Этап 1: tools/triage.py → безопасная распаковка + стековый/XOR декодер + jobs/<job_id>/triage_report.json
  └─ Этап 2: backends/* (Antigravity | Local LLM [Ollama/LM Studio] | OpenCode | Custom CLI)
       │
       ▼
[ИИ-агент (строго статика)]
  ├─ VirusTotal MCP: проверка только SHA-256 / доменов / IP (без загрузки файла)
  ├─ IDA Pro 9.5: tools/ida_session.py open → MCP ida-bridge + static execute_idapython → close
  ├─ Локальные декодеры: tools/run_static_decoder.py (AST + audit hook sandbox)
  └─ Финал: tools/send_telegram_report.py → jobs/<job_id>/delivery_ready.json
       │
       ▼
[bot_daemon.py] → отправляет вердикт, сводку и файл report_<name>.md обратно в чат

نموذج الأمان وملفات تعريف الصلاحيات (Static-Only + Configurable Profiles)

تم إعداد المستودع العام وفق مبدأ secure-by-default (PERMISSION_PROFILE=safe_static في .env.example وopencode.json.example)، بينما على جهازك الشخصي أو بيئة اختبار مخصصة تُوسَّع الصلاحيات بمرونة:

الملف التعريفي (PERMISSION_PROFILE)	PowerShell / Shell	الإنترنت وOSINT (المنسّق + الوكيل)	الاستيرادات غير المقيّدة في run_static_decoder.py	الغرض
safe_static (الافتراضي لـ GitHub)	❌ فقط whitelist tools/*.py	❌ فقط التجزئات المحلية + VT MCP	❌ whitelist صارم عبر AST	أقصى عزل لعمليات البناء العامة
extended_static	❌ فقط whitelist tools/*.py	✅ OSINT سلبي + وثائق HTTPS	❌ whitelist صارم عبر AST	تحليل ساكن آمن مع إثراء عبر الشبكة
full_local	✅ PowerShell كامل للتحليل الساكن	✅ OSINT سلبي كامل + وثائق HTTPS	✅ --unrestricted-imports + --allow-network	جهاز تحليل مخصص / حاسوب شخصي
custom	يُضبط عبر ALLOW_POWERSHELL=0|1	ALLOW_INTERNET=0|1 + ORCHESTRATOR_INTERNET=0|1	ALLOW_UNRESTRICTED_SCRIPTS=0|1	تركيبة فردية

تبديل الملف التعريفي بأمر واحد (يحافظ على أسرارك TG_* في .env ويزامن opencode.json المحلي / إعدادات الأتمتة):