angusdevgo/Seep-Reverse-Lab

Seep Reverse Lab – 它是什么

Seep Reverse Lab 是一个自包含的、由代理驱动的逆向工程工作台，用于分析二进制文件（Windows PE、Android APK、Linux ELF 和基于 Web 的代码）。它捆绑了一整套开源分析工具（Radare2、JADX、Apktool、Frida、可选的 IDA Pro）和一个轻量级 MCP（多命令处理器） 服务器，通过统一 API 暴露这些工具。关键之处在于，语言模型（例如 Claude、DeepSeek 或开源 LLM）可以被赋予一个纯英文请求——“绕过 FooBar.apk 中的高级检查”——内置的 softseep 编排器将：

1. 识别目标平台和适当的分析范式。
2. 运行所需的工具链步骤（反编译、搜索知识库、生成 Frida 钩子等）。
3. 在沙箱中执行概念验证，如果钩子失败则自动重试。
4. 生成三部分安全审计报告，包括 CWE-602（授权）评估。

所有这些都在本地运行；一键安装后，工作台不需要网络连接。

---

核心组件

组件	角色
softseep 编排器	决策树路由器（9 种任务类型 × 7 个门），将自然语言意图映射到具体的工具命令。
MCP 服务器（seep_mcp_server.py）	托管 23 个包装工具（Radare2、JADX、Apktool、Frida 等）和知识库搜索引擎。
知识库	289 条现场日志条目，描述已知漏洞模式、攻击图和 CWE-602 签名。
代理契约	提示工程文件（SYSTEM.md、AGENTS.md、扩展），引导 LLM，注入反拒绝逻辑，并保持术语一致。
实验室模式状态机	磁盘支持的标志（~/.pi/agent/lab-mode.flag），在模型切换时保持上下文，并激活反拒绝“BLOCK_NONE”注入。
自愈 PoC 循环	如果生成的 Frida 脚本崩溃，工作台解析错误、修补脚本并重试（最多三次尝试）。

---

典型会话如何工作

用户：lab: analyze FooBar.apk — find the premium check and bypass it

1. 实验室激活 存储会话标志并启用术语映射。
2. softseep 运行 seep_auto_triage → 检测到带有 DEX + ARM64 原生库的 Android APK。
3. seep_apk_decompile output_mode=fold 提取轻量级控制流骨架（≈‑60% 令牌成本）。
4. seep_kb_search 在日志 #142 中找到匹配的 CWE-602 模式。
5. seep_apk_gen_hook 创建可立即运行的 Frida 脚本（hook_verify.js）。
6. 脚本在连接的设备上执行；任何 ClassNotFoundException 都会触发自愈循环。
7. 成功运行后，seep_gen_security_report 组装三部分审计（分类、PoC、缓解措施）。

整个流程在 8–20 分钟 内完成，无需手动切换工具。

---

快速入门清单

1. 安装 – 运行提供的 PowerShell（install.ps1）或 Bash（install.sh）脚本。它会解压捆绑的工具链（≈ 251 MB），注册 MCP 服务器，并运行 51 项健康检查验证器。
2. 选择 LLM 代理 – 使用提供的 *.md 和 *.json 文件配置 Pi Agent、Claude Code、DeepSeek Harness (DSH) 或 OpenCode。
3. 进入实验室模式 – 输入 lab: 后跟您的自然语言目标。
4. 观察编排器 – 代理将调用适当的 seep_* 命令并流式传输结果。
5. 获取报告 – 最终输出保存为沙箱目录中的 Markdown 安全报告。

---

谁可能使用它

• 安全研究人员 需要可重复、自动化的 RE 管道进行二进制审计。
• 红队工程师 希望为客户端授权检查（CWE-602）生成快速 PoC。
• DevSecOps 团队 希望将 LLM 驱动的分析嵌入 CI/CD，而无需将数据暴露到云端。
• 教育工作者 可以通过单个命令演示端到端的逆向工程。

---

限制与注意事项

• “代理原生”功能依赖于提示工程契约；它们最适合受支持的 LLM（Claude、DeepSeek、OpenCode）。使用不同的模型可能需要自定义提示文件。
• 虽然工作台在安装后离线运行，但初始设置会下载预捆绑的二进制文件（Radare2、JADX 等），对于低带宽环境可能较大。
• 某些可选功能（例如 IDA Pro 集成）需要单独的商业许可证。

---

TL;DR

Seep Reverse Lab 是一个本地运行的、由 LLM 编排的逆向工程套件，将 23 个开源分析工具、精选知识库和自愈 PoC 生成器整合在一起。给它一个纯英文目标，它会自动选择正确的工具链、运行分析并生成专业的安全审计——而您无需输入任何 radare2 或 jadx 命令。