---

⚠️ 法律免责声明

Guardian 仅供授权的安全测试和教育目的使用。

• ✅ 合法用途：授权的渗透测试、安全研究、教育环境
• ❌ 非法用途：未授权访问、恶意活动、任何形式的网络攻击

您有完全责任确保在测试任何系统之前获得明确的书面授权。 未经授权访问计算机系统是违法的，违反法律包括《计算机欺诈和滥用法》（CFAA）、《通用数据保护条例》（GDPR）以及相应的国际立法。

使用 Guardian 即表示您同意仅在您拥有或已获明确授权测试的系统上使用它。

---

✨ 功能

🤖 多提供商 AI 智能

• 支持 7 种 AI 提供商：OpenAI（GPT-4o）、Anthropic（Claude）、Google（Gemini）、OpenRouter、Requesty、Ollama（本地）、兼容 OpenAI 的服务（vLLM、LM Studio、Together、Groq）
• 插件提供商合约：第三方提供商通过 [project.entry-points."guardian.providers"] 提供，无需 fork
• 多智能体架构：专门的 AI 智能体（规划者、工具选择者、分析者、报告者）以及辩论分类角色（红方辩护者、蓝方辩护者、裁判）和视觉分类
• 多智能体辩论分类：对模糊发现进行红/蓝/裁判三角色辩论 —— F1 ≥ 单智能体基准线 +5pp
• 视觉 LLM 分类：通过 gpt-4o / Claude 3.5+ / Gemini 1.5+ 进行无头截图捕获和图像增强的分析
• RAG 知识库：基于 SQLite + FTS5 检索 CVE / CWE / MITRE ATT&CK 数据源 —— 消除虚构的 CVE 引用
• 裁判模型路由：think_deeply 交换恢复 —— 大模型思考，小模型裁判，成本降低约 10 倍
• 学习型工具选择：基于会话遥测训练的离线排名器；低置信度时弃权并回退到 LLM 选择器
• 自适应测试：AI 根据发现的漏洞和先前工具产出调整策略
• 误报过滤：辩论分类减少噪声；当 fp_probability 明确时跳过廉价路径

🛠️ 丰富的工具库

10 个类别中的 50 个集成安全工具：

类别	工具
网络	nmap, masscan
Web 侦察	httpx, whatweb, wafw00f, cmseek
子域名 / DNS	subfinder, amass, dnsrecon
漏洞扫描	nuclei, nikto, sqlmap, wpscan
SSL/TLS 测试	testssl, sslyze
内容发现	gobuster, ffuf, arjun
安全分析	xsstrike, gitleaks
云 / 容器 / SBOM	trivy, grype, syft, scoutsuite, prowler, kube-bench
现代 Web + OSINT	graphw00f, clairvoyance, jwt_tool, shodan, theharvester
SAST + 机密（B11）	semgrep, trufflehog, dependency-check
API 模糊测试（B10）	schemathesis, cariddi, restler
Burp/ZAP 桥接（B13）	zap, burp
LLM 红队（B12）	garak, pyrit, prompt_fuzz
移动 Android（B9）	mobsf, apkleaks, objection
Active Directory（B8）	crackmapexec, bloodhound, kerbrute, impacket-secretsdump
视觉证据（A3）	playwright_screenshot

📊 增强的证据捕获

• 执行可追溯性：每个发现通过 execution_id 链接到其源工具执行
• 完整命令历史：完整工具输出随每个发现保留
• 原始证据存储：输出片段绑定到发现
• 视觉证据：每个 URL 捕获截图，附加到 Web 发现
• 会话重建：原子检查点的 session_<id>.json 支持 --resume

🔄 智能工作流系统（DSL v2）

• DAG 调度器：具有 depends_on 的步骤并行运行，最多 max_parallel_tools
• Jinja2 模板（沙盒化）：parameters: {key: "{{ <id>.parsed.alive_hosts }}"} 针对先前步骤结果进行解析
• 条件步骤：when: 子句根据先前输出控制执行
• 继续执行：--resume 从最后完成的步骤之后继续
• 参数优先级：工作流 YAML > 配置块 > 工具默认值
• 自定义智能体：分析步骤中的 agent: debate | visual | analyst
• 多种报告格式：Markdown、HTML、JSON

📤 输出集成（B14）

• SARIF v2.1.0：GitHub 友好，包含 security-severity，基于 execution_id 的去重 fingerprints
• DefectDojo：直接 REST 上传
• Slack：Webhook 发布，带有严重性颜色编码
• 通过以下方式触发：guardian report --export sarif --export defectdojo --export slack

🔒 安全与合规

• DNS 解析范围验证：关闭 SSRF 类绕过；私有 RFC1918 范围列入黑名单
• 提示注入防御：所有工具输出通过 <UNTRUSTED_TOOL_OUTPUT> 分隔符包装，并剥离 ANSI 转义
• API 密钥擦除：日志和报告在写入时隐藏机密信息
• 确认门控：主动+ 工具（侵入性/破坏性）需要用户明确批准
• 审计日志：每次 AI 决策和操作的轮转日志
• 安全模式：默认阻止破坏性操作

