Regenerator 2000
Un moderno disassemblatore 6502 interattivo per macchine Commodore a 8 bit. Una rivisitazione moderna di Regenerator.
- 🕹️ Analisi manuale — Una TUI veloce e incentrata sulla tastiera per l'esplorazione pratica: naviga il codice, definisci i dati, etichetta le subroutine, aggiungi commenti e perfeziona iterativamente il disassemblato.
- 🤖 Analisi automatizzata — Un server MCP integrato permette agli assistenti AI di guidare il disassemblatore in modo programmatico. Abbinato a competenze appositamente create, può analizzare interi programmi — classificando blocchi, tracciando routine e nominando simboli — con un intervento umano minimo.
Usa uno dei due flussi di lavoro da solo, o combinali: lascia che l'AI faccia un primo passaggio, poi perfeziona i risultati in modo interattivo.
Dai un'occhiata agli Esempi per vedere cosa si può ottenere, con giochi pre-disassemblati su diverse piattaforme Commodore!
Caratteristiche
Regenerator 2000 porta comodità moderne al disassemblaggio 6502:
- Disassemblaggio: Supporto completo 6502 inclusi opcode non documentati.
- Hex Dump:
- Vista affiancata con il disassemblato.
- Navigazione sincronizzata o indipendente.
- Charset PETSCII e Screencode non shiftato e shiftato.
- Sprite:
- Vista affiancata con il disassemblato.
- Multicolore o Monocromatico.
- Bitmap:
- Vista affiancata con il disassemblato.
- Alta risoluzione (320x200) e Multicolore (160x200).
- Utilizza il rendering a blocchi di quadranti per la piena risoluzione nella TUI.
- Charset:
- Vista affiancata con il disassemblato.
- Multicolore o Monocromatico.
- Blocchi:
- Vista affiancata con il disassemblato.
- Debugger: Connettiti a VICE per disassemblaggio in tempo reale, breakpoint, esecuzione/passo (F2–F9); pannello Debugger nel pannello destro.
- Mappa minima: Mappa in miniatura del file analizzato.
- Sistemi: Supporta macchine Commodore a 8 bit: C64, C128, VIC-20, Plus/4, PET 4.0, PET 2.0 e 1541.
- Importa: Carica i seguenti formati di file:
- PRG: file PRG
- CRT: immagini di cartuccia con supporto selezione bancale
- D64: immagini disco 35/40/42 tracce
- D71: immagini disco 70/80 tracce fronte-retro
- D81: immagini disco 80 tracce
- T64: immagini nastro
- VSF: file sessione VICE
- RAW / BIN: file binari grezzi
- DIS65: file progetto 6502bench
- REGEN2000PROJ: file progetto Regenerator 2000
- Spacchettatore binario: Emula un sandbox 6502 ciclicamente accurato per decomprimere automaticamente programmi C64 compressi.
- Esporta in .asm o HTML. Assembler supportati:
- 64tass
- ACME
- Kick Assembler
- ca65
- Gestione progetti: Salva e carica il tuo lavoro.
- Analisi: Analisi automatica per identificare aree di codice e dati.
- Modifica:
- Etichette: Aggiungi, modifica e rimuovi etichette locali e globali.
- Enum: Definisci e applica mappature valore-nome a tre livelli (Sistema, Globale, Specifico del progetto) per sostituire i numeri magici nel disassemblato e nei dati con nomi semantici.
- Commenti: Aggiungi commenti laterali e commenti di riga.
- Origine: Cambia l'indirizzo di caricamento/origine del binario.
- Tipi di dato: Converti regioni in Codice, Byte, Word, Indirizzo, Indirizzo Lo/Hi, Indirizzo Hi/Lo, Word Lo/Hi, Word Hi/Lo, Testo PETSCII, Testo Screencode, File Esterno o Indefinito.
- Annulla/Ripeti: Cronologia completa per tutte le azioni.
- Navigazione:
- Salta: Vai a indirizzi specifici, numeri di riga specifici, o segui gli operand.
- X-Ref: Ispeziona i riferimenti incrociati per etichette/indirizzi.
- Cronologia: Torna alle posizioni precedenti.
- Personalizzazione:
- Configura le impostazioni del documento (max x-ref, sistema, assembler).
- Opzioni di visualizzazione personalizzabili (mostra/nascondi tutte le etichette, ecc.).
- TUI:
- Interfaccia utente testuale.
- Tutto può essere fatto dalla tastiera.
- Modalità Visuale: Selezione simile a Vim per operazioni batch.
- Server MCP:
- Supporto server Model Context Protocol (MCP) per accesso programmatico.
- Modalità di trasporto HTTP e stdio.
- Strumenti per la manipolazione del disassemblato, ricerca in memoria, operazioni sui blocchi.
- Risorse per accedere ai dati binari e alle viste.
- Competenze di analisi integrate che automatizzano la classificazione dei blocchi, il tracciamento delle routine e la denominazione dei simboli.
- Veloce:
Requisiti
Terminali consigliati
Per garantire la migliore esperienza, specialmente per quanto riguarda scorciatoie da tastiera e rendering, consigliamo di utilizzare un terminale moderno.
| Piattaforma | Terminali consigliati |
|---|
| Windows | Windows Terminal, Alacritty, WezTerm |
| macOS | iTerm2, Ghostty, Alacritty, kitty, WezTerm |
| Linux | Ghostty, Alacritty, kitty, WezTerm, GNOME Terminal |
Installazione
Da Crates.io
cargo install regenerator2000
Dal codice sorgente
git clone https://github.com/ricardoquesada/regenerator2000.git
cd regenerator2000
cargo install --path .
Avvio rapido con agenti AI
Per iniziare rapidamente ad analizzare binari utilizzando un agente AI (come Antigravity o Claude Code), puoi utilizzare il repository regenerator2000-template. È preconfigurato con tutte le competenze e le autorizzazioni dell'agente necessarie, così puoi iniziare immediatamente ad analizzare e fare reverse engineering dei binari.
Utilizzo
Avvia l'applicazione con un file opzionale da caricare:
regenerator2000 [OPZIONI] [percorso/del/file.prg]
Opzioni CLI
ricardoquesada/regenerator2000
