2026-05-20-23-28-51 项目库映射交互与导入提示优化

工程分析/经验记录.md

@@ -1387,3 +1387,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 凡是新增医学影像或模型导入能力，都必须区分“默认演示资产”和“项目用户资产”。后端路径解析不能继续硬编码单一目录；导入后要清理前后端缓存并清空旧分割结果，避免新数据套用旧预览或旧位姿结果。
+
+## 2026-05-20-23-28-51 项目库结果操作要避免遮挡与误覆盖
+
+A. 具体问题
+
+用户指出位姿微调首次点击会带动可视化工具栏滚动条上跳，竖向 Slice Navigator 圆点没有稳定居中；项目库 Overlay Label Map 仍是黑色面板且位置不利于复核，“已保存”状态竖排；已有 DICOM/STL 再导入时缺少覆盖提醒，DICOM 详情也不应等点击后才解析。
+
+B. 产生问题原因
+
+位姿按钮在可滚动容器内按下时会触发浏览器默认焦点滚动，状态更新后滚动位置没有被恢复。项目库复用映射组件时仍使用组件内部深色 Overlay 摘要，导出入口放在下方导致菜单容易被页面边界裁切。DICOM 详情接口只做按需解析，导入流程没有缓存元数据，也没有在前端导入入口判断现有资产。
+
+C. 解决问题方案
+
+为位姿微调按钮增加 `preventDefault`，并在 `modelPose` 更新前后保持可视化工具栏 `scrollTop`。调整竖向 range input 的轨道和 thumb 偏移，使项目库与逆向工作区滑块居中。`VoxelizationMappingView` 增加 Overlay 统计回调和 `overlayPlacement="none"`，项目库外置浅色 Overlay 摘要；导出按钮移到顶部操作区，结果状态徽标增加不换行约束。项目导入前根据 DICOM/STL 现有数量弹覆盖确认；后端导入 DICOM 时生成 `.revoxelseg-dicom-info.json`，详情接口优先读取缓存。
+
+D. 后续如何避免问题
+
+可滚动面板内的长按按钮要优先处理焦点滚动和滚动位置恢复；医学视图内的统计面板若影响主画布或菜单可达性，应外置为复核信息块。任何覆盖式资产导入都要在前端显式确认，并在后端同步生成或清理与资产强绑定的缓存，防止新旧 DICOM/STL 信息串用。