REVOXELSEG_DICOM/工程分析/需求分析-2026-05-08-01-19-42.md

需求分析 - 2026-05-08-01-19-42

原始需求摘要

本次需要继续完善模型库与逆向工作区的三维融合可视化能力：

1. 模型库界面放大后右侧构件层级内容被挤出或不可见，需要解决滚动与布局问题。
2. 左侧逆向工作区图标需要更换，避免与模型库图标重复。
3. 逆向工作区中 重置默认位姿 改为 重置旋转位姿、重置平移缩放位姿，旋转 X/Y/Z 增加 ±90° 快捷旋转。
4. 模型位姿中除默认位姿外，支持位姿改名。
5. 影像与模型融合视角增加缓存/预存能力，DICOM 切片范围可选择五个点位预存信息，加速可视化。
6. 融合视角同时显示 DICOM 体数据矩形边界和模型矩形边界。
7. 模型旋转中心改为患者 DICOM 影像中心，避免模型旋转后脱离 DICOM。
8. 可视化工具栏中旋转、平移缩放单击只移动最低刻度，长按才连续移动。
9. DICOM 三维影像透明度增加两档可选。
10. 增加模型切分功能：可沿一个 DICOM 帧切割模型，并显示切割面。

业务目标

• 提升大缩放或小视口下的模型库可用性。
• 让逆向工作区和模型库在导航语义上更清晰。
• 增强模型位姿操作的可控性、可保存性和可解释性。
• 加快融合视角切片范围变化时的数据加载速度。
• 增强 DICOM 与 STL 的空间对比能力，为后续配准和模型切分提供基础。

输入与输出

• 输入：
  • 用户在模型库查看构件层级。
  • 用户调整逆向工作区模型位姿、保存/重命名位姿、切片范围、DICOM 透明度、切割帧。
• 输出：
  • 模型库右侧构件层级在放大后仍可滚动查看。
  • 逆向工作区左侧图标与模型库不同。
  • 逆向工作区可进行更细粒度和长按连续的位姿调节。
  • 融合视角显示 DICOM 边界、模型边界、DICOM 透明度档位、预存点位、切割面。

影响范围

• WebSite/src/components/Sidebar.tsx
• WebSite/src/components/ProjectLibrary.tsx
• WebSite/src/components/ReverseWorkspace.tsx
• WebSite/src/lib/api.ts
• WebSite/src/types.ts
• WebSite/server.ts
• 工程分析/经验记录.md

风险点

• 三维融合视图已包含 DICOM 体数据、STL 模型和位姿控制，继续加入边界框、切割面和缓存后需要避免 Three.js 对象重复泄漏。
• DICOM 预存点位如果一次预取过多，可能增加服务端与浏览器内存压力。
• 旋转中心改为 DICOM 中心后，模型本身的居中逻辑要与 DICOM 坐标系保持一致，不能再次叠加偏移。
• 频繁保存位姿名称或构件样式时，需要保持前端状态和后端项目状态一致。

待确认问题

用户已明确本次需求分析、实现方案、测试方案、执行修改均不需要二次人工确认，因此按默认执行确认规则直接实施。