跳到主要内容
Zeus[zjuːs] 雷神

您的痛点，Zeus 已阅；复杂的通信，交给框架。

把复杂留给 Zeus，把简单留给用户。

  • 先虚拟通道联调，再替换串口或 TCP，业务代码不用推倒
  • 宿主统一启动、停止、释放，避免端口泄漏和后台残留
  • 自定义帧与 Modbus 共用通道模型，半包粘包交给框架
  • WinForms / WPF 适配器负责切回 UI 线程，少写重复 Invoke
开始使用 Zeus跑通控制台示例
受支持界面控制台WinFormsWPF.NET 8+
QuickStart.cs
await using var app = ZeusHost.Create(builder =>
{
    builder.AddVirtualChannel("meter");
});

var meter = app.Channels.Get("meter");
meter.DataReceived += (_, e) =>
{
    Console.WriteLine("收到：" +
        Encoding.UTF8.GetString(e.Data.Span));
};

await app.StartAsync();
await meter.WriteAsync("PING"u8.ToArray());
3通道类型
8常用 Modbus 功能码
0硬件依赖即可联调

功能清楚 · 开箱即用

上位机底层问题，拆成独立模块

每个模块只做自己的事：通道搬字节，协议解释字节，采集更新点表，界面适配器负责线程切换。

宿主生命周期

统一启动、停止、释放资源，避免端口泄漏和窗口关闭后的后台残留。

串口、TCP、虚拟通道

同一套 IChannel API，开发期用虚拟通道，现场替换串口或 TCP。

自定义帧

处理帧头、长度、校验、半包、粘包和按序号匹配响应。

Modbus RTU / TCP

封装常用功能码，读写线圈和寄存器，不手拼 CRC 或 MBAP。

点表与周期采集

把地址命名成温度、压力、设定值，让业务代码读取当前值。

WinForms / WPF 适配

把通道状态和接收数据安全切到 UI 线程，少写重复 Invoke。

探索手册

三步上手 · 快速开始

按真实开发顺序接入

1

安装并跑通控制台

dotnet add package Zeus

先用虚拟通道写 PING、收回报，确认宿主和收发事件都通。

2

换成真实连接

builder.AddSerialPort("meter", "COM3", 9600);

把 AddVirtualChannel 换成串口或 TCP，后面的读写代码保持不变。

3

沉淀配置与采集

zeus.json → 端口 / 点表 / 间隔

把现场参数从代码里抽出来，方便交付和改点。

查看安装说明

初心如磐 · 匠心致远

框架只做该做的事

普通上位机程序很容易把开串口、拼协议、刷控件、关窗口释放端口写进同一段窗口代码。 功能一多，通信、协议、界面线程和重连就会缠在一起。

Zeus 的做法是把这些拆开：宿主管生命周期，通道搬字节，协议解释字节，采集更新点表，适配器切回 UI 线程。你只需要关心设备业务和界面怎么展示。

它不是低代码组态，也不自带图表、权限和报表。 它解决的是上位机里最容易重复写错的底层部分。