---
name: edge-system-test-writer
description: edge_collector 系统测试文档编写规范。用于为协议采集、边缘前端、云平台 AI 分析、WiFi/4G、内网穿透、端口转发、OTA、离线缓存、部署同步等功能编写验收测试、系统测试、测试评审清单和问题回溯记录。
---

# edge_collector 系统测试编写

## 适用范围

- 协议采集：FANUC、西门子、Modbus、OPC UA、传感器等。
- 边缘功能：WiFi、4G、内网穿透、端口转发、离线缓存、OTA、高级功能页面。
- 云平台：历史趋势、AI 分析、设备状态、配置管理。
- 部署：`package.sh`、`deploy_cloud.sh`、`scripts/migrate_edge.sh`、systemd 服务。

## 文档落点

- 通用测试方案：`docs/`
- 协议测试：`collector/docs/protocols/`
- 鲁班猫/设备测试：`docs/鲁班猫*/`
- 本地模型测试：`docs/本地模型/`

## 输出结构

```text
测试目标
测试范围
测试环境
测试数据
前置条件
测试场景
测试步骤与预期结果
异常与恢复场景
问题记录与回溯
通过标准
```

## 测试场景要求

每个功能至少覆盖：

- 正常路径。
- 参数非法或配置缺失。
- 网络断开、服务重启、进程异常退出。
- 同步/打包后动态配置是否被保留。
- 前端操作反馈、失败提示、权限控制。
- 远程目标主机差异，如 82/97/94/87 的架构和系统环境。

## 协议采集专项

测试点包括：

- 驱动能否按协议模板加载。
- 连接、读取、断线重连、设备离线恢复。
- 点位值类型是否符合 `PointData::UpdateValue` 预期。
- 用户可见协议介绍不暴露内部实现。
- ARM64/ARM32 helper 或第三方库场景要覆盖构建和运行验证。

## 前端专项

测试点包括：

- 页面不白屏。
- 按钮有 loading、成功、失败反馈。
- 弹窗使用项目统一对话框。
- 窄屏和长内容不遮挡、不溢出。
- 接口失败时展示可理解错误，不只显示通用失败。

## 验证命令

按实际改动选择：

```bash
npm run build
cmake --build build --target collector -j2
./package.sh --edge-only
bash -n scripts/<name>.sh
jq empty <config.json>
```

远程同步或重启必须等用户明确要求，并遵循对应部署 skill。

## 问题回溯

测试文档应保留问题回溯表：

```markdown
| 问题 | 影响场景 | 根因位置 | 修复提交/文件 | 回归结果 |
|------|----------|----------|----------------|----------|
```