TestAgent — 智能测试平台

基于 LLM 的自动化测试用例生成与管理平台,遵循 TDD(测试驱动开发)和 DDD(领域驱动设计)方法论。

提供 CLI 命令行 和 Web 可视化平台 两种交互方式,集成 unified-test-platform 已有 800+ 测试用例。

快速开始

Web 平台(推荐)

# 1. 安装依赖
pip install -r requirements.txt

# 2. 启动后端
python -m backend
# 访问 http://localhost:5002

# 3. 前端开发(可选)
cd frontend && pnpm install && pnpm dev
# 访问 http://localhost:5174

CLI 命令行

# 扫描仓库并生成测试
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:

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+ 用例
Description
No description provided
Readme 818 KiB
Languages
Python 92.8%
TypeScript 7%