56 lines
2.5 KiB
Markdown
56 lines
2.5 KiB
Markdown
# 需求分析-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 主影像打开。
|