DebuggerJ++

مُصحِّح / مُفكِّك تجميع بواجهة رسومية لـ تحليل البرمجيات الخبيثة في الملفات التنفيذية 32 و64 بت، على غرار OllyDbg / x64dbg. مُصمَّم لتشريح الفيروسات والبرمجيات الخبيثة لأغراض دفاعية: إنشاء توقيعات مضادات الفيروسات/البرمجيات الخبيثة، وفهم السلوك وتنظيف الأجهزة.

⚠️ حلِّل العينات دائمًا في جهاز افتراضي معزول / صندوق رمل (sandbox)، بدون شبكة، مع لقطات (snapshots). تشغيل ملف ثنائي تحت المُصحِّح يُنفِّذ شيفرته.

الميزات (v0.2)

• فتح .exe / .dll / .sys وتحليل كامل لملف PE (32/64 بت، نقطة الدخول، الأقسام، الاستيرادات، الصادرات، الإنتروبيا).
• نافذة CPU: تفكيك (Zydis) للكود، مع إبراز call/jmp/ret، وجهة القفزات، وأدلة بصرية لتدفق jmp/jz/jnz/إلخ والتعليمة الحالية عند التوقف المؤقت. تفتح قائمة السياق Jump To وجهة القفزة.
• نقاط التوقف البرمجية (0xCC)، والعتادية (DR0–DR3، تنفيذ/كتابة/قراءة-كتابة)، وعبر الاستثناءات، والذاكرية عبر PAGE_GUARD (وصول، كتابة أو تنفيذ). تشمل القائمة، والتسميات، والتفعيل/التعطيل، وشروط السجلات/الإصابات، وإجراءات التسجيل فقط، ونقاط توقف الأحداث (الخيوط/DLL). تُضبط الذاكرية أثناء التوقف المؤقت وتعمل على مستوى الصفحات، تمامًا كالتقنية المستخدمة في OllyDbg.
• عناصر التحكم: Play (تشغيل / متابعة)، Pause، Step Into (F7)، Step Over (F8)، Step To Ret، Rewind (التنقل في السجل)، Stop وإعادة تشغيل الجلسة.
• السجلات (x64: RAX..R15/RIP/EFLAGS؛ x86: EAX..EIP) عند التوقف المؤقت، مع التحرير المباشر.
• الذاكرة: تفريغ سداسي عشري + خريطة المناطق (VirtualQueryEx) مع الأذونات والنوع و الوحدة؛ قفز سريع إلى RSP، قراءة/كتابة، تجميع باستخدام Keystone وتصحيح/NOP.
• Strings & البحث: استخراج سلاسل ASCII/UTF-16 والبحث عن أنماط سداسية عشرية بأحرف بدل (48 8B ?? C3) أو نص، في الملف أو في الذاكرة الحية.
• الوحدات والرموز: الأقسام، استيرادات/صادرات PE، استدعاءات TLS، سلسلة SEH x86، مكتبات DLL المحمّلة وقت التشغيل، حل الرموز باستخدام DbgHelp والمصدر/السطر عند وجود PDB.
• التنقل والتتبعات: مراجع إلى الكود/البيانات، مكدس الاستدعاءات، run trace، الدوال المرشحة، xrefs/loops/bookmarks الدائمة، التعليقات التوضيحية (تعليقات/تسميات) والقفز إلى عنوان أو وحدة/DLL. النقر المزدوج على وحدة يفتح كودها في CPU.
• ذاكرة التحليل المؤقتة: تُحفظ السلاسل واكتشافات الـ packer والتعليقات التوضيحية في cache/ بجوار المصحّح. يُعاد استخدامها عند إعادة فتح ملف وتُبطَل إذا تغيّر حجمه أو تاريخ تعديله أو الحد الأدنى لطول السلاسل.
• الجلسات والتقارير: جلسات .dbgjsession مع التعليقات التوضيحية ونقاط التوقف؛ تصدير تقرير Markdown مع الهدف والأقسام والاكتشافات والحالة ونقاط التوقف.
• Packers: الكشف عبر التوقيعات (مجموعة مضمّنة + signatures/userdb.txt بأسلوب PEiD) واستدلال الإنتروبيا / الأقسام المشبوهة.
• Unpacking بمساعدة: البحث عن OEP، وتفريغ memory-aligned، وحل وإعادة بناء تجريبية لـ IAT، وخيارات مضادة لمضادات التصحيح للتحليل المُتحكَّم به.
• لوحة الذكاء الاصطناعي متعددة الوكلاء: Anthropic/Claude، ChatGPT/OpenAI، DeepSeek، Gemini، Grok، Mistral، Groq، OpenRouter، Ollama و LM Studio. يمكن للدردشة أن تتضمن تلقائيًا السجلات والمكدس والتفكيك الحالي.
• أدوات الذكاء الاصطناعي: عند تفعيل Permitir control del debugger (tools)، يمكن للوكيل الاستعلام عن الجلسة أو التحكم بها: فتح/تشغيل/إعادة تشغيل، متابعة أو إيقاف مؤقت، تنفيذ خطوات، قراءة الذاكرة والسجلات، التفكيك، البحث، وضع نقاط التوقف، التنقل إلى مكتبات DLL، التصحيح وتنفيذ بقية العمليات التي يعرضها المصحّح.
• نافذة Code: تحوّل روتينًا إلى شيفرة زائفة C++ تفسيرية باستخدام التفكيك والذاكرة والرموز والوحدات. إنه تفسير للتحليل، وليس استرجاعًا حرفيًا للشيفرة المصدرية.
• MCP: خادم محلي متوافق مع أدوات MCP ليتمكن وكيل خارجي من التحكم في DebuggerJ++. راجع mcp/README.md.
• إضافات قابلة للتوسيع: بيانات JSON الوصفية ومكتبات DLL أصلية x64 اختيارية في plugins/ تضيف إجراءات إلى واجهة المستخدم وأدوات ديناميكية إلى MCP. لا تُحمَّل مكتبات DLL إلا عندما يفعّل المستخدم الخيار صراحةً ويجب أن تكون موثوقة. راجع docs/PLUGINS.md.
• واجهة قابلة للتخصيص: لوحات قابلة للفصل، ورؤية دائمة، وفسيفساء وتخطيطات مخصصة بأسلوب OllyDbg/x64dbg.

