功能与规划
当前发布版本见 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换兼容承诺,不换产品面