v1.8.3 — 2026 年 5 月
本版本在仪表盘中引入了规划与可视化功能,并对警报引擎和通知做了重大改进。还包含了近期版本中引入但尚未正式发布的功能:AND/OR 复合警报和通知模板中的设施位置占位符。
新功能
计划维护窗口
为任意设施提前计划维护窗口,无需在开始和结束时手动切换状态。
- **访问:**Manager → Facilities → 编辑设施 → 选项卡 Operational Status → Schedule Maintenance。
- 配置:
- Start UTC和End UTC定义该窗口。
- Reason为可选 — 会被记录在变更历史中。
- 自动行为:
- 在窗口开始时,设施自动转换为_Maintenance_。
- 在窗口结束时,设施自动恢复为_Active_。
- **使用场景:**计划生产停机、预防性维护、设备校准。
- **覆盖:**如果在计划开始之前手动将设施置于_Maintenance_,则尊重手动变更。
历史小部件上的时间线导航器
端点历史小部件(xy-v2)现在包含一个可选的底部条,用于可视化地导航图表的时间范围。
- 激活:编辑小部件 → 勾选_Show timeline navigator_。
- **用法:**在底部条上点击并水平拖动可调整主图表的显示范围。
- **同步:**当导航器激活时,图表缩放会与同一仪表盘上的其他小部件同步。
图表(xy-v2)上的警报可视化
历史图表现在可以在图表内部以图标形式显示警报,并与时间轴对齐。
- 激活:编辑小部件 → 勾选_Show alarms_。
- 筛选:
- **警报严重程度:**下拉菜单仅显示某些严重程度(默认:All)。
- 交互:
- 悬停在图标上可显示警报详情(描述、严重程度、日期)。
- 图标按严重程度颜色编码(High 红色、Medium 橙色、Low 黄色、Information 蓝色)。
端点历史的拖拽缩放
xy-v2 图表现在允许直接在图表区域上拖动光标来缩放,无需打开单独面板。
- **用法:**在图表区域点击 + 水平拖动 → 缩放到所选范围。
- 重置:_Reset zoom_按钮位于图表右上角,可恢复到完整范围。
- **动画:**平滑过渡(300 毫秒)以避免突兀的跳跃。
- **可视化指示器:**当图表处于缩放状态时,小部件标题旁会出现一个_Zoomed_徽章。
其他功能(对近期版本的补充说明)
这些功能已在近期版本中引入但尚未正式宣布。在此一并说明,以确保所有客户都了解。
AND / OR 复合警报
警报现在支持多个条件的逻辑组合,而不是只能使用单一条件。
- 支持的运算符: AND(必须满足所有条件)和OR(任一条件)。
- **最大值:**每个警报最多 5 个条件。
- 限制:所有条件必须属于同一设施的端点。
- **配置:**在警报编辑器中 → 从_Logic_下拉菜单中选择运算符 → 通过_+ Add condition_添加额外条件。
- 典型使用场景:仅当多个条件同时满足时才触发警报(例如:高温AND低湿度AND门打开)。
通知模板中的设施位置占位符
警报通知模板现在支持变量,以自动将设施的物理位置包含在消息中。
- 占位符:
\{FACILITY\_LOCATION\_LINK\}— **描述:**带有设施坐标的 Google Maps URL — **可用于:**邮件、短信、WhatsApp - 占位符:
\{FACILITY\_ADDRESS\}— **描述:**设施的邮政地址(已格式化的字符串) — **可用于:**语音、短信 - 占位符:
\{FACILITY\_LOCATION\_HTML\}— **描述:**带有 Maps 链接的 HTML 锚点 + 作为文本的地址 — **可用于:**邮件 - **静默解析:**如果设施未配置坐标,则占位符替换为空字符串而不影响消息的其余部分。
- **典型使用场景:**外勤团队收到一条带有 Maps 直链的短信,以到达生成警报的现场。
- **配置:**设施在 Manager → Facilities → 选项卡_Location_中必须完整填写经度/纬度/地址。
改进
通知的扩展重试策略
系统现在最多重试通知发送(邮件、短信、语音、WhatsApp)长达48 小时(之前为 4 小时),然后才将其标记为失败(死信)。
- **理由:**覆盖外部 SMTP/SMS 提供商的长时间宕机,避免丢失关键通知。
- **行为:**5 分钟重试间隔,最多 576 次尝试(此前为 50 次)。
警报引擎稳定性
警报评估引擎的多项鲁棒性改进:
- 必填字段校验:创建/编辑设施和设备时,提供清晰提示指明哪个字段缺失。
- **已净化的错误消息:**到达客户端的异常现在会隐藏内部堆栈跟踪,但保留错误代码和功能性消息。
- **小部件竞态条件:**修复了 Camera/SimplifiedTable 小部件的缓存清理任务与令牌生成之间的竞态。
计划维护 API 端点
为需要安排维护的外部集成新增 REST 端点:
POST /services/core/FacilityService.svc/SetFacilityScheduledMaintenancePOST /services/core/FacilityService.svc/CancelFacilityScheduledMaintenanceGET /services/core/FacilityService.svc/GetFacilityScheduledMaintenance
Bug 修复
- Active Alarms报告:_Facility Status_列错误地为所有设施显示了“Maintenance”。现在显示真实状态。
- **xy-v2 警报图标:**修复了在关闭所有活跃警报后图表上警报图标消失 30 秒的问题(后端缓存)。
- **维护开关:**修复了当系统携带遗留 operational 枚举状态时,在_Active_和_Maintenance_之间切换时出现的 500 错误。
- **推送通知:**修复了新用户的浏览器令牌注册(之前在某些流程中静默失败)。
- **主表
**/devices**:**修复了 URL 别名 — 现在正确重定向到/endpoints(此前显示空白页)。 - **仪表盘同步:**修复了使用时间线导航器时多个小部件之间的时间范围同步。
支持
如有咨询,请联系 Cloud Studio 团队:contacto@cloud.studio。