Security: - 添加 API 认证中间件 (PLATFORM_API_TOKEN Bearer Token) - SSRF 防护: 校验 git URL scheme + 过滤内网 IP - 路径遍历修复: module 参数添加 is_relative_to 校验 - 异常信息泄露修复: 统一错误处理不返回内部信息 - API Key 不持久化到数据库 - 硬编码 SSH Key 移至环境变量 - CORS 生产环境校验 Rate Limiting: - 新增内存滑动窗口速率限制 (6个POST端点) Performance: - ThreadPoolExecutor(max_workers=4) 限制并发 - 任务超时 _enforce_proc_timeout (默认3600s) - JSON 原子写入 tempfile+os.replace - 日志轮转 RotatingFileHandler - httpx 连接池配置 - 随机名改用 uuid4 - 前端 Error Boundary - 前端统一 EventSource 使用 Docs: - 更新 .env.example, CHANGELOG, API.md, CONFIG.md, AGENTS.md - .gitignore 添加 .venv/ 和 backend/db.json
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
Languages
Python
88.6%
TypeScript
7%
HTML
4.3%