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

实现方案-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 重新部署并验证。