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

工程分析/实现方案-2026-05-20-23-28-51.md

@@ -0,0 +1,58 @@
+# 实现方案-2026-05-20-23-28-51
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-20-23-28-51.md`
+
+## 修改目标
+
+- 修复位姿按钮首次点击导致中部可视化工具栏滚动上跳。
+- 统一项目库与逆向工作区竖向 Slice Navigator 滑块居中样式。
+- 将项目库 Overlay Label Map 摘要从映射视图右侧黑色面板改为导出按钮下方浅色信息格。
+- 调整逆向分割结果状态徽标与标题同行。
+- 导入已有 DICOM/STL 时增加覆盖确认。
+- DICOM 导入时生成并保存详细信息缓存，详情接口优先读取缓存。
+- 项目库逆向分割页导出按钮移到顶部操作区。
+
+## 涉及路径
+
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/src/components/ProjectLibrary.tsx`
+- `WebSite/src/index.css`
+- `WebSite/server.ts`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+1. `VoxelizationMappingView` 新增 Overlay 统计回调和 `overlayPlacement='none'`，项目库使用外置浅色 Overlay 面板。
+2. 在项目库 mask 视图顶部操作区渲染“导出项目及结果”按钮和下拉菜单，删除下方旧导出入口。
+3. 调整竖向 range input CSS，使可点击层覆盖轨道但 thumb 视觉中心与轨道中心对齐。
+4. 为位姿微调按钮增加 `onMouseDown preventDefault`，并在位姿更新时保持工具栏滚动位置。
+5. 导入入口根据项目现有数据量弹出覆盖确认，再唤起文件选择。
+6. 后端 DICOM 导入后调用现有 DICOM 信息解析逻辑，将结果写入上传目录缓存文件；`/dicom-info` 优先读取缓存。
+
+## 执行步骤
+
+1. 写入本次需求、实现、测试方案。
+2. 定位映射视图、项目库 mask 页、位姿控件、CSS range 样式和导入接口。
+3. 修改前端组件结构与样式。
+4. 修改后端 DICOM 信息缓存逻辑。
+5. 执行 `npm run lint`、`npm run build`。
+6. 重启 `revoxelseg-dicom` tmux 服务并验证 `/api/health` 与首页。
+7. 追加经验记录，提交并推送 Gitea。
+
+## 兼容性与回滚方案
+
+- 若外置 Overlay 面板出现异常，可将项目库 `overlayPlacement` 改回 `side`。
+- DICOM 信息缓存失败时不阻断默认详情接口解析，可回退到实时解析。
+- 导入覆盖确认只在前端增加，后端接口仍保持原有覆盖写入能力。
+
+## 预计文件变更
+
+- 前端组件 2 个，样式 1 个，后端 1 个，工程分析文档 4 个。
+
+## 提交与部署策略
+
+- 只暂存本次相关文件，忽略历史删除和软著未跟踪文件。
+- commit message 包含 `2026-05-20-23-28-51` 与简要描述。
+- 推送 Gitea 后重启 4000 服务。