# ai-test-platform

**Repository Path**: rain_yang/ai-test-platform

## Basic Information

- **Project Name**: ai-test-platform
- **Description**: 基于 7 阶段功能测试全流程的 AI 驱动测试平台，覆盖从需求分析到上线监控的完整测试生命周期。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-23
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 智能测试平台

基于 7 阶段功能测试全流程的 AI 驱动测试平台，覆盖从需求分析到上线监控的完整测试生命周期。


## 界面预览

(![AI 智能测试平台](docs/screenshot.png))


## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Python 3.11+ · FastAPI · SQLAlchemy · SQLite · OpenAI SDK |
| 前端 | Vue 3 · Vite · Element Plus · Vue Router |
| AI   | OpenAI 兼容接口（默认接入公司万擎大模型） |

---

## 功能模块

### 7 阶段测试流程

| 阶段 | 功能 |
|------|------|
| S1 需求分析 | 上传需求文档（PDF/Word/文本），AI 解析功能点、预检缺陷风险 |
| S2 用例设计 | AI 生成手工 / 接口 / WebUI / AppUI 四类测试用例，自动入库 |
| S3 冒烟测试 | 快速执行冒烟用例，AI 分析日志，生成通过/失败报告 |
| S4 功能测试 | 全量用例执行，AI 对结果进行智能分析 |
| S5 Bug 追踪 | Bug 录入、严重级别管理，AI 规范化描述 + 根因分析 |
| S6 回归测试 | AI 推荐回归范围，生成测试报告 |
| S7 上线监控 | 上线后日志监控，AI 实时分析异常 |

### 基础管理

- **大模型配置**：11 个场景独立配置 API Key / Base URL / Model，支持一键恢复万擎默认
- **Skill 管理**：知识库维护，支持上传 ZIP 包查看所有文件内容，注入 AI 提示词
- **MCP 服务**：MCP 工具服务器管理
- **接口资产**：API 接口管理，支持 Swagger 2.0 / OpenAPI 3.x 导入（JSON/YAML/URL）

---

## 目录结构

```
ai-test-platform/
├── backend/                # FastAPI 后端
│   ├── main.py             # 应用入口
│   ├── models.py           # 数据模型
│   ├── database.py         # 数据库连接
│   ├── config.py           # 配置读取
│   ├── routers/            # API 路由
│   ├── services/           # AI 服务层（LLM 调用）
│   ├── requirements.txt    # Python 依赖
│   ├── .env                # 环境变量（不提交）
│   └── data/               # SQLite 数据库（不提交）
├── frontend/               # Vue 3 前端
│   ├── src/
│   │   ├── views/          # 页面组件
│   │   ├── App.vue         # 根组件（主题切换）
│   │   ├── router.js       # 路由配置
│   │   ├── api.js          # 接口封装
│   │   └── style.css       # 全局样式（赛博朋克主题）
│   └── package.json
└── start.sh                # 一键启动脚本
```

---

## 快速启动

### 前置条件

- Python 3.11+
- Node.js 18+

### 方式一：一键启动

```bash
cd ai-test-platform
chmod +x start.sh
./start.sh
```

### 方式二：分别启动

**启动后端**

```bash
cd ai-test-platform/backend

# 首次：创建虚拟环境并安装依赖
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 启动
python main.py
# 或
uvicorn main:app --host 0.0.0.0 --port 8001 --reload
```

**启动前端**

```bash
cd ai-test-platform/frontend

# 首次：安装依赖
npm install

# 开发模式
npm run dev

# 生产构建
npm run build
```

### 访问地址

| 服务 | 地址 |
|------|------|
| 前端界面 | http://localhost:5174 |
| 后端 API | http://localhost:8001 |
| API 文档 | http://localhost:8001/docs |

---

## 环境变量配置

后端 `backend/.env` 文件（参考 `.env.example`）：

```env
# 大模型配置（OpenAI 兼容，默认万擎）
OPENAI_API_KEY=your-api-key
OPENAI_BASE_URL=https://your-llm-endpoint/v1
OPENAI_MODEL=your-model-name

# 可选：温度 / 最大 Token（留空使用模型默认）
LLM_TEMPERATURE=
LLM_MAX_TOKENS=

# 数据库路径
DATABASE_URL=sqlite:///./data/platform.db
```

> 也可在平台「大模型配置」页面为每个测试阶段单独配置，页面配置优先级高于 `.env`。

---

## 主题切换

平台支持**暗黑赛博朋克**和**浅色**两种主题，点击顶栏右侧 🌙 / ☀️ 按钮切换。