Regenerator 2000

Commodore 8ビットマシン向けのモダンでインタラクティブな6502逆アセンブラ。Regeneratorの現代版です。

• 🕹️ 手動解析 — 高速でキーボード中心のTUIによる実践的な探索：コードのナビゲート、データの定義、サブルーチンのラベル付け、コメントの追加、そして反復的な逆アセンブリの洗練が可能。
• 🤖 自動解析 — 組み込みのMCP サーバーにより、AIアシスタントがプログラム的に逆アセンブラを操作。専用スキルと組み合わせることで、プログラム全体を解析 — ブロックの分類、ルーチンの追跡、シンボルの命名 — し、人間の介入を最小限に抑えます。

どちらかのワークフローを単独で使用するか、組み合わせることも可能：AIに最初のパスを任せ、その後に対話的に結果を洗練。

例をチェックして、さまざまなCommodoreプラットフォームで逆アセンブルされたゲームを実際にご覧ください。

特徴

Regenerator 2000は、6502逆アセンブリにモダンな便利機能をもたらします：

• 逆アセンブリ: 未定義オペコードを含む完全な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階層の値→名前マッピング（システム、グローバル、プロジェクト固有）を定義・適用し、逆アセンブリやデータ内のマジックナンバーを意味的名称に置き換え。
  • コメント: サイドコメントとラインブロックコメントの追加。
  • オリジン: バイナリのロードアドレス/オリジンの変更。
  • データ型: 領域を Code、Byte、Word、Address、Lo/Hi Address、Hi/Lo Address、Lo/Hi Word、Hi/Lo Word、PETSCII Text、Screencode Text、External File、または Undefined に変換。
  • 元に戻す/やり直し: すべての操作に対して完全な履歴サポート。
• ナビゲーション:
  • ジャンプ: 特定のアドレス、特定の行番号、またはオペランドへ移動。
  • クロスリファレンス: ラベル/アドレスのクロスリファレンスを調査。
  • 履歴: 以前の位置に戻る。
• カスタマイズ:
  • ドキュメント設定の構成（最大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: すべてのアセンブラでエクスポートのラウンドトリップ（エクスポート→アセンブル→差分）を検証。--headlessを暗黙的に指定

対応ファイル形式：.prg、.crt、.d64、.d71、.d81、.t64、.vsf、6502bench (.dis65)、.bin、.raw、.regen2000proj。

キーボードショートカット

すべてのキーボードショートカットはこちらに文書化されています：keyboard_shortcuts

サポートとドキュメント

• ドキュメント
• 例：逆アセンブルされたCommodoreゲームやソフトウェアのショーケース。様々なサポートプラットフォームでRegenerator 2000で何ができるかを示しています。
• Discordでのサポート（#regenerator2000チャンネルに参加、「Misc Projects」の下）

貢献

貢献は大歓迎です！お気軽にプルリクエストを送信してください。

謝辞

• Regenerator：オリジナルのWindows用6502逆アセンブラ。
• unp64：iAN CooGによるC64バイナリアンパッカー。アンパッカーモジュールのベースとなっています。
• 64tass、ACME、Kick Assembler、ca65：対応アセンブラ。

ライセンス

デュアルライセンス：MIT および Apache 2