Test-Agent 测试平台子系统
版本: v2.3.1
状态: 开发中
一、项目定位
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 克隆项目
git clone https://gitee.com/zhang-xiuqin01/test-agent.git
cd test-agent
3.2 配置 OpenCode
每个项目根目录需要放置 Instruction 文件才能让 OpenCode 正确加载自定义规则：
# 复制 instruction 模板
cp config/instructions/TODO_NOTIFY.md ./
四、版本历史
| 版本 | 日期 | 主要变更 |
|---|---|---|
| v2.3.1 | 2026-03-29 | 修复BUG-20260329-003：统一路径、test_files参数、指定commit不用shallow clone |
| v2.3.0 | 2026-03-29 | 新增cleanup API (POST /api/v1/sync/cleanup) - 支持按需清理旧测试文件 |
| 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
1 maintainer
Metadata
1 maintainer
Release files for oc-test-agent 2.3.17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| oc_test_agent-2.3.17.tar.gz | 612.3 kB | Without provenance | Details for oc_test_agent-2.3.17.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| oc_test_agent-2.3.17-py3-none-any.whl | Python 3 | none | any | Details for oc_test_agent-2.3.17-py3-none-any.whl |
Total release size: 1.1 MB
Release files / oc_test_agent-2.3.17.tar.gz
| Download URL | oc_test_agent-2.3.17.tar.gz |
|---|---|
| Size | 612.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
de0d9ca3028d5f7449f78f40a38ee88938bcb677fcf2458d2b18ec4b0ac231ad
|
|
BLAKE2b-256 checksum How to use checksums |
df79884937335da2f1fd5350419d4ffe7a1abef260b3aad939ee0b8ae4c4bde3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / oc_test_agent-2.3.17-py3-none-any.whl
| Download URL | oc_test_agent-2.3.17-py3-none-any.whl |
|---|---|
| Size | 452.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
793b55be3e39bfac6d6fba141d56b2b9a675a961494c1f94f5a2cf60a2b824f1
|
|
BLAKE2b-256 checksum How to use checksums |
b25dad8f02a208777437dc906c52c4be42346e6307f2071ba6aacda14889693d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Security for oc-test-agent 2.3.17
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
