UI 源码知识
自动生成的源码目录。修改主题 Markdown 的
code_paths后运行node docs/.vitepress/scripts/knowledge.mjs generate;不要手工编辑。
返回知识总入口。只读与当前模块有关的主题,再核对其中的源码、测试和状态;规划、历史不代表当前能力。
以下关联用于按源码定位和变更复核,不是完整调用图或主题所有权。跨模块链接保留在地图中,网页侧栏只列地图入口。
UI/ 根目录与跨模块关联
UI 知识入口 —
ui.index按问题路由到 UI 模块、属性编辑契约、运行时发现与 DLL 发布证据。UI NuGet 包构建与发布 —
ui.publishingUI NuGet整批与Algorithms单包发布、Release标签和版本预检;预检不预留版本,逐包上传没有整批回滚或逐条失败检查。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.Algorithms
算法与模板知识入口 —
algorithms.index区分统一 Runner、ImageEditor 直接 native 分析与 Engine 模板/MQTT 算法,并按任务定位专题。ROI 模型与模板入口 —
algorithms.roi-routes按用途定位发光区、SFR 寻边和中立算法 ROI 模型;各分支参数与坐标契约分别维护。统一图像算法平台 V1 —
algorithms.platform图像编辑器本地算法扩展:Catalog 描述、provider 注册、Invocation 和 Runner 执行;像素预览与应用/取消、几何结果和叠加显示分流,保留所有权与发布门禁;ONNX仅设计。算法结果交接、展示与导出 —
engine.results算法结果交接、已加载批次主记录查询与叠加显示:区分本地中立 Geometry/Overlay、Engine 历史 handler 和客户业务导出,保留来源与文档/revision 生命周期。系统职责与跨模块边界 —
platform.system宿主、UI、Engine、插件与项目的职责及调用边界:UI操作不必经过Engine,程序集依赖不是统一执行顺序,构建产物不等于交付制品。UI NuGet 包构建与发布 —
ui.publishingUI NuGet整批与Algorithms单包发布、Release标签和版本预检;预检不预留版本,逐包上传没有整批回滚或逐条失败检查。ROI 统计:区域、直方图与坏点候选 —
algorithms.roi-statisticsROI统计的区域选择、百分位、直方图、坏点候选计数/返回上限及六文件CSV导出;说明Float32精确统计预算、列名精度限制和实际窗口操作。ColorVision 概览 —
platform.productColorVision 的设备、流程、图像分析、结果、插件与客户项目能力,以及从任务进入文档的方法。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。ONNX / AI 推理接入设计(Deferred) [规划] —
algorithms.onnx尚未实现的 ONNX 接入设计:保持基础产品无 ONNX 运行时,新增 adapter 前须明确模型与验收门禁。配套服务纳入 ColorVision 的演进规划 [规划] —
platform.service-integration-roadmap在不修改 CVWindowsService 源码的前提下,由 ColorVision 接管配置、执行选择、结果与交付的渐进路线;区分已有本地能力、残余数据库与原生依赖,以及阶段验收和回退条件。
UI/ColorVision.Common
扩展性开发 —
platform.extensibility按插件、菜单、属性面板、设备、Flow、算法和结果扩展任务定位实现与当前契约。UI 组件目录 —
ui.control-catalog按控件、窗口和扩展接口定位对应 UI 源码与专题。Copilot 扩展、MCP 与 Hook —
copilot.extensions业务模块动态上下文、外部 MCP client 和 Hook 如何进入统一宿主权限与生命周期。Copilot 工具契约 —
copilot.tool-contractsCopilot 工具结果、事件、审批恢复和 Flow 编辑必须遵守的执行契约。Engine 设备资源与运行装配 —
engine.devices设备工厂、资源重载、显示装配与详情视图按需初始化;旧对象释放、集合重建和显示替换并非一个事务,记录存在、界面可见、服务在线和动作完成分别判断。算法结果交接、展示与导出 —
engine.results算法结果交接、已加载批次主记录查询与叠加显示:区分本地中立 Geometry/Overlay、Engine 历史 handler 和客户业务导出,保留来源与文档/revision 生命周期。模板注册、参数与持久化 —
engine.template-designTemplateControl注册与普通ITemplate<T>参数加载、保存、复制和删除契约;注册、内存变更和数据库成功是不同状态,JSON与Flow另有实现。Flow 运行诊断、中断恢复与 Incident 处置 —
flow.diagnosticsFlow本地诊断SQLite快照、节点尝试与Incident事件列表的读写边界;快照不保证包含未保存画布,终态持久化与业务结果分开,中断恢复不续跑节点,心跳不是判死条件。开发工具管理:检测与安装 Python、Node.js —
platform.developer-tools开发工具管理的Python/Node检测、当前应用与新终端命令路径、官方版本选择和安装校验;下载等待30分钟,关窗停止后续安装但不取消下载或终止安装器。启动、初始化与故障恢复 —
platform.runtime启动顺序与故障恢复:软件渲染兼容参数在 WPF 窗口前生效;初始化进度和ready不代表全部成功,一次性插件跳过不绕过真实故障。权限边界与鉴权入口 —
platform.security区分应用管理员、RBAC会话与权限码、Windows服务身份及远程/工具授权;登录缓存和界面状态不能替代执行入口的权限检查。插件装载、依赖门禁与扩展发现 —
plugins.modelPluginLoader的manifest/依赖门禁、禁用缓存、程序集发现和失败边界;载入不等于provider可用,也不支持隔离卸载。共享接口、属性通知与粗粒度权限 —
ui.common共享接口的宿主接入、属性通知与命令的同步执行限制、粗粒度权限判据,以及第三方工具发现和启动边界。配置持久化、重载与对象所有权 —
ui.configuration应用设置 JSON 的备份恢复、配置路径、延迟实例、合并保存与重载;ConfigHandler单文件替换不等于内存发布成功,重载会使旧配置引用失效。共享防抖与回调生命周期 —
ui.debounce-timer共享防抖的同键替换、回调所有权、Dispatcher 排队取消与可复用清理边界。UI 运行时扩展发现与排查 —
ui.discoveryUI 扩展发现与入口缺失排查:AssemblyHandler 的程序集过滤、类型缓存和 provider 构造;刷新程序集不重建所有消费者,入口可见不证明初始化或业务完成。多图查看、刷新与缩略图缓存 —
ui.image-toolsImageTools内置注册、多图列表中的单张预览、刷新与SQLite缩略图缓存;重选不保证重载,关窗不清缓存,缓存关闭也不等于零数据库访问。菜单:发现、显示、执行与配置 —
ui.menus插件菜单发现、类型缓存、菜单树、显示覆盖与执行权限。启动时加载可见性、顺序和父级配置,快捷键独立注册。PropertyGrid 属性编辑契约 —
ui.property-grid属性面板的字段生成、编辑器选择和 Flow 适配;区分直接修改、工作副本、关闭、重置与宿主持久化。应用搜索:入口、候选与执行 —
ui.search应用搜索窗口的入口、关键词匹配、候选来源、缓存刷新与命令执行;Ctrl+F 按焦点执行局部查找,Ctrl+Shift+P 打开应用搜索。设置窗口:发现、编辑与关闭契约 —
ui.settings设置窗口的元数据发现、搜索定位与活对象编辑;选项/搜索入口在关闭窗口后调用保存,关窗不撤销修改,保存失败不回滚;启动检查更新是聚合开关。状态栏:发现、刷新与宿主生命周期 —
ui.status-bar状态栏的插件发现、活动文档通知、绑定更新、控件重建和关闭生命周期;刷新不保证发现新provider,隐藏不等于保存偏好或停止采样。配置向导:步骤、应用与完成边界 —
ui.wizards配置向导的步骤发现、初始化时序、前进应用和完成标记;关闭不回滚,完成标记不证明组件健康或重启成功。FlowEngineLib 节点扩展 —
flow.node-extension说明服务与本地节点基类、请求与响应扩展点、分支输入隔离、属性编辑和流程完成的边界。JSON 模板 —
algorithms.json-templatesJSON模板的分组参数与文本编辑、语法检查、输入草稿、保存保护和默认参数;Schema提供字段提示而不补默认值或执行完整校验。ROI 统计:区域、直方图与坏点候选 —
algorithms.roi-statisticsROI统计的区域选择、百分位、直方图、坏点候选计数/返回上限及六文件CSV导出;说明Float32精确统计预算、列名精度限制和实际窗口操作。ColorVision 本地 MCP —
copilot.mcp-serverColorVision 入站本地 MCP 的连接与会话、工具和资源、工作区读取、两阶段确认及菜单写入边界。系统监控(SystemMonitor) —
plugins.system-monitor系统监控的 CPU/RAM 采样、手动刷新与状态栏生命周期;缓存大小包含子目录,清理只删顶层文件,逐文件失败不会单独提示。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.Core
本地十字定位 FindCross —
algorithms.find-cross本地十字定位的图像菜单、Flow 节点、生产参数、全图坐标、原生返回值与失败诊断。发光区定位:AA 模板与本地 V2 —
algorithms.find-light-areaAA 模板与本地发光区定位(V2)的入口、图像来源、POI保存模板和结果边界。本地 FOV V2 —
algorithms.fov-local本地 FOV V2 的默认四角与独立轮廓模式、相机角度参数、中心截线及包络口径、叠图和 FOV 2.0 结果兼容契约。本地点阵畸变 V2 —
algorithms.grid-distortion本地点阵畸变 V2 单次定位、TV/九点多口径及相对光学估计,覆盖 ImageView、Flow 和 ARVR 2.0 适配;光学估计不等同于标定结果。灯珠定位与完整网格判定 —
algorithms.light-beads灯珠亮点定位、完整规则网格与不亮偏暗判定,覆盖运行内存 POI、可选 CSV 及旧 native 暗区候选的限制。本地 P2 分析 —
algorithms.local-native-analysis本地 Ghost、旋转模板匹配和双目标定融合的直接 native 操作、结果显示与生命周期限制;灯珠定位由独立主题维护。Matching 模板匹配 —
algorithms.matching说明本地模板匹配的节点内置配置、cvtm 导入导出与无数据库执行,以及旧服务 Matching 的请求与 AOI 结果。日志来源、历史读取与筛选 —
operations.logs区分log4net输出、历史文件读取与UI筛选,说明刷新、截断和原生日志采集边界;没有显示不等于动作未发生。源图像帧:租约、位图复制与缓存失效 —
ui.image-frames位图读取时借用原图内存与复制像素的区别、租约释放责任和缓存版本;原图修改须显式失效,复制HImage不延长租约。景深融合:输入、执行与结果生命周期 —
ui.image-fusion景深融合窗口与本地流程节点共用文件执行器;输入顺序、CPU/CUDA门禁、取消、结果保存及下游图像交接。系统要求与首次构建 —
delivery.prerequisitesWindows x64 运行与源码构建前提:Desktop Runtime、SDK、C++ 工具集及已有 native DLL 的选择。OpenCV 和 native 集成开发指南 —
engine.native-integrationnative ABI与HImage所有权、函数族返回值,以及helper构建和CUDA发布输入;路由校准Context与POI原生参考。UI NuGet 包构建与发布 —
ui.publishingUI NuGet整批与Algorithms单包发布、Release标签和版本预检;预检不预留版本,逐包上传没有整批回滚或逐条失败检查。POI 模板 —
algorithms.poi-template说明 POI 主从表、伴生模板、复制导入、运行事件与结果类型映射。opencv_helper.dll API 参考 —
engine.opencv-helper-apiopencv_helper 英文 API 参考:校准/POI、图像处理、SFR、检测与内存释放;核对真实参数单位和函数族错误码,声明的选项不等于当前 Engine 提供操作入口。ColorVision.Core —
ui.core定位 HImage 所有权、OpenCV/CUDA PInvoke、ImageCompute 融合分流、位图桥接与默认关闭的原生日志。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.Database
数据所有者与存储定位 —
operations.data按设置JSON、Engine MySQL、模块SQLite和结果文件定位数据所有者;有记录、有图片、已导出和已备份不是同一状态。Engine 设备资源与运行装配 —
engine.devices设备工厂、资源重载、显示装配与详情视图按需初始化;旧对象释放、集合重建和显示替换并非一个事务,记录存在、界面可见、服务在线和动作完成分别判断。MySQL 结果索引优化、清理、备份与失败边界 —
engine.mysql-maintenanceMySQL 结果表的手动关联索引优化、历史删除、整表截断和SQL备份;在线DDL、并发、部分成功、备份与恢复边界分别说明。MySQL SQL 恢复、重置与资源保留 —
engine.mysql-recoveryMySQL恢复后更新流程节点标识,再同步配置和重启注册中心;支持独立更新按钮。SQL导入不回滚,迁移备份不含结果。数据库连接、DAO 与旧插件兼容 —
ui.databaseMySQL 连接配置与业务 DAO、POI 模板的 SQLite 自动回退,以及旧插件注册的二进制兼容。通用查询、条件会话与整表操作 —
ui.database-query实体驱动的通用查询窗口:条件参数化、执行时SQL预览、结果替换与进程内会话;关闭不取消查询,清空表/截断表作用于整表而非筛选结果。SQLite 正文存储、迁移与文件维护 —
ui.sqlite-storageSocket 与 Flow 的 SQLite 正文 gzip 编解码、按ID读写、旧TEXT逐批迁移、WAL备份与VACUUM;通用工具不自动停写/备份/恢复,失败可能已有批次提交。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.ImageEditor
UI 组件目录 —
ui.control-catalog按控件、窗口和扩展接口定位对应 UI 源码与专题。UI 知识入口 —
ui.index按问题路由到 UI 模块、属性编辑契约、运行时发现与 DLL 发布证据。显示图案计量 —
algorithms.display-metrology本地显示图案计量的入口、共享输入与 RGB 套色、外部鬼影、屏体缺陷、灰尘、双目和 Eyebox 等口径;十字 RGB 与圆环鬼影另有独立主题。本地十字定位 FindCross —
algorithms.find-cross本地十字定位的图像菜单、Flow 节点、生产参数、全图坐标、原生返回值与失败诊断。发光区定位:AA 模板与本地 V2 —
algorithms.find-light-areaAA 模板与本地发光区定位(V2)的入口、图像来源、POI保存模板和结果边界。本地 FOV V2 —
algorithms.fov-local本地 FOV V2 的默认四角与独立轮廓模式、相机角度参数、中心截线及包络口径、叠图和 FOV 2.0 结果兼容契约。本地点阵畸变 V2 —
algorithms.grid-distortion本地点阵畸变 V2 单次定位、TV/九点多口径及相对光学估计,覆盖 ImageView、Flow 和 ARVR 2.0 适配;光学估计不等同于标定结果。灯珠定位与完整网格判定 —
algorithms.light-beads灯珠亮点定位、完整规则网格与不亮偏暗判定,覆盖运行内存 POI、可选 CSV 及旧 native 暗区候选的限制。本地 P2 分析 —
algorithms.local-native-analysis本地 Ghost、旋转模板匹配和双目标定融合的直接 native 操作、结果显示与生命周期限制;灯珠定位由独立主题维护。Matching 模板匹配 —
algorithms.matching说明本地模板匹配的节点内置配置、cvtm 导入导出与无数据库执行,以及旧服务 Matching 的请求与 AOI 结果。统一图像算法平台 V1 —
algorithms.platform图像编辑器本地算法扩展:Catalog 描述、provider 注册、Invocation 和 Runner 执行;像素预览与应用/取消、几何结果和叠加显示分流,保留所有权与发布门禁;ONNX仅设计。十字 RGB 分离 —
algorithms.rgb-cross本地十字 RGB 三通道边缘测量、G 参考偏移、原图坐标与独立有效状态;像素结果不等同于已标定角度色差。圆环鬼影 —
algorithms.ring-ghost完整圆环与偏心弱环的区域平均信号比、GMR 阶次及 Flow 正常未检出零值约定;不自动证明光路阶次或现场精度。本地条纹 MTF —
algorithms.stripe-mtfImageView 与 Flow 共用的本地条纹亮暗对比度:取样、四部定位、比例与百分数、输入限制及 MTF 2.0 结果兼容。Copilot 扩展、MCP 与 Hook —
copilot.extensions业务模块动态上下文、外部 MCP client 和 Hook 如何进入统一宿主权限与生命周期。CVRAW / CVCIE 图像导出 —
engine.cv-image-exportCVRAW/CVCIE 原生导出的窗口、命令行参数、通道和命名规则,以及覆盖、部分失败和退出码边界。CVCIE POI 结果数值 —
engine.cvcie-resultsImageView 封闭区域 POI、D65 色彩中心 RMS、椭圆探针、结果显示精度与非正值重算;保留传统节点和导出边界。CV 文件读取、通道与写回契约 —
engine.file-ioCVRAW/CVCIE 读取、动态校正参数覆盖、RAW 按需色度测量、内嵌 XYZ 显示,以及版本写回和失败边界。算法结果交接、展示与导出 —
engine.results算法结果交接、已加载批次主记录查询与叠加显示:区分本地中立 Geometry/Overlay、Engine 历史 handler 和客户业务导出,保留来源与文档/revision 生命周期。相机服务、采集与结果视图 —
operations.camera本地与服务相机控制、共享电机会话、自动曝光与自动对焦模板、无文件预览;明确占用、超时、结果完成及帧寿命。系统职责与跨模块边界 —
platform.system宿主、UI、Engine、插件与项目的职责及调用边界:UI操作不必经过Engine,程序集依赖不是统一执行顺序,构建产物不等于交付制品。CIE 色度与样品分析 —
ui.cie-analysis统一 CIE 窗口的样品、色差、色域覆盖与导出契约;区分实测 XYZ、RGB 推算与仅色坐标。UI 运行时扩展发现与排查 —
ui.discoveryUI 扩展发现与入口缺失排查:AssemblyHandler 的程序集过滤、类型缓存和 provider 构造;刷新程序集不重建所有消费者,入口可见不证明初始化或业务完成。ColorVision.ImageEditor:打开、绘制与输出 —
ui.image-editor图像打开、绘图撤销、叠加层、3D 与快照输出边界,区分渲染图、当前源像素和重读源文件的模型导出。ImageEditor:上下文、工具装配与临时选区 —
ui.image-editor-contextImageView 的文档、会话、显示、算法协调和扩展所有权;说明源提交、连续帧有界处理、工具生命周期及临时 ROI 有效期。源图像帧:租约、位图复制与缓存失效 —
ui.image-frames位图读取时借用原图内存与复制像素的区别、租约释放责任和缓存版本;原图修改须显式失效,复制HImage不延长租约。状态栏:发现、刷新与宿主生命周期 —
ui.status-bar状态栏的插件发现、活动文档通知、绑定更新、控件重建和关闭生命周期;刷新不保证发现新provider,隐藏不等于保存偏好或停止采样。设置、流程与结果的导入导出边界 —
operations.exports按软件设置备份、流程、图像和项目结果定位导入导出入口,说明备份恢复范围、文件验收与迁移边界。UI NuGet 包构建与发布 —
ui.publishingUI NuGet整批与Algorithms单包发布、Release标签和版本预检;预检不预留版本,逐包上传没有整批回滚或逐条失败检查。Blob / 连通域 V1 —
algorithms.blob-analysisBlobAnalysis 保留实现的参数、结果与验证契约;默认运行时由 Experimental 门禁拒绝执行。圆拟合 V1 —
algorithms.circle-fitCircleFit 保留实现的参数、结果与验证契约;默认运行时由 Experimental 门禁拒绝执行。轮廓提取 V1 —
algorithms.contour-analysisContourAnalysis 保留实现的参数、结果与验证契约;默认运行时由 Experimental 门禁拒绝执行。FFT / 频域分析 V1 —
algorithms.frequency-spectrumFrequencySpectrum 保留实现的参数、结果与验证契约;默认运行时由 Experimental 门禁拒绝执行。几何变换 V1 —
algorithms.geometric-transformGeometricTransform 的输入、参数、结果、宿主接入与定向验证契约。图像比较:差分、SSIM 与对齐预检 —
algorithms.image-comparison图像比较的操作、参数范围、ROI、差分/SSIM/对齐结果和PNG/JSON/CSV导出;对齐预检使用有硬采样预算的均匀网格,192MiB仅限制图像输出。灰度与颜色剖面:采样、曲线与数据导出 —
algorithms.image-profile灰度/RGB、CVCIE 及带校正参数 CVRAW 的多通道叠加剖面、主题适配、统计和完整 JSON/CSV 导出;包含精度、单位、失效规则及预算。图像配准 V1 —
algorithms.image-registrationImageRegistration 的输入、参数、结果、宿主接入与定向验证契约。成像校正:参考图、执行与结果保存 —
algorithms.imaging-correction成像校正的参考图、固定阶段、参数/preset、执行并提交、mask与PNG/CSV/JSON保存;明确Alpha裁剪、无效样本、精确复制和批量只保存主图的边界。镜头畸变校正 V1 —
algorithms.lens-distortion-correctionLensDistortionCorrection 的输入、参数、结果、宿主接入与定向验证契约。直线拟合 V1 —
algorithms.line-fitLineFit 保留实现的参数、结果与验证契约;默认运行时由 Experimental 门禁拒绝执行。摩尔纹分析 V1 —
algorithms.moire-analysisMoireAnalysis 保留实现的参数、结果与验证契约;默认运行时由 Experimental 门禁拒绝执行。ROI 统计:区域、直方图与坏点候选 —
algorithms.roi-statisticsROI统计的区域选择、百分位、直方图、坏点候选计数/返回上限及六文件CSV导出;说明Float32精确统计预算、列名精度限制和实际窗口操作。亚像素边缘 V1 —
algorithms.subpixel-edgeSubpixelEdge 保留实现的参数、结果与验证契约;默认运行时由 Experimental 门禁拒绝执行。opencv_helper.dll API 参考 —
engine.opencv-helper-apiopencv_helper 英文 API 参考:校准/POI、图像处理、SFR、检测与内存释放;核对真实参数单位和函数族错误码,声明的选项不等于当前 Engine 提供操作入口。ColorVision 概览 —
platform.productColorVision 的设备、流程、图像分析、结果、插件与客户项目能力,以及从任务进入文档的方法。ProjectARVRPro —
projects.arvr-proARVRPro 项目入口、Socket 自动化、输出与历史结果查询;流程组、实例 Recipe 和 Demura 各有对应操作主题。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。ONNX / AI 推理接入设计(Deferred) [规划] —
algorithms.onnx尚未实现的 ONNX 接入设计:保持基础产品无 ONNX 运行时,新增 adapter 前须明确模型与验收门禁。设备视图内存预览设计(待实施) [规划] —
engine.camera-preview-plan设备视图已接入 RAW/CIE 独立快照;记录有界调度、预览模式和更低复制成本等后续优化及验收缺口。图像设置:作用范围、保存和扩展 —
ui.image-editor-settings-plan图像设置的作用范围、默认值与标定档案保存、视图隔离和扩展入口。
UI/ColorVision.ImageTools
景深融合:输入、执行与结果生命周期 —
ui.image-fusion景深融合窗口与本地流程节点共用文件执行器;输入顺序、CPU/CUDA门禁、取消、结果保存及下游图像交接。多图查看、刷新与缩略图缓存 —
ui.image-toolsImageTools内置注册、多图列表中的单张预览、刷新与SQLite缩略图缓存;重选不保证重载,关窗不清缓存,缓存关闭也不等于零数据库访问。存储清理与选择性设置重置 —
ui.storage-maintenance存储分类占用与模块扩展接口、独立文件确认清理,以及配置页的恢复点和选择性下次启动重置。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.Rbac
许可证激活与设备名额 —
delivery.backend-activation用户中心的可选许可证激活、TPM 离线凭据、在线租约和后台设备名额。文件中转、覆盖与公开分享 —
delivery.file-transferWeb文件中转与桌面云盘的匿名上传、续传、公开分享及过期规则;桌面保存本机队列,网页队列不持久化。RBAC:登录缓存、会话与权限边界 —
platform.rbac本地RBAC的登录缓存、会话校验和权限同步限制,以及自动登录失败、登出撤销和用户中心统计的实际边界。权限边界与鉴权入口 —
platform.security区分应用管理员、RBAC会话与权限码、Windows服务身份及远程/工具授权;登录缓存和界面状态不能替代执行入口的权限检查。共享接口、属性通知与粗粒度权限 —
ui.common共享接口的宿主接入、属性通知与命令的同步执行限制、粗粒度权限判据,以及第三方工具发现和启动边界。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.Scheduler
UI 运行时扩展发现与排查 —
ui.discoveryUI 扩展发现与入口缺失排查:AssemblyHandler 的程序集过滤、类型缓存和 provider 构造;刷新程序集不重建所有消费者,入口可见不证明初始化或业务完成。任务计划程序:创建、调度与执行历史 —
ui.scheduler任务计划程序按类型执行循环或启用定时计划;重启先暂停,完成后可重新执行整轮,仅执行一次独立于计划次数。状态栏:发现、刷新与宿主生命周期 —
ui.status-bar状态栏的插件发现、活动文档通知、绑定更新、控件重建和关闭生命周期;刷新不保证发现新provider,隐藏不等于保存偏好或停止采样。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.SocketProtocol
数据所有者与存储定位 —
operations.data按设置JSON、Engine MySQL、模块SQLite和结果文件定位数据所有者;有记录、有图片、已导出和已备份不是同一状态。数据库清理窗口、能力接入与完成边界 —
engine.database-maintenance数据库维护窗口与provider能力:表统计不是删除预览;备份默认关闭,备份和清理不是事务且失败不自动恢复;清理、手动优化和迁移边界彼此独立。跨模块运行问题定位 —
operations.index从启动、配置、日志、设备、流程和结果现象定位代码责任,区分已完成阶段与待验证阶段,避免用重启或改数据代替诊断。Spectrum Socket 业务指令与完成边界 —
plugins.spectrum-socketSpectrum Socket 的启用与状态查询、五个指令的参数和返回值;连接成功与标定就绪不同,30/60 秒取消不保证原生操作按时停止。通用查询、条件会话与整表操作 —
ui.database-query实体驱动的通用查询窗口:条件参数化、执行时SQL预览、结果替换与进程内会话;关闭不取消查询,清空表/截断表作用于整表而非筛选结果。UI 运行时扩展发现与排查 —
ui.discoveryUI 扩展发现与入口缺失排查:AssemblyHandler 的程序集过滤、类型缓存和 provider 构造;刷新程序集不重建所有消费者,入口可见不证明初始化或业务完成。TCP 监听、协议分发与消息记录 —
ui.socket-protocolSocket连接管理器的监听配置、窗口关闭与服务停止、防火墙放行、消息查询和JSON/Text分发;清空消息只清列表,重发可能换客户端,Sent不证明对端执行。SQLite 正文存储、迁移与文件维护 —
ui.sqlite-storageSocket 与 Flow 的 SQLite 正文 gzip 编解码、按ID读写、旧TEXT逐批迁移、WAL备份与VACUUM;通用工具不自动停写/备份/恢复,失败可能已有批次提交。ARVRPro TCP 通讯协议 —
projects.arvr-pro-protocolARVRPro TCP/JSON 对接:初始化与 RunAll、流程启用设置、切图确认、AOI 切图节点、状态码和最终结果关联;说明分帧与并发会话限制。LUX TCP 通讯协议 —
projects.lux-protocolARVRPro 的 LUX TCP 文本入口:T0000 握手、VID、光学中心、光通量与 SocketCode 流程,以及回包和连接限制。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.Solution
UI 组件目录 —
ui.control-catalog按控件、窗口和扩展接口定位对应 UI 源码与专题。Engine 设备资源与运行装配 —
engine.devices设备工厂、资源重载、显示装配与详情视图按需初始化;旧对象释放、集合重建和显示替换并非一个事务,记录存在、界面可见、服务在线和动作完成分别判断。主窗口与入口装配 —
operations.main-window主窗口菜单、搜索、状态栏与工作区装配;Windows 11 使用紧凑主窗口,Windows 10 保持原生窗口。终端进程、会话与脚本运行 —
operations.terminal定义内嵌ConPTY会话、编辑器Python运行与外部CMD入口,区分命令提交、脚本结束、shell退出和强制释放。UI 运行时扩展发现与排查 —
ui.discoveryUI 扩展发现与入口缺失排查:AssemblyHandler 的程序集过滤、类型缓存和 provider 构造;刷新程序集不重建所有消费者,入口可见不证明初始化或业务完成。编辑器选择、文档生命周期与停靠布局 —
ui.documents编辑器注册与选择、文档身份、保存重载关闭及外部变更;重置停靠布局保留已打开的编辑器和未保存修改。快捷键:发现、注册、编辑与释放 —
ui.hotkeys快捷键的发现、多组绑定、窗口/全局注册与搜索编辑;同一操作共享作用域,未分配操作保留展示,确认后立即保存,注册或持久化失败按结果补偿。工作区创建、资源打开与文件树管理 —
ui.solution工作区创建、打开与最近列表,文件树搜索和引用移除,切换取消及 cvsln 恢复。新建工作区保留已有文件。状态栏:发现、刷新与宿主生命周期 —
ui.status-bar状态栏的插件发现、活动文档通知、绑定更新、控件重建和关闭生命周期;刷新不保证发现新provider,隐藏不等于保存偏好或停止采样。文本编辑器 —
ui.text-editorAvalonEdit 编辑器的代码地图、字体、查找替换、自动配对、文档内补全与符号导航,以及后台分析和 JSON 诊断边界。主程序启动与最小图像验证 —
operations.first-run主程序启动的配置、实例和服务副作用,远程白屏的软件渲染兼容入口,以及隔离测试环境中的最小本地图像验证。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.Themes
主窗口与入口装配 —
operations.main-window主窗口菜单、搜索、状态栏与工作区装配;Windows 11 使用紧凑主窗口,Windows 10 保持原生窗口。PropertyGrid 属性编辑契约 —
ui.property-grid属性面板的字段生成、编辑器选择和 Flow 适配;区分直接修改、工作副本、关闭、重置与宿主持久化。文本编辑器 —
ui.text-editorAvalonEdit 编辑器的代码地图、字体、查找替换、自动配对、文档内补全与符号导航,以及后台分析和 JSON 诊断边界。主题选择、资源应用与窗口外观 —
ui.themes应用主题即时预览,启动页独立选择深色、浅色或跟随软件且下次启动生效;ThemeManager 的资源、系统跟随、窗口外观和保存边界。UI NuGet 包构建与发布 —
ui.publishingUI NuGet整批与Algorithms单包发布、Release标签和版本预检;预检不预留版本,逐包上传没有整批回滚或逐条失败检查。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
UI/ColorVision.UI
数据所有者与存储定位 —
operations.data按设置JSON、Engine MySQL、模块SQLite和结果文件定位数据所有者;有记录、有图片、已导出和已备份不是同一状态。扩展性开发 —
platform.extensibility按插件、菜单、属性面板、设备、Flow、算法和结果扩展任务定位实现与当前契约。插件装配与模块知识入口 —
plugins.index按程序集装载、产物交付、插件能力比较和模块操作定位权威主题与源码。UI 组件目录 —
ui.control-catalog按控件、窗口和扩展接口定位对应 UI 源码与专题。ColorVision.UI 壳层责任与知识入口 —
ui.frameworkColorVision.UI壳层责任入口:按配置、插件、菜单、热键、搜索、语言、状态栏、属性编辑和日志定位规范主题,业务行为仍归所属模块。UI 知识入口 —
ui.index按问题路由到 UI 模块、属性编辑契约、运行时发现与 DLL 发布证据。模板编辑入口与菜单契约 —
algorithms.template-menus从模板菜单、算法面板或应用搜索打开模板;说明选择索引、流程设计器直达和菜单发现的边界。Copilot 设置、持久化与连接诊断 —
copilot.configurationColorVision内置Copilot的设置草稿、配置保存与运行态发布、模型选择和联网诊断;保存失败可能已落盘,Local MCP测试核验会话握手与只读状态调用。检查更新、重新安装与程序备份 —
delivery.update检查更新、重新安装与程序备份入口,以及主程序和插件的检查复用、下载安装、失败回退与启动恢复。更新扫描保护:临时排除项与清理所有权 —
delivery.update-scan-protectionServiceHost提供的主程序增量更新临时Defender排除项、目录准入和清理所有权;启用失败不阻断更新,服务停止或保护超时不保证排除项立即恢复。CVRAW / CVCIE 图像导出 —
engine.cv-image-exportCVRAW/CVCIE 原生导出的窗口、命令行参数、通道和命名规则,以及覆盖、部分失败和退出码边界。数据库清理窗口、能力接入与完成边界 —
engine.database-maintenance数据库维护窗口与provider能力:表统计不是删除预览;备份默认关闭,备份和清理不是事务且失败不自动恢复;清理、手动优化和迁移边界彼此独立。Engine 设备资源与运行装配 —
engine.devices设备工厂、资源重载、显示装配与详情视图按需初始化;旧对象释放、集合重建和显示替换并非一个事务,记录存在、界面可见、服务在线和动作完成分别判断。MySQL SQL 恢复、重置与资源保留 —
engine.mysql-recoveryMySQL恢复后更新流程节点标识,再同步配置和重启注册中心;支持独立更新按钮。SQL导入不回滚,迁移备份不含结果。Explorer 缩略图读取与 COM 注册 —
engine.shell-extensionExplorer 的 CVRAW/CVCIE COM provider 如何读取像素、生成非测量用途缩略图,以及源码脚本与 ServiceHost 注册的不同副作用和失败边界。模板注册、参数与持久化 —
engine.template-designTemplateControl注册与普通ITemplate<T>参数加载、保存、复制和删除契约;注册、内存变更和数据库成功是不同状态,JSON与Flow另有实现。跨模块运行问题定位 —
operations.index从启动、配置、日志、设备、流程和结果现象定位代码责任,区分已完成阶段与待验证阶段,避免用重启或改数据代替诊断。日志来源、历史读取与筛选 —
operations.logs区分log4net输出、历史文件读取与UI筛选,说明刷新、截断和原生日志采集边界;没有显示不等于动作未发生。主窗口与入口装配 —
operations.main-window主窗口菜单、搜索、状态栏与工作区装配;Windows 11 使用紧凑主窗口,Windows 10 保持原生窗口。终端进程、会话与脚本运行 —
operations.terminal定义内嵌ConPTY会话、编辑器Python运行与外部CMD入口,区分命令提交、脚本结束、shell退出和强制释放。开发工具管理:检测与安装 Python、Node.js —
platform.developer-tools开发工具管理的Python/Node检测、当前应用与新终端命令路径、官方版本选择和安装校验;下载等待30分钟,关窗停止后续安装但不取消下载或终止安装器。启动、初始化与故障恢复 —
platform.runtime启动顺序与故障恢复:软件渲染兼容参数在 WPF 窗口前生效;初始化进度和ready不代表全部成功,一次性插件跳过不绕过真实故障。ColorVisionServiceHost:本机权限代理与生命周期 —
platform.service-hostColorVision 服务主机的状态刷新、安装修复、日志诊断、身份票据与就绪条件;自动刷新只更新日志,客户端超时不取消命令,服务停止超过两分钟仍等待排空,服务启动成功日志不证明后台清理和启动完整性检查完成。系统职责与跨模块边界 —
platform.system宿主、UI、Engine、插件与项目的职责及调用边界:UI操作不必经过Engine,程序集依赖不是统一执行顺序,构建产物不等于交付制品。插件产物、安装与交付 —
plugins.getting-started插件项目构建、HostCopy、市场与本地安装、备份回退和提取插件;DLL目录替换、依赖补回及重启后加载的完成条件,正式打包会上传。插件装载、依赖门禁与扩展发现 —
plugins.modelPluginLoader的manifest/依赖门禁、禁用缓存、程序集发现和失败边界;载入不等于provider可用,也不支持隔离卸载。WindowsServicePlugin:选包、本机安装与恢复 —
plugins.windows-serviceWindowsServicePlugin的在线选包与缓存、本机完整安装、数据库版本切换和恢复边界;下载、日志完成、备份与实际服务状态不能互相替代。关于窗口:视觉展示与光谱展示 —
ui.about-exhibition主程序的图像、色彩与测量展示,以及 Spectrum 的光谱关于页:独立品牌和版本、中英文与繁体资源、不透明深浅配色、原生圆角对齐与关闭释放约束。共享接口、属性通知与粗粒度权限 —
ui.common共享接口的宿主接入、属性通知与命令的同步执行限制、粗粒度权限判据,以及第三方工具发现和启动边界。配置持久化、重载与对象所有权 —
ui.configuration应用设置 JSON 的备份恢复、配置路径、延迟实例、合并保存与重载;ConfigHandler单文件替换不等于内存发布成功,重载会使旧配置引用失效。UI 运行时扩展发现与排查 —
ui.discoveryUI 扩展发现与入口缺失排查:AssemblyHandler 的程序集过滤、类型缓存和 provider 构造;刷新程序集不重建所有消费者,入口可见不证明初始化或业务完成。编辑器选择、文档生命周期与停靠布局 —
ui.documents编辑器注册与选择、文档身份、保存重载关闭及外部变更;重置停靠布局保留已打开的编辑器和未保存修改。快捷键:发现、注册、编辑与释放 —
ui.hotkeys快捷键的发现、多组绑定、窗口/全局注册与搜索编辑;同一操作共享作用域,未分配操作保留展示,确认后立即保存,注册或持久化失败按结果补偿。ImageEditor:上下文、工具装配与临时选区 —
ui.image-editor-contextImageView 的文档、会话、显示、算法协调和扩展所有权;说明源提交、连续帧有界处理、工具生命周期及临时 ROI 有效期。界面语言:资源发现、配置与重启 —
ui.localization界面语言的资源发现、系统语言回退、设置绑定和重启切换;语言下拉框不证明插件翻译完整,修改配置值不等于刷新窗口。菜单:发现、显示、执行与配置 —
ui.menus插件菜单发现、类型缓存、菜单树、显示覆盖与执行权限。启动时加载可见性、顺序和父级配置,快捷键独立注册。PropertyGrid 属性编辑契约 —
ui.property-grid属性面板的字段生成、编辑器选择和 Flow 适配;区分直接修改、工作副本、关闭、重置与宿主持久化。任务计划程序:创建、调度与执行历史 —
ui.scheduler任务计划程序按类型执行循环或启用定时计划;重启先暂停,完成后可重新执行整轮,仅执行一次独立于计划次数。应用搜索:入口、候选与执行 —
ui.search应用搜索窗口的入口、关键词匹配、候选来源、缓存刷新与命令执行;Ctrl+F 按焦点执行局部查找,Ctrl+Shift+P 打开应用搜索。设置窗口:发现、编辑与关闭契约 —
ui.settings设置窗口的元数据发现、搜索定位与活对象编辑;选项/搜索入口在关闭窗口后调用保存,关窗不撤销修改,保存失败不回滚;启动检查更新是聚合开关。工作区创建、资源打开与文件树管理 —
ui.solution工作区创建、打开与最近列表,文件树搜索和引用移除,切换取消及 cvsln 恢复。新建工作区保留已有文件。状态栏:发现、刷新与宿主生命周期 —
ui.status-bar状态栏的插件发现、活动文档通知、绑定更新、控件重建和关闭生命周期;刷新不保证发现新provider,隐藏不等于保存偏好或停止采样。存储清理与选择性设置重置 —
ui.storage-maintenance存储分类占用与模块扩展接口、独立文件确认清理,以及配置页的恢复点和选择性下次启动重置。主题选择、资源应用与窗口外观 —
ui.themes应用主题即时预览,启动页独立选择深色、浅色或跟随软件且下次启动生效;ThemeManager 的资源、系统跟随、窗口外观和保存边界。配置向导:步骤、应用与完成边界 —
ui.wizards配置向导的步骤发现、初始化时序、前进应用和完成标记;关闭不回滚,完成标记不证明组件健康或重启成功。设置、流程与结果的导入导出边界 —
operations.exports按软件设置备份、流程、图像和项目结果定位导入导出入口,说明备份恢复范围、文件验收与迁移边界。主程序启动与最小图像验证 —
operations.first-run主程序启动的配置、实例和服务副作用,远程白屏的软件渲染兼容入口,以及隔离测试环境中的最小本地图像验证。JSON 模板 —
algorithms.json-templatesJSON模板的分组参数与文本编辑、语法检查、输入草稿、保存保护和默认参数;Schema提供字段提示而不补默认值或执行完整校验。系统监控(SystemMonitor) —
plugins.system-monitor系统监控的 CPU/RAM 采样、手动刷新与状态栏生命周期;缓存大小包含子目录,清理只删顶层文件,逐文件失败不会单独提示。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。图像设置:作用范围、保存和扩展 —
ui.image-editor-settings-plan图像设置的作用范围、默认值与标定档案保存、视图隔离和扩展入口。
UI/ColorVision.UI.Desktop
Android 运维伴侣 —
delivery.android-operationsAndroid原生运维入口、现场HTTPS与固定签名中继的职责边界;连接、可见证据和操作授权不能互相替代。反馈归属、查询与诊断附件下载 —
delivery.backend-feedback反馈提交按服务端账号归属,普通用户只读本人记录,研发只读账号/API key可下载全部诊断附件,管理员独立更新状态;新目录使用北京时间和机器标识。Backend Operations 中继与只读概览 —
delivery.backend-operationsBackend Operations 的接口、身份与任务回执;区分在线、排队和执行完成,并说明加密快照的下载、消费与过期清理。检查更新、重新安装与程序备份 —
delivery.update检查更新、重新安装与程序备份入口,以及主程序和插件的检查复用、下载安装、失败回退与启动恢复。更新扫描保护:临时排除项与清理所有权 —
delivery.update-scan-protectionServiceHost提供的主程序增量更新临时Defender排除项、目录准入和清理所有权;启用失败不阻断更新,服务停止或保护超时不保证排除项立即恢复。开发工具管理:检测与安装 Python、Node.js —
platform.developer-tools开发工具管理的Python/Node检测、当前应用与新终端命令路径、官方版本选择和安装校验;下载等待30分钟,关窗停止后续安装但不取消下载或终止安装器。启动、初始化与故障恢复 —
platform.runtime启动顺序与故障恢复:软件渲染兼容参数在 WPF 窗口前生效;初始化进度和ready不代表全部成功,一次性插件跳过不绕过真实故障。插件产物、安装与交付 —
plugins.getting-started插件项目构建、HostCopy、市场与本地安装、备份回退和提取插件;DLL目录替换、依赖补回及重启后加载的完成条件,正式打包会上传。插件装载、依赖门禁与扩展发现 —
plugins.modelPluginLoader的manifest/依赖门禁、禁用缓存、程序集发现和失败边界;载入不等于provider可用,也不支持隔离卸载。UI 运行时扩展发现与排查 —
ui.discoveryUI 扩展发现与入口缺失排查:AssemblyHandler 的程序集过滤、类型缓存和 provider 构造;刷新程序集不重建所有消费者,入口可见不证明初始化或业务完成。快捷键:发现、注册、编辑与释放 —
ui.hotkeys快捷键的发现、多组绑定、窗口/全局注册与搜索编辑;同一操作共享作用域,未分配操作保留展示,确认后立即保存,注册或持久化失败按结果补偿。界面语言:资源发现、配置与重启 —
ui.localization界面语言的资源发现、系统语言回退、设置绑定和重启切换;语言下拉框不证明插件翻译完整,修改配置值不等于刷新窗口。菜单:发现、显示、执行与配置 —
ui.menus插件菜单发现、类型缓存、菜单树、显示覆盖与执行权限。启动时加载可见性、顺序和父级配置,快捷键独立注册。应用搜索:入口、候选与执行 —
ui.search应用搜索窗口的入口、关键词匹配、候选来源、缓存刷新与命令执行;Ctrl+F 按焦点执行局部查找,Ctrl+Shift+P 打开应用搜索。设置窗口:发现、编辑与关闭契约 —
ui.settings设置窗口的元数据发现、搜索定位与活对象编辑;选项/搜索入口在关闭窗口后调用保存,关窗不撤销修改,保存失败不回滚;启动检查更新是聚合开关。存储清理与选择性设置重置 —
ui.storage-maintenance存储分类占用与模块扩展接口、独立文件确认清理,以及配置页的恢复点和选择性下次启动重置。主题选择、资源应用与窗口外观 —
ui.themes应用主题即时预览,启动页独立选择深色、浅色或跟随软件且下次启动生效;ThemeManager 的资源、系统跟随、窗口外观和保存边界。配置向导:步骤、应用与完成边界 —
ui.wizards配置向导的步骤发现、初始化时序、前进应用和完成标记;关闭不回滚,完成标记不证明组件健康或重启成功。FlowEngineLib 节点扩展 —
flow.node-extension说明服务与本地节点基类、请求与响应扩展点、分支输入隔离、属性编辑和流程完成的边界。主程序启动与最小图像验证 —
operations.first-run主程序启动的配置、实例和服务副作用,远程白屏的软件渲染兼容入口,以及隔离测试环境中的最小本地图像验证。ColorVision.UI.Desktop —
ui.desktop桌面辅助壳层而非产品主入口:定位设置、市场下载、第三方工具、反馈和特权崩溃诊断。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
