2026-05-08-01-53-07 修正DICOM范围和切割Mask预览

工程分析/实现方案-2026-05-08-01-53-07.md

@@ -0,0 +1,85 @@
+# 实现方案 - 2026-05-08-01-53-07
+
+## 修改目标
+
+1. 固定融合视角的 DICOM 物理尺寸基准，使切片范围变化不改变模型原始位置。
+2. DICOM 切片范围默认显示到最高切片，并支持 `M-N` 双向范围选择。
+3. 优化逆向工作区布局，浏览器放大后可滚动访问 DICOM 切片范围。
+4. 项目库项目加载/导入后后台预加载 DICOM 与模型预览。
+5. 模型切分开启后，在 DICOM 切割帧上叠加 Mask 轮廓/填充，直观看到切割位置。
+
+## 涉及路径
+
+- `WebSite/src/components/ProjectLibrary.tsx`
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/server.ts`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+### 固定 DICOM 体基准
+
+- 后端 `dicom-fusion-volume` 的 `physicalSize.depth` 改为完整 DICOM 序列深度，而不是当前 `start/end` 范围深度。
+- 前端 FusionThreeView 使用完整物理尺寸计算 DICOM box 和模型缩放，范围变化只改变参与显示的帧，不改变空间基准。
+- 模型 pivot 保持 DICOM 中心，不根据切片范围重新定位。
+
+### 双向范围滑条
+
+- 恢复 `sliceStart` 与 `sliceEnd` 两个状态，但 UI 使用同一范围卡片表达。
+- 初始值设为 `sliceStart=maxSlice`、`sliceEnd=maxSlice`，即默认最高切片。
+- 请求接口前将 `min(sliceStart,sliceEnd)` 和 `max(sliceStart,sliceEnd)` 作为真实 `M-N`。
+- UI 显示 `M-N / total`，并提供两个滑条在同一区域控制左右端点。
+
+### 放大布局
+
+- 逆向工作区根容器允许纵向滚动。
+- 主三列区域保留内部滚动，左侧融合区域不因高度压缩导致 DICOM 范围卡片不可达。
+
+### 后台预加载
+
+- 项目库加载项目列表后，对默认/选中项目发起低成本预加载：
+  - DICOM 预览中间帧。
+  - 前几个 STL preview。
+  - 融合体最高切片。
+- 使用 `void` 异步调用，不阻塞 UI。
+
+### 切割 Mask 叠加
+
+- FusionThreeView 中当 `cutEnabled` 时，根据当前切割帧创建 DICOM texture overlay。
+- 在切割帧平面上叠加半透明橙色 Mask 区域和边界线，表示模型切割位置。
+- 该 Mask 是可视化辅助层，不改变模型、不写出 NIfTI。
+
+## 数据流或交互流程
+
+1. 进入逆向工作区读取项目，计算 `maxSlice=dicomCount-1`。
+2. 初始范围设为 `maxSlice-maxSlice`。
+3. 用户拖动双向范围控制，前端排序后请求 `dicom-fusion-volume?start=M&end=N`。
+4. 后端返回当前范围帧，但 physical depth 始终以完整 DICOM 序列计算。
+5. FusionThreeView 使用固定 DICOM box 渲染 DICOM 与模型，模型位姿不受范围变化影响。
+6. 启用模型切分后，在切割帧平面叠加 Mask 预览。
+
+## 兼容性与回滚方案
+
+- 对任意 DICOM 总数使用 `dicomCount` 和接口返回 `total`，不硬编码 300。
+- 若项目没有 DICOM 或 STL，预加载自动跳过。
+- 回滚本次 commit 可恢复旧的单端点切片范围与切割显示。
+
+## 预计文件变更
+
+- `server.ts`：修正融合体 physical depth 基准。
+- `ProjectLibrary.tsx`：新增项目后台预加载。
+- `ReverseWorkspace.tsx`：双向范围、布局滚动、固定模型空间、切割 Mask 叠加。
+
+## 人工审核状态
+
+用户已声明本次不需要二次人工确认，按默认执行确认规则直接执行。
+
+## 执行记录
+
+- 已将后端 `dicom-fusion-volume` 的 `physicalSize.depth` 改为完整 DICOM 序列深度，避免切片范围变化导致 DICOM 体和模型空间重新缩放。
+- 已将融合视图中每张 DICOM 帧的 Z 位置改为按真实 `volume.indices` 映射到完整 DICOM 深度，范围变化只增减显示帧，不重新铺满空间。
+- 已将逆向工作区 DICOM 切片范围改为双端点控制，支持 `M-N` 显示范围。
+- 已将默认切片范围初始化为最高切片 `maxSlice-maxSlice`，不硬编码 300。
+- 已让逆向工作区根容器支持纵向滚动，浏览器放大时仍可滚动访问 DICOM 切片范围。
+- 已在项目库中加入项目后台预加载：最高 DICOM 预览、最高融合体、前三个 STL 预览。
+- 已在模型切分开启时，在切割 DICOM 帧上叠加橙色 Mask 预览和边界标记，使用户能直接在 DICOM 上看到切割位置。