Skip to content
KitploitKITPLOIT
工具漏洞利用博客
Log in
提交
工具漏洞利用博客
提交

黑客、渗透测试和网络安全工具,武装您的安全武器库!

Kitploit 是一个黑客、网络安全和渗透测试工具的目录。发现最新的项目更新,查找漏洞、分析系统、自动化测试并加强你的安全。

订阅源联系隐私© 2026 Kitploit

工具目录

分类

查看所有分类
Loading categories
工具/GitHubGitHub/nautilusbits/retrokit
静态分析逆向工程脚本与自动化恶意软件分析实用工具与框架二进制分析AI 辅助逆向
GitHubnautilusbits/retrokit

retrokit

用于逆向工程 32 位 DOS 和 Win32 游戏(1993-2010)的无头 Ghidra 工具包:自带 LE/LX 加载器、Watcom 调用约定、库签名、MCP 服务器

查看仓库
51410722天前Kitploit 审核通过
分享

retro-kit – 逆向工程老游戏(无头 Ghidra)

单独使用 Ghidra 与 retro-kit 对比:通过 COM 虚表调用 DirectDraw

一套使用无头 Ghidra 反编译约 1993–2010 年间 32 位游戏的工具包:

  • DOS LE/LX(DOS/4GW、DOS/32A、PMODE/W、CauseWay、DOS/4G bind;也包括 OS/2 LX 和 VxD) 由 Watcom C/C++ 构建 – 自带用于 Ghidra 的 LE/LX 加载器,以及针对两种调用约定的 Watcom 编译器规格。
  • Win32 PE(通常为 MSVC):通过 COM 虚表调用的 DirectX 调用会显示其方法名, Miles/Smacker/Bink/FMOD/BASS 导入会被标注类型,从 MSVC RTTI 恢复 C++ 类, 从 Rich header 获取编译器版本。

输出是一个工作区,其中包含一个大型 .c 文件,容纳所有函数以及各类索引 (函数、调用图、字符串、修正/指针表、导入),你可以用 grep 检索,并在人员或 AI 代理之间拆分。 分析过程中发现的名称会回写到 Ghidra,并重新生成导出。

安装

前置条件:Ghidra 12.x (已解压)、JDK 21+(JAVA_HOME)、Python 3.10+。

pipx install git+https://github.com/nemo22/retrokit   # or from a checkout: pip install .  (or python -m retrokit)
retrokit doctor                                    # checks Python, Ghidra, Java, loader, cspecs
retrokit install-loader                            # once per Ghidra install (DOS LE/LX only)

Ghidra 可通过 --ghidra DIR、$GHIDRA_INSTALL_DIR,或位于游戏或工具包旁边的 ghidra/ghidra_* 目录找到。install-loader 使用 javac 针对该 Ghidra 编译加载器(无需 Gradle),将其安装到 Ghidra/Extensions 并注册 Watcom 编译器规格;更新 Ghidra 后需再次运行(doctor 会提示你何时需要)。

使用

retrokit info GAME.EXE              # format, DOS extender, compiler, calling convention
retrokit analyze GAME.EXE           # full pipeline -> GAME_analysis/  (-o DIR to choose)
retrokit show GAME_analysis FUN_00012345 main
retrokit tables GAME_analysis       # function-pointer and string tables (from fixups)
retrokit names GAME_analysis        # apply notes/names_*.csv, re-export
retrokit reexport GAME_analysis     # re-run the fix-up passes + export without re-importing

analyze 会检测格式、加载器,以及(对于 Watcom)调用约定 (--cspec watcom|watcomreg 可覆盖该检测结果),并将它们存入 GAME_analysis/retrokit.json; 后续命令只需该工作区。一个工作区:

