Skip to content

UI 包职责与依赖边界 ​

本页用于判断共享能力应放在哪个 UI 包,以及公开接口、依赖、框架或版本变化会影响哪些消费者。具体控件位置见组件目录,装配问题见运行时发现,构建与发布步骤见UI DLL 发布。

先按下表确定职责,再读取对应主题及目标 .csproj;包名或界面所在窗口不直接决定业务归属。

包边界 ​

DLL / 包主要职责常见风险详细页
ColorVision.Common.dllMVVM 基础、共享接口、初始化器、状态栏契约、权限基础对象、Win32 工具被高层业务反向污染ColorVision.Common
ColorVision.Themes.dll主题资源字典、窗口基类、标题栏、通用控件资源缺失、主题枚举和实际 XAML 不一致ColorVision.Themes
ColorVision.UI.dll配置、菜单、插件装载、属性编辑器、热键、多语言、日志、状态栏插件加载成功不等于菜单/设置/状态栏都注册成功ColorVision.UI
ColorVision.Algorithms.dll中立算法身份、参数、调用、结果、目录与执行器把 WPF、OpenCV、Engine DAO 或客户判定混入中立契约算法平台
ColorVision.Core.dllHImage、OpenCV helper P/Invoke、CUDA/fusion bridge、WPF 位图桥接native DLL、x64 runtime 或 OpenCV 依赖漏包ColorVision.Core
ColorVision.Database.dllSqlSugar DAO、MySQL/SQLite 基础、GenericQueryWindow 实体查询实体和真实表结构不一致、连接配置错误ColorVision.Database
ColorVision.SocketProtocol.dllTCP server、JSON/Text 分发、消息 SQLite、Socket 管理窗口端口冲突、协议模式错误、Handler 未加载ColorVision.SocketProtocol
ColorVision.Scheduler.dllQuartz 调度、任务配置、执行历史、任务管理窗口任务程序集未被发现、Cron/历史库不一致ColorVision.Scheduler
ColorVision.ImageEditor.dllImageView、绘图图元、工具发现、结果 overlay、伪彩、CIE、3D、实时图像工具初始化副作用、overlay 坐标和图像缩放不一致ColorVision.ImageEditor
ColorVision.UI.Desktop设置、向导、插件市场、下载器、第三方应用、反馈和诊断窗口被误认为主程序入口;实际主程序仍在 ColorVision/ColorVision.UI.Desktop
ColorVision.Solution.dll工作区、文件树、编辑器、AvalonDock 公共主题、终端把 Engine 流程或客户业务塞进工作区壳层ColorVision.Solution
ColorVision.ImageTools.dll多图查看、缩略图缓存、景深融合和 Solution 菜单贡献把通用图像工具重新耦合进 SolutionColorVision.ImageTools
ColorVision.Rbac.dll本地账户、角色、权限、会话和审计窗口把细权限误写成全产品统一网关RBAC 模块

依赖方向 ​

项目引用与运行调用是两种关系。当前主项目文件中,ImageEditor 引用 Algorithms、Core、Common、Themes 和 UI;Solution 引用 ImageEditor、UI.Desktop 和 UI;ImageTools 再引用 Solution、ImageEditor 等库。新增图像工具应放在其能力所有者,不能因为菜单显示在工作区就把实现移入 Solution。

Algorithms 没有项目或第三方包引用,也不启用 WPF。框架中立契约由它维护,像素来源、窗口、图像适配与 overlay 渲染由宿主承担;具体分界见算法平台。客户判定、MES 与业务导出仍属于 Projects/,Engine 历史结果的 DAO/handler 不能进入中立算法包。

依赖核对应读取当前 .csproj 的 ProjectReference、PackageReference 及其条件,不从示意关系推断直接引用。例如 Themes 引用 HandyControl,没有 Common 项目引用;Core 的 native 项目引用取决于 UseProjectReference,托管项目未引用 C++ 工程也不表示运行不需要 native DLL。底层库不应反向依赖高层窗口、Engine 业务或客户项目;确有共享能力时先确定接口、事件或 provider 边界。Spectrum 通过 ColorVision.Solution 引用公共 AvalonDock 主题,独立包须随带该库及其声明依赖;不引用主程序 EXE。原生紧凑标题栏的两个自包含源码文件由 Spectrum 项目链接编译,主窗口与工具窗口各自管理 HWND 和事件生命周期。

框架、版本与产物检查 ​

检查项判断依据
目标框架验证消费方与包内资产兼容,不要求所有 TargetFramework(s) 字符串等于主程序。部分 UI 库同时面向 .NET 8/10 Windows,Algorithms 面向 net8.0;net10.0,ImageEditor 等窗口库使用自己的 Windows TFM
平台中立 TFM 不解除仓库的宿主 x64 策略;FileIO 的独立 AnyCPU 例外见构建平台与制品边界
版本与签名按根 props、UI/Directory.Build.props 和项目覆写后的最终值判断,Themes 有自己的版本;不要求 UI 包与主程序版本号相同。保留存在签名密钥时的强名称规则,公开签名变更另核对实际消费者
资源与依赖核对 NuGet 资产和宿主输出中需要的 XAML、图标、shader、CIE 数据及 native runtime;项目引用存在不证明依赖和资源已交付。插件共享文件去重由插件打包规则负责
运行时装配对应程序集加载后,菜单、设置、状态栏、图像工具或 Socket handler 仍要经过各自发现与过滤;包生成成功不代表入口可见

ColorVision.Solution 使用 AvalonDock 5.x 时,XML 布局序列化由独立的 Dirkster.AvalonDock.Serializer.Xml 包提供,不能只交付主题包和 AvalonDock.dll;主程序与 Spectrum 还需要对应的 AvalonDock.Core.dll、AvalonDock.Serializer.Xml.dll 及主题程序集。VS2013 基础主题在运行时生成资源字典,由 DictionaryTheme.ThemeResourceDictionary 合并到共享现代主题。布局文件兼容与内容恢复规则见编辑器与文档生命周期。

ScottPlot 与 SkiaSharp 兼容性冻结 ​

所有消费方暂时保持 ScottPlot.WPF 5.0.56,主程序同时保持直接引用的 SkiaSharp 2.88.9。当前组合为 net10.0-windows 消费方选择 ScottPlot.WPF 的 lib/net6.0-windows7.0 资产,并从 SkiaSharp.Views.WPF 2.88.9 选择 lib/netcoreapp3.1,不会回退到 .NET Framework DLL。

不能把 ScottPlot.WPF 或 SkiaSharp 单独追到当前最新版。ScottPlot.WPF 5.1.59 会带入 SkiaSharp.Views.WPF 3.119.0;后者的 WPF 资产只有 net462,或最低要求 Windows 10.0.19041 的 net6.0/net8.0。仓库当前 Windows TFM 基线不能选择 Windows 10 资产时,NuGet 会回退选择 net462,改变现有 .NET Core 运行资产边界。

在出现新解法前,不再把 ScottPlot/SkiaSharp 列为常规依赖升级候选。解除冻结至少需要满足以下一项:新包提供与当前 Windows TFM 兼容且不会回退到 net4x 的 WPF 资产;仓库明确提高 Windows 最低版本并完成安装环境核验;或替换绘图库。候选方案还必须在还原后检查 obj/project.assets.json 与实际编译引用,并覆盖主程序、ColorVision.ImageEditor、Spectrum、ProjectKB 和 ProjectARVRPro 的构建及代表性绘图运行验证。

发布预检、包顺序、NuGet 版本占用及消费方验证见发布契约。

基于 MIT License 发布。