Regenerator 2000

Commodore 8비트 머신용 모던 인터랙티브 6502 디스어셈블러입니다. Regenerator의 현대적인 재해석입니다.

• 🕹️ 수동 분석 — 키보드 중심의 빠른 TUI로 직접 탐색: 코드 탐색, 데이터 정의, 서브루틴 레이블 지정, 주석 추가, 반복적인 디스어셈블리 개선.
• 🤖 자동 분석 — 내장 MCP 서버로 AI 어시스턴트가 프로그래밍 방식으로 디스어셈블러를 구동할 수 있습니다. 특별히 제작된 스킬과 함께 사용하면 사람의 개입을 최소화하면서 전체 프로그램을 분석하고, 블록을 분류하며, 루틴을 추적하고, 심볼 이름을 지정할 수 있습니다.

두 워크플로를 각각 사용하거나 결합할 수 있습니다. AI가 1차 분석을 수행하고, 그 결과를 대화형으로 다듬으면 됩니다.

Examples를 확인하여 다양한 Commodore 플랫폼에서 미리 디스어셈블된 게임을 통해 무엇을 할 수 있는지 알아보세요!

특징

Regenerator 2000은 6502 디스어셈블리에 현대적인 편의 기능을 제공합니다:

• 디스어셈블리: 미문서화된 opcode를 포함한 완전한 6502 지원.
• 16진 덤프:
  • 디스어셈블리와 나란히 보는 뷰.
  • 동기화 또는 독립 탐색.
  • 언시프트 또는 시프트 PETSCII 및 스크린코드 문자셋.
• 스프라이트:
  • 디스어셈블리와 나란히 보는 뷰.
  • 멀티컬러 또는 단색.
• 비트맵:
  • 디스어셈블리와 나란히 보는 뷰.
  • 고해상도(320x200) 및 멀티컬러(160x200).
  • TUI에서 전체 해상도를 위해 쿼드런트 블록 렌더링 사용.
• 문자셋:
  • 디스어셈블리와 나란히 보는 뷰.
  • 멀티컬러 또는 단색.
• 블록:
  • 디스어셈블리와 나란히 보는 뷰.
• 디버거: VICE에 연결하여 실시간 디스어셈블리, 중단점, 실행/단계 실행(F2–F9); 오른쪽 창에 디버거 패널.
• 미니맵: 분석 중인 파일의 미니맵.
• 시스템: Commodore 8비트 머신 지원: C64, C128, VIC-20, Plus/4, PET 4.0, PET 2.0, 1541.
• 가져오기: 다음 파일 형식 로드
  • PRG: PRG 파일
  • CRT: 뱅크 선택 지원 카트리지 이미지
  • D64: 35/40/42트랙 디스크 이미지
  • D71: 70/80트랙 양면 디스크 이미지
  • D81: 80트랙 디스크 이미지
  • T64: 테이프 이미지
  • VSF: VICE 세션 파일
  • RAW / BIN: 원시 바이너리 파일
  • DIS65: 6502bench 프로젝트 파일
  • REGEN2000PROJ: Regenerator 2000 프로젝트 파일
• 바이너리 언패커: 사이클 정확한 6502 백그라운드 샌드박스를 에뮬레이션하여 압축된 C64 프로그램을 자동으로 해제합니다.
• 내보내기: .asm 또는 HTML로 내보내기. 지원하는 어셈블러:
  • 64tass
  • ACME
  • Kick Assembler
  • ca65
• 프로젝트 관리: 작업 저장 및 로드
• 분석: 코드 및 데이터 영역을 식별하는 자동 분석.
• 편집:
  • 레이블: 로컬 및 전역 레이블 추가, 편집, 제거.
  • 열거형: 3계층 값-이름 매핑(시스템, 전역, 프로젝트별)을 정의하고 적용하여 디스어셈블리 및 데이터의 매직 넘버를 의미 있는 이름으로 대체.
  • 주석: 측면 주석 및 줄 주석 추가.
  • Origin: 바이너리의 로드 주소/origin 변경.
  • 데이터 타입: 영역을 Code, Byte, Word, Address, Lo/Hi Address, Hi/Lo Address, Lo/Hi Word, Hi/Lo Word, PETSCII Text, Screencode Text, External File, 또는 Undefined로 변환.
  • 실행 취소/다시 실행: 모든 작업에 대한 전체 기록 지원.
