# 实现方案-2026-05-20-21-25-19

## 实现方案文档路径

`工程分析/实现方案-2026-05-20-21-25-19.md`

## 修改目标

1. 优化项目库“逆向分割结果”中的三维融合视图默认/复位视角，使复位后呈现用户示意的正向融合观察效果。
2. 为 `VoxelizationMappingView` 增加项目库紧凑展示模式，去掉无意义标签，把窗宽按钮、复位按钮、视图标题、DICOM 切片位置和竖向导航重新布局。
3. 调整项目库结果区左右面板高度与底部对齐。
4. 为逆向工作区增加加载中页面，展示加载进度、加载速度和当前阶段，数据未就绪时不显示完整工作区。
5. 增加 DICOM 融合体与 STL 预览数据的内存缓存，减少跨模块返回后的重复加载。

## 涉及路径

- `WebSite/src/components/ReverseWorkspace.tsx`
- `WebSite/src/components/ProjectLibrary.tsx`
- `WebSite/src/index.css`
- `工程分析/经验记录.md`

## 技术路线

- 在 `ReverseWorkspace.tsx` 中增加模块级缓存 Map，用于缓存 DICOM fusion volume、STL preview、映射视图预览数据。
- 为 `FusionThreeView` 增加 `variant` 或复位视角参数，项目库复用同一组件但使用较适合结果复核的默认视角。
- 为 `VoxelizationMappingView` 增加 `variant="workspace" | "library"`，项目库模式采用黑色画布、精简标题和窄导航栏；工作区保持完整操作信息。
- 用加载指标组合逆向工作区所需数据状态，未完成时显示独立加载卡片。
- 调整项目库逆向结果布局为等高网格，并保证左右图容器底部一致。

## 执行步骤

1. 阅读现有 `ProjectLibrary.tsx`、`ReverseWorkspace.tsx` 的视图复用和数据加载逻辑。
2. 写入本次需求、实现、测试方案文档。
3. 修改融合视图与映射视图组件参数，补齐紧凑模式和复位视角。
4. 增加数据缓存与加载页，避免跨页面返回时重复拉取大数据。
5. 调整项目库结果区布局和控件位置。
6. 执行类型检查、构建、服务重启与健康检查。
7. 追加经验记录并提交推送到 Gitea。

## 兼容性与回滚方案

- 新增 UI 变体保持默认值为工作区模式，避免影响已有调用。
- 缓存仅保存在浏览器内存中，刷新页面会自然清空；若出现旧数据问题，可删除缓存分支回退为原请求逻辑。
- 如果紧凑模式影响项目库结果展示，可只回退 `variant="library"` 调用，不影响逆向工作区主流程。

## 预计文件变更

- 修改 `ReverseWorkspace.tsx`：组件参数、缓存、加载页、视图布局。
- 修改 `ProjectLibrary.tsx`：调用参数、布局对齐、控件位置。
- 视需要修改 `index.css`：竖向导航样式微调。
- 新增本次三份工程分析文档，并追加经验记录。

## 提交与部署策略

- 只暂存本次修改的源码和本次工程分析文档。
- commit message 使用 `2026-05-20-21-25-19 项目库结果视图与加载缓存优化`。
- 推送到 `http://192.168.31.5:5002/admin/REVOXELSEG_DICOM.git` 的 `main` 分支。
- 使用 `tmux` 会话 `revoxelseg-dicom` 重新部署并验证。