Regenerator 2000

一款用于 Commodore 8 位计算机的现代化交互式 6502 反汇编器。是对 Regenerator 的现代化重塑。

• 🕹️ 手动分析 — 一个快速、以键盘为中心的 TUI，用于亲手探索：浏览代码、定义数据、标记子程序、添加注释，并迭代优化反汇编结果。
• 🤖 自动分析 — 内置 MCP 服务器，允许 AI 助手以编程方式驱动反汇编器。配合专门的技能，它可以分析整个程序——分类代码块、追踪例程、命名符号——几乎无需人工干预。

可以单独使用任一流程，也可结合使用：让 AI 进行初步分析，然后交互式地优化结果。

查看示例，了解不同 Commodore 平台上预反汇编的游戏成果！

特性

Regenerator 2000 为 6502 反汇编带来了现代便利：

• 反汇编：完整支持 6502，包括未公开操作码。
• 十六进制转储：
  • 与反汇编并列显示。
  • 同步或独立导航。
  • 支持未移位或移位的 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
• 项目管理：保存和加载您的工作。
• 分析：自动分析以识别代码和数据区域。
• 编辑：
  • 标签：添加、编辑和删除局部和全局标签。
  • 枚举：定义并应用三层值到名称的映射（系统级、全局级、项目特定），将反汇编和数据中的魔法数字替换为语义化名称。
  • 注释：添加侧边注释和行注释。
  • 起始地址：更改二进制文件的加载地址/起始地址。
  • 数据类型：将区域转换为代码、字节、字、地址、低/高地址、高/低地址、低/高字、高/低字、PETSCII 文本、屏幕代码文本、外部文件或未定义。
  • 撤销/重做：所有操作的完整历史记录。
• 导航：
  • 跳转：跳转到指定地址、指定行号，或跟随操作数。
  • 交叉引用：检查标签/地址的交叉引用。
  • 历史：返回之前的位置。
• 自定义：
  • 配置文档设置（最大交叉引用数、系统、汇编器）。
  • 可自定义显示选项（显示/隐藏所有标签等）。
• TUI：
  • 文本用户界面
  • 所有操作均可通过键盘完成
  • 可视模式：类似 Vim 的选择模式，用于批处理操作。
• MCP 服务器：
  • 支持模型上下文协议 (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" 下）

贡献

欢迎贡献！请随时提交 Pull Request。

致谢

• Regenerator：适用于 Windows 的原始 6502 反汇编器。
• unp64：由 iAN CooG 开发的 C64 二进制解包器，解包模块基于此实现。
• 64tass、ACME、Kick Assembler、ca65：受支持的汇编器。

许可证

双许可证：MIT 和 Apache 2.0。