demcstify: LLM 에이전트를 활용한 마인크래프트 소스 코드 복구 연구 프로젝트

섹션별 상세

기존 디컴파일러는 제네릭 오류나 제어 흐름 왜곡 등 원본과 다른 코드를 생성하는 한계가 있습니다. demcstify는 Vineflower의 출력을 단순한 초안으로 취급하고, LLM 에이전트가 이를 수정하여 원본 바이트코드와 100% 일치하는 소스를 만드는 것을 목표로 합니다.

근거

Vineflower 출력물은 권위 있는 소스가 아닌 수리해야 할 초안에 불과하다. — The Core Idea 섹션의 'The decompiler is priming, not truth' 문구

멀티 에이전트 시스템은 역할 분담을 통해 효율적으로 작동합니다. decompiler, compiler_fixer, bytecode_aligner, verifier, librarian으로 역할을 나누어 소스 수정부터 최종 검증까지의 워크플로우를 자동화합니다.

SQLite 데이터베이스인 progress.db가 시스템의 중앙 제어 장치 역할을 수행합니다. 에이전트들은 SQL 트랜잭션을 통해 작업 큐를 점유함으로써 파일 시스템 락 없이도 병렬로 작업을 처리하고 진행 상황을 기록합니다.

근거

SQLite는 에이전트 간의 동시성 제어와 감사(audit)의 핵심이다. — Why SQLite Is Central 섹션

복구 품질은 두 가지 티어로 정의됩니다. Tier A는 원본 바이트코드와 1바이트까지 동일한 상태를 의미하며, Tier B는 의미론적으로는 동일하지만 컴파일러 아티팩트 차이를 허용하는 수준을 뜻합니다.

근거

Tier A는 원본 JAR와 바이트 단위로 동일한 상태를 의미한다. — Equality Tiers 표

법적 경계 준수를 위해 저장소에는 마인크래프트의 실제 코드나 자산이 포함되지 않습니다. 사용자가 직접 제공한 JAR 파일을 로컬에서만 처리하며, 결과물 역시 로컬 장치에만 저장되도록 설계되었습니다.

기술

Vineflower
Gradle
SQLite
LLM
Java
Node.js

활용 사례

레거시 소프트웨어 소스 코드 복구
디컴파일러 출력 최적화
자동화된 버그 수정 및 컴파일 에러 해결

언급된 리소스

GitHubremill