auto-re-agent 是什么?

auto-re-agent 已更名为 ReAgent。它是 Dryxio 发布的开源逆向工程代理,借助 Ghidra 提取程序信息,再让 Claude、Codex 或 OpenAI 兼容模型生成候选 C/C++ 代码,并用检查器和项目自有验证命令记录证据。

⭐ 736 Stars 🍴 103 Forks Python MIT 作者: Dryxio
来源:github.com/Dryxio/reagent;https://github.com/Dryxio/reagent/blob/main… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

从 Ghidra 获取反编译结果、交叉引用、类型和符号等上下文,再把选定函数交给代理流程。模型生成的候选实现写入报告或覆盖层,检查器给出反馈后可继续修订;原始源码不会被流程直接覆盖。

来源:github.com/Dryxio/reagent/blob/main/README.md;https://github.com/Dryx…

核心功能

Ghidra 后端

从 Ghidra 获取反编译结果、交叉引用、类型和符号等上下文,再把选定函数交给代理流程。

来源:github.com/Dryxio/reagent/blob/main/README.md
候选代码与审查循环

模型生成的候选实现写入报告或覆盖层,检查器给出反馈后可继续修订;原始源码不会被流程直接覆盖。

来源:github.com/Dryxio/reagent/blob/main/README.md
保守证据检查

函数清单、结构检查和 parity 信号用于发现差异,输出是审计线索,不等于证明语义或二进制完全一致。

来源:github.com/Dryxio/reagent/blob/main/README.md;https://github.com/Dryx…
多模型入口

支持 Claude、Codex CLI 以及 OpenAI 兼容接口;使用者仍需自行提供并管理相应凭据。

来源:github.com/Dryxio/reagent/blob/main/README.md;https://github.com/Dryx…

技术架构

ReAgent 的编排器读取 Ghidra 后端与项目配置,建立函数清单,将反编译上下文交给模型生成候选代码,再运行检查器和可选的构建、测试或运行命令。报告、提示与响应日志构成证据链;候选内容和原项目分开保存。

来源:github.com/Dryxio/reagent/blob/main/README.md

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Ghidra Ghidra Bridge Claude、Codex CLI 或 OpenAI 兼容模型之一Claude、Codex… Git(源码安装时) Ghidra 后端 候选代码与审查循环 保守证据检查 多模型入口 auto-re-agent 项目本体 核心功能 关键依赖

技术栈

语言Python 3.10+;目标代码为 C/C++框架CLI 编排器、Ghidra Bridge、模型提供方适配器
GhidraGhidra BridgeClaude、Codex CLI 或 OpenAI 兼容模型之一Git(源码安装时)
本机或隔离工作环境;验证命令由目标项目配置
来源:github.com/Dryxio/reagent/blob/main/README.md;https://github.com/Dryx…

快速上手

先确认目标二进制和源码具有合法分析授权,在隔离虚拟环境安装 `auto-re-agent[ghidra-bridge]>=0.4.0`,配置 Ghidra Bridge 和一种模型提供方。先运行 `re-agent doctor` 检查依赖,再用 `re-agent init --profile generic-cpp` 建立配置;首次只生成 plan 或 dry-run,人工审阅配置里的构建、测试和运行命令后再决定是否启用。
来源:github.com/Dryxio/reagent/blob/main/README.md;https://github.com/Dryx…

使用场景

适合在获得授权的旧软件维护、互操作研究和自有二进制审计中整理 Ghidra 证据、生成候选实现并记录验证过程。不适合绕过许可、分析未获授权的软件,或把模型输出直接当作可发布源码。

来源:github.com/Dryxio/reagent/blob/main/README.md

优势与局限

优势

  • 把 Ghidra 上下文、模型生成和验证证据放在同一流程
  • 候选代码不直接改写原始源码
  • 支持多种模型入口
  • v0.4.0 增加函数清单和证据导出

局限

  • 需要 Ghidra、模型凭据和逆向工程经验
  • 项目配置可包含任意构建或运行命令,错误信任会执行目标项目代码
  • 结构与 parity 信号不能证明语义或二进制等价
  • 授权与软件许可必须由使用者判断
  • 本轮没有安装、运行或分析任何二进制
来源:github.com/Dryxio/reagent/blob/main/README.md;https://github.com/Dryx…

最新版本

当前正式版为 v0.4.0,发布于 2026-09-09。该版加入跨 Windows/POSIX 的参数数组、函数清单、证据导出和状态改进,并修复多项编排问题。Release 中的测试数字来自项目方,本轮没有复跑。

来源:github.com/Dryxio/reagent/releases/tag/v0.4.0

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对重定向后的官方仓库、README、pyproject.toml 与 v0.4.0 Release  |  limitations: 未安装 ReAgent、Ghidra 或模型客户端,未运行 doctor、plan、构建、测试、parity 或任何逆向分析  |  observed_output: 官方仓库名称为 ReAgent;包要求 Python 3.10 以上,v0.4.0 Release 记录 Windows/POSIX 参数数组、函数清单、证据导出与状态命令等变化

来源:github.com/Dryxio/reagent;https://github.com/Dryxio/reagent/blob/main…

同类项目对比

Ghidra 是美国国家安全局公开的软件逆向工程框架,负责反汇编、反编译、图形与脚本等基础分析。ReAgent 依赖这类底层能力,再增加模型生成、检查循环、候选代码和证据报告。只需要人工分析时直接使用 Ghidra;需要在授权项目中试验受约束的模型辅助流程时,才评估 ReAgent。

来源:github.com/NationalSecurityAgency/ghidra;https://github.com/Dryxio/re…

总结评价

ReAgent 可以把授权逆向任务中的 Ghidra 上下文、候选实现和验证记录串起来,但它不能替代工程师对许可、反编译结果和执行命令的判断。先用自有小样本、禁用不可信命令并保留人工审查,再决定是否扩大范围。

来源:github.com/Dryxio/reagent/blob/main/README.md

常见问题

auto-re-agent 为什么现在叫 ReAgent?

Dryxio 已把仓库更名为 ReAgent,旧的 auto-re-agent 地址会跳转到新仓库。安装包和命令仍以官方 README 当前写法为准。

ReAgent v0.4.0 会直接修改原项目源码吗?

官方说明中,候选代码写入报告或覆盖层,原始源码不会被自动改写。使用者仍要审阅输出后再手工合并。

ReAgent 的 parity 通过是否代表代码完全等价?

不代表。结构检查和 parity 信号是保守证据,只能帮助发现差异,不能证明语义正确或二进制完全一致。

运行 ReAgent 前最需要检查什么?

先确认分析授权,再检查配置里的构建、测试和运行命令。只有在目标项目由自己控制且命令可信时,才启用 trust_configured_commands。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件