TBC/docs/QUICKSTART.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

2.1 KiB
Raw Blame History

TestAgent 快速开始

前置条件

  • Python 3.9+
  • Node.js 18+ (pnpm)
  • Git

1. 环境配置

# 创建 .env 文件
cat > .env << 'EOF'
OPENAI_API_KEY=sk-xxx
OPENAI_BASE_URL=https://llmgateway.d-robotics.cc/v1
TEST_USERNAME=your_username
TEST_PASSWORD=your_password
EOF

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

2. 前端构建

cd frontend
pnpm install
pnpm build
cd ..

3. 启动 Web 平台

python3 -m backend
# 访问 http://localhost:5002

4. CLI 命令行

# 扫描仓库并生成测试
python3 main.py run -r https://github.com/user/repo.git

# 精确回归(只对变更代码生成测试)
python3 main.py diff -r https://github.com/user/repo.git -a HEAD~3

# 仅 DDD 领域分析(不调用 LLM)
python3 main.py analyze -r https://github.com/user/repo.git

5. Web 平台页面

页面 路由 功能
控制台 /dashboard 统计概览 + 快速操作入口
仓库管理 /repos 添加 Git 仓库 → 扫描/分析/生成/回归
任务管理 /tasks 实时 SSE 日志流 + 停止/删除
测试报告 /reports 报告列表 + 详情 + 日志回放
已有用例 /existing 运行 D-Cloud 903 用例 + Robogo 13 场景

6. 仓库管理使用流程

1. 输入 Git 仓库 URL + 分支
2. 点击「扫描」→ 自动 clone + AST 分析 + DDD 建模
3. 展开仓库卡片 → 点击「生成测试」→ LLM 自动生成测试
4. 或点击「全流程」→ 一键完成扫描+分析+生成

7. 已有用例使用流程

D-Cloud

1. 选择模块(如 E2E 全量测试)
2. 选择具体测试用例
3. 点击运行

Robogo

1. 选择产品(Robogo 全量巡检 / 数据闭环)
2. 点击「配置并启动」
3. 填写产品/环境/范围/账号/密码
4. 点击「启动巡检」

8. API Key 配置方式

方式 说明
.env 文件 OPENAI_API_KEY=sk-xxx
环境变量 export OPENAI_API_KEY=sk-xxx
Web 页面输入框 仓库管理/任务创建页面
CLI 传参 python3 main.py run -r <url> -k sk-xxx