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`를 통해 검색 가능합니다. 에이전트는 항상 지식 기반을 먼저 확인하여 "제로 웨이스트 리콘" 정책을 강제합니다.
오프라인 준비	필요한 모든 바이너리(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 바이너리에서 클라이언트 측 인증 검사를 빠르게 검증해야 하는 보안 감사 담당자.
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 토큰 예산을 관리하고 자기 복구 실행 루프를 제공합니다.