From 4eaa4be4d2cbd2aa49d36a313ce71ad3e743db4a Mon Sep 17 00:00:00 2001 From: yeg <1347747024@qq.com> Date: 星期三, 02 九月 2026 12:22:53 +0800 Subject: [PATCH] 彻底清理补采完整性遗留依赖 --- AGENTS.md | 9 ++++----- 1 files changed, 4 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 4108b24..126c165 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,9 +12,8 @@ ## 设备路径 - 每个设备适配器实例从数据库读取名称、类型、主机、端口、启停、轮询周期、时区和能力，不在代码中固定连接参数。 -- 每个实例只有一个串行请求队列；一次 `inquire` 批量查询需监测通道。状态查询默认每 5 秒，历史下载使用较低优先级。 -- 连接拒绝、最长约 30 秒响应超时、断线和后端重启均进入对账与恢复流程。恢复时重新查询设备事实并从持久化游标补采，不推断设备已停止。 -- 历史补采按测试结束时间和通道公平轮转，每批最多 1000 条；数据保存成功后才推进数据库游标。 +- 每个实例只有一个串行请求队列；一次 `inquire` 批量查询需监测通道。状态查询默认每 5 秒。 +- 连接拒绝、响应超时、断线和后端重启只记录设备/请求异常并继续观测，不自动恢复或追回历史数据。 - 解析器拒绝 DOCTYPE/外部实体，限制响应大小，并显式处理缺字段、非法数值和未知枚举。 - 协议报文压缩保存到文件系统，数据库仅保存索引、校验值和解析结果；普通报文保留 30 天，解析失败或冲突报文保留 180 天。 @@ -22,7 +21,7 @@ - 开始接收在一个事务内校验全部检测柜和采集器在线可观测及必填映射完整；任一条件失败则整体回滚。暂停接收停止该测试的数据请求，继续接收恢复请求，停止测试进入不可恢复终态并释放业务占用。 - 检测柜通道允许运行中接入；同一次设备运行可依次服务多个测试，数据归属按测试级动作时间判断，不建立来源接收区间约束。 -- 停止测试或设备自然结束后进入内部“完成确认中”；只有所有来源补采完成且接收时段内没有未解释缺口、冲突或异常，才聚合为“检测完成”。 +- 停止测试或设备自然结束后直接进入“检测完成”；成功接收的数据追加保存，缺失、序号跳跃和采样间隔异常只作为可见事实。 - “检测完成”和“已终止”是不可恢复终态。异常恢复、数据缺口处置、终止和负责人转交都追加审计。 - 相同“测试 + 通道 + 异常类型”在未恢复期间聚合首次时间、最近时间和次数；恢复后关闭，再次发生创建新事件。 @@ -43,7 +42,7 @@ ## 验证 -- 设备协议或调度改动至少覆盖正常多通道、拒绝连接、断线恢复、超时、畸形 XML、重复/乱序/缺失历史和重启补采中受影响的场景。 +- 设备协议或调度改动至少覆盖正常多通道、拒绝连接、断线、超时、畸形 XML 和实时数据幂等冲突等受影响场景。 - 运行设备模块测试：`mvn -pl ruoyi-device test`。 - 跨模块改动运行全量测试：`mvn test`。 - 验证可执行包：`mvn -pl ruoyi-admin -am package -DskipTests`。启动验证时使用可写的 `LOG_PATH`，完成后停止临时进程。 -- Gitblit v1.7.1