DebuggerJ++

GUI आधारित डीबगर / डिसअसेम्बलर जो 32 और 64 बिट निष्पादन योग्य फ़ाइलों में मैलवेयर विश्लेषण के लिए है, OllyDbg / x64dbg की शैली में। इसे रक्षात्मक उद्देश्यों के लिए वायरस और मैलवेयर का विश्लेषण करने के लिए बनाया गया है: एंटीवायरस/एंटीमैलवेयर हस्ताक्षर बनाना, व्यवहार को समझना और उपकरणों को साफ़ करना।

⚠️ नमूनों का विश्लेषण हमेशा एक पृथक वर्चुअल मशीन / सैंडबॉक्स में करें, बिना नेटवर्क के, स्नैपशॉट के साथ। डीबगर के अंतर्गत बाइनरी चलाने से उसका कोड निष्पादित होता है।

विशेषताएँ (v0.2)

• .exe / .dll / .sys खोलें और PE का पूर्ण पार्सिंग (32/64 बिट, entrypoint, सेक्शन, imports, exports, एंट्रॉपी)।
• CPU विंडो: कोड का डिसअसेम्बली (Zydis), call/jmp/ret के हाइलाइट के साथ, जंप गंतव्य, jmp/jz/jnz/आदि के लिए विज़ुअल फ़्लो गाइड और पॉज़ होने पर वर्तमान निर्देश। संदर्भ मेनू Jump To जंप के गंतव्य को खोलता है।
• Breakpoints: सॉफ़्टवेयर (0xCC), हार्डवेयर (DR0–DR3, निष्पादन/लेखन/पठन-लेखन), अपवाद-आधारित और PAGE_GUARD के माध्यम से मेमोरी (एक्सेस, लेखन या निष्पादन)। इसमें सूची, लेबल, सक्रिय/निष्क्रिय करना, रजिस्टर/hits की शर्तें, केवल-लॉग क्रियाएँ और इवेंट breakpoints (थ्रेड/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 के imports/exports, TLS callbacks, x86 SEH चेन, रनटाइम पर लोड हुई DLLs, DbgHelp के साथ सिंबल रिज़ॉल्यूशन और PDB होने पर स्रोत/पंक्ति।
• नेविगेशन और ट्रेस: कोड/डेटा के संदर्भ, कॉल स्टैक, run trace, संभावित फ़ंक्शन, xrefs/loops/स्थायी bookmarks, एनोटेशन (टिप्पणियाँ/लेबल) और किसी पते या मॉड्यूल/DLL पर जंप। किसी मॉड्यूल पर डबल क्लिक उसका कोड CPU में खोलता है।
• विश्लेषण कैश: strings, packer डिटेक्शन और एनोटेशन डिबगर के साथ cache/ में सहेजे जाते हैं। किसी फ़ाइल को फिर से खोलने पर इन्हें पुनः उपयोग किया जाता है और यदि उसका आकार, संशोधन तिथि या strings की न्यूनतम लंबाई बदल जाए तो ये अमान्य हो जाते हैं।
• सत्र और रिपोर्ट: एनोटेशन और breakpoints के साथ .dbgjsession सत्र; लक्ष्य, सेक्शन, डिटेक्शन, स्थिति और breakpoints के साथ Markdown रिपोर्ट का निर्यात।
• Packers: सिग्नेचर द्वारा डिटेक्शन (एम्बेडेड सेट + PEiD शैली का signatures/userdb.txt) और एंट्रॉपी / संदिग्ध सेक्शन का ह्यूरिस्टिक।
• सहायित Unpacking: OEP की खोज, memory-aligned dump, IAT का रिज़ॉल्यूशन और प्रायोगिक पुनर्निर्माण, और नियंत्रित विश्लेषण के लिए anti-anti-debug विकल्प।
• मल्टीएजेंट AI पैनल: Anthropic/Claude, ChatGPT/OpenAI, DeepSeek, Gemini, Grok, Mistral, Groq, OpenRouter, Ollama और LM Studio। चैट स्वचालित रूप से रजिस्टर, स्टैक और वर्तमान डिसअसेम्बली शामिल कर सकता है।
• AI के लिए Tools: Permitir control del debugger (tools) सक्षम करने पर, एजेंट सत्र को क्वेरी या नियंत्रित कर सकता है: खोलना/लॉन्च करना/पुनः आरंभ करना, जारी रखना या पॉज़ करना, स्टेप करना, मेमोरी और रजिस्टर पढ़ना, डिसअसेम्बल करना, खोजना, breakpoints लगाना, DLLs पर नेविगेट करना, पैच करना और डिबगर द्वारा उजागर की गई अन्य सभी क्रियाएँ निष्पादित करना।
• Code विंडो: डिसअसेम्बली, मेमोरी, सिंबल और मॉड्यूल का उपयोग करके किसी रूटीन को व्याख्यात्मक C++ स्यूडोकोड में बदलती है। यह विश्लेषण के लिए एक व्याख्या है, स्रोत कोड की शाब्दिक पुनर्प्राप्ति नहीं।
• MCP: MCP टूल्स के साथ संगत स्थानीय सर्वर ताकि कोई बाहरी एजेंट DebuggerJ++ को नियंत्रित कर सके। देखें mcp/README.md।
• विस्तार योग्य Plugins: plugins/ में JSON मैनिफ़ेस्ट और वैकल्पिक नेटिव x64 DLLs UI में क्रियाएँ और MCP में गतिशील tools जोड़ते हैं। DLLs केवल तब लोड होती हैं जब उपयोगकर्ता स्पष्ट रूप से विकल्प सक्रिय करता है और वे विश्वसनीय होनी चाहिए। देखें docs/PLUGINS.md।
• कॉन्फ़िगर करने योग्य इंटरफ़ेस: अलग करने योग्य पैनल, स्थायी दृश्यता, मोज़ेक और OllyDbg/x64dbg शैली के कस्टम लेआउट।

कंपाइल करें (Windows)

यह केवल MSVC के साथ Windows पर संकलित होता है क्योंकि यह 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 केवल (FetchContent) Zydis, Dear ImGui और nlohmann/json डाउनलोड करेगा।

3. build\Release\DebuggerJ++.exe को व्यवस्थापक के रूप में चलाएँ (डिबग करने में सक्षम होने के लिए)।

त्वरित उपयोग

1. फ़ाइल → .exe खोलें। CPU, सेक्शन, स्ट्रिंग्स और पैकर स्कैन भर जाता है।
2. EntryPoint पर एक ब्रेकपॉइंट सेट करें (Breakpoints पैनल) और Play (लॉन्च) दबाएँ।
3. प्रक्रिया लोडर के ब्रेकपॉइंट पर रुक जाती है; अपने ब्रेकपॉइंट तक पहुँचने के लिए फिर से Play दबाएँ। वहाँ से Step Into / Step Over का उपयोग करें, रजिस्टर और मेमोरी का निरीक्षण करें, स्ट्रिंग्स खोजें, और ASM के बारे में AI एजेंट से पूछें।
4. Window → Code में, वर्तमान रूटीन का स्पष्टीकरण प्राप्त करने के लिए Usar RIP और Interpretar como C++ का उपयोग करें।

AI एजेंट और API keys

एजेंट को Tools → Options → AI में कॉन्फ़िगर करें। पहला स्टार्टअप, यदि मौजूद हों, तो ANTHROPIC_API_KEY और OPENAI_API_KEY वेरिएबल्स का पता लगाता है; आप किसी एजेंट के फ़ॉर्म में भी एक कुंजी पेस्ट कर सकते हैं। ChatGPT/OpenAI को ChatGPT (OpenAI) प्रीसेट के रूप में प्रस्तुत किया जाता है।

क्रेडेंशियल केवल एप्लिकेशन के स्थानीय उपयोग के लिए निष्पादन योग्य फ़ाइल के साथ ai_config.json में सहेजे जाते हैं। उस फ़ाइल या .env फ़ाइलों को रिपॉज़िटरी में अपलोड न करें: वे पहले से ही .gitignore द्वारा बहिष्कृत हैं।

एजेंट को कार्य करने की अनुमति देने के लिए, function calling के साथ संगत एक प्रदाता/मॉडल चुनें और IA विंडो में Permitir control del debugger (tools) सक्षम करें। Code विंडो एजेंट को केवल क्वेरी टूल्स तक सीमित रखती है ताकि प्रक्रिया में परिवर्तन न हो।

आर्किटेक्चर

docs/ARQUITECTURA.md देखें।

लाइसेंस

DebuggerJ++ GNU General Public License v3.0 या बाद के संस्करण (GPL-3.0-or-later) के अंतर्गत वितरित किया जाता है। आप इसे उन शर्तों के तहत उपयोग, अध्ययन, संशोधित और पुनर्वितरित कर सकते हैं। तृतीय-पक्ष निर्भरताएँ अपने स्वयं के सूचनाएँ और लाइसेंस बनाए रखती हैं।

सीमाएँ और अगले सुधार

यह रक्षात्मक विश्लेषण के लिए एक कार्यात्मक आधार है। अगले संस्करण के लिए नियोजित क्षेत्र:

• ब्रेकपॉइंट के लिए नियमों/अभिव्यक्तियों के रूप में व्यक्त उन्नत शर्तें।
• पहले से चल रही प्रक्रियाओं से अटैच करना, चाइल्ड प्रक्रिया ट्रैकिंग और थ्रेड पर बेहतर नियंत्रण।
• अधिक पूर्ण PDB सिंबल, स्रोत जानकारी और फ्रेम पॉइंटर्स के बिना मजबूत stack walking।
• सत्रों की पूर्ण स्थायित्व, रिपोर्ट निर्यात और एक नियंत्रण प्रवाह ग्राफ़ दृश्य।
• संशोधन संचालन के लिए अतिरिक्त सत्यापन और IAT के पुनर्निर्माण में सुधार।