TBC/README.md
jiawei.chen 6f6053ff51 feat: TestAgent 智能测试平台 v1.0
- 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 合规
2026-07-08 11:27:38 +08:00

160 lines
6.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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+ 用例 |