angusdevgo/Seep-Reverse-Lab

Agent-Native multi-platform reverse engineering and CWE-602 client-side authorization audit workbench.

Seep Reverse Lab – AI 增强型逆向工程工作台

是什么 – Seep Reverse Lab 是一个自包含的多平台逆向工程套件，您可以用自然语言与 AI「代理」对话，它会自动识别二进制文件的平台，选择合适的工具（Radare2、JADX、Apktool、Frida、IDA Pro 等），执行分析，生成 PoC 补丁或钩子，并最终生成一份三部分的安全审计报告。整个流程由一个名为 Lab Mode 的状态机封装，并由轻量级编排器 softseep 驱动。

核心功能

功能	如 README 所述的工作方式
自然语言意图	您输入类似 `lab: analyze FooBar.apk — find the premium check and bypass it` 的内容。代理解析请求，分类平台（APK + ARM64）和任务类型，然后将任务路由到相应的技能链。
统一工具链（23 个 MCP 工具）	自定义 MCP 服务器（`seep_mcp_server.py`）为 Radare2、JADX、Apktool、Frida、IDA Pro 等工具提供封装。代理调用这些封装，而不是您手动调用每个工具。
CWE-602 客户端侧授权审计	工作流包含「飞行模式确认」步骤，验证功能开关是本地强制还是服务器端强制，生成简洁的 CWE-602 审计报告。
上下文-预算控制	某些命令（如 `seep_r2_decompile` 使用 `output_mode=fold` 或 `summary`）会自动截断返回给 LLM 的数据量，减少约 60–90% 的 token 使用。
自修复 PoC 循环	如果 Frida 脚本崩溃，代理会映射错误、修补脚本并重试（最多三次），之后才转交给人类。
知识库集成	289 个现场日志条目可通过 `seep_kb_search` 搜索。代理始终优先检查知识库，强制执行「零浪费侦察」策略。
离线就绪	所需的所有二进制文件（Radare2、JADX 等）均已打包（约 251 MB）。一键安装后，正常操作无需网络连接。
多代理支持	预先编写好的提示文件可让您使用 Pi Agent、Claude Code、DeepSeek Harness 或 OpenAI Codex 运行相同工作流。

架构概览

用户提示 → Lab-Mode 状态机（磁盘备份标志）
    ↓
softseep 编排器
    ├─ 平台检测（PE / APK / ELF / Web）
    ├─ 任务类型分类（9 种范式 × 7 门决策树）
    └─ 路由至以下之一：
        • seep MCP（23 个原生工具）
        • IDA-Pro MCP 桥接（可选）
        • 知识库搜索
    ↓
工具执行（Radare2、JADX、Frida 等）
    ↓
PoC 生成 → 沙箱执行 → 自修复循环
    ↓
飞行模式确认（CWE-602 证明）
    ↓
三部分咨询级安全报告

README 中的图示展示了相同流程，使用持久化的 ~/.pi/agent/lab-mode.flag 文件在模型切换间保持上下文。

快速入门摘要（来自 README）

前提条件 – Windows 10/11 x64（推荐）或 Linux/macOS，Python 3.11+，Node 18+，Git。
一键安装 – 运行 setup\install.ps1（或双击 check.bat）。脚本解压捆绑工具，安装 Python MCP 包，注册服务器，并运行 35 项健康验证器。
激活 Lab Mode – 在任意支持的聊天界面中输入 lab: 后跟您的自然语言目标。
运行任务 – 示例：lab: analyze FooBar.apk — find the premium check and bypass it。
获取报告 – 自主循环完成后，代理返回三部分审计报告（漏洞详情、可复现 PoC、修复建议）。

典型用例

需要快速验证 Windows、Android 或 Linux 二进制文件中客户端侧授权检查（CWE-602）的安全审计人员。
希望用单一 API 表面替代多个命令行工具（Radare2、JADX、Frida、IDA Pro）的逆向工程团队。
CTF 或培训实验室中，参与者可专注于策略，而代理处理底层工具和 token 预算管理。
事件响应自动化 – 自修复 PoC 循环可脚本化，用于在受损二进制文件上测试补丁，无需手动重试。

限制与注意事项（已披露）

需授权 – 仓库免责声明强调，运行任何分析前必须获得资产所有者的书面许可。
模型拒绝缓解 – 系统注入 BLOCK_NONE 令牌并执行术语映射，防止 LLM 拒绝安全相关请求；这是自定义绕过方案，可能不适用于所有提供方。
工具许可 – IDA Pro 集成为可选，需单独商业许可。
平台支持 – 尽管 README 列出 Windows、Android、Linux 和「Web」，但捆绑的二进制文件主要针对 x86/x64/ARM64；macOS 支持未明确验证。
自修复循环 – 限于三次重试；之后代理将移交人类操作员。

谁可能需要这个？

寻找可重复、AI 驱动工作流以进行客户端侧二进制审计的红队/渗透测试公司。
需要快速生成结构化审计报告的安全顾问。
对统一、代理原生接口连接流行开源工具感兴趣的逆向工程研究人员。

总结

Seep Reverse Lab 是一个真正的开源项目，将丰富的逆向工程工具集与 AI 编排层结合。它自动化了从自然语言安全请求开始，选择合适工具、执行分析并交付精炼审计报告的端到端流程，同时管理 LLM token 预算并提供自修复执行循环。