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