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 전송 모드
  • 디스어셈블리 조작, 메모리 검색, 블록 작업을 위한 도구
  • 바이너리 데이터 및 뷰 접근을 위한 리소스
  • 블록 분류, 루틴 추적, 심볼 이름 지정을 자동화하는 번들 분석 스킬
• 빠름:
  • 매우 빠름

요구 사항

권장 터미널

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

플랫폼	권장 터미널
Windows	Windows Terminal, Alacritty, WezTerm
macOS	iTerm2, Ghostty, Alacritty, kitty, WezTerm
Linux	Ghostty, Alacritty, kitty, WezTerm, GNOME Terminal

설치

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 암시
• --mcp-server: MCP 서버 실행(HTTP, 포트 3000)
• --mcp-server-stdio: stdio를 통해 MCP 서버 실행
• --vice <HOST:PORT>: 시작 시 VICE 바이너리 모니터에 자동 연결 (예: --vice localhost:6502)
• --dump-system-config-files <PATH>: 모든 내장 시스템 설정 파일(system-*.toml)을 지정된 디렉토리에 덤프하고 종료합니다. 시스템 정의를 검사하거나 사용자 정의하는 데 유용합니다.
• --dump-theme-files <PATH>: 모든 내장 테마 파일(theme-*.toml)을 지정된 디렉토리에 덤프하고 종료합니다. 편집 후 설정 디렉토리에 넣어 사용자 정의 테마를 만들 수 있습니다.
• --dump-enum-files <PATH>: 모든 내장 열거형 파일(enum-*.toml)을 지정된 디렉토리에 덤프하고 종료합니다. 편집 후 설정 디렉토리에 넣어 사용자 정의 열거형을 만들 수 있습니다.

지원되는 파일 형식: .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