DebuggerJ++

32비트 및 64비트 실행 파일의 악성코드 분석을 위한 GUI 기반 디버거 / 디스어셈블러로, OllyDbg / x64dbg 스타일입니다. 바이러스와 악성코드를 방어적 목적으로 해부하기 위해 설계되었습니다: 안티바이러스/안티멀웨어 시그니처 생성, 동작 이해, 그리고 시스템 정리.

⚠️ 샘플은 항상 격리된 가상 머신 / 샌드박스에서, 네트워크 없이, 스냅샷과 함께 분석하십시오. 디버거에서 바이너리를 실행하면 해당 코드가 실행됩니다.

기능 (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)를 일시 정지 시 표시하며 직접 편집 가능.
메모리: 16진수 덤프 + 권한, 유형, 모듈을 포함한 영역 맵(VirtualQueryEx); RSP로 빠른 점프, 읽기/쓰기, Keystone을 이용한 어셈블 및 패치/NOP.
문자열 & 검색: ASCII/UTF-16 문자열 추출 및 와일드카드가 포함된 16진수 패턴 (48 8B ?? C3) 또는 텍스트 검색, 파일 또는 실행 중인 메모리에서 수행.
모듈 & 심볼: 섹션, PE 임포트/익스포트, TLS 콜백, x86 SEH 체인, 런타임에 로드된 DLL, DbgHelp를 통한 심볼 해석 및 PDB가 있을 경우 소스/라인 정보.
탐색 및 트레이스: 코드/데이터 참조, 호출 스택, run trace, 후보 함수, 영구 xref/루프/북마크, 주석(코멘트/레이블), 주소 또는 모듈/DLL로의 점프. 모듈을 더블 클릭하면 CPU에서 해당 코드가 열립니다.
분석 캐시: 문자열, 패커 탐지 및 주석이 디버거 옆의 cache/에 저장됩니다. 파일을 다시 열 때 재사용되며, 크기, 수정 날짜 또는 최소 문자열 길이가 변경되면 무효화됩니다.
세션 및 보고서: 주석과 브레이크포인트가 포함된 .dbgjsession 세션; 대상, 섹션, 탐지, 상태 및 브레이크포인트를 포함한 Markdown 보고서 내보내기.
패커: 시그니처 기반 탐지(내장 세트 + PEiD 스타일 signatures/userdb.txt) 및 엔트로피/의심스러운 섹션 휴리스틱.
보조 언패킹: OEP 검색, memory-aligned 덤프, IAT 해석 및 실험적 재구성, 그리고 통제된 분석을 위한 안티-안티-디버그 옵션.
멀티에이전트 AI 패널: Anthropic/Claude, ChatGPT/OpenAI, DeepSeek, Gemini, Grok, Mistral, Groq, OpenRouter, Ollama 및 LM Studio. 채팅에 레지스터, 스택 및 현재 디스어셈블리를 자동으로 포함할 수 있습니다.
AI용 Tools: Permitir control del debugger (tools)를 활성화하면 에이전트가 세션을 조회하거나 제어할 수 있습니다: 열기/실행/재시작, 계속 또는 일시 정지, 스텝 실행, 메모리 및 레지스터 읽기, 디스어셈블, 검색, 브레이크포인트 설정, DLL로 탐색, 패치 및 디버거가 노출하는 기타 작업 실행.
Code 창: 디스어셈블, 메모리, 심볼 및 모듈을 사용하여 루틴을 설명적인 C++ 의사코드로 변환합니다. 이는 분석을 위한 해석이며, 소스 코드의 문자 그대로의 복원이 아닙니다.
MCP: 외부 에이전트가 DebuggerJ++를 제어할 수 있도록 MCP 도구와 호환되는 로컬 서버. mcp/README.md를 참조하세요.
확장 가능한 플러그인: plugins/의 JSON 매니페스트 및 선택적 x64 네이티브 DLL이 UI에 액션을 추가하고 MCP에 동적 도구를 추가합니다. DLL은 사용자가 옵션을 명시적으로 활성화한 경우에만 로드되며 신뢰할 수 있는 것이어야 합니다. docs/PLUGINS.md를 참조하세요.
구성 가능한 인터페이스: 분리 가능한 패널, 영구 표시 상태, 타일링 및 OllyDbg/x64dbg 스타일의 사용자 정의 레이아웃.