GAME_analysis/
  retrokit.json        how the binary was analysed
  decomp/              <exe>_decompiled.c, functions.csv (addr,name,size,callers,callees,cc,signature),
                       calls.txt, strings.txt, data_symbols.txt, memory_blocks.txt,
                       fixups.txt (source -> target of every pointer: the key to pointer tables
                       and to which function uses which string), imports.txt (PE)
  notes/               findings, names_<topic>.csv proposals
  ghidra_project/      the Ghidra project (open it in the Ghidra GUI too)
  logs/

AI 代理:retrokit mcp GAME_analysis 是一个基于工作区的 MCP 服务器(stdio,无需额外软件包):函数、反编译代码、调用图、交叉引用、字符串、指针表、反汇编和字节、库;它记录名称提议和注释,并可以应用这些名称重新导出(按需,在后台进行)。Claude Code:

claude mcp add retrokit -- retrokit mcp /path/to/GAME_analysis

其他客户端的设置、每个工具以及 agent 应如何工作:docs/MCP.md; 面向 agent 的简短版本见 AGENTS.md。

命名:将命名建议写入 notes/names_<topic>.csv(addr,name,confidence,comment,confidence 为 V 表示已验证或 G 表示猜测);retrokit names WS 会重命名函数/标签(V 优先于 G, 冲突时加上 _<addr>)并重新导出。

