跳到主要内容

功能与规划

当前发布版本见 NuGet 包。0.20.1 是 0.20.0 之后的补丁修复版;0.20.0 新增 OPC UA;0.19.0 是 1.0 前的收敛面:公开 API 与 JSON 规范只保留当前推荐写法,不保留旧别名、同义字段或隐式兼容入口。现场长期兼容承诺仍要等到 1.0。

按版本的变更细节见仓库 CHANGELOG。

当前版本​

0.20.1 修复取消、协议超时、运行期拓扑回滚、报警搁置/解除抑制、点表时间戳刷新、事件订阅者异常隔离、重连回调和 TCP 服务端广播取消等边界行为。0.20.0 在收敛后的宿主、配置、报警与桌面绑定表面上新增 OPC UA 协议包,支持 opc.tcp、SecurityPolicy None、会话、Value 读写和虚拟 Server 联调。

1.0 范围​

1.0 锁定现在这套日常上位机闭环,而不是再堆新协议或新业务模块。

包含

  • 宿主:ZeusHost.Create、StartAsync / StopAsync,停止后可再次启动
  • 通道:串口、TCP/UDP 客户端与服务端、虚拟通道、报文追踪与结构化日志
  • 故障恢复:Faulted 后默认指数退避自动重连
  • 协议常用子集:自定义帧、Modbus RTU/TCP/ASCII、Mitsubishi MC、Siemens S7、Omron FINS、Omron Host Link、Panasonic MEWTOCOL、EtherNet/IP、DL/T 645、IEC 60870-5-104、MQTT 3.1.1、OPC UA、SNMP v2c
  • 点表:周期采集、连续地址合并读取、当前快照、报警限、报警队列、按点名写回
  • 历史:点历史与趋势持久化由业务层订阅 Changed / BatchChanged 后自行保存
  • 配置:JSON 装载通道、设备与点表;监视文件时同步拓扑,并迁移同名通道上的事件订阅
  • 界面:WinForms 控件绑定;WPF MVVM 绑定源;支持通道状态、点值、报警色、报警列表和写回按钮
  • 诊断:builder.Logging 接入标准 MEL;ZeusLogEvents 稳定事件编号;可选 AddCommunicationLogging 记录 TX/RX

不包含(留给 1.1 及以后)

  • 配方管理:按点名批量下发一组设定值
  • 用户权限:操作员确认报警、写回与远程控制的授权边界
  • 自动更新:桌面宿主检查并安装后续版本
  • 更多品牌 PLC 驱动
  • 协议全集加深:MQTT 5、SNMP v3、OPC UA 证书加密与订阅、S7 String/DateTime、更多 Modbus 冷门功能码与 MC 专用命令

已知限制(冻结)​

这些是设计边界,不作为 0.20.x 缺陷修掉:

  • 自动重连只针对 Faulted,主动 CloseAsync 不会重开
  • 自定义 IDevice 必须实现 Channel;按点名写回还需实现 IPointWriter
  • 使用自定义换算函数、未提供 scale 的点无法自动写回
  • TCP/UDP 服务端的无参 WriteAsync 仍回复最近一次对端;多客户端请用带远端的 WriteAsync 或 ISessionChannel

1.x 兼容政策​

  • 保证:已发布公开类型、成员、扩展方法;手册中的 JSON 规范字段;已发布 ZeusLogEvents 编号
  • 不保证:内部实现、未文档化默认值、虚拟从站内部细节、协议未声明的子集
  • 0.20.x / 未来的 1.0.x 只修缺陷;新能力进次版本;破坏性变更进下一个大版本

到 1.0 还要做什么​

  • 用冻结后的公开面做真机/网关冒烟,缺硬件的协议在手册里标明验证级别
  • 补发布门禁:编译、Zeus.Tests、公开 API 基线
  • 1.0.0 换兼容承诺,不换产品面