newliver666/apk-reverse

해결하는 문제

이 프로젝트는 Android APK 역공학을 위한 포괄적인 기능 세트를 제공합니다. AI 에이전트가 앱의 불필요한 기능 제거, 광고 제거, DEX 파일 패치, APK 재패키징, 런타임 또는 서버 측 동작 분석과 같은 작업을 수행할 수 있도록 합니다. 특히 역공학 과정에서 흔히 발생하는 실패 요인, 예를 들어 서버 측 결제 장벽 우회, 하드ened/패킹된 대상 처리, 패치된 빌드가 기능적이고 안정적인지 보장하는 점에 초점을 맞춥니다.

작동 방식

이 프로젝트는 튜토리얼이 아니라 AI 에이전트(Claude Code 또는 Codex 등)가 로드할 수 있는 "에이전트 스킬"로 설계되었습니다. 구조화된 접근 방식을 통해 에이전트가 과정을 안내합니다:

• 절차적 안내: SKILL.md 파일은 "게이트"(통과 기준)와 "오버라이드 규칙"을 갖춘 절차로 작동하여 에이전트가 환상이나 반복적인 실수를 하지 않도록 합니다.
• 요청 시 참조 자료: references/ 디렉터리 내의 상세한 기술 가이드는 특정 단계에서 필요할 때만 로드됩니다.
• 파라미터화된 스크립트: scripts/ 디렉터리 내의 대량의 Python 및 JavaScript 스크립트는 바이트 수준 패치, DEX 읽기, Frida 기반 런타임 탐지, APK 재패키징 등 무거운 작업을 처리합니다.
• 환경 검증: doctor.py 스크립트를 먼저 실행하여 도구 가용성 및 환경 건강 상태(예: 시계 오차, ADB 연결성)를 확인하여 측정 오염을 방지합니다.

대상 사용자

이 스킬셋은 스킬 로드 허브를 갖춘 AI 에이전트뿐 아니라, Android 애플리케이션 분석 및 수정에 필요한 전문 도구와 방법론을 제공하고자 하는 개발자 또는 보안 연구자에게 적합합니다.

주요 특징

• 외과적 패치: 앱의 안정성을 해치지 않도록 동일 길이의 바이트 수정을 지원하며, 더 복잡한 변경을 위한 DEX 레벨 리라이터도 제공합니다.
• 하드ened 대상 지원: 패커 식별 및 언패킹, 코드 가상화 처리, 프로세스를 의도적으로 중단시키는 네이티브 라이브러리 무력화 도구를 포함합니다.
• 런타임 분석: 네트워크 계층 분석 및 메모리 매핑을 위한 통합된 Frida 프로브를 통해 실제로 실행되는 내용을 확인할 수 있습니다.
• Dart AOT 지원: 리터럴 복구 및 Dart AOT 스냅샷 디어셈블링에 특화된 도구를 제공합니다.
• 안정성 검사: 패치된 APK가 실제로 작동하는지 확인하기 위한 "클레임 래더"와 검증 단계를 포함하여, 빌드는 성공했지만 런타임에서 실패하는 "성공한 빌드"를 방지합니다.