🔒 Security: - 修复 API Key 泄露,移除 platform_db.json 明文存储 - 限制 CORS 允许来源,不再全开放 - 添加路径校验防止目录穿越攻击 - Git 命令使用列表传参防止注入 - os.killpg 添加异常处理 🐛 Bug Fixes: - 生产环境禁用 Flask debug 模式 - 修复 SSE 连接泄漏(useTaskLogs + ReposView) - 修复 fetch 静默吞错误,添加 console.error 日志 - 补全 _run_ui_fix 函数签名 - 修复 .coveragerc source 配置 - _load_db 添加文件锁和 Queue maxsize - SSE log_queues 使用 WeakValueDictionary 🔧 Refactor: - BaseAPI → APIClient 统一命名 - 删除后端死代码和重复 import - 删除 business_backup 备份代码 - 删除 conftest_metrics 死代码 📝 Docs: - 新增 CHANGELOG.md 和 CHANGELIST.md - 更新 QUICKSTART.md 添加安全注意事项 - 更新 CONFIG.md 添加安全加固和性能优化
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
92.8%
TypeScript
7%