- CLI + Web 双平台,基于 LLM 的 TDD+DDD 自动化测试生成 - 集成 unified-test-platform 903 个 D-Cloud 用例 + 13 个 Robogo 场景 - Agent 5 步流水线: 扫描 -> DDD -> LLM 生成测试 - 精确回归 + UI 变更检查 - 可视化 HTML 测试报告 - 暗色/亮色主题切换 - 19 个 API 端点 + 6 个 SPA 页面 - 15/15 项 TDD+DDD 合规
160 lines
6.9 KiB
Markdown
160 lines
6.9 KiB
Markdown
# TestAgent — 智能测试平台
|
||
|
||
基于 LLM 的自动化测试用例生成与管理平台,遵循 TDD(测试驱动开发)和 DDD(领域驱动设计)方法论。
|
||
|
||
提供 **CLI 命令行** 和 **Web 可视化平台** 两种交互方式,集成 unified-test-platform 已有 800+ 测试用例。
|
||
|
||
## 快速开始
|
||
|
||
### Web 平台(推荐)
|
||
|
||
```bash
|
||
# 1. 安装依赖
|
||
pip install -r requirements.txt
|
||
|
||
# 2. 启动后端
|
||
python -m backend
|
||
# 访问 http://localhost:5002
|
||
|
||
# 3. 前端开发(可选)
|
||
cd frontend && pnpm install && pnpm dev
|
||
# 访问 http://localhost:5174
|
||
```
|
||
|
||
### CLI 命令行
|
||
|
||
```bash
|
||
# 扫描仓库并生成测试
|
||
python main.py run -r https://github.com/user/repo.git -k sk-your-api-key
|
||
|
||
# 不传 API Key 会交互式提示输入
|
||
python main.py run -r https://github.com/user/repo.git
|
||
```
|
||
|
||
## 页面功能
|
||
|
||
| 页面 | 路由 | 功能 |
|
||
|------|------|------|
|
||
| **控制台** | `/dashboard` | 统计概览(仓库/任务/报告/已有用例)+ 快速操作入口 |
|
||
| **仓库管理** | `/repos` | 添加 Git 仓库 → 扫描 → DDD 分析 → 生成测试 → 精确回归 → 全流程一键执行 |
|
||
| **任务管理** | `/tasks` | 任务列表 + 实时 SSE 日志流 + 停止/删除 |
|
||
| **测试报告** | `/reports` | 报告列表 + 详细日志 + 失败截图查看 |
|
||
| **已有用例** | `/existing` | 浏览 unified-test-platform 的 22 个模块 800+ 用例,按模块/标记运行 |
|
||
|
||
## CLI 命令
|
||
|
||
| 命令 | 说明 |
|
||
|------|------|
|
||
| `run` | 全量扫描生成 — 克隆仓库 → 分析代码 → 提取领域模型 → LLM 生成测试 |
|
||
| `diff` | 精确回归 — 只对 git diff 变更文件生成测试,自动映射限界上下文 |
|
||
| `analyze` | 领域分析 — 只分析 DDD 领域模型,不调用 LLM(免费) |
|
||
|
||
## 测试类型
|
||
|
||
```
|
||
smoke 冒烟测试 — 核心主流程快速验证
|
||
unit 单元测试 — 领域层纯逻辑,Mock 隔离所有外部依赖
|
||
integration 集成测试 — 跨模块/跨服务接口联动
|
||
regression 回归测试 — 代码变更后精确回归
|
||
e2e 端到端测试 — 完整业务流程黑盒验证
|
||
```
|
||
|
||
## 5 步流水线
|
||
|
||
```
|
||
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
||
│ 1.拉取代码│ → │ 2.代码分析│ → │ 3.领域提取│ → │ 4.Prompt │ → │ 5.LLM生成 │
|
||
│ git clone │ │ AST解析 │ │ DDD建模 │ │ SOUL+技能 │ │ 测试用例 │
|
||
└──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘
|
||
```
|
||
|
||
## 生成的测试目录结构
|
||
|
||
```
|
||
tests/
|
||
├── domain/ # 领域层测试(纯逻辑,Mock 隔离)
|
||
│ └── {context_name}/
|
||
│ ├── test_entities.py
|
||
│ ├── test_value_objects.py
|
||
│ ├── test_services.py
|
||
│ └── test_aggregates.py
|
||
├── infrastructure/ # 基础设施层测试(真实依赖)
|
||
│ └── {context_name}/
|
||
│ ├── test_repositories.py
|
||
│ └── test_api.py
|
||
├── session/ # Session 领域测试
|
||
│ ├── test_session_lifecycle.py
|
||
│ └── test_session_context.py
|
||
├── smoke/ / integration/ / e2e/ # 分层测试
|
||
├── conftest.py # 全局 fixtures
|
||
└── domain_report.md # DDD 领域分析报告
|
||
```
|
||
|
||
## 配置
|
||
|
||
编辑 `config.yaml`:
|
||
|
||
```yaml
|
||
agent:
|
||
model: deepseek-chat # LLM 模型
|
||
provider: deepseek # deepseek / openai / anthropic
|
||
base_url: https://api.deepseek.com
|
||
temperature: 0.3
|
||
|
||
test_generation:
|
||
metrics_gate:
|
||
min_coverage: 60 # 覆盖率门禁
|
||
min_pass_rate: 95 # 通过率门禁
|
||
```
|
||
|
||
## 支持的编程语言
|
||
|
||
| 语言 | 分析能力 | 测试框架 |
|
||
|------|---------|---------|
|
||
| Python | AST 全量解析(类/函数/导入/装饰器) | pytest |
|
||
| TypeScript | 正则提取(类/函数/导入) | Jest |
|
||
| JavaScript | 正则提取 | Jest |
|
||
| Go | 基础行数统计 | testing |
|
||
| Java | 基础行数统计 | JUnit |
|
||
|
||
## 插件系统
|
||
|
||
| 插件 | 触发时机 | 功能 |
|
||
|------|---------|------|
|
||
| `pylint_analyzer` | pre_analysis | 代码静态质量扫描(行长度/TODO/print 检测) |
|
||
| `test_runner` | post_generation | 自动运行生成的测试 + 指标门禁检查 |
|
||
|
||
## 架构概览
|
||
|
||
```
|
||
┌──────────────────────────────────────┐
|
||
│ React SPA (Vite) │
|
||
│ Dashboard / Repos / Tasks / Reports │
|
||
│ /existing (已有用例) │
|
||
└────────────────┬─────────────────────┘
|
||
│ HTTP + SSE
|
||
┌────────────────▼─────────────────────┐
|
||
│ Flask Backend (端口 5002) │
|
||
│ API 路由 / 任务调度 / SSE 日志流 │
|
||
└────────────────┬─────────────────────┘
|
||
│
|
||
┌──────────────────────┼──────────────────────┐
|
||
│ │ │
|
||
┌─────────▼─────────┐ ┌────────▼────────┐ ┌─────────▼─────────┐
|
||
│ agent/ (引擎) │ │ unified-test- │ │ main.py (CLI) │
|
||
│ LLM + Git + AST │ │ platform/tests/ │ │ run/diff/analyze │
|
||
│ DDD + 测试生成 │ │ 800+ 已有用例 │ │ │
|
||
└───────────────────┘ └─────────────────┘ └───────────────────┘
|
||
```
|
||
|
||
## 与 hermes-bot 的对比
|
||
|
||
| 维度 | hermes-bot | TestAgent |
|
||
|------|-----------|-----------|
|
||
| 定位 | 飞书销售顾问机器人 | 智能测试用例生成与管理平台 |
|
||
| 交互方式 | 飞书 WebSocket 对话 | CLI + Web 可视化平台 |
|
||
| LLM 用途 | 自然语言对话 | 代码生成 |
|
||
| 知识库 | 产品/价格/销售流程 | TDD/DDD/测试框架规范 |
|
||
| 插件 | 报价计算/对话 guardrails | 静态分析/测试运行 |
|
||
| 输出 | 自然语言回复 | pytest 测试文件 + Web 任务管理 |
|
||
| 已有资产 | 无 | 集成 unified-test-platform 800+ 用例 | |