# TestCaseAI

**Repository Path**: jinxinran/test_case_ai

## Basic Information

- **Project Name**: TestCaseAI
- **Description**: 一个利用AI智能生成测试用例的智能体
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 测试智能体 (TestCaseAI)

## 项目概述

TestCaseAI 是一个智能测试用例生成和管理系统，旨在帮助测试工程师自动化生成测试用例、管理测试文档、执行回归测试并输出详细测试报告。该项目针对随手记会员开通/升级引导功能进行测试用例优化，提供了完整的测试框架和工具集。

## 目录结构

```
Test_Case_AI/
├── config/                          # 配置文件目录
│   ├── config.json                  # 项目配置文件
│   └── trae_config/
│       └── role_config.yaml         # 角色配置文件
├── test_cases/                      # 测试用例目录
│   ├── test_cases.json              # 测试用例集合
│   └── regression_test_report.json  # 回归测试报告
├── test_results/                     # 测试结果目录
│   └── regression_test_report.txt   # 回归测试文本报告
├── test_scripts/                     # 测试脚本目录
│   ├── api_documentation.py         # API文档管理模块
│   ├── data_storage.py              # 数据存储管理模块
│   ├── document_management.py       # 文档管理模块
│   ├── export_module.py             # 测试用例导出模块
│   ├── regression_test.py           # 回归测试模块
│   └── test_framework.py            # 测试框架核心模块
└── README.md                        # 项目说明文档
```

## 功能特性

### 1. 测试用例管理
- 支持 JSON 格式测试用例存储
- 提供测试用例分类和检索功能
- 支持测试用例的增删改查操作

### 2. API 文档管理
- 自动解析 API 接口文档
- 关联测试用例与 API 接口
- 支持多版本 API 管理

### 3. 回归测试
- 自动执行历史接口功能回归测试
- 生成详细的测试报告
- 支持测试结果导出

### 4. 文档管理
- 支持需求文档 (PRD) 上传和管理
- 文档分类和检索功能
- 文件哈希校验确保文档完整性

### 5. 数据存储
- 加密存储测试数据
- 支持分类存储和日期范围查询
- 数据导出功能 (支持 JSON 格式)

### 6. 测试用例导出
- 支持导出为 CSV 格式
- 自动提取模块、前置条件、测试步骤、预期结果
- 支持优先级标记

## 测试接口

系统提供以下核心测试接口：

| 接口类型 | 说明 |
|---------|------|
| 空间付费拦截 | 测试空间使用量达到不同阈值时的引导场景 |
| 账本创建拦截 | 测试账本持有量达到不同阈值时的引导场景 |
| 账本人数拦截 | 测试成员人数达到不同阈值时的引导场景 |
| 会员试用期计算 | 测试会员试用期的各种计算场景 |

### 测试场景覆盖

- **正常场景**: 覆盖所有正常业务流程
- **边界场景**: 覆盖各种边界条件 (如空间 5G、30G、365G 等临界点)
- **异常场景**: 覆盖接口异常、超限等情况

## 环境配置

### 依赖环境
- Python 3.8+
- 必要的 Python 包 (requests, json, hashlib 等)

### 配置文件
- `config.json`: 项目基础配置
- `role_config.yaml`: 角色配置 (Trea 系统集成)

## 使用说明

### 1. 运行测试框架
```python
from test_scripts.test_framework import TestFramework

framework = TestFramework()
framework.load_config()
framework.load_test_cases()
framework.run_all_tests()
framework.generate_report()
```

### 2. 执行回归测试
```python
from test_scripts.regression_test import RegressionTester

tester = RegressionTester('api_doc_path')
tester.parse_api_endpoints()
tester.create_test_cases()
tester.run_all_tests()
tester.generate_report('report_path')
```

### 3. 导出测试用例
```python
from test_scripts.export_module import ExportModule

exporter = ExportModule()
exporter.export_test_cases_to_csv(test_cases, 'output.csv')
```

## 测试结果

测试结果保存在 `test_results/` 目录，包含：
- 回归测试详细报告 (JSON 格式)
- 回归测试文本报告 (TXT 格式)

## 注意事项

1. 配置文件路径需根据实际部署环境调整
2. 测试用例需与实际 API 接口保持一致
3. 定期执行回归测试确保功能稳定性
4. 敏感数据存储采用加密处理，确保数据安全