复现已有算法

2026-07-14 15:43:18 +08:00
parent abebd2a683
commit 50b8111fd9
860 changed files with 182250 additions and 18 deletions
@@ -0,0 +1,89 @@
+---
+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
+| 问题 | 影响场景 | 根因位置 | 修复提交/文件 | 回归结果 |
+|------|----------|----------|----------------|----------|
+```