ARTICLE · 1393288
WPF 企业级插件化工业软件平台(上位机)
前言
工业现场的上位机软件,长期处在一个挺尴尬的位置:每接一台新设备,就得新写一套程序;每改一个协议,就得动一次核心代码。项目越做越多,代码越堆越乱,最后谁也不敢碰。
项目想解决的,就是这个问题——把"一台设备一套程序"变成"一套平台装多个插件",让设备协议、MES 适配、报表、认证这些能力都能装卸,业务模块按模板新建,二次开发不碰核心。
项目介绍
项目是一个企业级插件化工业软件平台,定位是上位机平台。下位机的 AI 编程由姊妹项目 NeuroAxis 承担,专注把现场设备的数据采上来、存下去、送到界面上。
技术栈是 .NET 8(照顾存量工控机)加 .NET 10(新现场),数据库用 PostgreSQL 16/17,客户端是 WPF,现场以 Windows 服务直装,不引入 Docker。
一条点位从 PLC 到数据库再到界面的全链路已经跑通并做了自动化验证,设备台账和多设备采集也已经落地。
项目功能
项目特点
插件化底座:设备协议、MES 适配、报表、认证都能装卸,业务模块按模板新建,二次开发不动核心。
不可丢语义:采集走有界队列背压,攒批写入失败时批次保留重试,停机也不丢数据。
设备间故障隔离:每设备独立轮询循环,按 driver_id 由驱动工厂实例化,一台设备出问题不拖垮其他设备。
时序数据专门处理:point_history 按月分区加 BRIN 索引,写入走二进制 COPY,时序查询禁走 EF,避免 ORM 拖慢采集。
客户端只连 API:WPF 不直连数据库,5s 超时加全异常兜底,界面不会因为后端抖动而卡死。
离线友好:现场 Windows 服务直装,不依赖 Docker,适配存量工控机环境。
质量门禁:构建 0 错 0 警,15/15 单测通过,其中包含断线重连、flush 失败不丢数据、多设备故障隔离三个韧性回归。
项目架构

项目技术
语言与运行时:.NET 8 基线 / .NET 10 新现场,C#。
数据库:PostgreSQL 16/17,point_history 按月分区 + BRIN 索引,Npgsql 二进制 COPY。
客户端:WPF,快照表格轮询,只连 API。
服务端:ASP.NET API + 采集 HostedService,薄组合根设计。
插件体系:Platform.Abstractions 定义驱动/点位/质量码契约,插件唯一依赖,仅 BCL。
采集内核:Platform.Core 负责采集调度与有界队列流水线。
数据写入:Platform.Data 专做 point_history 的 COPY 写入。
测试:xUnit 单测,含韧性回归。
工具链:DbInit、ModbusSlaveSimulator 两个 .NET 工具项目,配合 PowerShell 自测脚本。
项目代码
工程结构可以参考:
├─ src/│ ├─ xxxx.Abstractions/ # 驱动/点位/质量码契约(插件唯一依赖,仅 BCL)│ ├─ xxxx.Core/ # 采集调度、有界队列流水线(业务内核)│ ├─ xxxx.Data/ # point_history COPY 写入器(时序专用)│ ├─ xxxx.Host/ # ASP.NET API + 采集 HostedService(薄组合根)│ ├─ xxxx.Client/ # WPF 客户端(只连 API)│ └─ Plugins/Driver.ModbusTcp/ # 驱动插件├─ tests/xxxx.Tests/ # xUnit 单测(含韧性回归)├─ tools/ # DbInit、ModbusSlaveSimulator(.NET 工具项目)├─ scripts/ # run-m0.ps1 等运维/自测脚本├─ deploy/sql/ # DDL(V001 point_history 分区表)└─ docs/ # 设计文档五分册 + architecture.svg项目效果
项目第一阶段已经跑通一条完整链路:Modbus TCP 从站 → 驱动插件 → 有界队列(背压)→ 攒批 COPY → point_history → API → WPF,并且做了自动化验证。

第二阶段设备台账和多设备采集落地,S1~S7 七大业务场景 17 项断言全部通过,覆盖采集正确性、多设备、韧性自愈、停机完整性。



一键自测的命令也很直接:
powershell scripts/run-m0.ps1 # 建库 -> 模拟器 -> Host 采集 -> 验证行数 -> 清理dotnet test xxxx.slnx # 单元测试手动分步则是先跑 DbInit 建库建表,再开 ModbusSlaveSimulator 模拟 PLC,然后启动 xxxWPF 客户端,三步就能看到数据从模拟设备一路流到界面。

项目源码
设计文档在 docs/ 下分五个分册,另有整体架构图。

总结
项目把上位机从"一设备一程序"的泥潭里拉出来,做成插件化底座。M0 证明了全链路可行,M1 把设备台账和多设备采集补上,场景回归也跑通了。对现场来说,这意味着接新设备、改协议、加报表不再需要动核心代码;对二次开发来说,业务模块按模板新建,边界清晰。后面 P1/P2 还要继续推进,但从目前的质量门禁和回归覆盖看,底子是打得比较扎实的。
关键词
#插件化、#工业软件、#上位机、Modbus TCP、PostgreSQL、WPF、.NET、#设备采集、#时序数据、#二次开发
作者:小码编匠
WinForms 工业上位机自定义控件库:让组态界面不用从零画
WPF 工业设备上位机模板(PLC、SECS/GEM、配方管理)
.NET 10 工业边缘网关:从 PLC 接入到 MQTT/OPC UA 北向
20 个项目、5 种 PLC 协议,这套产线上位机是怎么把依赖管住的
.NET 9 三大 LINQ 新招:代码少一半,让数据聚合和索引操作又快又干净
WPF 工业通信调试工具(串口、TCP、OPC UA、S7 全覆盖)
WinForms 对接 VisionMaster 的视觉打标上位机,断线能自愈
一套可二次开发的 WPF 运动控制上位机(点位、Modbus、Lua 和 3D仿真)
不依赖第三方视觉库,用 .NET 10 + WPF 搭一套无代码视觉上位机
S7 数据怎么稳稳落到 SQL Server?一套 WPF + MVVM 的 SCADA 上位机
WPF + OpenCvSharp 工业自动化平台(视觉识别与分拣系统)
基于 Prism 框架的 WPF 工业通讯系统:集成S7与串口通信
C# 自动化实战:10 分钟掌握 UI Automation 控制桌面软件
C# + Python(YOLO 模型)视觉识别项目(采集、标注、训练、识别)
中后台的权限、租户、审计,这个 .NET + Vue 项目都内置了
告别老旧 Chart 控件:试试这个面向 WPF 的开源图表库
觉得有收获?不妨分享让更多人受益
关注「DotNet技术匠」,共同提升技术实力



















































































