内容
<p align="center">
<img src="docs/assets/secagent_logo.png" alt="SecAgent Logo" width="380">
</p>
**自主进攻AI框架，适用于红队和安全研究人员**
*工业实力。精英情报。任务就绪。*
---
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://isocpp.org/)
[](https://www.rust-lang.org/)
[](https://go.dev/)
[](https://github.com/gl1tch0x1/cog-ai)
[](https://github.com/astral-sh/ruff)
</div>
---
> **法律免责声明** — SecAgent 仅设计用于**授权的安全测试、红队参与和漏洞研究**，针对您拥有或有明确书面许可测试的系统。未经许可擅自使用SecAgent攻击系统是违法的。作者不对滥用SecAgent承担任何责任。
---
## 目录
- [什么是SecAgent](#-什么是secagent)
- [关键差异化因素](#-关键差异化因素)
- [能力矩阵](#-能力矩阵)
- [综合系统架构](#-综合系统架构)
- [1. 高级系统拓扑和多语言引擎](#1-高级系统拓扑和多语言引擎)
- [2. 自主扫描生命周期顺序](#2-自主扫描生命周期顺序)
- [3. 多代理群体决策逻辑](#3-代理群体决策逻辑)
- [4. 多提供商LLM备用和共识引擎](#4-多提供商llm备用和共识引擎)
- [快速入门指南](#-快速入门指南)
- [安装指南](#-安装指南)
- [前提条件](#前提条件)
- [方法1 — 自动安装引擎（推荐）](#方法1--自动安装引擎推荐)
- [方法2 — 手动软件包安装](#方法2--手动软件包安装)
- [发布、部署和软件包](#-发布部署和软件包)
- [ 发布](#️-发布)
- [ 部署模型](#-部署模型)
- [ 软件包](#-软件包)
- [配置和操作清单](#-配置和操作清单)
- [完整的CLI用法参考](#-完整的cli用法参考)
- [子命令规范和标志](#子命令规范和标志)
- [示例交付成果和交付成果模式](#-示例交付成果和交付成果模式)
- [1. 高级Markdown交付成果](#1-高级markdown交付成果)
- [2. 机器可读JSON模式](#2-机器可读json模式)
- [项目目录布局](#-项目目录布局)
- [故障排除和操作指南](#-故障排除和操作指南)
- [贡献和安全政策](#-贡献和安全政策)
- [许可证](#-许可证)
---
## 什么是SecAgent
传统的漏洞扫描器是**僵化、噪音大、上下文盲**的。它们执行静态模式匹配，错过复杂的多阶段攻击向量，并用假阳性结果淹没安全操作员，浪费宝贵的时间。
**SecAgent是一个自主的、纯CLI的红队和进攻性智能框架。**
它作为一个**分布式认知安全引擎**运行 — 利用专门的多代理AI群体，以精英红队操作员的方式**推理**攻击面。SecAgent识别技术栈，枚举子域和HTTP端点，通过主动`httpx`和Go探测器，创建上下文感知型漏洞利用，验证漏洞通过确定性验证，并生成相关的、影响优先的交付成果。
适用于：
- 执行全范围自主参与的**红队**
- 执行自动攻击面发现和零日研究的**安全研究人员**
- 进行主动侦察和漏洞验证的**漏洞悬赏猎人**
- 审计AI供应链、提示注入和RAG管道的**进攻性AI研究人员**
---
## 关键差异化因素
1. **纯CLI优先架构**：不需要臃肿的Web UI或复杂的数据库设置。设计用于无头VPS执行、Docker容器、SSH会话和CI/CD管道。
2. **多语言性能引擎**：高速Go微服务用于并发网络探测，Rust用于微秒优先级调度，C++20用于SIMD正则表达式签名匹配，Python用于LLM多代理推理。
3. **Aura认知记忆引擎**：目标DNA分层、有效载荷模式结晶、衰减强化机制和扫描任务之间的WAF指纹记忆（`secagent memory`）。
4. **零假阳性实时验证**：集成的`CrucibleValidator`重放验证载荷与HTTP状态码一致性和响应体方差检查针对目标端点。
5. **共享连接池和高并发**：连接池的`CVEScanner`和并发的`WebSecurityAgent`扫描通过`asyncio.Semaphore`任务调度。
6. **无头浏览器检查**：`BrowserAgent`自动Chrome DOM提取和动态Playwright表单解析，并使用备用HTTP检查。
7. **严格的SSL/TLS强制执行**：环境控制的动态SSL验证（`SECAGENT_VERIFY_SSL`）适用于所有代理HTTP客户端。
8. **硬件感知本地备用**：自动检测GPU/CPU能力，以便在云API不可用时提供本地Ollama模型（`llama3`、`mistral`、`codellama`）。
10. **模型上下文协议（MCP）服务器模式**：本地JSON-RPC stdio服务器（`secagent mcp`）允许Claude Code、Cursor和VS Code Copilot驱动SecAgent，无需API成本。
11. **声明性YAML剧本**：定义和版本控制复杂的渗透测试方法论，具有条件规则和LLM决策门（`secagent playbook`）。
12. **便携式证明胶囊和重放引擎**：将验证的漏洞导出为`.json`证明胶囊，并按需重新验证（`secagent replay`）。
13. **人机协作远程操作**：在扫描执行过程中双击`Ctrl+C`，进入交互式操作员REPL（`step`、`inspect`、`inject`、`resume`、`abort`）。
14. **LLM预算守护和成本保障**：实时代币成本核算和可配置的预算限制强制执行（`SECAGENT_PRICE_LIMIT`）。
---
## 能力矩阵
| 模块 | 子组件 | 操作描述 |
|--------|----------------|-------------------------|
| **神经群体编排** | `Orchestrator`、`ArmadaSwarm`、`TaskDAG` | 将高级目标分解为有向无环执行图（DAG），具有重试和断路器逻辑。 |
| **MCP服务器模式** | `MCPServer`、`JSON-RPC stdio` | 通过模型上下文协议（`secagent mcp`）将SecAgent工具暴露给Claude Code、Cursor和Copilot。 |
| **声明性剧本** | `Playbook`、`PlaybookRunner` | 执行YAML定义的扫描方法论，具有依赖顺序和条件执行（`secagent playbook`）。 |
| **证明胶囊和重放** | `ProofCapsule`、`ProofCapsuleReplayer` | 将验证的发现结果导出为可移植的`.json`胶囊，以便立即离线重放和CI验证（`secagent replay`）。 |
| **人机协作远程操作** | `TeleoperationController` | 拦截双击`Ctrl+C`以暂停扫描并启动交互式REPL shell。 |
| **LLM成本保障** | `BudgetGuard` | 跨OpenAI、Anthropic、Gemini、Groq和OpenRouter的实时代币定价和成本限制强制执行。 |
| **Aura认知记忆** | `AuraMemoryManager`、`Target DNA` | 目标DNA指纹、WAF内存、有效载荷模式结晶、自动置信强化和衰减（`secagent memory`）。 |
| **主动侦察引擎** | `ReconAgent`、`GoRecon`、`httpx`探测器 | 主动子域解析、TLS/头部探测、HTML爬取、链接提取和GET/POST参数发现。 |
| **无头浏览器引擎** | `BrowserAgent`、`Playwright` | Chromium DOM树检查、动态JS错误跟踪和自动HTML表单输入提取。 |
| **Web安全扫描器** | `WebSecurityAgent`、`CVEChecks` | 31+漏洞类别，包括SQLi、XSS、SSTI、LFI、RFI、SSRF、RCE、命令注入、Log4Shell和多源CORS检查。 |
| **API安全扫描器** | `APISecurityAgent` | REST和GraphQL内省、BOLA/IDOR检测（敏感模式字段评估）、JWT算法操作（`none`算法）和CORS错误配置。 |
| **12个专用群体代理** | `specialized.py` | 用于智能工具选择、CTF挑战解决、漏洞利用生成、漏洞关联和速率限制检测的功能性AI群体代理。 |
| **Web3和合约审计器** | `Web3SecurityAgent` | EVM和Solana智能合约安全分析，用于重入、整数溢出、delegatecall漏洞和访问控制绕过。 |
| **PoC验证** | `CrucibleValidator` | 实时HTTP请求重放，多次尝试一致性验证，消除假阳性。 |
| **漏洞利用链关联** | `ChainCorrelator` | 将隔离的漏洞链接成完整的多步骤利用路径。 |
| **影响优先报告** | `ReportAgent` | 生成高级Markdown报告和机器可读的JSON工件。 |
---
## 综合系统架构
### 1. 高级系统拓扑和多语言引擎
```mermaid
graph TB
subgraph CLI_LAYER["🖥️ CLI & 接口控制平面"]
CLI["secagent CLI（富TUI）"]
MCP["🔌 MCPServer（JSON-RPC stdio）"]
PLAYBOOK["📜 剧本引擎（YAML方法论）"]
CAPSULE["📦 证明胶囊引擎和重放器"]
HITL["🕹️ 远程操作控制器（双击Ctrl+C）"]
BUDGET["💰 预算守护（代币和成本核算）"]
SCOPE["范围门（失败关闭强制执行）"]
VAULT["Vault密钥管理器（.env加载器）"]
PREFLIGHT["预飞行完整性检查器"]
end
subgraph MEMORY_LAYER["🧠 认知记忆子系统"]
AURA["AuraMemoryManager（目标DNA和模式引擎）"]
DB[("💾 SQLite / aura-memory SDK 数据库")]
end
subgraph SWARM_LAYER["🐝 Python代理群体"]
PLANNER["🎯 计划代理（Armada DAG构建器）"]
RECON["🔍 侦察代理（httpx + 异步探测器）"]
WEB["🌐 Web安全代理"]
API["⚡ API安全代理"]
WEB3["🕸️ Web3安全代理"]
VALIDATOR["🔬 验证代理（Crucible）"]
REPORTER["📊 报告代理"]
end
subgraph ENGINE_LAYER["⚙️ 多语言核心引擎"]
CPP["⚡ C/C++ 基础核心（cpp-core）"]
RUST["🦀 Rust引擎和优先级调度器"]
GO["🐹 Go子域和网络探测器"]
REDIS[("🔴 Redis Pub/Sub事件总线")]
end
CLI --> SCOPE
MCP --> SCOPE
PLAYBOOK --> SCOPE
CAPSULE --> VALIDATOR
HITL --> SWARM_LAYER
BUDGET --> SWARM_LAYER
SCOPE --> PREFLIGHT
PREFLIGHT --> VAULT
VAULT --> PLANNER
AURA <--> DB
PLANNER <-->|召回目标DNA| AURA
PLANNER --> RECON
PLANNER --> WEB
PLANNER --> API
PLANNER --> WEB3
RECON --> GO
RECON --> RUST
RECON --> CPP
SWARM_LAYER --> REDIS
SWARM_LAYER --> VALIDATOR
VALIDATOR -->|导出证明胶囊| CAPSULE
VALIDATOR -->|结晶漏洞利用| AURA
VALIDATOR --> REPORTER
```
---
### 5. C/C++ 基础核心引擎（`cpp-core`）和本地桥演示
SecAgent结合编译的**C++20 基础核心（`cpp-core`）**，用于亚毫秒级执行任务、SIMD加速的正则表达式/签名匹配和异步原始套接字探测。
#### C++核心架构拓扑
```mermaid
graph LR
subgraph PYTHON_BRIDGE["🐍 Python本地桥"]
PY_NATIVE["secagents.core.native"]
CTYPES["ctypes C-ABI加载器"]
end
subgraph CPP_ENGINE["⚡ C++ 基础引擎（secagent_core）"]
C_API["c_api.cpp（extern 'C'导出API）"]
MATCHER["FastMatcher（C++20 SIMD正则表达式引擎）"]
PROBER["RawSocketProber（非阻塞套接字引擎）"]
end
subgraph OS_KERNEL["💻 操作系统内核"]
SOCKETS["原始套接字 / AF_PACKET / Winsock2"]
end
PY_NATIVE --> CTYPES
CTYPES ==>|直接C-ABI调用| C_API
C_API --> MATCHER
C_API --> PROBER
PROBER ==>|非阻塞I/O| SOCKETS
```
#### 代码演示 1 — 高速C++签名匹配（`fast_matcher.cpp`)
```cpp
#include "fast_matcher.hpp"
#include <regex>
namespace SecAgentCore {
bool FastMatcher::scan_signature(const std::string& buffer, const std::string& pattern) {
if (buffer.empty() || pattern.empty()) return false;
try {
std::regex re(pattern, std::regex_constants::icase | std::regex_constants::optimize);
return std::regex_search(buffer, re);
} catch (...) {
return buffer.find(pattern) != std::string::npos;
}
}
}
```
#### 代码演示 2 — 非阻塞C++套接字探测器（`raw_socket.cpp`)
```cpp
#include "raw_socket.hpp"
#include <chrono>
namespace SecAgentCore {
ProbeResult RawSocketProber::probe_port(const std::string& host, int port, int timeout_ms) {
auto start = std::chrono::high_resolution_clock::now();
int sock = ::socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
// 执行非阻塞套接字连接并使用select()超时监控...
auto elapsed = std::chrono::high_resolution_clock::now() - start;
double latency = std::chrono::duration<double, std::milli>(elapsed).count();
return {true, port, "open", latency};
}
}
```
#### 代码演示 3 — 导出C-ABI桥（`c_api.cpp`)
```cpp
#include "c_api.h"
#include "fast_matcher.hpp"
#include "raw_socket.hpp"
extern "C" {
SECAGENT_EXPORT int secagent_match_signature(const char* buffer, const char* pattern) {
return SecAgentCore::FastMatcher::scan_signature(buffer, pattern) ? 1 : 0;
}
SECAGENT_EXPORT SecAgentProbeResult secagent_probe_port(const char* host, int port, int timeout_ms) {
auto res = SecAgentCore::RawSocketProber::probe_port(host, port, timeout_ms);
return {res.open ? 1 : 0, res.port, res.latency_ms};
}
}
```
#### 代码演示 4 — Python本地桥调用（`native.py`)
```python
from secagents.core.native import native_engine
# 高速C++签名扫描
matched = native_engine.match_signature(response_body, r"Apache/\d+\.\d+")
# 高速本地套接字探测
result = native_engine.probe_port("127.0.0.1", 80, timeout_ms=500)
print(f"Port Open: {result['open']}, Latency: {result['latency_ms']}ms"):
```
### erequisites
| 需求 | 最低要求 | 推荐配置 | 备注 |
|-------------|---------|-------------|-------|
| **操作系统** | Windows / Linux / macOS | Linux / macOS / WSL2 | 原生Windows PowerShell和Linux环境下完全支持 |
| **Python** | 3.11+ | Python 3.11, 3.12, 3.13 | 跨环境验证兼容性 |
| **Git** | 已安装 | 最新版本 | 版本控制和更新引擎 |
| **Docker** | *(可选)* | 20.10+ | 容器化沙盒执行（使用 `--no-sandbox` 参数绕过） |
---
### 方法 1 — 自动安装引擎（推荐）
安装程序设置虚拟环境，挂载核心依赖项，创建入口点，并验证系统完整性：
```bash
python installer.py
```
### 方法 2 — 手动软件包安装
适用于开发者控制或集成到现有的Python环境中：
```bash
# 1. 创建并激活虚拟环境
python -m venv venv
# Windows PowerShell:
.\venv\Scripts\Activate.ps1
# Linux / macOS:
source venv/bin/activate
# 2. 以可编辑模式安装 secagents 软件包
pip install -e ./python-agents[dev,browser]
```
---
## 版本、部署和软件包
### 版本
- **当前版本**：`v0.3.0-dev`
- **版本跟踪**：通过 [CHANGELOG.md](file:///c:/Users/Acer/Downloads/SecAgent-Updated/SecAgent-Updated/CHANGELOG.md) 管理
- **标签**：遵循语义版本控制（`MAJOR.MINOR.PATCH`）。
### 部署模式
SecAgent设计用于在本地机器、远程服务器和容器化集群上灵活部署。
#### Docker Compose 部署
运行核心后台微服务（Redis事件总线、Rust引擎、Go探测器）：
```bash
docker compose up -d
```
容器清单：
- `redis`：发布/订阅事件总线（`:6379`）
- `rust-core`：Rust优先级任务调度器
- `recon`：Go高并发网络探测器
#### 独立CLI二进制部署
安装程序生成可执行二进制包装器用于快速调用：
- **Windows**：`secagent.bat`
- **Linux/macOS**： `./secagent`
---
### 软件包
Python代理核心打包为标准的PyPI轮：
```bash
# 构建Python软件包轮
cd python-agents
python -m build
```
生成的工件： `python-agents/dist/secagents-0.2.0-py3-none-any.whl`。
---
## 配置和操作清单
操作参数和API凭证从 `.env` 读取：
```env
# ─── 主要LLM提供商密钥 ───
OPENAI_API_KEY=sk-proj-...
ANTHROPIC_API_KEY=sk-ant-...
GEMINI_API_KEY=AIzaSy...
GROQ_API_KEY=gsk_...
DEEPSEEK_API_KEY=sk-...
# ─── 本地LLM配置 ───
OLLAMA_HOST=http://localhost:11434
DEFAULT_LOCAL_MODEL=llama3:8b
# ─── 操作范围和基础设施 ───
ALLOWED_DOMAINS=example.com,target.local
REDIS_URL=redis://localhost:6379/0
RESULTS_DIR=cog-ai-results
SECAGENT_VERIFY_SSL=true
```
---
## 完整的CLI用法参考
```text
用法：secagent [-h] [--version]
{scan,vault,keyhacks,preflight,update,hardware,worker} ...
SecAgent — 自主进攻性AI框架（仅限授权测试）
位置参数：
{scan,vault,keyhacks,preflight,update,hardware,worker}
scan 执行自主红队管道
vault 与秘密存储和API密钥交互
keyhacks 扫描本地资产以查找泄露的凭证
preflight 验证系统准备情况
update 检查并应用框架更新
hardware 硬件感知模型优化
worker 启动后台工作流处理器
选项：
-h, --help 显示此帮助消息并退出
--version 显示程序的版本号并退出
```
### 子命令规格和标志
#### 1. `secagent scan` — 自主红队管道
```bash
secagent scan --target <域名/URL> [选项]
选项：
--target, -t TEXT 目标域名或URL [必填]
--depth {quick,standard,deep} 扫描强度（默认：standard）
--workers, -w INT 并行代理群大小（默认：4）
--skip-os-check 跳过操作系统安全基准检查
--no-sandbox 跳过Docker堡垒隔离
--no-arsenal 跳过启发式Arsenal探测器
--insecure 跳过SSL/TLS验证
--setup-local-llm 自动配置本地Ollama模型
--results-dir PATH 输出目录（默认：cog-ai-results）
```
#### 2. `secagent vault` — 密钥完整性管理器
```bash
secagent vault --validate --env .env
```
#### 3. `secagent keyhacks` — 凭证审计
```bash
secagent keyhacks ./src --rate-limit 10.0
```
#### 5. `secagent mcp` — 模型上下文协议服务器
```bash
secagent mcp
```
#### 6. `secagent playbook` — 声明式方法执行
```bash
secagent playbook ./playbooks/web-api.yaml --target example.com
```
#### 7. `secagent replay` — 证明胶囊PoC重放器
```bash
secagent replay ./cog-ai-results/capsules/proof_sqli_123.json
```
#### 5. `secagent memory` — Aura认知内存控制
```bash
secagent memory [选项]
选项：
--target, -t TEXT 按目标域名筛选认知记忆信号
--purge-decay 应用记忆衰减算法并移除零置信度模式
```
#### 6. `secagent hardware` — 硬件检测
```bash
secagent hardware
```
#### 6. `secagent update` — 情报同步
```bash
secagent update
```
---
## 样本文档和文档模式
### 1. 执行摘要Markdown文档
```markdown
# 任务情报文档：example.com
## 执行摘要
SecAgent对目标域名`example.com`执行了自主安全审计。
总共提取了**3个有效漏洞**，无假阳性。
### 关键发现矩阵
| 严重程度 | 漏洞 | 位置 | 置信度 | CWE |
| :--- | :--- | :--- | :---: | :--- |
| **严重** | SQL注入 | `/api/users?id=` | 95% | CWE-89 |
| **高** | 反射XSS | `/search?q=` | 90% | CWE-79 |
| **高** | 不安全直接对象引用 | `/api/users/102` | 85% | CWE-639 |
---
## 技术发现详情
### 1. SQL注入（`CWE-89`）
- **目标URL**： `https://example.com/api/users`
- **方法**： `GET`
- **有效载荷**： `' UNION SELECT NULL--`
- **证明信号**： `您在SQL语法中有一个错误，靠近 '1'`
```
### 2. 机器可读JSON模式（`target.json`）
```json
{
"target": "example.com",
"domain": "example.com",
"findings": [
{
"type": "sqli",
"severity": "critical",
"url": "https://example.com/api/users",
"payload": "' UNION SELECT NULL--",
"confidence": 0.95,
"cwe": "CWE-89",
"poc_url": "https://example.com/api/users?id=' UNION SELECT NULL--"
}
]
}
```
---
## 项目目录布局
```text
SecAgent/
├── python-agents/ # 主要Python AI代理群和CLI引擎
│ ├── pyproject.toml # 软件包配置、脚本和开发依赖项
│ └── secagents/
│ ├── agents/ # 自主专业代理群
│ │ ├── api_security.py # REST/GraphQL漏洞探测器和BOLA检查器
│ │ ├── base.py # 具有置信度评分和标准格式的BaseAgent类
│ │ ├── keyhacks.py # 本地资产秘密和凭证泄漏扫描器
│ │ ├── planner.py # 阶段分解器、资源分配器和风险标识符
│ │ ├── recon.py # 活动DNS探测器、httpx爬虫和参数发现
│ │ ├── report.py # Markdown文档生成器和发现总结器
│ │ ├── supervisor.py # 动作意图分类器和群控制器
│ │ ├── validator.py # 概念验证和重放引擎
│ │ ├── web3_security.py # 智能合约审计器（EVM和Solana漏洞探测器）
│ │ └── web_security.py # Web漏洞扫描器（SQLi、XSS、SSTI、LFI、SSRF、RCE）
│ ├── armada/ # 群处理器和编排任务
│ │ ├── handlers.py # 任务处理器注册和路由
│ │ └── swarm.py # 并行代理群运行器
│ ├── arsenal/ # 启发式利用探测器
│ │ └── exploits.py # Arsenal有效载荷探测器和二次验证
│ ├── core/ # 核心系统基础设施
│ │ ├── memory.py # 持久内存存储
│ │ ├── orchestrator.py # 任务DAG编排器和断路器跟踪器
│ │ ├── skill_manager.py # SKILL.md解析器和技能注册引擎
│ │ └── workers.py # 异步工作池和队列管理器
│ ├── crucible/ # 验证和回归框架
│ │ ├── regression.py # 测试套件回归跟踪器
│ │ └── validation.py # 现场概念验证重放和线性扩展时间验证器
│ ├── engine/ # 上下文和图处理
│ │ ├── caveman.py # 令牌高效的提示压缩器
│ │ ├── ci_notifier.py # CI/CD webhook和警报调度器
│ │ └── memory_graph.py # 基于图的漏洞关系存储
│ ├── fortress/ # 隔离和沙盒
│ │ └── sandbox.py # Docker堡垒执行隔离检查
│ ├── hermes/ # 回顾性记忆引擎
│ │ ├── retrospective.py # 扫描后分析和学习反馈环
│ │ └── store.py # Hermes持久记忆存储
│ ├── infra/ # 操作安全措施和完整性
│ │ ├── preflight.py # 系统依赖和先决条件验证器
│ │ └── scope.py # 封闭目标域范围强制执行器
│ ├── intel/ # 威胁情报集成
│ │ ├── chaos_client.py # ProjectDiscovery Chaos API集成
│ │ └── shodan_client.py # Shodan主机情报集成
│ ├── llm/ # LLM提供商抽象
│ │ ├── consensus.py # 多提供商协议和共识引擎
│ │ └── omni.py # 统一LLM客户端（OpenAI、Anthropic、Gemini、Groq、DeepSeek）
│ ├── modules/ # 确定性检测签名
│ │ └── cve_checks.py # 31+零假阳性CVE签名和检查定义
│ ├── operational/ # 环境和系统完整性
│ │ └── integrity.py # 操作系统基准安全更新和工具更新器
│ ├── pipeline/ # 统一扫描执行
│ │ └── runner.py # 扫描管道编排器（范围 -> 预检 -> 群 -> 报告）
│ ├── remediation/ # 自动修复和补丁
│ │ ├── patcher.py # 自动修复代码补丁程序
│ │ └── reporter.py # 最终报告格式化器和文档生成器
│ ├── vault/ # 操作秘密存储
│ │ └── env_loader.py # 环境密钥加载器和实时API验证
│ ├── whichllm/ # 硬件感知模型配置
│ │ └── hardware.py # 本地GPU/CPU检测器和Ollama自动配置器
│ └── cli.py # Rich CLI终端用户界面和子命令解析器
├── go-services/ # 高性能Go微服务
│ ├── recon/ # 高速侦察引擎
│ │ ├── crawler.go # 并发网页爬虫和链接提取器
│ │ ├── httpprobe.go # 多线程HTTP/HTTPS服务探测器
│ │ ├── params.go # GET/POST参数发现引擎
│ │ ├── recon_test.go # Go侦察单元测试套件
│ │ └── subdomain.go # 多线程DNS强制枚举器
│ ├── scanners/ # 网络扫描器
│ │ ├── portscan.go # 快速TCP端口扫描器
│ │ └── syn.go # 原始SYN分组扫描器
│ └── cli/ # Go CLI二进制构建入口点
│ └── cmd/main.go # Go CLI入口点
├── rust-core/ # Rust引擎和优先级任务调度器
│ ├── Cargo.toml # Rust软件包清单和依赖项
│ └── src/
│ ├── engine.rs # 核心Rust执行引擎
│ ├── event_bus.rs # 无锁事件调度总线
│ ├── main.rs # Rust引擎二进制入口点
│ ├── policy.rs # 安全策略评估引擎
│ ├── scheduler.rs # 微秒延迟任务优先级队列
│ └── state.rs # 系统状态跟踪器
├── skills/ # 模块化狩猎方法论
│ ├── bb-methodology/ # 漏洞赏金方法论指南
│ ├── PromptInjection/ # LLM提示注入审计剧本
│ ├── Recon/ # 高级侦察技术
│ └── WebAssessment/ # OWASP Top 10评估工作流程
├── tests/ # 统一测试套件
│ └── unit/
│ ├── test_agents_complete.py # Python代理群单元测试
│ ├── test_comprehensive.py # 系统编排器和工作单元测试
│ └── test_cve_checks.py # 签名和CVE验证测试
├── docker-compose.yml # 生产背景微服务配置
├── Makefile # 统一构建、测试和执行目标
├── installer.py # 自动部署和安装引擎
├── update.py # 情报和框架同步工具
├── SKILL.md # 主狩猎知识库参考
├── LICENSE # MIT许可证分发条款
├── SECURITY.md # 安全策略和漏洞报告
└── README.md # 主文档和架构指南
```
---
## 故障排除和操作指南
### 常见操作场景
#### 1. 跳过Docker沙盒隔离
如果Docker未运行或不需要沙盒隔离：
```bash
secagent scan --target example.com --no-sandbox
```
#### 2. 配置离线本地LLM模型
在没有云API密钥的空气间隙环境中运行：
```bash
secagent scan --target target.local --setup-local-llm
```
#### 3. 解决SSL证书警告
对于具有自签名SSL证书的内部 staging 环境：
```bash
secagent scan --target https://staging.local --insecure
```
---
## 贡献和安全策略
### 贡献
1. 在GitHub上分叉仓库。
2. 创建您的功能分支（`git checkout -b feature/advanced-cve-check`）。
3. 验证测试覆盖率（`pytest`）和linter合规性（`ruff check python-agents`）。
4. 提交您的更改并提交拉取请求。
### 报告漏洞
要报告SecAgent本身的安全漏洞，请查看我们的 [SECURITY.md](file:///c:/Users/Acer/Downloads/SecAgent-Updated/SecAgent-Updated/SECURITY.md) 以获取负责任的披露指南。
---
## 许可证
在MIT许可证下分发。有关详细信息，请参见 [LICENSE](file:///c:/Users/Acer/Downloads/SecAgent-Updated/SecAgent-Updated/LICENSE)。
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器