• 탐색:
  • 이동: 특정 주소, 특정 줄 번호로 이동하거나 operand 따라가기.
  • X-Ref: 레이블/주소에 대한 상호 참조 검사.
  • 히스토리: 이전 위치로 돌아가기.
• 맞춤 설정:
  • 문서 설정 구성(최대 x-ref, 시스템, 어셈블러).
  • 사용자 정의 가능한 표시 옵션(모든 레이블 표시/숨기기 등).
• TUI:
  • 텍스트 사용자 인터페이스
  • 모든 작업을 키보드로 수행 가능
  • 비주얼 모드: Vim 스타일 선택으로 일괄 작업.
• MCP 서버:
  • 프로그래밍 방식 접근을 위한 Model Context Protocol(MCP) 서버 지원
  • HTTP 및 stdio 전송 모드
  • 디스어셈블리 조작, 메모리 검색, 블록 작업을 위한 도구
  • 바이너리 데이터 및 뷰 접근을 위한 리소스
  • 블록 분류, 루틴 추적, 심볼 이름 지정을 자동화하는 번들 분석 스킬
• 빠름:
  • 매우 빠름

요구 사항

권장 터미널

최상의 경험, 특히 키보드 단축키 및 렌더링을 위해 최신 터미널을 권장합니다.

설치

Crates.io에서

cargo install regenerator2000

소스에서

git clone https://github.com/ricardoquesada/regenerator2000.git
cd regenerator2000
cargo install --path .

AI 에이전트로 빠른 시작

AI 에이전트(Antigravity 또는 Claude Code 등)를 사용하여 바이너리 분석을 빠르게 시작하려면 regenerator2000-template 저장소를 사용할 수 있습니다. 필요한 모든 스킬과 에이전트 권한이 미리 구성되어 있어 즉시 바이너리 분석 및 리버스 엔지니어링을 시작할 수 있습니다.

사용법

선택적으로 파일을 로드하여 애플리케이션을 시작합니다:

regenerator2000 [OPTIONS] [path/to/file.prg]

CLI 옵션

• --help: 도움말 메시지 출력
• --version: 버전 정보 출력
• --import_lbl <PATH>: 지정된 파일에서 VICE 레이블 가져오기
• --export_lbl <PATH>: (분석/가져오기 후) 레이블을 지정된 파일로 내보내기
• --export_asm <PATH>: (분석/가져오기 후) 어셈블리를 지정된 파일로 내보내기
• --export_html <PATH>: (분석/가져오기 후) HTML을 지정된 파일로 내보내기
• --assembler <NAME>: 내보내기용 어셈블러 형식 재정의. 유효한 값: 64tass, acme, ca65, kick
• --headless: 헤드리스 모드로 실행(TUI 없음), 배치 처리에 유용
• --verify: 모든 어셈블러에 대해 내보내기 라운드트립(내보내기 → 어셈블 → diff) 확인. --headless 암시

지원되는 파일 형식: .prg, .crt, .d64, .d71, .d81, .t64, .vsf, 6502bench (.dis65), .bin, .raw, .regen2000proj.

키보드 단축키

모든 키보드 단축키는 다음에서 문서화되어 있습니다: keyboard_shortcuts

지원 및 문서

• 문서
• 예제: 디스어셈블된 Commodore 게임 및 소프트웨어 쇼케이스. 다양한 지원 플랫폼에서 Regenerator 2000으로 달성할 수 있는 것을 보여줍니다.
• Discord 지원 (#regenerator2000 채널 참여, "Misc Projects" 섹션)

기여

기여는 환영합니다! 자유롭게 Pull Request를 제출해 주세요.

감사의 말

• Regenerator: Windows용 오리지널 6502 디스어셈블러.
• unp64: iAN CooG의 C64 바이너리 언패커. 언패커 모듈의 기반이 되었습니다.
• 64tass, ACME, Kick Assembler, ca65: 지원되는 어셈블러.

라이선스

이중 라이선스: MIT 및 Apache 2.0