git clone https://github.com/mangod12/OneAlert.git
cd OneAlert
pip install -r requirements.txt
python -m backend.demo

docker compose up --build

# 后端
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m uvicorn backend.main:app --reload

# 前端
cd frontend-v2 && npm install && npm run dev

# AI代理所需
AI_PROVIDER=anthropic          # 或 openai, ollama, vllm, groq
ANTHROPIC_API_KEY=sk-ant-...   # 或 AI_API_KEY 用于兼容 OpenAI

# 可选
AI_TRIAGE_MODEL=claude-sonnet-4-20250514
AI_BASE_URL=http://localhost:11434/v1  # 用于 Ollama/vLLM
SECRET_KEY=your-production-secret
DATABASE_URL=postgresql://user:pass@host/db

                      OneAlert AI 安全操作系统
 ┌─────────────────┬───────────────────┬───────────────────────┐
 │  传感器层       │  代理层          │      控制平面          │
 │                 │                   │                        │
 │  Suricata EVE   │  检测代理         │  策略引擎              │
 │  Zeek 日志      │  分类代理         │  自主等级              │
 │  Syslog/Auth    │  狩猎代理         │  审批工作流            │
 │  OT 发现        │  响应代理         │  代理账本              │
 │  PII 脱敏       │  紫色团队代理     │  OT区域约束            │
 │                 │  合规代理         │  行动执行器            │
 ├─────────────────┼───────────────────┼───────────────────────┤
 │  数据层         │  AI运行时        │     前端               │
 │                 │                   │                        │
 │  PostgreSQL     │  Claude (默认)    │  仪表盘                │
 │  SQLite (开发)  │  兼容OpenAI      │  案例与调查            │
 │  事件存储       │  Ollama/vLLM     │  事件查看器            │
 │  代理账本       │  模型路由        │  MITRE ATT&CK 地图    │
 │  语义搜索       │                   │  狩猎实验室            │
 │                 │                   │  响应计划              │
 │                 │                   │  紫色团队验证          │
 └─────────────────┴───────────────────┴───────────────────────┘

Suricata/Zeek 事件 ──► 接收 API ──► 事件存储
                                            │
                                       检测代理 (异常检测)
                                            │
CVE 告警 (NVD/CISA/ICS-CERT) ──► 分类代理 (关联 + MITRE)
                                            │
                                       调查案例
                                            │
                                       响应代理 (管控计划)
                                            │
                                  人工批准 ──► 执行行动

backend/
├── services/ai/          # 提供商无关的LLM运行时
├── services/agents/       # 检测、分类、狩猎、响应、紫色代理
├── services/mitre/        # MITRE ATT&CK集成
├── services/parsers/      # Suricata + Zeek事件解析器
├── models/                # SQLAlchemy模型 + Pydantic模式
├── routers/               # FastAPI路由处理程序
├── services/pii_redactor.py    # PII/机密信息脱敏流水线
├── services/action_executor.py # 响应行动执行
├── services/semantic_search.py # TF-IDF搜索 + 爆炸半径
└── services/              # CVE、合规、计费、通知

frontend-v2/src/
├── pages/                 # 仪表盘、案例、事件、狩猎实验室、MITRE地图、响应计划、验证
├── components/            # 图表、布局、共享UI
└── stores/                # Zustand认证状态

tests/                     # 309个pytest测试
tests/e2e/                 # 针对已部署应用的Playwright E2E测试
docs/                      # AI_CONTEXT、ARCHITECTURE、CODEMAP、VISION