البناء (Windows)

يُجمَّع فقط على Windows باستخدام MSVC لأنه يستخدم Windows Debug API وDbgHelp وDirect3D 11 وWinHTTP.

1. ثبّت Visual Studio 2022 مع Desktop development with C++، وCMake 3.20+ وGit.

2. انقر نقرًا مزدوجًا على build.bat (أو من x64 Native Tools Command Prompt):

   build.bat
   

   CMake سيقوم بتنزيل Zydis وDear ImGui وnlohmann/json فقط (FetchContent).

3. شغّل build\Release\DebuggerJ++.exe كمسؤول (لتتمكن من التصحيح).

الاستخدام السريع

1. ملف → فتح .exe. يتم ملء CPU والأقسام والسلاسل النصية وفحص الـ packers.
2. ضع نقطة توقف عند EntryPoint (لوحة Breakpoints) واضغط Play (تشغيل).
3. تتوقف العملية عند نقطة توقف الـ loader؛ اضغط Play مرة أخرى للوصول إلى نقطة توقفك. من هناك استخدم Step Into / Step Over، وافحص السجلات و الذاكرة، وابحث عن السلاسل النصية، واسأل وكيل الذكاء الاصطناعي عن ASM.
4. في Window → Code، استخدم Usar RIP وInterpretar como C++ للحصول على شرح للروتين الحالي.

وكلاء الذكاء الاصطناعي ومفاتيح API

قم بتكوين الوكلاء في Tools → Options → AI. عند أول تشغيل يتم اكتشاف، إن وُجدت، المتغيرين ANTHROPIC_API_KEY وOPENAI_API_KEY؛ يمكنك أيضًا لصق مفتاح في نموذج أحد الوكلاء. يُقدَّم ChatGPT/OpenAI كإعداد مسبق ChatGPT (OpenAI).

تُحفظ بيانات الاعتماد فقط في ai_config.json بجانب الملف التنفيذي للاستخدام المحلي للتطبيق. لا ترفع ذلك الملف ولا ملفات .env إلى المستودع: فهي مستبعدة بالفعل بواسطة .gitignore.

للسماح للوكيل بالتصرف، اختر مزودًا/نموذجًا متوافقًا مع function calling وفعّل Permitir control del debugger (tools) في نافذة IA. نافذة Code تقيّد الوكيل بأدوات استعلام حتى لا يغيّر العملية.

البنية

انظر docs/ARQUITECTURA.md.

الترخيص

يُوزَّع DebuggerJ++ بموجب GNU General Public License v3.0 أو أحدث (GPL-3.0-or-later). يمكنك استخدامه ودراسته وتعديله وإعادة توزيعه بموجب تلك الشروط. تحتفظ تبعيات الطرف الثالث بإشعاراتها وتراخيصها الخاصة.

القيود والتحسينات التالية

إنها قاعدة وظيفية للتحليل الدفاعي. المجالات المخطط لها في الإصدار التالي:

• شروط متقدمة معبَّر عنها كقواعد/تعبيرات لنقاط التوقف.
• الارتباط بعمليات قيد التشغيل بالفعل، وتتبع العمليات الفرعية وتحكم أفضل في الخيوط.
• رموز PDB أكثر اكتمالًا، ومعلومات المصدر وstack walking قوي عند غياب frame pointers.
• حفظ كامل للجلسات، وتصدير التقارير، وعرض رسم بياني لتدفق التحكم.
• تحققات إضافية لعمليات التعديل وتحسينات عند إعادة بناء IAT.