Regenerator 2000

Современный интерактивный дизассемблер 6502 для 8-битных машин Commodore. Современная интерпретация Regenerator.

• 🕹️ Ручной анализ — Быстрый TUI-интерфейс, ориентированный на клавиатуру, для практического исследования: навигация по коду, определение данных, маркировка подпрограмм, добавление комментариев и итеративное улучшение дизассемблирования.
• 🤖 Автоматизированный анализ — Встроенный MCP-сервер позволяет AI-ассистентам управлять дизассемблером программно. В паре со специально разработанными навыками он может анализировать целые программы — классифицировать блоки, отслеживать маршруты и называть символы — с минимальным вмешательством человека.

Используйте любой рабочий процесс по отдельности или комбинируйте их: позвольте AI выполнить первый проход, а затем уточните результаты интерактивно.

Посмотрите Примеры, чтобы увидеть, чего можно достичь; в них представлены предварительно дизассемблированные игры для различных платформ Commodore!

Возможности

Regenerator 2000 привносит современные удобства в дизассемблирование 6502:

• Дизассемблирование: Полная поддержка 6502, включая недокументированные опкоды.
• Hex-дамп:
  • Просмотр рядом с дизассемблированием.
  • Синхронизированная или независимая навигация.
  • Несмещённая или смещённая кодировка PETSCII и Screencode.
• Спрайты:
  • Просмотр рядом с дизассемблированием.
  • Многоцветный или одноцветный.
• Растр:
  • Просмотр рядом с дизассемблированием.
  • Высокое разрешение (320x200) и многоцветный (160x200).
  • Использует рендеринг квадратными блоками для полного разрешения в TUI.
• Charset:
  • Просмотр рядом с дизассемблированием.
  • Многоцветный или одноцветный.
• Блоки:
  • Просмотр рядом с дизассемблированием.
• Отладчик: Подключение к VICE для дизассемблирования в реальном времени, точки останова, запуск/шаг (F2–F9); панель отладчика в правой панели.
• Мини-карта: Мини-карта анализируемого файла.
• Системы: Поддерживает 8-битные машины Commodore: 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
• Управление проектами: Сохраняйте и загружайте свою работу.
• Анализ: Автоматический анализ для определения областей кода и данных.
• Редактирование:
  • : Добавление, редактирование и удаление локальных и глобальных меток.

Требования

Рекомендуемые терминалы

Чтобы обеспечить наилучший опыт, особенно в отношении сочетаний клавиш и рендеринга, мы рекомендуем использовать современный терминал.

Установка

Из 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 [ОПЦИИ] [путь/к/файлу.prg]

Опции командной строки

• --help: Вывести справку
• --version: Вывести информацию о версии
• --import_lbl <ПУТЬ>: Импортировать метки VICE из указанного файла
• --export_lbl <ПУТЬ>: Экспортировать метки в указанный файл (после анализа/импорта)
• --export_asm <ПУТЬ>: Экспортировать ассемблерный код в указанный файл (после анализа/импорта)
• --export_html <ПУТЬ>: Экспортировать HTML в указанный файл (после анализа/импорта)
• --assembler <ИМЯ>: Переопределить формат ассемблера для экспорта. Допустимые значения: 64tass, acme, ca65, kick
• --headless: Запустить в безголовом режиме (без TUI), полезно для пакетной обработки
• --verify: Проверить цикл экспорта (экспорт → ассемблирование → сравнение) для всех ассемблеров. Подразумевает

Поддерживаемые форматы файлов: .prg, .crt, .d64, .d71, .d81, .t64, .vsf, 6502bench (.dis65), .bin, .raw и .regen2000proj.

Сочетания клавиш

Все сочетания клавиш описаны здесь: keyboard_shortcuts

Поддержка и документация

• Documentation
• Examples: Дизассемблированные игры и программное обеспечение Commodore, демонстрирующие, чего можно достичь с помощью Regenerator 2000 на различных поддерживаемых платформах.
• Support in Discord (присоединяйтесь к каналу #regenerator2000, в разделе "Misc Projects")

Участие в разработке

Вклад приветствуется! Не стесняйтесь отправлять Pull Request.

Благодарности

• Regenerator: Оригинальный дизассемблер 6502 для Windows.
• unp64: Распаковщик двоичных файлов C64 от iAN CooG, на котором основан модуль распаковщика.
• 64tass, ACME, Kick Assembler, ca65: Поддерживаемые ассемблеры.

Лицензия

Двойная лицензия: MIT и Apache 2