DebuggerJ++

Depurador / desassemblador com GUI para análise de malware em executáveis de 32 e 64 bits, no estilo OllyDbg / x64dbg. Pensado para dissecar vírus e malware com fins defensivos: criar assinaturas de antivírus/antimalware, entender o comportamento e limpar equipamentos.

⚠️ Analise amostras sempre em uma máquina virtual isolada / sandbox, sem rede, com snapshots. Executar um binário sob o depurador executa seu código.

Características (v0.2)

Abrir .exe / .dll / .sys e análise completa do PE (32/64 bits, entrypoint, seções, imports, exports, entropia).
Janela CPU: desmontagem (Zydis) do código, com realce de call/jmp/ret, destino dos saltos, guias visuais de fluxo para jmp/jz/jnz/etc. e a instrução atual quando você está pausado. O menu de contexto Jump To abre o destino do salto.
Breakpoints de software (0xCC), hardware (DR0–DR3, execução/escrita/leitura-escrita), por exceção e de memória mediante PAGE_GUARD (acesso, escrita ou execução). Inclui lista, rótulos, ativação/desativação, condições de registradores/hits, ações de apenas log e breakpoints de eventos (threads/DLL). Os de memória são configurados pausado e trabalham por páginas, assim como a técnica usada pelo OllyDbg.
Controles: Play (iniciar / continuar), Pause, Step Into (F7), Step Over (F8), Step To Ret, Rewind (navegação de histórico), Stop e reinício da sessão.
Registradores (x64: RAX..R15/RIP/EFLAGS; x86: EAX..EIP) ao pausar, com edição direta.
Memória: dump hex + mapa de regiões (VirtualQueryEx) com permissões, tipo e módulo; salto rápido para RSP, leitura/escrita, montagem com Keystone e patch/NOP.
Strings & busca: extração de strings ASCII/UTF-16 e busca de padrões hex com curingas (48 8B ?? C3) ou texto, em arquivo ou em memória viva.
Módulos & símbolos: seções, imports/exports do PE, TLS callbacks, cadeia SEH x86, DLLs carregadas em runtime, resolução de símbolos com DbgHelp e fonte/linha quando há PDB.
Navegação e traços: referências a código/dados, pilha de chamadas, run trace, funções candidatas, xrefs/loops/bookmarks persistentes, anotações (comentários/rótulos) e saltos para um endereço ou módulo/DLL. Um duplo clique sobre um módulo abre seu código na CPU.
Cache de análise: strings, detecções de packer e anotações são salvos em cache/ junto ao debugger. São reutilizados ao reabrir um arquivo e são invalidados se mudarem seu tamanho, data de modificação ou o mínimo de comprimento de strings.
Sessões e relatórios: sessões .dbgjsession com anotações e breakpoints; exportação de relatório Markdown com objetivo, seções, detecções, estado e breakpoints.
Packers: detecção por assinaturas (set embutido + signatures/userdb.txt estilo PEiD) e heurística de entropia / seções suspeitas.
Unpacking assistido: busca de OEP, dump memory-aligned, resolução e reconstrução experimental de IAT, e opções anti-anti-debug para análise controlada.
Painel de IA multiagente: Anthropic/Claude, ChatGPT/OpenAI, DeepSeek, Gemini, Grok, Mistral, Groq, OpenRouter, Ollama e LM Studio. O chat pode incluir automaticamente registradores, pilha e desmontagem atual.
Tools para IA: ao habilitar Permitir control del debugger (tools), o agente pode consultar ou controlar a sessão: abrir/iniciar/reiniciar, continuar ou pausar, dar passos, ler memória e registradores, desmontar, buscar, definir breakpoints, navegar para DLLs, aplicar patch e executar as demais operações expostas pelo debugger.
Janela Code: transforma uma rotina em pseudocódigo C++ explicativo usando a desmontagem, memória, símbolos e módulos. É uma interpretação para análise, não uma recuperação literal do código-fonte.
MCP: servidor local compatível com ferramentas MCP para que um agente externo controle o DebuggerJ++. Consulte mcp/README.md.
Plugins extensíveis: manifestos JSON e DLLs nativas x64 opcionais em plugins/ adicionam ações à UI e tools dinâmicas ao MCP. As DLLs só são carregadas quando o usuário ativa expressamente a opção e devem ser confiáveis. Consulte docs/PLUGINS.md.
Interface configurável: painéis separáveis, visibilidade persistente, mosaico e layouts personalizados estilo OllyDbg/x64dbg.

Compilar (Windows)

Só compila em Windows com MSVC porque usa a Windows Debug API, DbgHelp, Direct3D 11 e WinHTTP.

Instale Visual Studio 2022 com Desenvolvimento para Desktop com C++, CMake 3.20+ e Git.
Dê um duplo clique em build.bat (ou a partir de um x64 Native Tools Command Prompt):
```
build.bat
```
CMake baixará sozinho (FetchContent) Zydis, Dear ImGui e nlohmann/json.
Execute build\Release\DebuggerJ++.exe como Administrador (para poder depurar).

Uso rápido

Arquivo → Abrir .exe. Preenche-se a CPU, as seções, as strings e a varredura de packers.
Coloque um breakpoint no EntryPoint (painel Breakpoints) e pressione Play (lançar).
O processo para no breakpoint do loader; dê Play novamente para chegar ao seu breakpoint. A partir daí use Step Into / Step Over, inspecione Registros e Memória, busque strings e pergunte ao agente de IA sobre o ASM.
Em Window → Code, use Usar RIP e Interpretar como C++ para obter uma explicação da rotina atual.

Agentes de IA e API keys

Configure os agentes em Tools → Options → AI. Na primeira inicialização, são detectadas, se existirem, as variáveis ANTHROPIC_API_KEY e OPENAI_API_KEY; você também pode colar uma chave no formulário de um agente. O ChatGPT/OpenAI é oferecido como o preset ChatGPT (OpenAI).

As credenciais são salvas apenas em ai_config.json junto ao executável para o uso local da aplicação. Não envie esse arquivo nem arquivos .env para o repositório: eles já estão excluídos pelo .gitignore.

Para permitir que o agente atue, selecione um provedor/modelo compatível com function calling e habilite Permitir controle do debugger (tools) na janela IA. A janela Code limita o agente a ferramentas de consulta para não alterar o processo.

Arquitetura

Ver docs/ARQUITECTURA.md.

Licença

O DebuggerJ++ é distribuído sob a GNU General Public License v3.0 ou posterior (GPL-3.0-or-later). Você pode usá-lo, estudá-lo, modificá-lo e redistribuí-lo sob esses termos. As dependências de terceiros mantêm seus próprios avisos e licenças.

Limitações e próximas melhorias

É uma base funcional para análise defensiva. Áreas previstas para uma próxima versão:

Condições avançadas expressas como regras/expressões para breakpoints.
Anexar a processos já em execução, rastreamento de processos filhos e melhor controle de threads.
Símbolos PDB mais completos, informações de fonte e stack walking robusto quando não há frame pointers.
Persistência completa de sessões, exportação de relatórios e uma visualização de grafo de fluxo de controle.
Validações adicionais para operações de modificação e melhorias ao reconstruir a IAT.

Mais Populares

DebuggerJ-