IDAssist

由AI驱动的IDA Pro逆向工程插件

作者: Jason Tang

描述

IDAssist 是一个 IDA Pro 插件，将基于 LLM 的分析直接集成到 IDA 的界面中，通过可配置的 LLM 提供程序、语义知识图谱、RAG 文档搜索提供 AI 辅助的二进制逆向工程，并支持多种 LLM 提供程序。

IDAssist 使用 Python 和 PySide6 构建，作为 IDA Pro 9.0+ 中的一个可停靠面板运行，并与 LLM 提供程序（OpenAI, Anthropic, Ollama, LiteLLM 等）通信，用于分析函数、建议重命名、回答有关代码的问题，以及构建整个二进制文件的可搜索知识图谱。

核心功能

函数解释 — 生成反编译函数的详细自然语言解释，并自动进行安全分析，包括风险级别、活动概况、安全标志和 API 检测。

交互式查询聊天 — 询问关于二进制文件的问题，并保留持久化聊天历史。使用上下文宏（#func、#addr、#line、#range）将函数代码、地址或反汇编范围注入到查询中。

自动化操作 — 由AI驱动的函数、变量和类型重命名建议。在带有置信度分数的表格中查看提议的更改，然后选择性地将操作应用到 IDB。

语义知识图谱 — 构建和探索二进制文件的函数、调用关系、数据流和安全特征的知识图谱。包括可视化图形渲染、语义搜索和社区检测。

RAG 文档搜索 — 上传参考文档（.txt、.md、.rst、.pdf），并在 LLM 查询期间将其作为上下文使用。支持通过 Whoosh 索引进行混合文本+向量搜索。

SymGraph 集成 — 推送和拉取函数名称、变量名称、类型和图数据到 SymGraph 协作平台。包含带有冲突解决的多步向导。

设置管理 — 配置多个 LLM 和 MCP 提供程序，管理 SymGraph API 凭据，自定义系统提示词，以及设置数据库路径。

高级功能

ReAct 代理

查询选项卡支持自主 ReAct（推理+行动）代理模式。启用后，LLM 规划调查策略，执行工具收集信息，反思发现结果，并综合给出全面答案——所有步骤自动跨多个推理轮次进行。

扩展思考

配置推理努力级别以控制 LLM 在响应前的“思考”程度：

MCP 集成

IDAssist 可以连接到外部 MCP 服务器，实现工具增强的 LLM 交互，使模型能够在推理过程中以编程方式检查函数、读取反汇编、查询交叉引用和修改 IDB。支持基于 URL 的 MCP 服务器（SSE 或 Streamable HTTP）以及从本地 CLI 命令启动的 stdio 型 MCP 服务器。IDAssist 还提供内置内部工具用于函数调用，无需外部 MCP 服务器。

函数调用

支持工具调用的 LLM 提供程序可以在对话过程中调用 IDA 分析函数，实现无需手动干预的迭代调查。

RLHF 反馈

对解释和查询响应提供赞/踩反馈。反馈信息本地存储，可用于改进提示词工程和模型选择。

架构

IDAssist 遵循 MVC（模型-视图-控制器）模式：

• 视图 (src/views/) — PySide6 选项卡控件，在用户交互时发出信号
• 控制器 (src/controllers/) — 将视图信号连接到服务调用，管理状态
• 服务 (src/services/) — 业务逻辑、LLM 提供程序、数据库访问、图分析
• 内部工具 (src/services/internal_tools.py) — 用于 LLM 函数调用的 IDA 特定工具定义
• 图工具 (src/services/graphrag/graphrag_tools.py) — 用于 LLM 交互的语义图读写工具

主要设计原则：

• 所有 IDA API 调用通过 execute_on_main_thread() 在主线程执行
• LLM 响应增量地流式传输到 UI
• 本地 SQLite 数据库用于持久化（无需外部数据库）
• 带有线程安全初始化的单例服务注册表

快速开始

1. 安装插件（推荐 — IDA 插件管理器）：

   root@kitploit:~

   hcli plugin install idassist
   

   这会自动将插件及其 Python 依赖项安装到 IDA 的环境中。

2. 或手动安装（从发布压缩包）：

   从 GitHub Releases 下载最新的发布 zip 文件，并将其解压到您的 IDA 插件目录中：

   Linux / macOS:

   root@kitploit:~

   unzip IDAssist-*.zip -d ~/.idapro/plugins/
   

   Windows: 将 zip 文件解压到 %APPDATA%\Hex-Rays\IDA Pro\plugins\。

   然后使用 IDA 自带的 Python（而不是系统 Python）安装依赖项：

   Linux / macOS:

   root@kitploit:~

   <IDA_INSTALL_DIR>/python3/bin/pip3 install -r ~/.idapro/plugins/IDAssist/requirements.txt
   

   Windows:

   root@kitploit:~

   "<IDA_INSTALL_DIR>\python3\python.exe" -m pip install -r "%APPDATA%\Hex-Rays\IDA Pro\plugins\IDAssist\requirements.txt"
   

   将 <IDA_INSTALL_DIR> 替换为您的 IDA Pro 安装路径（例如 /opt/idapro-9.0 或 C:\Program Files\IDA Pro 9.0）。

   您也可以设置 环境变量指向一个包含 子目录的自定义目录。

有关详细安装说明，请参阅开始使用。

LLM 提供程序设置

IDAssist 支持以下提供程序类型：

推荐模型

使用语义图

语义图选项卡提供二进制文件的知识图谱：

1. 重新索引二进制文件 — 提取函数结构、调用图和交叉引用
2. 语义分析 — 为每个函数生成 LLM 摘要
3. 安全分析 — 检测漏洞模式和安全相关 API
4. 网络流 — 跟踪调用图上的网络操作
5. 社区检测 — 将相关函数分组为模块

通过列表视图（调用者、被调用者、边、标志）、可视化图（交互式节点图，支持 N 跳扩展）或搜索（7 种查询类型，包括语义搜索、相似函数和调用上下文）来探索图形。

右键菜单操作

在任意反汇编或伪代码视图中右键单击即可访问：

系统要求

• IDA Pro 9.0+ 带有 Python 3 和 PySide6
• Hex-Rays 反编译器（推荐用于伪代码功能）
• requirements.txt 中列出的 Python 包

文档

• 文档索引
• 开始使用
• 选项卡参考：解释 | 查询 | 操作 | 语义图 | RAG | 设置
• 工作流：解释 | 查询 | 语义图

主页

https://symgraph.ai

许可证

详情请参阅 LICENSE 文件。