Metadata-Version: 2.4
Name: oc-test-agent
Version: 2.2.3
Summary: Test-Agent: Docker-based Test Execution System
Author: Test-Agent Team
License: MIT
Keywords: testing,docker,automation,ci,cd
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: pytest>=8.0
Requires-Dist: pytest-cov>=7.0
Requires-Dist: docker>=7.0
Requires-Dist: flask>=2.0
Requires-Dist: aiohttp>=3.9
Requires-Dist: cryptography>=41.0.0

# Test-Agent 测试平台子系统

**版本**: v2.2.0  
**状态**: 开发中

---

## 一、项目定位

Test-Agent 是独立的测试平台子系统，为 oc-collab 和 PM-Agent 提供隔离的测试环境。

### 1.1 核心能力

| 能力 | 说明 |
|------|------|
| 独立测试数据库 | 隔离生产数据 |
| 多Agent互动测试 | 多进程真实Agent通信 |
| 动态测试项目 | 支持任意类型项目 |
| 测试场景管理 | 定义/执行/记录测试 |
| 前端测试 | 复用PM-Agent Vitest |

### 1.2 技术架构

| 组件 | 技术 |
|------|------|
| 测试执行 | Python CLI |
| 前端测试 | Vitest (复用) |
| 数据库 | SQLite |
| HTTP API客户端 | ConfManClient, OcCollabClient |

### 1.3 HTTP API 客户端

Test-Agent v1.3 提供 HTTP API 客户端，用于与各子系统通信：

| 客户端 | 用途 | 路径 |
|--------|------|------|
| ConfManClient | conf-man 版本管理 | `src/core/conf_man_client.py` |
| OcCollabClient | oc-collab 协作服务 | `src/core/oc_collab_client.py` |

### 1.4 环境变量配置

| 变量 | 说明 | 默认值 |
|------|------|--------|
| CONF_MAN_API_URL | conf-man API 地址 | http://localhost:8000 |
| OC_COLLAB_API_URL | oc-collab API 地址 | http://localhost:8080 |
| OC_PROJECT_PATH | 测试项目路径 | ./ |
| OC_AGENT_ID | Agent标识 | test-agent |

### 1.3 架构分层

```
L1: Test-Agent-core (测试执行框架)
L2: 测试场景编排
L3: 测试Agent管理
```

---

## 二、目录结构

```
test-agent/
├── backend/         # 测试执行后端
├── frontend/       # 测试管理前端 (如需要)
├── tests/          # 测试场景定义
├── docs/           # 项目文档
│   ├── 01-requirements/
│   ├── 02-design/
│   ├── 05-design/
│   ├── 06-roadmap/
│   └── 07-research/
├── state/          # 测试状态数据
└── config/         # 配置文件
```

---

## 三、快速开始

### 3.1 克隆项目

```bash
git clone https://gitee.com/zhang-xiuqin01/test-agent.git
cd test-agent
```

### 3.2 配置 OpenCode

每个项目根目录需要放置 Instruction 文件才能让 OpenCode 正确加载自定义规则：

```bash
# 复制 instruction 模板
cp config/instructions/TODO_NOTIFY.md ./
```

---

## 四、版本历史

| 版本 | 日期 | 主要变更 |
|------|------|----------|
| v2.2.0 | 2026-03-23 | 新增Jenkins CI/CD集成：WebHook接收、主动拉取测试结果、JUnit XML解析、oc-collab报告 |
| v3.1.0 | 2026-03-10 | 代码同步API、子系统注册功能增强 |
| v2.1.3 | 2026-02-28 | API Key验证改为自动信任conf-man有效Key |
| v2.0.0 | 2026-02-26 | HTTP API服务、测试执行接口、项目管理接口、Agent管理接口、自动通知机制 |
| v1.2.1 | 2026-02-19 | Docker测试执行能力、测试结果数据库、76个E2E测试用例 |

---

## 六、相关文档

- 需求文档: `docs/01-requirements/`
- 设计文档: `docs/02-design/`
- API文档: `docs/04-api/`
- 路线图: `docs/06-roadmap/`
- 研究报告: `docs/07-research/`
- oc-collab主项目: `../dual-agent-collaboration-system`
- PM-Agent项目: `../pm-agent`

---

**作者**: oc-collab团队  
**创建日期**: 2026-02-18
