### [npm](https://www.npmjs.com/package/@vigolium/vigolium)```bash
npm install -g @vigolium/vigolium

查看[架构概览](https://docs.vigolium.com/architecture/overview)以了解完整流水线，查看[策略指南](https://docs.vigolium.com/native-scan/strategies)以了解策略、配置文件和节奏配置。如需快速命令参考，请参阅 [docs.vigolium.com/getting-started/cheat-sheet](https://docs.vigolium.com/getting-started/cheat-sheet)。

## 服务器模式```bash
# Start API server with authentication
vigolium server -k my-secret-key

# Enable transparent HTTP proxy for traffic recording
vigolium server -k my-key --ingest-proxy-port 9003

# Auto-scan ingested traffic
vigolium server -k my-key --scan-on-receive

python3 -m pip install -r requirements.txt
python3 -m pip install -e .

python3 -m cveintel --help

usage: cveintel [-h] [-v] [-d] [-c CONFIG] [-o OUTPUT] [-f {json,table,csv}] [-s {critical,high,medium,low}]
                [-k KEYWORD] [-l LIMIT] [-p PROVIDER] [-t TIMEFRAME] [--no-cache] [--clear-cache]
                [--cache-stats] [--cache-max-age CACHE_MAX_AGE] [--cache-dir CACHE_DIR] [--no-color]
                [--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [--log-file LOG_FILE]

CVE Intelligence Aggregator - 从多个来源获取并分析 CVE 数据

options:
  -h, --help            显示此帮助信息并退出
  -v, --version         显示程序版本号并退出
  -d, --debug           启用调试日志
  -c CONFIG, --config CONFIG
                        配置文件路径
  -o OUTPUT, --output OUTPUT
                        输出文件路径
  -f {json,table,csv}, --format {json,table,csv}
                        输出格式（默认：table）
  -s {critical,high,medium,low}, --severity {critical,high,medium,low}
                        按严重程度过滤
  -k KEYWORD, --keyword KEYWORD
                        按关键词过滤
  -l LIMIT, --limit LIMIT
                        结果数量限制
  -p PROVIDER, --provider PROVIDER
                        指定数据提供者（nvd、cisa、github、all）
  -t TIMEFRAME, --timeframe TIMEFRAME
                        时间范围（例如：7d、30d、90d）
  --no-cache            禁用缓存
  --clear-cache         清空缓存后退出
  --cache-stats         显示缓存统计信息后退出
  --cache-max-age CACHE_MAX_AGE
                        缓存最大保留时间（秒）
  --cache-dir CACHE_DIR
                        缓存目录
  --no-color            禁用彩色输出
  --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
                        日志级别
  --log-file LOG_FILE   日志文件路径

# 获取最近的严重 CVE
python3 -m cveintel -s critical -l 10

# 获取最近 30 天的 CVE
python3 -m cveintel -t 30d -f json -o cves.json

# 按关键词搜索
python3 -m cveintel -k "remote code execution" -l 20

# 使用特定提供者
python3 -m cveintel -p nvd -s high -l 15

# 显示缓存统计信息
python3 -m cveintel --cache-stats

# 清空缓存
python3 -m cveintel --clear-cache

┌─────────────┬──────────┬──────────────────────────────────────┬────────────┐
│ CVE ID      │ 严重程度 │ 描述                                 │ 发布日期   │
├─────────────┼──────────┼──────────────────────────────────────┼────────────┤
│ CVE-2024-...│ CRITICAL │ 远程代码执行漏洞...                  │ 2024-01-15 │
│ CVE-2024-...│ HIGH     │ 身份验证绕过...                      │ 2024-01-14 │
└─────────────┴──────────┴──────────────────────────────────────┴────────────┘

# API 密钥
api_keys:
  nvd: "your-nvd-api-key"
  github: "your-github-token"

# 数据提供者
providers:
  nvd:
    enabled: true
    base_url: "https://services.nvd.nist.gov/rest/json/cves/2.0"
  cisa:
    enabled: true
    base_url: "https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json"
  github:
    enabled: true
    base_url: "https://api.github.com/advisories"

# 缓存设置
cache:
  enabled: true
  ttl: 3600  # 秒
  directory: "~/.cache/cveintel"

# 输出设置
output:
  format: "table"
  color: true
  max_results: 100

# 日志设置
logging:
  level: "INFO"
  file: "cveintel.log"

export NVD_API_KEY="your-nvd-api-key"
export GITHUB_TOKEN="your-github-token"
export CVEINTEL_CONFIG="/path/to/config.yaml"
export CVEINTEL_CACHE_DIR="/path/to/cache"
export CVEINTEL_LOG_LEVEL="DEBUG"

cveintel/
├── __init__.py
├── __main__.py          # 入口点
├── cli.py               # 命令行界面
├── config.py            # 配置管理
├── models.py            # 数据模型
├── cache.py             # 缓存实现
├── aggregator.py        # 数据聚合
├── providers/           # 数据提供者
│   ├── __init__.py
│   ├── base.py          # 基础提供者类
│   ├── nvd.py           # NVD 提供者
│   ├── cisa.py          # CISA 提供者
│   └── github.py        # GitHub 提供者
├── filters/             # 过滤逻辑
│   ├── __init__.py
│   ├── severity.py      # 严重程度过滤
│   ├── keyword.py       # 关键词过滤
│   └── timeframe.py     # 时间范围过滤
└── output/              # 输出格式化器
    ├── __init__.py
    ├── json_formatter.py
    ├── table_formatter.py
    └── csv_formatter.py

# 克隆仓库
git clone https://github.com/yourusername/cveintel.git
cd cveintel

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate     # Windows

# 安装开发依赖
pip install -r requirements-dev.txt
pip install -e .

# 运行测试
pytest

# 运行代码检查
flake8 cveintel/
black cveintel/
mypy cveintel/

# 运行所有测试
pytest

# 运行覆盖率测试
pytest --cov=cveintel --cov-report=html

# 运行特定测试文件
pytest tests/test_providers.py

# 运行特定测试
pytest tests/test_providers.py::test_nvd_provider

有关服务器设置，请参阅[运行服务器](https://docs.vigolium.com/server-mode/running-the-server)；有关摄取工作流，请参阅[摄取](https://docs.vigolium.com/server-mode/ingestion)；有关完整的 REST API 参考，请参阅 [API 概览](https://docs.vigolium.com/api-overview)。

> **代理集成**：使用适用于 Burp Suite 的 [burp-vigolium](https://github.com/vigolium/burp-vigolium) 扩展或适用于 Caido 的 [caido-vigolium](https://github.com/vigolium/caido-vigolium) 插件，将实时代理流量转发到正在运行的 Vigolium 服务器。两者都提供相同的桥接协议（`-B/--burp-bridge-url`，别名为 `--caido-bridge-url`），并且摄取到的流量会标记其来源代理。

## 认证扫描

Vigolium 支持多会话认证扫描，用于 IDOR/BOLA 测试和权限提升检查：```bash
# Inline session via CLI flag (name:Header:value)
vigolium scan -t https://example.com \
  --auth "admin:Cookie:session_id=abc123" \
  --auth "user:Cookie:session_id=xyz789"

# Load session(s) from a YAML/JSON file
vigolium scan -t https://example.com --auth-file ./admin-session.yaml

# Auth file with an automated login flow (token extraction, etc.)
vigolium scan -t https://example.com --auth-file ./login-flow.yaml

# Add custom headers (works with sessions)
vigolium scan -t https://example.com -H "Authorization: Bearer token123"

Agentic 扫描模式：
- **Autopilot**：自主扫描。CLI 直接调用 `pkg/olium/autopilot.Run`；服务器在同一循环周围添加 vigolium-audit 预处理、认证设置和冻结的上下文包
- **Swarm**：AI 引导的漏洞扫描，支持定向单请求和全范围（`--discover`）。主代理分析输入、选择模块、生成自定义 JS 扩展、运行代码审计和 SAST、执行扫描并对结果进行分诊
- **Audit**：通过 `vigolium agent audit` 进行源代码审计——一个统一调度器，运行内嵌的 **vigolium-audit**（claude/codex）和/或 **piolium**（Pi 原生）执行框架，通过 `--driver {auto|both|audit|piolium}` 选择（默认 `auto`：预检 audit 分支，当解析到的 `claude`/`codex` CLI 在 PATH 上、二进制已内嵌且链具有 audit 支持的模式时运行它；否则回退到 piolium 而不启动 audit。运行中 audit 失败会暴露出来，而不是切换驱动）。独立的执行框架；**不要**通过 olium 路由。每个驱动的子行位于一个父 AgenticScan 下，并在后处理阶段进行发现去重。没有独立的 `agent piolium` 子命令——piolium 通过 `--driver=piolium` 运行

> **独立审计 CLI**：agentic 安全审计也以独立 CLI 形式发布，可独立于 Vigolium 运行：[vigolium-audit](https://github.com/vigolium/vigolium-audit)（`vigolium agent audit` 背后的执行框架）和 [piolium](https://github.com/vigolium/piolium)（`vigolium agent audit --driver=piolium` 背后的 Pi 原生驱动）。

完整指南请参阅 [agent 模式指南](https://docs.vigolium.com/agentic-scan/agent-mode)。

## ⚡ Vigolium 云控制台

面向希望获得 Vigolium 强大功能而无需管理基础设施的团队的云解决方案。控制台是 **Vigolium 的升级、全功能版本**，由**先进的自主代理**主导整个工作流程——对目标进行推理、选择自己的攻击路径并确认其发现——在开源核心之上叠加托管扫描和共享结果，让你可以专注于修复漏洞，而不是维护工具。

> 感兴趣？[联系我们获取演示](https://www.vigolium.com/request-demo)。

## 原生扫描层

原生扫描流水线由模块化层组成，每一层都有单独的文档：

| 层 | 描述 | 文档 |
|-------|-------------|------|
| **内容发现（Deparos）** | 自适应目录/文件枚举，具有基于指纹的软 404 检测 | [docs.vigolium.com/native-scan/phases/discovery](https://docs.vigolium.com/native-scan/phases/discovery) |
| **浏览器爬虫（Spitolas）** | Chromium 驱动的状态机爬虫，具有 CDP 流量捕获 | [docs.vigolium.com/native-scan/phases/spidering](https://docs.vigolium.com/native-scan/phases/spidering) |
| **审计** | 主动/被动漏洞扫描，具有插入点提取和 DiffScan 框架 | [docs.vigolium.com/native-scan/phases/audit](https://docs.vigolium.com/native-scan/phases/audit) |
| **扫描器模块** | 207 个主动模块和 117 个被动模块，覆盖 OWASP Top 10 及更多 | [docs.vigolium.com/native-scan/modules-reference](https://docs.vigolium.com/native-scan/modules-reference) |

## 文档

完整文档位于 [docs.vigolium.com](https://docs.vigolium.com/)。发行说明和版本历史见 [CHANGELOG](https://github.com/vigolium/vigolium/blob/main/CHANGELOG.md)。快速链接：

| 主题 | 链接 |
|-------|------|
| 设置代理 | [docs.vigolium.com/getting-started/setup-agent](https://docs.vigolium.com/getting-started/setup-agent) |
| 启动原生扫描 | [docs.vigolium.com/getting-started/native-scan](https://docs.vigolium.com/getting-started/native-scan) |
| 启动 Agentic 扫描 | [docs.vigolium.com/getting-started/agentic-scan](https://docs.vigolium.com/getting-started/agentic-scan) |
| 启动 Agentic 审计 | [docs.vigolium.com/getting-started/agentic-security-audit](https://docs.vigolium.com/getting-started/agentic-security-audit) |
| 快速开始 | [docs.vigolium.com/getting-started/quickstart](https://docs.vigolium.com/getting-started/quickstart) |
| 速查表 | [docs.vigolium.com/getting-started/cheat-sheet](https://docs.vigolium.com/getting-started/cheat-sheet) |
| 服务器与数据摄取 | [docs.vigolium.com/getting-started/server-and-ingestion](https://docs.vigolium.com/getting-started/server-and-ingestion) |
| 编写扩展 | [docs.vigolium.com/customization/writing-extensions](https://docs.vigolium.com/customization/writing-extensions) |

## JavaScript 引擎

直接运行 JavaScript/TypeScript 代码，或编写自定义扫描模块和钩子而无需重新编译：```bash
# Execute inline JavaScript
vigolium js --code 'let r = vigolium.http.get(TARGET); console.log(r.status)' -t https://example.com

# Run a JS file with timeout
vigolium js --code-file ./my-script.js -t https://example.com --timeout 60s

# Manage extensions
vigolium ext ls                # list loaded extensions
vigolium ext docs --example    # browse API with code examples
vigolium ext preset            # install starter scripts

See [writing extensions](https://docs.vigolium.com/customization/writing-extensions) for the extension authoring guide and `pkg/jsext/vigolium.d.ts` for the full TypeScript API definitions.

## CLI 参考

<details>
<summary>展开完整的命令与标志参考</summary>

### 命令```
Scanning:
  vigolium scan                Run a native scan (deterministic multi-phase vulnerability scanning)
  vigolium run <phase>         Run a single native scan phase (alias for scan --only <phase>)
  vigolium scan-url <url>      Quick native scan of a single URL
  vigolium scan-request        Native scan from a raw HTTP request

Agentic scan (in-process olium engine):
  vigolium agent autopilot     Autonomous AI-driven vulnerability scanning
  vigolium agent swarm         AI-guided targeted or full-scope vulnerability scanning
  vigolium agent query         Single-shot prompt (code review, endpoint discovery)
  vigolium agent olium         Direct olium TUI (or one-shot non-interactive via -p)
  vigolium agent audit         Unified driver dispatcher (vigolium-audit and/or piolium, --driver=auto|both|audit|piolium)
  vigolium agent session       Browse/replay agent session artifacts
  vigolium olium | vigolium ol Top-level alias for `vigolium agent olium`

Server & ingestion:
  vigolium server              Start the API server with traffic ingestion
  vigolium ingest              Ingest traffic to a running server
  vigolium storage             Interact with cloud object storage (uploads, downloads)

Data & projects:
  vigolium db                  Database operations (list, stats, export, clean, seed)
  vigolium finding             Browse and manage findings (load, tui)
  vigolium traffic             Browse and replay HTTP records (tui, replay)
  vigolium replay              Mutate a stored/supplied HTTP request and diff baseline vs replay
  vigolium project             Manage projects (create, list, use, config)
  vigolium scope               Manage scope rules
  vigolium import              Import findings/data from external sources
  vigolium export              Export scan results

Extensions & auth:
  vigolium js                  Execute JavaScript/TypeScript code
  vigolium ext                 Manage JavaScript extensions (eval, lint)
  vigolium auth                Manage authentication sessions (list, load, lint, totp)

Setup & introspection:
  vigolium init                Initialize a Vigolium workspace
  vigolium config              Manage configuration (ls, set, path, clean)
  vigolium strategy            Inspect scanning strategies and phases
  vigolium module              Inspect/enable scanner modules
  vigolium doctor              Diagnose environment & dependencies
  vigolium version             Show version info

</details>

## 仓库布局

`platform/` 目录包含外部工具和 UI Dashboard，不属于核心扫描器的一部分。不应对其进行任何更改。

## 基准测试

Vigolium 持续针对故意存在漏洞的应用程序进行基准测试，并通过漏洞赏金和负责任披露计划对真实目标进行大量测试。

- **自托管（Docker）：** [DVWA](https://github.com/digininja/DVWA)、[OWASP Juice Shop](https://github.com/juice-shop/juice-shop)、[VAmPI](https://github.com/erev0s/VAmPI)、[crAPI](https://github.com/OWASP/crAPI)、[Vulnerable Java App](https://github.com/DataDog/vulnerable-java-application)、[Vulnerable Nginx](https://github.com/detectify/vulnerable-nginx)、[OopsSec Store](https://github.com/kOaDT/oss-oopssec-store)（自定义 Next.js 应用）
- **外部（托管）：** [Acunetix TestPHP](http://testphp.vulnweb.com)、[Gin & Juice Shop](https://ginandjuice.shop)、[Testfire](http://demo.testfire.net)
- **XSS 与多漏洞：** [BruteLogic XSS](https://github.com/vigolium/vigolium/blob/main/test/benchmark/xss_scanner)、[XBOW](https://github.com/vigolium/vigolium/blob/main/test/benchmark/definitions/xbow)（XSS、SQLi、SSTI、LFI、SSRF、XXE、命令注入）

使用 `make test-canary`（Docker 应用）或 `make test-integration`（XSS）运行基准测试。

## 开发```bash
make build          # build and install
make test           # run all tests (auto-installs gotestsum)
make test-unit      # fast unit tests (-short, no external deps)
make test-e2e       # E2E tests (requires Docker)
make lint           # run linter
make fmt            # format code