2026-05-20-21-25-19 项目库结果视图与加载缓存优化

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

@@ -0,0 +1,58 @@
+# 实现方案-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` 重新部署并验证。

工程分析/测试方案-2026-05-20-21-25-19.md

@@ -0,0 +1,61 @@
+# 测试方案-2026-05-20-21-25-19
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-20-21-25-19.md`
+
+## 静态检查
+
+- 在 `WebSite/` 执行 `npm run lint`，确认 TypeScript 类型检查通过。
+
+## 构建检查
+
+- 在 `WebSite/` 执行 `npm run build`，确认 Vite 生产构建通过。
+
+## 关键业务场景验证
+
+- 项目库进入“逆向分割结果”，确认左右两张图底部对齐。
+- 点击项目库三维融合视角“位置重置”，确认出现“三维融合视角已复位”类反馈，视角呈现正向融合观察效果。
+- 项目库逆向分割映射视图不再显示“逆向分割映射视图”标题行，不再显示 `Base DICOM`、`Overlay Label Map` 标签。
+- 项目库映射视图同一行显示窗宽按钮和位置重置按钮。
+- 项目库映射视图黑色画布左上显示“逆向分割映射视图”，右下显示 DICOM 切片位置，右侧只保留竖向进度条。
+- 逆向工作区首次进入时，在数据加载完成前显示加载进度、速度和阶段；完成后进入完整工作区。
+- 从逆向工作区切到其他模块再返回，确认已加载数据复用缓存，减少重复加载等待。
+
+## 医学影像数据相关边界验证
+
+- DICOM 切片范围为 300 层时，右侧竖向进度条顶/底/当前值显示正确。
+- 切片切换后，DICOM 底图和 Overlay Label Map 仍同步更新。
+- 位置重置只改变浏览视口，不改变模型位姿与导出参数。
+
+## 部署验证
+
+- 使用 `tmux` 会话 `revoxelseg-dicom` 启动：
+  - `cd WebSite`
+  - `npm run serve -- --host 0.0.0.0 --port 4000`
+- 验证：
+  - `http://127.0.0.1:4000/api/health`
+  - `http://127.0.0.1:4000/`
+
+## Git/Gitea 备份验证
+
+- 检查 `git status --short`，确认只暂存本次相关文件。
+- commit message 包含 `2026-05-20-21-25-19` 与简要描述。
+- 推送到 Gitea 后确认远端更新成功。
+
+## 风险与回归关注点
+
+- 项目库紧凑变体不能影响逆向工作区完整编辑态。
+- 缓存不能导致项目切换后显示上一个项目的 DICOM/STL 数据。
+- 加载页不能在部分非关键数据失败时永久阻塞用户进入工作区。
+
+## 执行结果
+
+- `npm run lint`：通过。
+- `npm run build`：通过，仅保留 Vite 大 chunk 既有提示。
+- 重新部署：已重启 `tmux` 会话 `revoxelseg-dicom`，服务监听 `0.0.0.0:4000`。
+- `curl -fsS http://127.0.0.1:4000/api/health`：通过，返回 `ok: true`。
+- `curl -I -fsS http://127.0.0.1:4000/`：通过，返回 `HTTP/1.1 200 OK`。
+- DICOM/项目数据接口抽查：`/api/projects`、`/api/projects/head-ct-demo/dicom-fusion-volume`、`/api/projects/head-ct-demo/dicom-preview` 均有有效响应。
+- 页面级截图：使用系统 Chrome 生成 `/tmp/revoxelseg-home.png`，页面可渲染；因当前应用启动时会自动退出登录，未使用无交互截图验证登录后的三维画布。
+- 备注：尝试临时安装 `playwright-core` 做交互截图验证，但安装过程无输出且超时，已终止，未产生仓库文件变更。

工程分析/经验记录.md

