angusdevgo/Seep-Reverse-Lab

Agent-Native multi-platform reverse engineering and CWE-602 client-side authorization audit workbench.

Seep Reverse Lab – AI増強型リバースエンジニアリングワークベンチ

何であるか – Seep Reverse Lab は自己完結型でマルチプラットフォーム対応のリバースエンジニアリングスイートであり、英語で自然言語でAI「エージェント」と会話することで、バイナリのプラットフォームを自動認識し、適切なツール（Radare2、JADX、Apktool、Frida、IDA Proなど）を選定し、分析を実行し、PoCパッチまたはフックを生成し、最終的に3部構成のセキュリティ監査レポートを出力します。この全プロセスは、Lab Mode と呼ばれるステートマシンでラップされ、軽量なオーケストレーター softseep によって駆動されます。

コア機能

機能	READMEに記載された動作方法
自然言語による意図	`lab: analyze FooBar.apk — find the premium check and bypass it` のような入力をします。エージェントはリクエストを解析し、プラットフォーム（APK + ARM64）とタスクタイプを分類し、適切なスキルチェーンにジョブをルーティングします。
統合ツールチェーン（23種のMCPツール）	カスタムMCPサーバー（`seep_mcp_server.py`）がRadare2、JADX、Apktool、Frida、IDA Pro、その他のユーティリティのラッパーを公開します。エージェントはこれらのラッパーを呼び出すことで、手動で各ツールを実行する必要がありません。
CWE-602 クライアント側認可監査	ワークフローには「飛行機モード確認」ステップが含まれており、機能ゲートがローカルで制御されているかサーバー側で制御されているかを検証し、簡潔なCWE-602監査を生成します。
コンテキスト・トークン予算制御	特定のコマンド（例：`seep_r2_decompile` で `output_mode=fold` または `summary`）は、LLMに送信されるデータ量を自動的に制限し、トークン使用量を約60〜90％削減します。
自己修復型PoCループ	Fridaスクリプトがクラッシュした場合、エージェントはエラーをマッピングし、スクリプトを修正して再試行（最大3回）し、その後人間に引き渡します。
知識ベース統合	289件のフィールドジャーナルエントリは `seep_kb_search` で検索可能です。エージェントは常にKBを最初に確認し、「ゼロ・ウェイスト・リコン」ポリシーを強制します。
オフライン対応	必要なバイナリ（Radare2、JADXなど）はすべてバンドル済み（約251MB）。ワンクリックインストール後、通常の操作ではネットワークアクセスは不要です。
マルチエージェント対応	事前に作成されたプロンプトファイルにより、Pi Agent、Claude Code、DeepSeek Harness、OpenAI Codex で同じワークフローを実行できます。

アーキテクチャの概要

ユーザーのプロンプト → Lab-Mode ステートマシン（ディスクバックアップフラグ）
    ↓
softseep オーケストレーター
    ├─ プラットフォーム検出（PE / APK / ELF / Web）
    ├─ タスクタイプ分類（9種のパラダイム × 7ゲート決定木）
    └─ 以下のいずれかにルーティング：
        • seep MCP（23種のネイティブツール）
        • IDA-Pro MCPブリッジ（オプション）
        • 知識ベース検索
    ↓
ツール実行（Radare2、JADX、Fridaなど）
    ↓
PoC生成 → サンドボックス実行 → 自己修復ループ
    ↓
飛行機モード確認（CWE-602証明）
    ↓
3部構成のコンサルティングレベルのセキュリティレポート

READMEに掲載された図は同じフローを示しており、モデル切り替え間でもコンテキストを保持する永続的な ~/.pi/agent/lab-mode.flag ファイルがあります。

クイックスタート要約（READMEより）

前提条件 – Windows 10/11 x64（推奨）または Linux/macOS、Python 3.11+、Node 18+、Git。
ワンクリックインストール – setup\install.ps1 を実行する（または check.bat をダブルクリック）。スクリプトはバンドルされたツールを展開し、Python MCPパッケージをインストール、サーバーを登録、35チェックの健全性検証を実行します。
Lab Modeの有効化 – 任意の対応するチャットインターフェースで lab: と自然言語の目標を入力します。
タスクの実行 – 例：lab: analyze FooBar.apk — find the premium check and bypass it。
レポートの取得 – 自動ループが終了後、エージェントは3部構成の監査レポート（脆弱性詳細、再現可能なPoC、修復アドバイス）を返します。

一般的な利用例

Windows、Android、Linuxバイナリでクライアント側認可チェック（CWE-602）を迅速に検証したいセキュリティ監査担当者。
Radare2、JADX、Frida、IDA Proの複数のコマンドラインツールを管理するのではなく、単一のAPI表面を求めるリバースエンジニアリングチーム。
CTFやトレーニングラボで、参加者が戦略に集中できるように、エージェントが低レベルのツール操作とトークン予算管理を処理するケース。
インシデント対応の自動化 – 自己修復型PoCループは、手動で再実行せずに損傷したバイナリにパッチをテストするようにスクリプト化可能。

制限事項と注意点（公開済み）

許可が必要 – リポジトリの免責条項は、分析を実行する前に資産所有者から書面による許可を得ている必要があると強調しています。
モデル拒否対策 – システムは BLOCK_NONE トークンを挿入し、用語マッピングを実行して、LLMがセキュリティ関連リクエストを拒否しないようにしています。これはカスタム対処法であり、すべてのプロバイダーで機能するとは限りません。
ツールライセンス – IDA Proの統合はオプションであり、別途商用ライセンスが必要です。
プラットフォーム対応 – READMEではWindows、Android、Linux、および「Web」をリストアップしていますが、バンドルされたバイナリは主にx86/x64/ARM64向けです。macOS対応は明示的に検証されていません。
自己修復ループ – 最大3回の再試行に制限されており、それ以上はエージェントが人間のオペレーターに引き渡します。

どの人にとって価値があるか？

クライアント側バイナリ監査に再現可能なAI駆動ワークフローを求めるレッドチーム／ペネトレーションテスト会社。
速やかに構造化された監査レポートを出力したいセキュリティコンサルタント。
人気のオープンソースツールへの統合されたエージェントネイティブインターフェースに興味を持つリバースエンジニアリング研究者。

まとめ

Seep Reverse Lab は、豊富なリバースエンジニアリングユーティリティとAIオーケストレーションレイヤーを組み合わせた本格的なオープンソースプロジェクトです。自然言語によるセキュリティリクエストを受けて、適切なツールを選定し、分析を実行し、洗練された監査レポートを出力するエンドツーエンドのプロセスを自動化しています。同時にLLMのトークン予算を管理し、自己修復実行ループを提供しています。