REVOXELSEG_DICOM/工程分析/需求分析-2026-05-20-01-38-33.md

需求分析-2026-05-20-01-38-33

开始时间

2026-05-20-01-38-33

原始需求摘要

用户提出五项修改：去掉“开始自动配准”；将上方导出改为“导出全部 NII.GZ”，并提供 DICOM 原始影像、分割影像、位姿数据选项，方便 ITK-SNAP 打开检查；在三维融合视角右下角增加小型 XYZ 坐标轴；解决重新进入项目后可视化工具栏保存位姿丢失；处理浏览器对 blob:http 下载的 insecure connection 报错。

业务目标

• 顶部操作区更聚焦导出，不再展示自动配准演示按钮。
• 导出的医学影像文件与 DICOM 原始序列维度、spacing 对齐，能被 ITK-SNAP 作为主影像/分割影像加载。
• 位姿数据能随项目保存，并能作为导出侧车 JSON 下载。
• 三维融合视角提供固定的 XYZ 空间方向提示。
• 前端下载避免 URL.createObjectURL(blob)，减少 blob:http insecure connection 警告。

输入与输出

• 输入：
  • 当前项目 DICOM 序列、模块样式、已保存位姿。
  • 用户在导出选项中勾选的 DICOM 原始影像、分割影像、位姿数据。
• 输出：
  • DICOM 原始影像 .nii.gz。
  • 与原始影像同维度/spacing 的分割影像 .nii.gz。
  • 项目位姿与构件样式 JSON。
  • 重新进入项目仍可读取的已保存位姿。

影响范围

• WebSite/server.ts
• WebSite/src/lib/api.ts
• WebSite/src/types.ts
• WebSite/src/components/ReverseWorkspace.tsx
• 本次工程分析文档与 工程分析/经验记录.md

关键约束

• 不引入新依赖。
• 旧的分割导出入口仍需兼容。
• NIfTI 文件需要保持标准 NIfTI-1 单文件布局，设置正确 dim、datatype、pixdim、vox_offset、magic。
• 位姿保存不能只停留在 React 组件内存中，需要写入项目状态文件。
• 本次提交不能混入历史 工程分析 文档删除状态。

风险点

• 导出完整 512x512x300 体数据会比旧 64x64x64 演示 Mask 大很多，生成和下载耗时增加。
• 当前分割影像仍是后端基于 DICOM 像素阈值生成的同维度标签图，不等同于完整 STL 体素化算法。
• HTTP 访问环境下浏览器仍可能对非 HTTPS 下载有提示，但去掉 blob URL 可消除当前报错指向的 blob:http 链路。

默认假设

• “DICOM 原始影像”导出优先保证 ITK-SNAP 可打开与空间尺寸匹配，使用当前解析到的 CT HU int16 数据写入 NIfTI。
• “位姿数据”作为 JSON 侧车文件导出，供复现实验参数使用，不作为 ITK-SNAP 主影像打开。