REVOXELSEG_DICOM/工程分析/需求分析-2026-05-24-10-45-43.md

需求分析-2026-05-24-10-45-43

开始时间

2026-05-24-10-45-43

原始需求摘要

用户要求修正逆向工作区和项目库中的分割显示、镜像翻转、导出结构、DICOM 预览交互和 DICOM 切片序号/滚动条样式问题，并同步修正 Docker部署/ 中相关内容。

业务目标

• 让二维分割映射中的所有构件尽量以填充实体呈现，避免只显示为线段连接的空心效果。
• 在模型位姿中增加沿 X/Y/Z 轴、以模型中心为基准的镜像翻转能力。
• 调整“构件分别导出”结果结构，方便后续统一处理各构件 NIfTI 文件。
• 项目库 DICOM 首页支持滚轮缩放、拖拽移动和位置重置。
• 修正项目库与工作区 DICOM 切片显示顺序和滑块样式，使切片编号符合用户观察习惯。
• 保证 Docker 部署说明和容器化运行包含本次能力。

输入与输出

• 输入：
  • 用户提供的 5 张截图与问题描述。
  • 当前 React/Express 一体工程源码。
  • 现有 Docker 部署目录。
• 输出：
  • 前端 DICOM/分割/位姿 UI 与交互修正。
  • 后端导出结构修正。
  • 类型、构建、部署验证结果。
  • 更新后的 Docker部署/ 说明或配置。
  • 本次工程分析文档、经验记录和 Git/Gitea 备份提交。

影响范围

• WebSite/src/components/ProjectLibrary.tsx
• WebSite/src/components/ReverseWorkspace.tsx
• WebSite/src/types.ts
• WebSite/server.ts
• Docker部署/
• 工程分析/

关键约束

• 不伪造真实医学级算法能力；如果显示填充来自二维映射渲染增强，应明确其与导出体素结果的关系。
• 镜像翻转必须纳入保存位姿、导出位姿和服务端导出计算链路，避免 UI 与导出不一致。
• DICOM/STL 空间基准不能因显示缩放或拖动而改变。
• 提交时避免混入运行态数据、医学数据和无关文件。

风险点

• 现有分割映射可能基于 STL 与 DICOM 切面交线或投影采样，空心线段与真实截面、视角或采样算法有关；直接填充需要避免把多个不连通区域错误合并。
• 镜像翻转会影响三维显示、二维映射、保存位姿和导出体素化坐标，需要统一变换模型。
• NIfTI 导出包结构改变可能影响已有用户脚本，需兼容命名清晰。
• 切片顺序修正需要兼顾 axial/sagittal/coronal 与已有 API sliceIndex 约定。

待确认问题或默认假设

• 默认假设：用户希望前端所有分割映射默认显示为填充实体，并且导出体素结果也应按填充体素生成，而不是仅导出轮廓线。
• 默认假设：“构建分别导出”指“构件分别导出”，目标是一个导出包内统一放置所有构件 NIfTI 文件，而不是为每个构件再套一个独立目录。
• 默认假设：切片编号应按用户看到的顺序显示，初始页显示最后一张即 300 / 300，滑块视觉采用截图 5 的暗色轨道和蓝色菱形滑块样式。