在中药煎药自动化项目里PLC负责工艺底线WPF上位机则决定了项目的交付上限与合规验收通过率。很多团队做上位机容易陷入两个极端要么只做简单的状态展示配方、工单、追溯全靠人工记录GMP验收直接卡壳要么把工艺时序、控制逻辑全写在软件里断个网、崩个程序就整批药材报废。真正工业级的煎药上位机永远是监控做全、追溯做深、逻辑解耦PLC牢牢守住工艺时序与安全联锁上位机专注于生产可视化、处方管理、批次追溯与合规审计两边通过标准化OPC UA通信层对接职责边界清晰稳定且易维护。本文就结合多个量产煎药产线的落地经验完整讲解基于C# WPF CommunityToolkit.Mvvm的上位机全方案从分层架构设计、多锅位实时监控到处方版本管控、全链路批次追溯、现场性能优化覆盖所有核心模块与工程化细节可直接用于项目开发与验收。一、整体架构分层解耦是工业上位机的基础工业上位机和普通桌面软件最大的区别就是长期运行稳定性与可维护性要求极高。所有逻辑堆在后台代码里的写法短期跑demo没问题量产运行必然面临维护难、扩展慢、故障多的问题。1.1 核心设计原则整套上位机严格遵循MVVM分层思想额外独立服务层封装基础设施形成四层架构依赖方向单向职责边界清晰。业务与硬件解耦相机、PLC等硬件SDK全部封装在服务层通过接口向上提供能力换硬件品牌业务层不用改代码。界面与逻辑解耦ViewModel承载全部业务逻辑View只做数据绑定与输入改界面不影响业务业务逻辑可独立单元测试。工艺与业务分离工艺时序、安全联锁全部沉在PLC侧上位机不干预实时控制只做状态读取、指令下发与数据追溯。1.2 四层架构拆解各层核心职责View层仅负责界面展示与用户输入所有数据通过绑定实现后台代码不含业务逻辑。包含主监控界面、单锅详情、配方管理、追溯报表、日志查询等页面。ViewModel层业务逻辑核心。接收服务层数据转换为界面可直接展示的格式封装用户操作命令全程不引用任何界面控件。Model层纯数据实体。对应PLC点位结构、业务数据表结构不包含任何业务逻辑与界面逻辑。服务层基础设施封装。OPC UA通信、数据持久化、归档、报表等能力全部在这里实现向上层提供标准接口。1.3 与PLC的职责边界工业项目红线这是煎药项目最容易踩的边界误区直接决定了系统的安全底线。PLC侧负责单锅工艺状态流转、分段PID温控、硬件安全联锁、断点续煎逻辑、实时闭环控制。所有和时序、安全相关的逻辑必须全部沉在PLC里。上位机负责生产状态可视化、配方参数管理、工单派发调度、历史数据追溯、合规审计报表、故障告警通知。核心原则上位机就算崩了、网断了PLC也要能独立把当前这锅药跑完。这是医药工控的铁律也是量产项目的基本要求。二、全流程实时监控模块实现多锅位实时监控是上位机的基础功能核心要求是多设备复用、刷新流畅、状态准确、长期运行不卡顿。2.1 通用锅位ViewModel一套逻辑多路复用煎药产线少则4锅多则16锅以上每锅都写一套逻辑是最低效的做法。采用通用ViewModel设计一套逻辑承载所有锅位业务有多少口锅就实例化多少个代码复用率90%以上。核心实现代码using CommunityToolkit.Mvvm.ComponentModel; using CommunityToolkit.Mvvm.Input; using CommunityToolkit.Mvvm.Messaging; using System.Windows; using System.Windows.Threading; using LiveCharts; using LiveCharts.Defaults; namespace DecoctionMonitor.ViewModels; /// summary /// 通用煎药锅视图模型可多实例复用 /// /summary public partial class PotViewModel : ObservableRecipient { private readonly IOpcUaService _opcService; private const int MaxChartPoints 300; private int _pointIndex; public PotViewModel(int potId, IOpcUaService opcService) { PotId potId; _opcService opcService; // 订阅状态变更消息 WeakReferenceMessenger.Default.RegisterPotStatusMessage(this, (recipient, message) { if (message.PotId ! PotId) return; // 后台采集数据调度到UI线程更新 Application.Current.Dispatcher.InvokeAsync(() { UpdateStatus(message); }, DispatcherPriority.Background); }); } /// summary锅位号/summary [ObservableProperty] private int _potId; /// summary当前主状态文本/summary [ObservableProperty] private string _mainStatus 待机就绪; /// summary状态背景色/summary [ObservableProperty] private string _statusColor #666666; /// summary当前温度显示/summary [ObservableProperty] private string _tempDisplay 25.0 ℃; /// summary工序进度百分比/summary [ObservableProperty] private double _processProgress; /// summary温度曲线数据/summary [ObservableProperty] private ChartValuesObservablePoint _temperaturePoints new(); /// summary是否告警/summary [ObservableProperty] private bool _isAlarm; /// summary /// 更新设备状态 /// /summary private void UpdateStatus(PotStatusMessage msg) { // 温度格式化 TempDisplay ${msg.CurrentTemp:F1} ℃; // 状态码转文本与颜色 (MainStatus, StatusColor) msg.StatusCode switch { 0 (待机就绪, #666666), 1 (浸泡中, #2196F3), 2 (武火升温, #FF8C00), 3 (文火煎煮, #4CAF50), 4 (出液中, #9C27B0), 5 (清洗中, #00BCD4), -1 (故障告警, #F44336), _ (未知状态, #999999) }; IsAlarm msg.IsAlarm; if (IsAlarm) StatusColor #F44336; // 更新进度 ProcessProgress msg.Progress; // 更新温度曲线 滚动窗口 TemperaturePoints.Add(new ObservablePoint(_pointIndex, msg.CurrentTemp)); if (TemperaturePoints.Count MaxChartPoints) { TemperaturePoints.RemoveAt(0); } } #region 操作命令 [RelayCommand(CanExecute nameof(CanStart))] private async Task StartAsync() { await _opcService.SendCommandAsync(PotId, PotCommand.Start); } [RelayCommand] private async Task StopAsync() { await _opcService.SendCommandAsync(PotId, PotCommand.Stop); } private bool CanStart() !IsAlarm StatusCode 0; #endregion }主窗口ViewModel统一管理所有锅位实例public partial class MainViewModel : ObservableObject { public ObservableCollectionPotViewModel Pots { get; } new(); public MainViewModel(IOpcUaService opcService) { // 初始化8口煎药锅 for (int i 1; i 8; i) { Pots.Add(new PotViewModel(i, opcService)); } } }界面层用ItemsControl通用用户控件批量渲染新增锅位只需要添加实例不用写任何界面与逻辑代码。2.2 实时通信订阅优先 线程安全工业场景高频数据刷新直接轮询既浪费资源又容易卡顿采用订阅消息总线的方案。OPC UA订阅模式温度、状态、告警等关键点位采用订阅方式数据变化主动推送降低网络与CPU开销。后台采集UI更新采集回调在SDK后台线程图像处理、逻辑判断全部在后台完成只有最终界面更新调度到UI线程且优先级设为Background避免抢占输入资源。消息总线解耦用WeakReferenceMessenger做通信层与ViewModel的桥梁双方互不引用换通信方案业务层不用改。2.3 工艺可视化状态进度曲线三位一体完整的煎药监控不能只显示数字要做到状态直观、进度清晰、曲线可查。状态色编码不同工序对应不同主题色告警红色高亮一眼就能识别整线运行情况。工序进度条每个工序内置进度百分比结合总工序节点图直观展示当前位置与剩余时间。实时温度曲线采用滚动窗口机制固定300个数据点新点进来旧点移除既满足查看需求又避免内存无限增长。2.4 告警分级机制不同等级告警对应不同处理方式不刷屏、不遗漏提示级参数偏离预警界面黄色标注记录日志不弹窗警告级一般故障、工艺异常弹窗提示声光告警需人工确认危险级安全联锁触发、紧急故障全屏红色告警强制提示需立即处理。三、处方与批次追溯系统GMP合规核心如果说监控是项目的基础功能那处方追溯就是医药项目的验收核心。GMP对配方管控、批次追溯、操作审计的要求非常细不是简单存个参数就能满足的。3.1 配方版本全生命周期管理配方是受控技术文件不是普通参数必须遵循「草稿→审批→生效→归档」的完整流程所有变更留痕可追溯。核心设计点版本号规则采用「主版本.次版本」工艺重大变更升主版本参数微调升次版本。每个版本独立完整存储不做差异增量追溯时直接取对应版本即可。状态流转新建默认为草稿状态仅编辑可见不能用于生产提交后需工艺人员审核通过进入生效等待可指定未来生效时间到生效时间自动变为生效中生效配方禁止修改变更必须新建版本旧版本禁用后自动归档保留五年内可查不得删除。批次强绑定工单启动瞬间绑定当时生效的配方版本号完整参数快照到批次数据。批次运行中途配方升级不影响当前批次避免同一批药前后工艺不一致。3.2 全链路批次追溯围绕单个批次实现从处方到成品的全链路可查满足GMP复盘要求。每一批次完整留存基础信息工单编号、处方版本、药材批号、操作人员、开始结束时间过程数据秒级温度、压力、液位曲线各工序执行时长、实际参数事件记录告警信息、手动干预、异常处理、断点续煎记录操作审计所有登录、操作、参数修改、审批记录带账号与时间戳。3.3 双写持久化与数据归档单靠数据库存生产数据风险极高数据库宕机、磁盘损坏都会导致数据丢失采用本地数据库双写策略。本地优先写入所有生产数据优先写入本地SQLite文件写入成功即返回不依赖数据库状态。后台异步同步后台线程异步同步到MySQL等关系数据库用于查询、报表与追溯。故障自动补传数据库故障时本地正常写入恢复后自动补同步完全不影响生产。滚动归档压缩每天生成日归档文件每月压缩超过保留期自动清理保证磁盘空间可控。3.4 合规性设计不可篡改存储生产记录、操作日志采用追加式写入禁止修改删除关键数据带校验和篡改即可识别。权限分级控制操作员、工艺员、管理员三级权限参数修改、配方审批、异常处置都需要对应权限全程留痕。电子签名关键操作配方审批、异常确认、清场确认实行双人员电子签名符合医药生产规范。四、工控场景核心优化与避坑工业现场环境复杂高频数据、网络波动、长期运行都是常态基础MVVM直接用很容易出问题必须针对性优化。4.1 高频数据UI卡顿优化煎药产线十几台设备每秒推送数据全部直接刷界面很快就会卡顿。数值节流温度变化小于0.1℃不触发界面更新状态不变不重复通知大幅减少渲染次数。渲染降频相机采集25fps界面不用每帧都更每秒更新10~15帧视觉上完全无差别UI压力减半。优先级控制界面更新统一使用DispatcherPriority.Background优先响应用户输入操作避免批量数据抢占UI线程。4.2 内存泄漏专项治理WPF工控项目长期运行内存泄漏是重灾区常见泄漏点与解决方案事件与消息用WeakReferenceMessenger弱引用消息ViewModel销毁自动断开用户控件卸载时手动解绑命令与事件。图像与曲线WriteableBitmap复用不每帧新建曲线固定滚动窗口不无限追加数据点。大对象复用字节数组、数据集合用对象池复用避免频繁GC产生内存碎片。定时巡检回收每半小时主动触发一次完整GC同时检查内存占用连续超限记录堆栈便于定位问题。4.3 断线重连与数据补传车间网络波动、交换机重启都是常事通信层必须做容错处理。自动重连链路断开后指数退避重连1秒、2秒、4秒最大间隔30秒避免网络恢复瞬间的通信风暴。断点补传断开期间PLC本地缓存带时间戳的数据恢复后上位机主动拉取历史数据批量补回本地保证曲线完整、数据连续。状态对齐通信恢复后永远以PLC侧状态为准上位机主动读取同步绝对不能以上位机记忆的状态往下覆盖。4.4 常见踩坑汇总坑1把工艺逻辑写在上位机网络中断、程序崩溃直接导致生产事故工艺控制必须沉在PLC。坑2每帧新建Bitmap高频画面下内存暴涨用WriteableBitmap直接写缓冲区性能提升明显。坑3日志不限大小不限大小的日志跑几个月能占满系统盘按天切割保留最近30天归档压缩。坑4数据只存数据库数据库宕机数据全丢本地文件兜底是量产项目的标配。五、项目落地最佳实践5.1 推荐项目结构DecoctionMonitor/ ├─ Views/ # 界面层 窗口/用户控件 ├─ ViewModels/ # 视图模型 业务逻辑 ├─ Models/ # 数据实体 ├─ Services/ # 基础设施服务 │ ├─ OpcUa/ # OPC UA通信服务 │ ├─ Recipe/ # 配方数据服务 │ ├─ Archive/ # 归档服务 │ └─ Report/ # 报表服务 ├─ Messages/ # 消息契约 ├─ Helpers/ # 工具类 └─ App.xaml5.2 技术栈选型UI框架WPF CommunityToolkit.Mvvm工控场景首选轻量稳定、MVVM支持完善。通信协议OPC UA工业标准跨平台跨品牌替代老旧的Modbus与自定义协议。本地存储SQLite单文件零配置WAL模式高并发写入适合本地数据兜底。关系数据库MySQL成熟稳定用于业务数据、追溯报表。图表组件LiveCharts.Wpf数据驱动绑定契合MVVM模式工控场景足够用。5.3 验收合规要点配方版本变更记录、审批流程完整可查批次数据完整温度曲线连续无断点所有操作有日志、有账号、有时间可追溯设备安全联锁功能有效故障告警及时准确数据备份与归档机制完善可恢复可验证。总结工业煎药机的WPF上位机开发从来不是简单的界面展示而是生产管理与合规追溯的核心载体。从分层架构解耦到通用多锅复用再到处方版本管控、全链路批次追溯每一环都要贴合医药行业的工艺特性与合规要求。技术只是工具真正落地的核心是理解工艺、分清边界、重视合规。这套方案经过多个7×24小时运行的煎药产线验证稳定可靠、合规性强同样适用于包装检测、环保监控、设备采集等同类工业场景。