# testagent

**Repository Path**: dragondjf/testagent

## Basic Information

- **Project Name**: testagent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-21
- **Last Updated**: 2026-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 测试智能体开发与工具集成平台（v1.0）

> 基于软件工厂理念，以 **DeepSeek Harness（DSH）** 为技术底座、**一切皆插件**为核心架构的下一代智能测试基础设施。

核心公式：**`Agent = Model + Harness`** —— 平台所有能力均以 DSH 插件形式承载，通过 `--patch` 注入 DSH 运行时，**不包含、不修改 DSH 源码**，仅依赖其 npm 包。

## 一、技术底座

- **运行时**：`@deepseek-ai/dsh`（DSH 主包，含完整 agent loop / Web UI / 沙箱 / 多模型）
- **插件机制**：Cordis 插件系统，`ctx.tools` / `ctx.systemPrompt` / Service 注入等扩展点
- **语言**：TypeScript（插件）、Node.js（运行时）、Vite + 原生 JS（前端）
- **存储**：JSON 文件（`.testagent-data/`，零外部依赖）

## 二、目录结构

```
testagent/
├── plugins/                  # DSH 插件（平台核心，以 --patch 注入）
│   ├── core/                 # 核心服务：领域模型 / 存储 / CRUD（ctx.testAgent）
│   ├── tools/                # 测试工具：defineTool 暴露给模型
│   ├── preset/               # 预设：预置五类测试智能体 + 平台 system-prompt
│   ├── executor/             # 测试执行智能体：统一调度 / 状态感知 / 自愈重试（ctx.testExecutor）
│   ├── report/               # 报告生成智能体：GJB438C 文档 / 根因分析（ctx.testReport）
│   ├── http/                 # HTTP 桥接：REST API 供前端与外部调用
│   └── cordis.generated.yml  # 插件装载文件（脚本自动生成）
├── web/                      # 前端门户（1:1 复刻高保真原型 V2，Vite）
│   └── src/proto.css         # 原型完整设计系统 CSS
│   └── src/proto.js          # 原型 11 视图 + 动态数据接入
├── scripts/
│   └── dev-harness.mjs       # 启动脚本（生成装载 + 拉起 DSH 运行时）
├── docs/
│   └── 插件开发计划.md        # 功能需求 → 插件完整映射（覆盖产品定义）
└── package.json              # 依赖 DSH 相关包
```

## 三、快速开始

### 前置
- Node.js ≥ 22、pnpm

### 1. 安装依赖
```bash
cd /f/workspace/yfjzworkspace/webspace/aispace/testagent
pnpm install          # 安装 DSH 运行时与插件依赖
cd web && npm install # 安装前端依赖
cd ..
```

### 2. 启动后端（DSH 运行时 + 平台插件）
```bash
node scripts/dev-harness.mjs            # 默认（会开浏览器到 DSH Web UI）
node scripts/dev-harness.mjs --no-open  # 仅启动服务
```
启动后：
- 平台 REST API：`http://localhost:8090`
- DSH Web UI：`http://localhost:3080`

### 3. 启动前端（复刻原型 V2 门户）
```bash
cd web && npm run dev
```
访问 `http://localhost:5173`，前端通过 `/api` 代理访问后端 8090。

## 四、REST API 概览

| 方法 | 路径 | 说明 |
|:---|:---|:---|
| GET | `/api/health` | 健康检查 |
| GET/POST | `/api/agents` | 智能体列表 / 创建 |
| GET/PUT/DELETE | `/api/agents/:id` | 智能体详情 / 更新 / 删除 |
| GET/POST | `/api/tasks` | 任务列表 / 创建（自动生成用例） |
| GET/DELETE | `/api/tasks/:id` | 任务详情 / 删除 |
| POST | `/api/tasks/:id/run` | 执行单个任务 |
| POST | `/api/tasks/:id/cases` | 重新生成用例 |
| POST | `/api/executor/run` | 批量调度（并行 / 状态感知 / 自愈重试） |
| GET | `/api/executor/progress/:runId` | 调度进度 |
| GET/POST | `/api/reports` | 报告列表 / 聚合生成 |
| POST | `/api/reports/gjb438c` | 生成 GJB438C 软件测试报告（Markdown） |
| GET | `/api/reports/:id` | 报告详情 |

## 四·五、前端设计
前端**1:1 复刻**《测试智能体平台·高保真原型 V2》的全部视觉与交互：11 个视图（我的工作台 / 创建测试任务 / 任务详情 / 执行监控 / 失败诊断 / Agent 市场 / Agent 开发台 / Agent 调试 / 质量门禁 / 报告中心 / 报告详情），侧边栏分组导航、顶栏、流程条、KPI 卡片等设计系统完整保留。
其中 5 个数据视图（工作台 / 任务详情 / 执行监控 / Agent 市场 / 报告中心）接入后端真实 API，其余流程展示视图保持原型形态。

## 五、三大核心流程（v1.0）

1. **测试任务闭环**：创建任务（UI/API/PERF）→ 自动生成用例 → 执行/批量调度 → 结果与日志
2. **智能体开发**：平台预置五类测试智能体（UI/接口/性能/执行/报告），可查看与定制，模型可调用平台工具
3. **质量与报告**：结果聚合 → 通过率/分区统计 → GJB438C 合规报告 + 失败根因分析

## 六、功能覆盖

全部产品定义需求（R-DSH / R-AGENT / R-UI / R-API / R-PERF / R-EXEC / R-REPORT / R-INT / R-CI / R-QA / R-AI / R-PORTAL / R-NF）到插件的逐项映射，见 [docs/插件开发计划.md](docs/插件开发计划.md)。