DebuggerJ++

マルウェア解析向けのGUI付きデバッガ / 逆アセンブラ。32ビットおよび64ビットの実行ファイルに対応し、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。
• Strings & 検索：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 の検索、メモリアライメント ダンプ、IAT の解決と 実験的な再構築、および制御された解析のためのアンチアンチデバッグオプション。
• マルチエージェント AI パネル：Anthropic/Claude、ChatGPT/OpenAI、DeepSeek、Gemini、Grok、 Mistral、Groq、OpenRouter、Ollama、LM Studio。チャットには現在の レジスタ、スタック、逆アセンブルを自動的に含めることができる。
• AI 用ツール：Permitir control del debugger (tools) を有効にすると、エージェントは セッションを照会または制御できる：開く/起動/再起動、続行または一時停止、ステップ実行、 メモリとレジスタの読み取り、逆アセンブル、検索、ブレークポイントの設定、DLL へのナビゲーション、 パッチ適用、およびデバッガーが公開するその他の操作の実行。
• Code ウィンドウ：逆アセンブル、メモリ、シンボル、モジュールを用いて、ルーチンを説明的な C++ 擬似コードに変換する。これは解析のための解釈であり、 ソースコードの逐語的な復元ではない。
• MCP：MCP 対応ツールと互換性のあるローカルサーバーで、外部エージェントが DebuggerJ++ を制御できる。mcp/README.md を参照。
• 拡張可能なプラグイン：plugins/ 内の JSON マニフェストとオプションのネイティブ x64 DLL が UI にアクションを追加し、MCP に動的ツールを追加する。DLL はユーザーが 明示的にオプションを有効にした場合にのみロードされ、信頼できるものでなければならない。docs/PLUGINS.md を参照。
• 設定可能なインターフェース：分離可能なパネル、永続的な表示状態、タイル表示、および OllyDbg/x64dbg スタイルのカスタムレイアウト。

ビルド (Windows)

Windows の MSVC でのみコンパイルできます。Windows Debug API、DbgHelp、Direct3D 11、WinHTTP を使用しているためです。

1. Visual Studio 2022 を 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、セクション、文字列、パッカー検出スキャンが読み込まれます。
2. EntryPoint にブレークポイントを設定し（ブレークポイントパネル）、**Play（起動）**を押します。
3. プロセスはローダーのブレークポイントで停止します。もう一度 Play を押して 自分のブレークポイントに到達します。そこから Step Into / Step Over を使い、レジスタや メモリを検査し、文字列を検索し、AI エージェントに ASM について質問できます。
4. 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 ウィンドウで **デバッガーの制御を許可（ツール）**を有効にします。Code ウィンドウでは、 プロセスを変更しないよう、エージェントは照会ツールに制限されます。

アーキテクチャ

docs/ARQUITECTURA.md を参照してください。

ライセンス

DebuggerJ++ は GNU General Public License v3.0 以降 （GPL-3.0-or-later）の下で配布されます。これらの条件の下で、使用、研究、変更、再配布が 可能です。サードパーティの依存関係は、それぞれ独自の通知とライセンスを保持します。

制限事項と今後の改善

これは防御的分析のための機能的な基盤です。次のバージョンで予定されている領域：

• ブレークポイント用のルール/式として表現される高度な条件。
• 実行中のプロセスへのアタッチ、子プロセスの追跡、スレッド制御の改善。
• より完全な PDB シンボル、ソース情報、フレームポインタがない場合の堅牢なスタックウォーキング。
• セッションの完全な永続化、レポートのエクスポート、制御フローグラフビュー。
• 変更操作のための追加の検証と、IAT 再構築の改善。