流水线的作用:

  • 库(两种格式):retrokit libs(也是 info 和 analyze 的一部分 -> notes/libraries.md)可识别约 20 个该时期的库——Miles/AIL、HMI SOS、DIGPAK、 Smacker、Bink、FMOD、BASS、DirectX、zlib、libjpeg、libpng、PKWARE DCL、Lua 等——依据 字符串、导入和数据文件,并附带版本、其格式说明和移植提示。 库代码通过签名查找(随附:Watcom C/C++ 运行时、来自 Open Watcom 的数学和 C++ 库、 zlib 1.0.4-1.2.3、libjpeg 6b;retrokit sigs build 从你拥有的库中生成它们,sigs learn 从你已识别的函数中生成)——先精确匹配,再匹配来自其他编译器版本的相似代码——然后命名, 并根据 retrokit/knowledge/*.h 赋予类型。
  • LE/LX:使用 LE 加载器和 Watcom cspec 导入,在指向代码的 fixup 目标处创建函数 (Watcom 游戏通过指针表调用其大部分逻辑),switch 跳转表保留在其函数内部,撤销错误的 “无返回”标志,定义短字符串并将字符串字面量显示为 "text",参数数量来自调用点的 ADD ESP,n 清理,原型按被调用者优先的顺序恢复,导出。
  • PE:使用 Ghidra 的 PE 加载器和自动分析导入,然后在指针表目标处以及填充之后创建函数, 直到不再出现新函数,执行相同的字符串 / 参数 / 原型处理,导出。

其他命令:classes(从 RTTI 提取 MSVC C++ 类)、libs(使用中的库)、convert(XMIDI/HMI/HMP -> MIDI,VOC -> WAV, Smacker/Bink/FLIC -> MP4,按内容识别)、sigs match|build|learn(库签名,见 docs/WORKFLOW.md)、 entries(PE:没有函数的代码地址)、modules --rules FILE (PE:通过 assert 路径将函数 → 原始源文件)、strings EXE OUT(无需 Ghidra 的 PE 字符串清单)、 match(将名称转移到相关的 EXE:续作、附加内容、其他版本)、 le EXE info|dump|rec|s16|s32(在 Ghidra 地址处读取 LE 中的表)、rnc(RNC ProPack)、 flic info|png|video(Autodesk FLI/FLC)。选项见 retrokit COMMAND --help。

详细流程、预期结果和已知陷阱见 docs/WORKFLOW.md;MCP 服务器见 docs/MCP.md; AI agent 的任务模板见 docs/AGENT_PROMPTS.md;计划中的工作见 docs/ROADMAP.md; 维护和发布见 docs/MAINTAINING.md。

布局

retrokit/               Python package (CLI: retrokit/cli.py)
  ghidra_scripts/       headless Ghidra scripts used by the pipelines
  tools/                standalone Python tools behind the CLI commands
  le-loader/            LE/LX loader for Ghidra (Java) + Watcom compiler specs (data/languages/)
  sigs/                 library signatures (Open Watcom C run-time)
  knowledge/            libraries.json (library catalog), library prototypes as C headers
scripts/                build_sigs.py: rebuilds the shipped signatures
tests/                  synthetic test programs, scoring against the linker map, baseline
docs/                   WORKFLOW, AGENT_PROMPTS, ROADMAP
Ghidra 脚本用途
CreateFunctionsFromFixups.javaLE:将 32 位 fixup 目标处的函数转换为代码;将代码中的 switch 表转换为代码
CreateFunctionsAtEntries.java在给定地址处创建函数(列表或 @file),可选地从代码间隙中的 fixup 或序言创建
FixTruncatedCallers.java清除导致调用者被截断的错误“无返回”标记
FixAnalysis.java手动修复:noreturn:ADDR、func:ADDR
MarkStringsConstant.java定义短字符串,将可写数据中的字符串标记为 constant(反编译中的字面量)
ApplyLibraryPrototypes.java为具名库函数提供有文档的原型(knowledge/*.h),标记为 LIBRARY
ApplyStackConvention.java根据调用点的 ADD ESP,n 推断参数个数 / __cdecl / 可变参数,根据 RET n 推断 __stdcall
RecoverPrototypes.java从反编译器恢复原型,按调用图层级自底向上进行
ApplyNames.java从 names_*.csv 应用名称
ExportDecompiled.java导出 .c + functions.csv、calls.txt、strings.txt 等
DumpFixups.javaLE fixup / PE 基址重定位 → fixups.txt
DumpImports.javaPE 导入和 IAT 槽位 → imports.txt
DumpFunctions.java仅输出函数列表(在 PE 入口遍历之间)
DumpDisasm.java将函数的反汇编输出到 stdout
EnableDeepAnalysis.java开启慢速分析器(不推荐,参见 WORKFLOW)

测试

tests/ 使用 Open Watcom 构建小型合成程序(仅作为开发/CI 依赖:DOS/4GW、DOS/32A、PMODE/W、DOS/4G bind、OS/2 LX、Win32;栈和寄存器约定),将加载器与每个镜像的独立 Python 模型进行比对,对其运行 retrokit analyze,并根据链接器映射对结果评分(函数地址、参数个数、调用参数、字符串字面量、被截断的函数、反编译器噪声)。参见 tests/README.md。

贡献

欢迎在 GitHub 上提交 issue 和 pull request。主仓库在其他地方维护并镜像到 GitHub,因此 pull request 会在那里合并,并在镜像同步后于 GitHub 上显示为已合并(docs/MAINTAINING.md)。请不要附加游戏文件或反编译的游戏代码;请改为描述该二进制文件(格式、扩展器、编译器、出了什么问题),并在可能的情况下,用类似 tests/ 中的 Open Watcom 小型程序复现它。

制作方式

retro-kit 通过 Claude Code 使用 Claude(Anthropic)开发:大部分代码和文档由 Claude 在维护者的指导下编写,维护者设定范围和设计,在 Windows 和 Linux 上测试,并决定每个版本包含的内容。提交记录将 Claude 列为共同作者。质量通过 tests/ 中的测试语料库进行跟踪:合成程序根据其链接器映射评分,并在 Windows 和 Linux 的 CI 中检查基线。

许可证

Apache License 2.0(LICENSE)。该工具包的早期版本使用了 yetmorecode/ghidra-lx-loader;当前的 加载器(retrokit/le-loader)是一个新的实现。

retro-kit 不包含任何游戏文件,也不包含任何反编译的游戏代码。请仅在你拥有的软件上使用它。

下载工具

最受欢迎

查看全部 →

发现我们社区最常用的工具。

暂无热门数据。

探索所有工具

浏览我们的工具集合

查看所有工具 →