← 返回列表

Obsius-AI: AI驱动的智能体协作工具

聚合站 SecWiki技术 入库 2026-11-18T01:42:25

Obsius-AI 是一个 AI 驱动的安全研究工作台,面向 CTF、渗透测试、红队行动、逆向分析、Pwn、IoT/车联网研究和恶意样本分析。项目以 Windows 为主要运行环境,按任务需要使用 Docker 或 WSL2 执行隔离工作。

最简单的方式是双击项目根目录的 启动平台.bat:

也可以直接启动后端:

python scripts/serve.py
桌面窗口模式:

python scripts/serve.py --window
或双击 启动平台(窗口).bat。窗口模式会优先加载静态前端,其次探测 Vite;关闭最后一个 owner 窗口时会优雅停止服务并保存任务现场。停止平台请使用 停止平台.bat,它会先请求后端保存现场,再在超时后结束进程。

┌─────────────────────────────────────────────────────────┐
│ React + TypeScript + Vite WebUI                         │
│ 项目 / 智能体 / 任务 / 浏览器 / 样本 / 逆向 / 设置      │
└──────────────────────────┬──────────────────────────────┘
                           │ HTTP / WebSocket
┌──────────────────────────▼──────────────────────────────┐
│ FastAPI Core API(127.0.0.1:8420)                      │
│ API 路由 · 任务编排 · 黑板 · 浏览器池 · 分析适配器       │
└──────────────┬───────────────────┬─────────────────────┘
               │                   │
       SQLite(WAL)黑板       执行网关
       项目数据与审计事件       Host / WSL / Docker / Sandbox
               │                   │
               └──────────┬────────┘
                          ▼
                 LLM 供应商与外部工具
层 技术
后端 Python 3.11+、FastAPI、Uvicorn
前端 React、TypeScript、Vite、Tailwind CSS
存储 SQLite WAL,经 Core API 统一写入
浏览器 Electron WebContentsView 真实 Chromium + Python CDP(可选)
运行时 Windows 优先,按能力降级到 Docker/WSL2
测试 pytest

在项目根目录执行:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[api]"

按需安装可选能力:

python -m pip install -e ".[browser]"  # 浏览器与抓包能力
cd desktop
npm install                              # Electron 壳、node-pty 与真实浏览器标签
cd ..
python -m playwright install chromium   # 安装托管浏览器
cd webui
npm install

开发时启动 Vite:

npm run dev
构建生产静态文件:

npm run build
构建完成后,后端会自动从 webui/dist 同源托管前端,不再需要单独启动 Vite。

原文链接:https://github.com/ILOVCTRY/Obsius-AI