Gepetto

Gepetto 是一个 Python 插件，它利用多种大型语言模型为 IDA Pro（≥ 7.6）反编译后的函数赋予语义。它可以借助这些模型来解释函数的功能，并自动重命名其变量。以下是一个简单的示例，展示了它能在短短几秒钟内提供的结果：

安装

使用 hcli（推荐）

安装 Gepetto 最简单的方式是使用 Hex-Rays CLI 工具 (hcli)：

pip install ida-hcli
hcli plugin install gepetto

这会自动将插件安装到你的 IDA 用户目录中。

手动安装

你也可以手动安装插件：

1. 将此脚本（gepetto.py 以及 gepetto/ 文件夹）放入你的 IDA 插件目录（$IDAUSR/plugins）。
2. 插件目录的位置取决于你的操作系统：
   • Windows：%APPDATA%\Hex-Rays\IDA Pro\plugins\
   • macOS：~/Library/Application Support/IDA Pro/plugins/
   • Linux：~/.idapro/plugins/
3. 在 IDA 的 Python 环境中安装所需的包。你可以通过检查以下注册表项来确定 IDA 使用的解释器： Computer\HKEY_CURRENT_USER\Software\Hex-Rays\IDA（Windows 默认路径：%LOCALAPPDATA%\Programs\Python\Python39）。
4. 使用相应的解释器运行：

   [/path/to/python] -m pip install -r requirements.txt
   

⚠️ 你还需要编辑配置文件（位于 gepetto/config.ini），并添加你自己的 API 密钥。对于 OpenAI，可以在 这个页面 找到 API 密钥。请注意，API 查询通常不是免费的（尽管费用不高），你需要向相应的提供商设置支付方式。

支持的模型

• OpenAI
  • gpt-5
  • gpt-5-mini
  • gpt-5-nano
  • gpt-4-turbo
  • gpt-4o
  • o4-mini
  • gpt-4.1
  • o3
  • o3-pro
• Google Gemini
  • gemini-2.0-flash
  • gemini-2.5-pro
  • gemini-2.5-flash
  • gemini-2.5-flash-lite-preview-06-17
• Azure OpenAI
  • gpt-35-turbo
  • gpt-35-turbo-1106
  • gpt-35-turbo-16k
  • gpt-4-turbo
  • gpt-4-turbo-2024-0409-gs
• Ollama
  • 任何通过 Ollama 暴露的本地模型（如果 Ollama 未运行，则不会显示）
• Groq
  • llama-3.1-70b-versatile
  • llama-3.2-90b-text-preview
  • mixtral-8x7b-32768
• Together
  • mistralai/Mixtral-8x22B-Instruct-v0.1（不支持重命名变量）
• Novita AI
  • deepseek/deepseek-r1
  • deepseek/deepseek-v3
  • meta-llama/llama-3.3-70b-instruct
  • meta-llama/llama-3.1-70b-instruct
  • meta-llama/llama-3.1-405b-instruct
• Kluster.ai
  • deepseek-ai/DeepSeek-R1
  • deepseek-ai/DeepSeek-V3-0324
  • google/gemma-3-27b-it
  • klusterai/Meta-Llama-3.1-8B-Instruct-Turbo
  • klusterai/Meta-Llama-3.1-405B-Instruct-Turbo
  • klusterai/Meta-Llama-3.3-70B-Instruct-Turbo
  • meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8
  • meta-llama/Llama-4-Scout-17B-16E-Instruct
  • Qwen/Qwen2.5-VL-7B-Instruct
• LM Studio
  • 任何通过 LM Studio 暴露的本地模型（如果 LM Studio Developer 服务器未运行，则不会显示）

只要你考虑的提供商提供与 OpenAI 类似的 API，添加对其他模型的支持应该并不困难。可以参考 gepetto/models 文件夹获取灵感，或者如果你无法解决，可以直接提交问题。

使用方法

插件正确安装后，你应该能够在 IDA 的伪代码窗口的上下文菜单中调用它，如下图所示：

你可以在“编辑 > Gepetto”菜单中切换 Gepetto 支持的模型：

Gepetto 还提供了一个命令行界面，你可以在 IDA 中直接向 LLM 提问。请确保在输入栏中选择“Gepetto”：

快捷键

以下是可用的快捷键：

• 请求模型解释函数：Ctrl + Alt + G
• 请求模型为代码添加注释：Ctrl + Alt + K
• 请求为函数的变量生成更好的名称：Ctrl + Alt + R

