dewolf插件安装与使用指南

dewolf插件安装与使用指南

dewolf A research decompiler implemented as a Binary Ninja plugin. 项目地址: https://gitcode.com/gh_mirrors/de/dewolf

1. 项目目录结构及介绍

dewolf是一款以Binary Ninja为基础的反编译插件，旨在提供研究级别的代码重构能力。以下是其主要的目录结构及关键文件介绍：

• LICENSE: 项目使用的许可协议，遵循LGPL-2.1。
• Makefile: 用于构建项目的自动化脚本。
• README.md: 项目的主要说明文件，包含了安装步骤、使用方法和配置详情。
• decompiler: 包含核心反编译逻辑的Python源码文件夹。
  • __init__.py: 初始化模块。
  • decompile.py: 反编译主逻辑实现。
• config.json: 示例配置文件，用于说明可自定义的配置项（可通过GUI或CLI方式调整）。
• requirements.txt: Python依赖列表，确保项目运行所需的库版本。
• binja_plugin_setup.sh (未在引用中显示，假设存在): 可能存在的脚本来设置Binary Ninja插件环境。
• dockerignore, gitignore, pytest.ini等: 保持版本控制整洁的相关配置文件。

2. 项目的启动文件介绍

GUI使用

在成功配置插件后，无需直接操作特定的“启动文件”。您只需通过Binary Ninja界面进行操作：

• 启动Binary Ninja。
• 导入您想要分析的二进制文件。
• 在工具菜单(Tools)下找到dewolf decompiler选项来启用插件功能，之后，当前活跃符号的反编译结果将显示在一个新的面板中。

命令行使用

对于命令行模式，启动文件实际上是脚本decompile.py，位于项目根目录下。使用方法如下：

python decompile.py <路径/到/二进制文件>

您可以通过添加函数名作为第二个参数来指定反编译特定函数，或者使用命令行参数进行更细致的控制。

3. 项目的配置文件介绍

配置dewolf可以通过两种方式进行：

GUI配置

• 进入Binary Ninja的偏好设置(Edit > Preferences > Settings)。
• 使用搜索框输入dewolf快速定位相关设置。
• 直接在GUI中修改配置，但请注意这些配置仅适用于通过GUI启动的情况，并不覆盖CLI设置。

CLI配置与配置文件

• 对于命令行模式或需要高级配置的情况，可以在项目根目录创建一个名为config.json的文件。

• 此文件应采用JSON格式，示例如：

  {
      "expression-propagation": {
          "maximum_instruction_complexity": 5
      }
  }
  

  上述配置仅是示例，实际配置项更为丰富，可在decompiler/util/default.json查找所有可用配置。

• 通过这种方式配置后，无论是GUI还是CLI启动，都会应用该配置文件中的设定。

以上就是基于dewolf项目的简要安装与使用指南，确保遵循正确步骤来最大化利用此工具的功能。

dewolf A research decompiler implemented as a Binary Ninja plugin. 项目地址: https://gitcode.com/gh_mirrors/de/dewolf