2026-05-20-01-38-33 完善NII导出与位姿持久化

工程分析/测试方案-2026-05-20-01-38-33.md

@@ -0,0 +1,59 @@
+# 测试方案-2026-05-20-01-38-33
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-20-01-38-33.md`
+
+## 静态检查
+
+- 在 `WebSite/` 下执行 `npm run lint`。
+
+## 构建检查
+
+- 在 `WebSite/` 下执行 `npm run build`。
+
+## 关键业务场景验证
+
+- 顶部不再显示“开始自动配准”。
+- 顶部显示“导出全部 NII.GZ”，并能展开 DICOM 原始影像、分割影像、位姿数据选项。
+- 三维融合视角右下角显示小型 XYZ 坐标轴。
+- 保存自定义位姿后重新进入项目，位姿仍存在。
+- 重命名自定义位姿后刷新项目，名称仍保留。
+
+## 导出验证
+
+- `curl` 验证 DICOM 原始影像导出接口返回 `.nii.gz`。
+- `curl` 验证分割影像导出接口返回 `.nii.gz`。
+- `curl` 验证位姿数据导出接口返回 JSON。
+- 使用 gzip 文件头或响应大小确认导出不是旧 `64x64x64` 演示 Mask。
+- 确认前端下载不再使用 `URL.createObjectURL(blob)`。
+
+## 部署验证
+
+- 重启 `tmux` 会话 `revoxelseg-dicom`。
+- 验证：
+  - `curl http://127.0.0.1:4000/api/health`
+  - `curl -I http://127.0.0.1:4000/`
+
+## Git/Gitea 备份验证
+
+- 显式暂存本次相关代码和文档。
+- 创建包含时间戳和描述的 commit。
+- 推送到 Gitea `origin/main`。
+
+## 实测结果
+
+- `npm run lint`：通过。
+- `npm run build`：通过；仅保留 Vite chunk size 提醒。
+- 临时服务 `127.0.0.1:4100` 导出 DICOM 原始影像：HTTP 200，`.nii.gz` 约 75.76 MB。
+- DICOM NIfTI 头验证：`512x512x300`，datatype `4`，bitpix `16`，vox_offset `352`。
+- 临时服务导出 STL 分割影像：HTTP 200，`.nii.gz` 约 146 KB。
+- STL 分割 NIfTI 头验证：`512x512x300`，datatype `2`，bitpix `8`，非零体素 `1131842`，最大标签 `9`。
+- 临时服务导出位姿数据：HTTP 200，JSON 内包含 `project=head-ct-demo`、当前 `activePose` 和 3 个默认/保存位姿。
+- 前端下载实现已确认不再使用 `URL.createObjectURL(blob)`，改为后端直链附件下载。
+
+## 回归关注点
+
+- 右侧分割 NII/NII.GZ 导出按钮仍可工作。
+- 项目库中的 Mask 下载入口仍可工作。
+- DICOM/STL 预览与三维融合视图不受导出改动影响。