Skip to content

数据所有者与存储定位 ​

设置中的存储展示分类占用,提供历史日志、明确临时产物和可重建缓存的手动清理,以及独立的历史数据与程序存档入口;配置恢复点和选择性设置重置位于“配置”。这些入口不是“总数据库”或全盘垃圾扫描器,以下数据所有者边界仍然适用。

ColorVision 没有一个覆盖软件设置、设备资源、流程模板、消息记录、业务结果和图片的“总数据库”。先确认对象由谁写入、谁读取,再选择查询、导出或备份入口。UI/ColorVision.Database 提供通用数据库基础,不拥有所有模块的数据。

从对象找到实现 ​

对象所有者与实际存储入口继续核对
软件设置与界面配置ConfigHandler.ConfigFilePath 指向配置 JSON;ConfigService 提供配置对象配置持久化与重载、设置导入导出
Engine 设备资源与配置MySQL t_scgd_sys_resource;SysResourceModel.Value 对应 txt_value资源配置、保存与重启
流程与关联模板Engine 的 TemplateFlow 及模板 DAO;运行图、保存模板和导出包不是一份对象Flow 模板与持久化
POI 本地模板MySQL 未连接或列表查询失败时,PoiTemplateStorage 自动使用 ColorVision.Local.db;与服务器库独立数据库基础契约
Engine 算法历史结果MySQL t_scgd_algorithm_result_master 与所属明细 DAO;ImgFile / ResultImagFile 是路径字段结果展示链路
Engine MQTT 消息记录MessagesListManager / MsgRecordDataBaseHelper,路径取 MsgRecordManagerConfig.SqliteDbPathMQTT 消息契约
Flow 运行与节点诊断旧节点写队列与 FlowExecutionJournal 共用 FlowNodeRecordConfig.SqliteDbPath,不是业务 MySQLFlow 运行诊断与中断恢复
Socket 收发记录SocketMessageManager.SqliteDbPath,与 Engine MQTT 消息库分开Socket 协议模块
Spectrum 测量结果Plugins/Spectrum/Data/ViewResultManager.cs 管理自身 SQLiteSpectrum
ARVR 项目结果Projects/ProjectARVRPro/ViewResultManager.cs 管理自身 SQLite 与历史结果模型ProjectARVRPro
原图、标注图、CSV/MES 等交付物所属设备、ImageEditor 或项目 exporter,不能从一条数据库记录推出文件完整性导入导出边界

这是已定位的主要责任,不是所有插件和客户包的完整存储清单。添加或修改数据路径时,检查该模块的实际配置和写入入口,不把相同类名 ViewResultManager 当成共享数据库。

路径与数据源发现 ​

软件设置的具体路径选择与文件名规则统一见配置路径契约,以实际 ConfigFilePath 为准,不能固定猜成仓库或可执行文件旁的 Config。设置 JSON 的路径与模块自己的 SQLite 路径不是同一契约,迁移配置文件不等于一起迁移数据库。

模块的当前默认 SQLite 位置如下,实际查询仍以当次配置或静态属性值为准:

模块默认路径,ApplicationData 指 Windows 当前用户的漫游应用数据目录
本地模板库(当前接入 POI)ApplicationData/ColorVision/Config/ColorVision.Local.db
Engine MQTT 消息ApplicationData/ColorVision/Config/MsgRecords.db
Flow 节点诊断ApplicationData/ColorVision/Config/FlowNodeRecords.db
Socket 消息ApplicationData/ColorVision/Config/SocketMessages.db
ARVR 结果ApplicationData/ColorVision/Config/ProjectARVRPro.db
Spectrum 结果ApplicationData/Spectromer/Config/Spectrum.db;Spectromer 是代码中的实际拼写

MQTT/Flow 的 SqliteDbPath 是 DirectoryPath 加固定文件名的只读属性;Socket、Spectrum、ARVR 的同名静态属性则可被替换。修改已初始化的对象路径还要核对其持有连接和初始化状态,不能当成在线切库协议。MySQL 则由 MySqlControl 使用当前 MySqlConfig 的服务器、端口和数据库名建立连接,不是本地 .db 文件。

通过所属业务页面和实际配置定位各数据库;连接、DAO 与旧插件兼容的边界见数据库基础契约。

查数据前的副作用边界 ​

查源码里的路径是只读动作,调用运行时单例不一定是:ConfigHandler 首次单例加载会初始化配置/Backup 目录,并在 IsAutoSave 开启时安排备份(空构造函数本身不执行这些动作);SocketMessageManager 会创建目录、建表及补充 schema;Spectrum/ARVR 的结果管理器初始化各自表结构;Flow 诊断初始化还会迁移 schema 并启动写线程。不要为了回答“数据库在哪”就调用这些初始化路径或启动整套应用。

同样,业务对象的内存集合、数据库行、图片文件和协议输出分别有自己的完成条件:

  • MessagesListManager.MsgRecordsClearCommand 与 SocketMessageManager.MessagesClearCommand 只清当前内存列表,不等于删除数据库记录。
  • Engine 主结果中的图片路径不包含原始像素;有主记录不证明图片仍存在,有预览图也不证明全部明细成功落库。
  • 配置备份只覆盖配置服务管理的设置;.cvflow、项目数据库、原图及项目报告各自核对。导出一种对象不构成全项目备份。
  • 日志、MQTT/Socket 消息和 Flow 诊断帮助定位执行阶段,不能单独替代业务结果查询或外部系统的最终回执。

最小核验顺序 ​

  1. 固定对象类型、版本、设备 Code / SN / 批次或主结果 ID,确定写入代码与读取代码是否指向同一库、同一路径。
  2. 在已有授权范围内只读检查来源、过滤条件及页码;不为排障触发采集、重载设备、创建数据库或重跑流程。
  3. 将证据拆开:写入返回与异常、重新查询的记录、实际文件及其可读取性、业务最终状态。需要导出时进入该对象的规范主题。
  4. 只有明确要求数据维护后才讨论备份、迁移和清理。使用模块已有的维护入口并核对它的停写、锁与恢复条件;“撤销界面编辑”或“重置数据库”都不是通用备份恢复策略。Socket/Flow 的压缩正文与旧 TEXT 迁移、强制备份入口和部分提交边界见 SQLite 存储与维护。

业务页面的通用查询窗口按实体构造条件并替换调用方结果集合;SQL 预览、会话保存和整表操作须分别核对,不能把“当前只显示这些行”当成删除范围。

另一个数据库维护窗口以 provider 组织表统计、按月清理、备份和迁移;统计不是删除预览,关闭不取消后台维护。MySQL 的结果表白名单、历史删除与整表截断、SQL 备份及部分失败边界见 MySQL 结果维护。

需要加载SQL备份、重置数据库或确认服务切库时,进入 MySQL恢复与资源保留:恢复失败可能发生在导入之后,资源迁移备份不包含历史结果,不能替代完整备份与验收。

跨 MySQL、SQLite、文件和外部协议的迁移、写入中断和恢复按各自阶段验收。

基于 MIT License 发布。