v2.3.0

约 917 字大约 3 分钟

2026-05-19

日期：2026-05-18 类型：Feature / Architecture / Decoupling

变更概述

在本次架构迭代中，我们针对 IDriverFactory 与 IDriverRegistry 职责合并进行了二次演进，设计并实现了一套完全解耦、面向切面的反射驱动装配系统：

统一自扫描标记 (UniconDriverAttribute)：引入了自定义特性 [UniconDriver(string driverType)]，用于修饰具体的南向物理驱动类（如 S7Driver, ModbusDriver）。
免配置零代码发现 (DiscoverAndRegisterDrivers)：在统一服务 IDriverRegistry 接口上增加了自动发现功能。该功能不仅扫描当前运行 AppDomain 中的已加载程序集，还智能扫描并主动加载执行目录中的所有 UniCon.Drivers.*.dll 驱动模块。
彻底去除编译时依赖：
- 彻底移除了 src/UniCon.WebServer/Program.cs 入口对 S7Driver, ModbusDriver, OpcUaDriver, MqttDriver, OpcUaPubSubDriver 等物理驱动类名与 using 命名空间的依赖。
- 实现了高可用、解耦的南向“即插即用 (Plug-and-Play)”插件化架构。

UniconDriverAttribute: Custom attribute for decorating concrete southbound communication driver classes with their protocol alias.
DiscoverAndRegisterDrivers: Dynamic reflection scanning method inside IDriverRegistry to automatically discover, load, and register southbound modules across AppDomain and output directory dll files.
Plug-and-Play Southbound Ecosystem: Allows adding new drivers simply by dropping their compiled dll inside the execution directory without modifying the host webserver's startup code.

Manual Mapping Registrations: Deleted hardcoded manual type mappings in Program.cs and matching compile-time southbound dependencies.
IDriverFactory & DriverFactory (standalone): Removed standalone redundant factory components.

CommunicationService: Refactored to inject only the unified single service IDriverRegistry.
Program.cs: Simplified host startup by calling driverRegistry.DiscoverAndRegisterDrivers().
DriverFactoryTests: Refactored xUnit tests to test automated scanning discovery rather than hardcoded registry setups.

------details-----

将独立的 IDriverFactory 与 IDriverRegistry 合并为一个统一的 IDriverRegistry 接口和 DriverRegistry 实现，实现活跃实例管理与自动依赖装配工厂的二合一；
在 ServiceCollectionExtensions.cs 中精简为单例注入 IDriverRegistry，免去注册多个服务组件的繁琐；
引入 [UniconDriver] 自定义特性和反射自动扫描，实现运行时自装配和完全解耦的即插即用插件化南向生态；
重构 WebServer 程序启动项、CommunicationService 服务以及单元测试以完全对接合并后的 IDriverRegistry。

docs/2. core/2.driver-registry.md (原因：重写并合并注册中心与工厂模式的架构说明文档)
src/UniCon.Core/Attributes/UniconDriverAttribute.cs (原因：新建自动扫描特性标记)
src/UniCon.Core/IDriverRegistry.cs (原因：重构以集成 IDriverFactory 的接口方法与反射自发现实现)
src/UniCon.Core/ServiceCollectionExtensions.cs (原因：精简 IoC 服务注入，仅保留统一注册中心 IDriverRegistry)
src/UniCon.WebServer/Program.cs (原因：在启动项中删除所有硬编码的驱动依赖，并调用 DiscoverAndRegisterDrivers 进行自动装配)
src/UniCon.WebServer/Services/CommunicationService.cs (原因：全面重构以通过单服务 IDriverRegistry 同时完成驱动的工厂创建与状态索引)
tests/UniCon.Tests/DriverFactoryTests.cs (原因：重构单元测试，全面对接合并后的 IDriverRegistry，验证反射自扫描装配功能)
versions/v2.3.0.md (原因：追加版本变更描述，真实记录本次架构整合与反射扫描重构)

Step 1: 编写并整合文档，合并 docs/2. core/2.driver-registry.md，删除临时 docs/3. drivers/7.driver-factory.md。
Step 2: 重构 src/UniCon.Core/IDriverRegistry.cs，将工厂别名管理与自动装配逻辑整合至 IDriverRegistry。
Step 3: 删除重复文件 src/UniCon.Core/IDriverFactory.cs，消除物理冗余。
Step 4: 精简 ServiceCollectionExtensions.cs 中的服务注册逻辑，仅注入单例 IDriverRegistry。
Step 5: 重构 Program.cs 与 CommunicationService.cs 的初始化与依赖逻辑，完全接入统一接口。
Step 6: 重构并运行 DriverFactoryTests.cs 等所有单元测试，确保质量门禁完全通过。
Step 7: 归档版本变更记录。

------details end------