复现已有算法

This commit is contained in:
cloud
2026-07-14 15:43:18 +08:00
parent abebd2a683
commit 50b8111fd9
860 changed files with 182250 additions and 18 deletions
@@ -0,0 +1,22 @@
---
name: protocol-e2e-testing
description: 协议端到端 (E2E) 测试规范。用于指导编写和修改协议 E2E 测试框架、Mock Server 以及测试报告生成器。
---
# 协议 E2E 测试规范
## 测试报告原则:展示真实原始数据
在协议的 E2E 测试报告中,**必须展示正确的、真实的原始网络报文数据(Raw Packet),而不是仅展示经过业务逻辑加工或提取后的字段**。
- **原始报文格式**:在记录 Mock Server 下发或接收的数据时,需要直接呈现抓包层面的完整原始报文。根据协议的实际类型选择合适的呈现方式(对于二进制协议,建议使用十六进制 Hex 格式;对于基于文本的协议,如原生支持 JSON/XML 的协议,则直接保留其原始文本或字符串形态),确保展示的是网络线缆上传输的真实数据。
- **附加结构说明**:在原始报文下方,应当简要附上该协议报文结构的文字说明,以帮助阅读者对照报文内容(例如说明报文头部、指令码、负载、校验码的具体位置,或 JSON 协议的根节点结构)。
- **禁止二次加工**:切忌在面向用户的测试日志/测试报告的 Mock Server 响应示例中,仅打印出协议负载内部提取出来的单一业务字段(如只打印解析后的电压值)。必须保留完整的通信底层原始数据,方便直观验证通信协议。
## 测试数据对比原则
- 驱动解析和抛出的业务层数据(Probe 采集的 JSON/格式化数据)应当与 Mock Server 预期发送的业务数据在内部对比工具(如 Data Comparator)中进行数值对比和断言。
- 最终生成的 Markdown 测试报告中:
1. 必须包含 **Mock Server 原始响应报文示例**(呈现其 Raw Packet 形态)。
2. 包含具体的比对结果(精确匹配、容差范围等)。
3. 可保留 Probe 采集输出的格式化首帧作为对比参考,但不可用其替代 Mock Server 的原始报文。