SuperAPI AI 工具集

validate-pipeline

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:对 UNS 管道做端到端验证,查询 TimescaleDB 确认客户端采集的 readings 是否正确写入 tag_history,并以固定格式输出验证报告。

主要能力:提供 /validate-pipeline 命令,执行 uv run scripts/validate_pipeline.py(无需参数,校验 tag_history 中已有数据),并解读六项检查——标签覆盖率(tag_database.csv 中每个 tag 是否有数据行)、时间戳合理性(是否近期、UTC、非未来)、外键完整性(tag_id 是否都能解析到 uns_namespace)、死信(是否有被拒绝的 readings)、数值合理性(布尔是否为 0/1、温度是否在范围内)、跨区域漂移(各区域时间戳是否对齐)。同时报告客户端健康摘要(按区域的行数与最新时间戳),并对 FAIL 项结合客户端代码与配置定位根因。报告格式包含 Checks、Client Health、Diagnosis 三部分。

必要用法与前置条件:先执行 uv sync 安装依赖;确保 schema 已应用且 uns_namespace 已初始化;采集客户端已运行使 tag_history 有数据。若没有真实数据源,可先启动单独的模拟器脚本采集。若 tag_history 为空,验证脚本会警告并退出。

适用场景:在 UNS 管道采集环节后验证数据完整性、排查时序与时区问题、发现无效或异常数值、检查跨区域一致性。

限制:仅校验 tag_history 中已存在的数据,不负责采集本身;资料未提供具体依赖版本、模拟器脚本名称及详细的失败修复步骤。