UC3DStudio 项目文件（.uc3dproj）

数据来源：《UC3DStudio 用户说明书》V1.38 §5.5「项目文件（.uc3dproj）」。

菜单入口

设备菜单 → 新建项目 / 保存项目 / 另存项目 / 加载项目 / 最近项目。

以单个 XML 文件保存 / 加载全部配置：

系统设置、传感器身份与相机参数
滤波链、补正补偿
ROI、全部检测项与输出配置
通讯配置

保存 / 另存

保存项目：有当前文件名时静默覆盖；另存项目强制另存为新文件。
软件启动时自动加载上次项目，可在「最近项目」中切换。

项目文件唯一化布局（2026-09-30 起）

projects/<项目名>.uc3dproj          ← 项目文件（全盘唯一一份，位于项目文件夹的上级目录）
projects/<项目名>/                  ← 项目文件夹：只承载归档数据，不含项目文件副本
├── DATA/OK、DATA/NG                ← 手动保存轮廓/点云 + 自动 OK/NG 轮廓
└── Result/                         ← 测量结果 CSV、趋势 CSV/PNG 等导出

加载旧版本保存的「文件在文件夹内」布局时，软件会自动迁移到新布局。

数据源模式（在线 / 离线，自动记录）

保存项目时按当前状态自动写入 <DataSource mode="online|offline">，无需手动选择。
加载离线项目（保存时为 PCD 回放态）时自动回到离线回放。

新建项目的行为

运行态配置全部复位为默认值（滤波 / 补正 / 测量 / 通讯 / ROI / 检测项；相机参数缓存清空、设备 ROI 写回全幅），硬件连接保持不断开。
清空中央视图：轮廓曲线、测量标注、分色叠加层、原图、趋势图 / 直方图统计与结果表全部回到「无数据」初始态（帧缓存一并丢弃）。
写入两条「记录」到新项目文件（注意是记录而非启用）：
1. 「打开 PCD 文件」的记录 —— 当前点云源路径；
2. 传感器管理槽位记录 —— 序列号 / 配置文件。
  下次打开该项目时「打开PCD文件」与「传感器管理」对话框会自动预填。但新项目的数据源模式恒为在线，要离线看旧点云需手动「打开PCD文件」。

关闭软件时的未保存提示

改动过会写入项目文件的内容后关闭软件，弹出提示：保存 / 另存为 / 不保存 / 取消。

选择	行为
保存	已有项目文件名时静默覆盖；尚未保存过则自动转为「另存为」
不保存	丢弃改动直接退出
取消	中止关闭，返回软件

会触发提示：ROI（新建 / 拖拽 / 旋转 / 编辑 / 删除 / 颜色 / 透明度）、检测项（新增 / 删除 / 参数确认 / 上下移 / 启停 / 加载配置）、滤波链、补正、系统设置。

⚠️ 不计入提示：传感器硬件参数（曝光 / 增益 / 激光模式 / 触发 / 分辨率 / 相机像素 ROI）与通讯面板配置不保存在项目文件中，修改它们不会弹窗。

远程切换

Modbus 命令码 5 / Raw SW:n 可在产线远程切换不同项目（项目注册表按保存顺序编号）。