Framework.md

系统架构设计

伊机控采用现代化的分层架构设计，实现了高度模块化和跨平台支持。

技术栈

• .NET 10.0 - 现代化的跨平台开发框架
• Avalonia UI - 跨平台用户界面框架，基于MVVM架构
• CommunityToolkit.Mvvm - 高效MVVM框架，清晰的职责分离
• OpenCV - 图像处理和计算机视觉
• 自研脚本引擎 - 完整的编译器-虚拟机实现，支持复杂逻辑
• 模块化设计 - 松耦合架构，易于扩展维护

架构概览

系统架构图

┌─────────────────────────────────────────────────────────┐
│                   用户界面层 (UI Layer)                    │
│  ┌──────────────────┐         ┌──────────────────┐      │
│  │  Avalonia UI     │         │   WinForms UI    │      │
│  │  (跨平台)         │         │   (Windows)      │      │
│  └──────────────────┘         └──────────────────┘      │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                 业务逻辑层 (Business Logic)               │
│  ┌──────────────────┐         ┌──────────────────┐      │
│  │  ViewModels      │         │   Services       │      │
│  │  (MVVM模式)       │         │   (业务服务)      │      │
│  └──────────────────┘         └──────────────────┘      │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                   核心层 (Core Layer)                     │
│  ┌──────────────────────────────────────────────────┐   │
│  │              EasyCon.Core                        │   │
│  │  (脚本运行器、项目管理、配置管理)                    │   │
│  └──────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                   模块层 (Module Layer)                   │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐  │
│  │  Device  │ │ Capture  │ │  Script  │ │  VPad    │  │
│  │ (设备通信)│ │(图像处理)│ │(脚本解析)│ │(虚拟手柄)│  │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘  │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                   硬件层 (Hardware Layer)                 │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐                │
│  │ 单片机设备 │ │ 采集卡   │ │ 手柄设备  │                │
│  └──────────┘ └──────────┘ └──────────┘                │
└─────────────────────────────────────────────────────────┘

架构优势

跨平台能力

• 多UI框架: Avalonia支持全平台，WinForms专精Windows
• 设备抽象: 硬件无关的接口设计，便于移植
• 统一API: 各平台共享核心业务逻辑

设备兼容性

• 多协议支持: Serial、TCP/IP、蓝牙等多种通信协议
• 自动发现: 智能设备扫描和连接机制
• 接口统一: 标准化的服务接口设计
• 热插拔: 支持运行时设备连接和断开

图像识别能力

• 多引擎支持: 集成多种图像处理库
• 算法丰富: 模板匹配、OCR、颜色检测等
• 性能优化: 异步处理、智能缓存
• 易扩展: 插件式算法架构

代码质量保证

• MVVM架构: 清晰的职责分离，便于单元测试
• 数据绑定: 响应式UI更新，减少样板代码
• 模块化设计: 松耦合、高内聚，易于维护
• 完善文档: 详细的架构设计和API文档

开发工具

• IDE: Visual Studio 2026
• 版本控制: Git
• 构建工具: MSBuild