@@ -1333,3 +1333,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 新增影像查看交互时必须先判断它属于“浏览视口”还是“结果位姿”。浏览视口状态默认不进入保存和导出；只有会改变模型与 DICOM 空间关系的参数才进入 `modelPose`、保存快照和导出数据。
+
+## 2026-05-20-21-25-19 结果复核视图与加载缓存要拆分展示形态
+
+A. 具体问题
+
+用户要求项目库“逆向分割结果”复用真实三维融合和二维映射效果，但项目库是复核场景，不需要工作区里的完整编辑控件；同时逆向工作区和项目库在跨模块返回时重复载入 DICOM/STL 预览，等待感明显。
+
+B. 产生问题原因
+
+此前 `FusionThreeView` 和 `VoxelizationMappingView` 虽然已复用到项目库，但组件只有一种工作区展示形态，项目库只能带着 Base/Overlay 标签、统计面板和较宽导航一起展示。DICOM 预览、DICOM fusion volume 和 STL preview 的缓存也在组件或页面局部，页面卸载后缓存随之丢失。
+
+C. 解决问题方案
+
+将只读预览数据缓存提升为模块级缓存函数，项目库、逆向工作区和 STL 查看器统一使用 `getCachedDicomPreview`、`getCachedDicomFusionVolume`、`getCachedModelPreview`。`FusionThreeView` 增加项目库复核视角预设，复位后呈现更正向的三维融合观察角度；`VoxelizationMappingView` 增加 `library` 紧凑变体，把窗宽、旋转和位置重置放在同一黑色工具行，画布内只保留视图名、DICOM 切片位置和窄竖向进度条。逆向工作区首次进入前增加加载页，显示进度、阶段和速度。
+
+D. 后续如何避免问题
+
+同一个医学视图组件被复用到“编辑工作区”和“项目库复核”时，应优先通过 `variant` 或视角预设区分展示密度，而不是复制第二套近似实现。大体积医学预览数据应使用按项目、切片、窗宽、文件和采样精度组成的缓存 key，避免跨项目串数据；加载页只阻塞首次必要数据，不把普通浏览视口变化误判为需要重新进入全屏加载。

工程分析/需求分析-2026-05-20-21-25-19.md

@@ -0,0 +1,50 @@
+# 需求分析-2026-05-20-21-25-19
+
+## 开始时间
+
+2026-05-20-21-25-19
+
+## 原始需求摘要
+
+用户要求继续优化项目库与逆向工作区的逆向分割结果查看体验：项目库的三维融合视角复位后应呈现指定观察角度；项目库右侧逆向分割映射视图需更紧凑，删除无意义标题行与 Base/Overlay 标签，将窗宽按钮和位置重置整合在同一行，黑色影像区左上显示视图名、右下显示 DICOM 切片位置，右侧仅保留一个进度条；项目库逆向分割结果左右图底部对齐；逆向工作区加载未完成前不显示半成品工作区，而显示进度、速度等加载反馈；从逆向工作区或项目库切换到其他模块再返回时，应减轻重复加载。
+
+## 业务目标
+
+- 让项目库中的逆向分割结果更接近保存结果复核视图，减少控件占用面积。
+- 让项目库左右两张结果图在视觉底线和布局高度上对齐，便于横向比较。
+- 避免用户在数据未加载完时看到半成品工作区，降低误解。
+- 对大体积 DICOM/STL 预览数据做页面级缓存，减少跨模块返回时的重复请求和等待。
+
+## 输入与输出
+
+- 输入：项目库最新逆向分割结果、DICOM 融合体数据、STL 预览数据、构件样式、切片位置和窗宽模式。
+- 输出：项目库紧凑版逆向分割结果视图、逆向工作区加载页、复用缓存后的三维融合视图和二维映射视图。
+
+## 影响范围
+
+- `WebSite/src/components/ProjectLibrary.tsx`
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/src/index.css`
+- `工程分析/经验记录.md`
+- 本次需求/实现/测试方案文档
+
+## 关键约束
+
+- 医学影像主画布不能被无意义标签遮挡。
+- 位置重置应只重置浏览视角，不修改模型位姿或导出结果。
+- 缓存只能缓存只读预览数据，不应缓存用户保存状态导致脏状态误判。
+- 项目库和逆向工作区复用同一真实视图组件时，必须允许项目库使用更紧凑的 UI 变体。
+- 提交时不能混入当前工作树已有的历史删除和软著资料。
+
+## 风险点
+
+- Three.js 组件缓存与 React 生命周期若处理不当，切换页面后可能出现旧场景未更新或重复加载。
+- 右侧竖向进度条如果在紧凑布局中宽度过大，会继续挤压 DICOM 画布。
+- 加载页若依赖过严，可能在部分 STL 失败时一直不进入工作区。
+- 项目库复用工作区组件时，需要避免把工作区专用操作暴露到项目库。
+
+## 默认假设
+
+- “减轻重复加载”优先通过浏览器内存级缓存完成，暂不引入 IndexedDB 或后端缓存。
+- 加载完成标准以 DICOM 融合体加载完成、STL 预览基础数据可用为主；个别 STL 预览失败时显示错误但不永久阻塞页面。
+- 项目库逆向分割映射视图可以使用紧凑变体，逆向工作区保留更完整的编辑态信息。