2026-05-20-21-25-19 项目库结果视图与加载缓存优化

工程分析/经验记录.md

@@ -1333,3 +1333,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 新增影像查看交互时必须先判断它属于“浏览视口”还是“结果位姿”。浏览视口状态默认不进入保存和导出；只有会改变模型与 DICOM 空间关系的参数才进入 `modelPose`、保存快照和导出数据。
+
+## 2026-05-20-21-25-19 结果复核视图与加载缓存要拆分展示形态
+
+A. 具体问题
+
+用户要求项目库“逆向分割结果”复用真实三维融合和二维映射效果，但项目库是复核场景，不需要工作区里的完整编辑控件；同时逆向工作区和项目库在跨模块返回时重复载入 DICOM/STL 预览，等待感明显。
+
+B. 产生问题原因
+
+此前 `FusionThreeView` 和 `VoxelizationMappingView` 虽然已复用到项目库，但组件只有一种工作区展示形态，项目库只能带着 Base/Overlay 标签、统计面板和较宽导航一起展示。DICOM 预览、DICOM fusion volume 和 STL preview 的缓存也在组件或页面局部，页面卸载后缓存随之丢失。
+
+C. 解决问题方案
+
+将只读预览数据缓存提升为模块级缓存函数，项目库、逆向工作区和 STL 查看器统一使用 `getCachedDicomPreview`、`getCachedDicomFusionVolume`、`getCachedModelPreview`。`FusionThreeView` 增加项目库复核视角预设，复位后呈现更正向的三维融合观察角度；`VoxelizationMappingView` 增加 `library` 紧凑变体，把窗宽、旋转和位置重置放在同一黑色工具行，画布内只保留视图名、DICOM 切片位置和窄竖向进度条。逆向工作区首次进入前增加加载页，显示进度、阶段和速度。
+
+D. 后续如何避免问题
+
+同一个医学视图组件被复用到“编辑工作区”和“项目库复核”时，应优先通过 `variant` 或视角预设区分展示密度，而不是复制第二套近似实现。大体积医学预览数据应使用按项目、切片、窗宽、文件和采样精度组成的缓存 key，避免跨项目串数据；加载页只阻塞首次必要数据，不把普通浏览视口变化误判为需要重新进入全屏加载。