初步测试表明，先请求函数解释后再请求更好的变量名效果更好——我推测这是因为模型会利用其自身的注释来提出更准确的建议。AI 的回复带有一定的随机性。如果初次得到的响应不符合你的期望，你可以随时再次执行该命令。

限制

• 该插件需要访问 HexRays 反编译器才能正常工作。
• 所有支持的 LLM 都是通用型模型，可能会出错！务必对返回的结果保持批判性思维！

翻译

你可以通过编辑配置中的 locale 来更改 Gepetto 的语言。例如，要以法语使用该插件，只需添加：

[Gepetto]
LANGUAGE = "fr_FR"

所选的 locale 必须与 gepetto/locales 中的文件夹名称匹配。如果所需的语言尚未提供，你可以通过自行添加来为项目贡献力量！为所需的语言创建一个新的文件夹（例如：gepetto/locales/de_DE/LC_MESSAGES/），然后提交包含更新后的 .po 文件的新拉取请求。你可以通过复制并编辑 gepetto/locales/gepetto.pot 来创建 .po 文件（将所有以 msgstr 开头的行替换为本地化版本）。

致谢

• OpenAI，显然感谢他们提供了这些令人惊叹的模型。
• Hex Rays——IDA 的开发者，感谢他们迅速的支持。
• 卡巴斯基，最初资助了该项目。
• HarfangLab——目前的支持者，使这项工作成为可能。
• @vanhauser-thc，通过他的 fork 贡献了更多模型和提供商的想法。
• 所有贡献翻译的人员：@seifreed、@kot-igor、@ruzgarkanar、@orangetw。

Gepetto 快速上手指南

Gepetto 是一款专为 IDA Pro (≥ 7.6) 设计的 Python 插件，利用大语言模型（LLM）自动解释反编译函数的功能并重命名变量，显著提升逆向分析效率。

环境准备

• 操作系统：Windows, macOS, 或 Linux
• 核心软件：IDA Pro 7.6 或更高版本（必须安装 HexRays 反编译器）
• Python 环境：需与 IDA Pro 使用的 Python 解释器版本一致
  • 查看方法：检查注册表 Computer\HKEY_CURRENT_USER\Software\Hex-Rays\IDA (Windows) 或在 IDA 输出窗口查看启动信息。
• API 密钥：需准备至少一个支持的 LLM 提供商 API Key（如 OpenAI, Google Gemini, Groq, Novita AI 等）。
  • 注意：大多数模型调用会产生费用，请确保账户已绑定支付方式。

安装步骤

方法一：使用 hcli 工具（推荐）

这是最简便的安装方式，会自动处理依赖和路径。

pip install ida-hcli
hcli plugin install gepetto

方法二：手动安装

1. 复制文件：将 gepetto.py 文件和 gepetto/ 文件夹复制到 IDA 的插件目录：

   • Windows: %APPDATA%\Hex-Rays\IDA Pro\plugins\
   • macOS: ~/Library/Application Support/IDA Pro/plugins/
   • Linux: ~/.idapro/plugins/

2. 安装依赖：使用 IDA 对应的 Python 解释器安装所需包。

   [/path/to/ida/python] -m pip install -r requirements.txt
   

   (注：请将 [/path/to/ida/python] 替换为实际的 Python 路径，国内用户可添加 -i https://pypi.tuna.tsinghua.edu.cn/simple 加速下载)

3. 配置 API Key： 编辑 gepetto/config.ini 文件，填入你的 API 密钥。例如配置 OpenAI：

   [OpenAI]
   API_KEY = sk-your-api-key-here
   

   支持模型包括 OpenAI (gpt-4o 等), Google Gemini, Azure, Ollama (本地), Groq, Novita AI 等，具体请参考配置文件中的模型列表。

基本使用

安装并配置完成后，重启 IDA Pro。

1. 切换模型

在 IDA 菜单栏选择 Edit > Gepetto，从列表中选择你想要使用的 LLM 模型。

2. 功能快捷键

在 IDA 的伪代码窗口（Pseudocode window）中选中任意函数，使用以下快捷键：

• 解释函数功能：Ctrl + Alt + G
  • 建议先执行此操作，有助于后续重命名更准确。
• 自动添加代码注释：Ctrl + Alt + K
• 智能重命名变量：Ctrl + Alt + R

3. CLI 交互模式

你也可以直接在 IDA 底部的输入框中选择 Gepetto 作为上下文，直接向模型提问关于当前函数的具体问题。

提示：AI 生成的结果具有随机性。如果对首次结果不满意，可再次运行相同命令获取新的建议。请务必对 AI 生成的代码逻辑保持批判性验证。