
Enigma 是一个受 Ghidra 分析流水线启发的原生 C++ 逆向工程引擎。它提供了检查、反汇编、分析和反编译可执行二进制文件所需的核心能力,其架构旨在让这些能力既能被人类分析师使用,也能被 AI 代理使用。
传统的逆向工程工作流往往要求分析师操作 GUI、逐条检查指令、跟踪引用并手动串联发现。Enigma 的方向有所不同:将底层分析能力暴露出来,使代理能够执行有针对性的调查、在整个程序中追踪证据并报告其发现——同时人类可以检查并指导这项工作。
Enigma 是一个分析引擎,而不是 LLM,也不仅仅是一组提示词集合。其分析由原生工具执行;AI 代理则围绕这些能力提供推理与编排。
SHA-256 校验与源文件完全一致: "4D0AC76047ADA91AF8ADECE92D151D691CF6661C384FDB4C690EB0B20D6D6CEB"
Enigma 的加载流水线支持多种可执行文件和目标文件格式:
.gzf、.gbf 和 .rep该引擎维护一个程序模型,其中包含内存、指令、函数、符号、引用、数据类型、重定位及相关分析状态。
分析能力包括:
Enigma 包含一个与 Qt 无关的控制流模型以及一个函数图视图。
术语说明: 函数图表示函数内部的控制流。它不同于程序范围的调用图,后者表示函数之间的调用者/被调用者关系。
Enigma 集成了 Ghidra 的原生 C++ 反编译器库,并围绕它提供了原生 C++ 程序模型。
可用功能包括类 C 反编译、类型信息、函数签名、符号、注释以及分析过程中使用的其他程序元数据。
Qt 6 界面为该引擎提供了人工检查环境:
GUI 只是检查和引导分析的一种方式;它并不是引擎本身的定义。
Enigma 正围绕面向智能体的工作流进行开发。目标是让 AI 智能体将逆向工程能力作为具体操作来使用,而不是模仿人类在桌面应用程序中点击操作。
智能体辅助的调查可以按如下方式组织:
该仓库包含面向智能体的说明。智能体可用的具体操作取决于已安装的 Enigma 构建中存在的工具和接口。请查阅仓库当前的智能体说明以及每个工具的帮助输出;除非构建明确提供,否则不要假设存在单独的 MCP 服务器或动态插件接口。
flowchart TD
A[Executable or project] --> B[Binary loader / project importer]
B --> C[Native program model]
C --> D[Disassembly and P-code]
D --> E[Automatic analysis]
E --> F[Functions, symbols, types, references]
F --> G[Control-flow model]
F --> H[Decompiler]
G --> I[Function Graph]
C --> J[Project storage]
D --> K[Agent-facing tools and workflows]
E --> K
G --> K
H --> K
F --> K
K --> L[AI agent orchestration]
I --> M[Human inspection through Qt GUI]
H --> M
D --> M
Enigma 在部分场景中使用了选定的 Ghidra 技术,以提供项目所需的底层处理器与反编译功能。其外围的程序模型、分析流水线、存储层、加载器以及 Qt 界面均由 Enigma 原生实现。
| 组件 | 来源 |
|---|---|
| 原生反编译器库 | Ghidra C++ 反编译器 |
| SLEIGH 处理器规范 | Ghidra |
| 程序模型 | 原生 Enigma C++ 实现 |
| 内存、符号、引用与数据类型系统 | 原生 Enigma C++ 实现 |
| 分析流水线 | 原生 Enigma C++ 实现 |
| 二进制加载 | 原生 Enigma 实现 |
| 项目存储 | 原生 Enigma 实现 |
| 桌面界面 | 原生 Qt 6 实现 |
flatcgit clone https://github.com/BunnyBuzz/Enigma.git
cd Enigma/Enigma-Engine
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DENABLE_GUI=ON
cmake --build build
ctest --test-dir build --output-on-failure
依赖可用性和编译器配置可能因平台而异。请参阅仓库的构建脚本和项目文档,以了解当前开发环境所使用的确切配置。
Enigma 正在积极开发中。原生分析流水线、反编译器集成、项目存储和 Qt 界面均已实现,Function Graph 也已添加并在开发工作流中完成验证。
在 Function Graph 工作的最新报告验证节点:
在 PatchMemory 所有权路径中单独发现了一个先前存在的应用程序拆卸期间堆损坏问题。功能检查在拆卸之前完成;关闭问题不应被解读为 Function Graph 失败。请查看当前问题跟踪器和 PLAN/PROGRESS.md 以了解后续状态。
PLAN/ — 项目计划、进度和技术设计说明Enigma-Engine/ — 引擎、GUI、工具和测试Enigma 根据 Apache License 2.0 许可。第三方组件仍受其各自许可证的约束。