컴파일 (Windows)

MSVC가 설치된 Windows에서만 컴파일됩니다. Windows Debug API, DbgHelp, Direct3D 11 및 WinHTTP를 사용하기 때문입니다.

Visual Studio 2022를 Desktop development with C++, CMake 3.20+ 및 Git과 함께 설치합니다.
build.bat을 더블 클릭합니다(또는 x64 Native Tools Command Prompt에서 실행).
```
build.bat
```
CMake는 (FetchContent를 통해) Zydis, Dear ImGui, nlohmann/json만 다운로드합니다.
build\Release\DebuggerJ++.exe를 관리자 권한으로 실행합니다(디버깅을 위해서).

빠른 사용법

파일 → .exe 열기. CPU, 섹션, 문자열, 패커 스캔이 채워집니다.
EntryPoint에 브레이크포인트를 설정하고(브레이크포인트 패널) **Play(실행)**를 누릅니다.
프로세스가 로더 브레이크포인트에서 멈추면, Play를 다시 눌러 자신의 브레이크포인트에 도달합니다. 그 지점에서 Step Into / Step Over를 사용하고, 레지스터와 메모리를 검사하고, 문자열을 검색하고, AI 에이전트에게 ASM에 대해 질문합니다.
Window → Code에서 RIP 사용과 C++로 해석을 사용하여 현재 루틴에 대한 설명을 얻습니다.

AI 에이전트 및 API 키

Tools → Options → AI에서 에이전트를 구성합니다. 첫 실행 시 ANTHROPIC_API_KEY와 OPENAI_API_KEY 환경 변수가 존재하면 감지합니다. 에이전트의 양식에 직접 키를 붙여넣을 수도 있습니다. ChatGPT/OpenAI는 ChatGPT (OpenAI) 프리셋으로 제공됩니다.

자격 증명은 애플리케이션의 로컬 사용을 위해 실행 파일 옆의 ai_config.json에만 저장됩니다. 해당 파일이나 .env 파일을 저장소에 업로드하지 마십시오. 이미 .gitignore에 의해 제외되어 있습니다.

에이전트가 작동하도록 허용하려면 function calling을 지원하는 제공자/모델을 선택하고 IA 창에서 **디버거 제어 허용(tools)**을 활성화합니다. Code 창은 프로세스를 변경하지 않도록 에이전트를 조회 도구로 제한합니다.

아키텍처

docs/ARQUITECTURA.md를 참조하십시오.

라이선스

DebuggerJ++는 GNU General Public License v3.0 또는 이후 버전 (GPL-3.0-or-later)에 따라 배포됩니다. 해당 조건에 따라 사용, 연구, 수정 및 재배포할 수 있습니다. 타사 종속성은 자체 고지 및 라이선스를 유지합니다.

제한 사항 및 향후 개선 사항

방어적 분석을 위한 기능적 기반입니다. 다음 버전에서 예정된 영역:

브레이크포인트에 대한 규칙/표현식으로 표현되는 고급 조건.
이미 실행 중인 프로세스에 연결, 자식 프로세스 추적 및 향상된 스레드 제어.
더 완전한 PDB 심볼, 소스 정보, 그리고 프레임 포인터가 없을 때의 견고한 스택 워킹.
전체 세션 지속성, 보고서 내보내기, 제어 흐름 그래프 뷰.
수정 작업에 대한 추가 검증 및 IAT 재구성 개선.

인기

DebuggerJ-