📋 专业报告

• CVSS v3.1 重新计算：根据向量数学验证声称的分数；标记偏差
• 执行摘要：非技术性概述
• 技术深度分析：带有证据、CVSS、CWE、CVE、MITRE 技术的发现
• AI 决策追踪：每个智能体的令牌使用量、成本、思维链记录
• 视觉分类章节：嵌入图像增强的描述

⚡ 性能与效率

• 全程异步：工具通过 asyncio 子进程执行；智能体异步
• 延迟加载工具：注册 50 个工具，直到需要时才导入 —— --help 保持在 500ms 以下
• 并行 DAG 执行：每个生成周期中，独立步骤并发运行
• 工作流自动化：13+ 个工作流（侦察、Web、网络、AD、移动、LLM 红队、SAST、API）

---

📋 先决条件

必需

• Python 3.11 或更高版本（下载）
• AI 提供商 API 密钥（选择一种）：
  • OpenAI API 密钥（获取）
  • Anthropic API 密钥（获取）
  • Google AI Studio API 密钥（获取）
  • OpenRouter API 密钥（获取）
  • Requesty API 密钥（获取）
• Git（用于克隆仓库）

可选工具（获取完整功能）

如果安装了这些工具，Guardian 可以智能地使用它们：

工具	用途	安装方式
nmap	端口扫描	apt install nmap / choco install nmap
masscan	超快速扫描	apt install masscan / 从源码构建
httpx	HTTP 探测	go install github.com/projectdiscovery/httpx/cmd/httpx@latest
subfinder	子域名枚举	go install github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
amass	网络映射	go install github.com/owasp-amass/amass/v4/...@master
nuclei	漏洞扫描	go install github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
whatweb	技术指纹识别	gem install whatweb / apt install whatweb
wafw00f	WAF 检测	pip install wafw00f
nikto	Web 漏洞扫描	apt install nikto
sqlmap	SQL 注入	pip install sqlmap / apt install sqlmap
wpscan	WordPress 扫描	gem install wpscan
testssl	SSL/TLS 测试	从 testssl.sh 下载
sslyze	SSL/TLS 分析	pip install sslyze
gobuster	目录暴力枚举	go install github.com/OJ/gobuster/v3@latest
ffuf	Web 模糊测试	go install github.com/ffuf/ffuf/v2@latest
arjun	参数发现	pip install arjun
xsstrike	高级 XSS	git clone https://github.com/s0md3v/XSStrike
gitleaks	密钥扫描	go install github.com/zricethezav/gitleaks/v8@latest
cmseek	CMS 检测	pip install cmseek
dnsrecon	DNS 枚举	pip install dnsrecon

注意：Guardian 可以在没有外部工具的情况下工作，但扫描能力有限。AI 会根据可用工具自适应调整。

---

🚀 安装

步骤 1：克隆仓库```bash

git clone https://github.com/zakirkun/guardian-cli.git cd guardian-cli

### 第二步：设置 Python 环境

**Linux/macOS：**```bash
python3 -m venv venv
source venv/bin/activate
pip install -e .

Windows:```powershell python -m venv venv .\venv\Scripts\activate pip install -e .

### 步骤 3：配置 AI 提供商

Guardian 支持多个 AI 提供商。在 `config/guardian.yaml` 中配置您偏好的提供商：```yaml
# config/guardian.yaml
ai:
  # Choose your provider: openai, claude, gemini, openrouter, or requesty
  provider: openai
  
  # OpenAI Configuration (recommended)
  openai:
    model: gpt-4o
    api_key: sk-your-api-key-here  # Or set OPENAI_API_KEY env var
  
  # Claude Configuration
  claude:
    model: claude-3-5-sonnet-20241022
    api_key: null  # Or set ANTHROPIC_API_KEY env var
  
  # Gemini Configuration
  gemini:
    model: gemini-2.5-pro
    api_key: null  # Or set GOOGLE_API_KEY env var
  
  # OpenRouter Configuration
  openrouter:
    model: anthropic/claude-3.5-sonnet
    api_key: null  # Or set OPENROUTER_API_KEY env var

  # Requesty Configuration (OpenAI-compatible gateway)
  requesty:
    model: openai/gpt-4o-mini
    api_key: null  # Or set REQUESTY_API_KEY env var

或者使用环境变量：```bash

Linux/macOS

export OPENAI_API_KEY="sk-your-key-here" export ANTHROPIC_API_KEY="sk-ant-your-key-here" export GOOGLE_API_KEY="your-gemini-key" export OPENROUTER_API_KEY="your-router-key" export REQUESTY_API_KEY="your-requesty-key"

Windows PowerShell

$env:OPENAI_API_KEY="sk-your-key-here" $env:ANTHROPIC_API_KEY="sk-ant-your-key-here"

### 步骤 4：初始化配置```bash
# Verify installation
python -m cli.main --help

# Check AI provider status
python -m cli.main models

🎯 快速开始

基本命令```bash

List available workflows

python -m cli.main workflow list

View AI providers and models

python -m cli.main models

Run with specific provider

python -m cli.main workflow run --name web_pentest --target example.com --provider openai

### 使用场景示例