如何用IDAssist智能重命名让IDA伪代码瞬间可读:Actions标签页使用教程
如何用IDAssist智能重命名让IDA伪代码瞬间可读:Actions标签页使用教程
还在对着 sub_401000、v1、a3 这样的默认符号头疼吗?IDAssist 是一款面向 IDA Pro 的 AI 逆向工程插件,其中的 Actions 标签页 正是解决"符号不可读"这一痛点的利器:它调用 LLM(如 Claude、GPT、Ollama 本地模型)分析当前函数,批量提出函数重命名、变量重命名、类型修正乃至结构体创建的建议,并给出 0.0~1.0 的置信度评分——你只需勾选、应用,伪代码就能瞬间变得可读。
Actions 标签页能做什么?
Actions 标签页位于 IDA 内嵌的 IDAssist 面板中(快捷键 Ctrl+Shift+A 打开)。它的核心工作流只有三步:分析 → 审阅 → 应用。
支持四种建议类型:
| 操作类型 | 说明 |
|---|---|
| Rename Function | 为当前函数建议一个有意义的名称(基于函数行为、调用的 API、字符串引用和调用上下文) |
| Rename Variable | 为局部变量和参数建议名称,在 Hex-Rays 伪代码下效果最佳 |
| Retype Variable | 建议更准确的类型,例如把 int 改为 HANDLE、char * 改为 const wchar_t * |
| Auto Create Struct | 分析字段访问模式,自动提议结构体定义,解决"重复偏移访问"问题 |
💡 变量重命名和结构体创建依赖 Hex-Rays 反编译器;没有 Hex-Rays 时 IDAssist 会自动回退到反汇编分析。
一键安装:先让 Actions 跑起来
Actions 标签页复用 IDAssist 全局的 LLM 配置,因此使用前需完成两件事:
- 安装插件:推荐通过 IDA 插件管理器执行
hcli plugin install idassist,也可手动解压到~/.idapro/plugins/并用 IDA 自带 Python 安装 requirements.txt 中的依赖。 - 配置 LLM 提供商:进入 Settings 标签页,点击 Add 添加一个提供商(本地免费的 Ollama 最适合入门),保存后设为 Active Provider,并点击 Test 验证连接。
完整的安装与配置步骤可参考官方入门指南:docs/getting-started.md。
五步完成智能重命名
第 1 步:定位目标函数
在 IDA 的反汇编视图或伪代码视图中,把光标移到想要重命名的函数上。Actions 标签页顶部的 Current Offset 会自动显示该函数的地址——这是分析入口,位置不对建议就不会对。
第 2 步:勾选需要的建议类型
在表格下方的可用操作列表(Available Actions)中,勾选你希望 LLM 提出的建议类型。比如只想改函数名,就只勾 Rename Function;想彻底整理符号,可把 Rename Variable 也勾上。
第 3 步:点击 Analyse Function
点击底部的 Analyse Function 按钮后,IDAssist 会把当前函数的伪代码(或反汇编)连同勾选的操作类型一起发送给 LLM,建议结果随即填充进上方的 Proposed Actions 表格。
第 4 步:审阅建议——关注置信度
表格共五列,逐列解读:
| 列名 | 用途 |
|---|---|
| Select | 复选框,决定这条建议是否随"应用"写入 IDB |
| Action | 操作类型(rename_function / rename_variable / retype_variable / create_struct) |
| Description | 人类可读的变更描述,双击可直接编辑——觉得名字不够好?改完再应用 |
| Status | 状态:Pending / Applying... / Applied / Error,用颜色区分(绿=成功,红=失败) |
| Confidence | 模型置信度(0.0~1.0),分数越高越可信 |
✅ 小技巧:对置信度低于 0.8 的建议保持警惕,先结合 Explain 标签页理解函数行为再决定是否采纳;对高置信度的批量勾选即可。
第 5 步:点击 Apply Actions 写入 IDB
确认勾选后点击 Apply Actions,选中的变更在后台线程逐条应用到 IDB:函数重命名通过 IDA 的 set_name() 生效,变量重命名调用 rename_lvar(),全部 IDA 修改都会通过 execute_on_main_thread() 在主线程安全执行。应用完成后,Status 列会变为绿色 Applied 或红色 Error,伪代码视图中的符号立即更新。
不满意?点击 Clear 清空整个建议表格,重新分析即可。
最佳实践:先解释,后重命名
单独使用 Actions 标签页已经足够高效,但以下组合能让效果翻倍:
- 先 Explain 再 Actions:先用 Explain 标签页生成函数解释(含安全分析面板),确认对函数行为有把握后再让它起名字,命名质量会显著提升。
- 用 Query 追问:对某个改名拿不准?切到 Query 标签页,用
#func上下文宏插入当前函数伪代码,直接问"这个函数为什么应该叫 X?"。 - 从入口函数开始:像文档化二进制一样,从 main、导出函数等入口出发,逐个函数"解释 + 重命名",符号表会随进度越来越可读。
常见问题(FAQ)
Q:点击 Analyse Function 后没有响应? 到 Settings 标签页对当前 Active Provider 点击 Test,检查 URL、API Key 与模型名;本地 Ollama 需确认服务已启动。
Q:Rename Variable / Auto Create Struct 不可用? 这两类操作需要 Hex-Rays 反编译器。请确认你的 IDA 已授权并加载了对应架构的 Hex-Rays;无 Hex-Rays 时函数重命名仍可用。
Q:应用失败(Status 显示 Error)怎么办? 查看 IDA 的 Output 窗口日志定位原因;通常是同名冲突或地址无效,编辑 Description 或改用建议后重试。
Q:数据保存在哪里?
所有分析数据本地存储在 ~/.idapro/idassist/ 下的 SQLite 数据库中,不会上传任何代码。
延伸阅读
- Actions 标签页完整参考:UI 元素、状态颜色与操作类型详解
- Actions 界面源码:表格、按钮与信号定义
- Actions 控制器源码:后台应用线程与执行流程
- Actions 服务源码:建议应用与 IDA API 封装
- Getting Started 指南:安装、提供商配置与首次分析
- Explain 工作流:先解释后重命名的完整流程



