REVOXELSEG_DICOM/工程分析/测试方案-2026-05-20-02-55-11.md

测试方案：头部 STL 实体导出验证

测试方案文档路径：工程分析/测试方案-2026-05-20-02-55-11.md

静态检查

• 运行 npm run lint，确认 TypeScript 类型检查通过。
• 运行 git diff --check，确认无空白错误。

结果：已通过。

构建检查

• 在 WebSite/ 执行 npm run build，确认生产构建通过。

结果：已通过。Vite 仍提示单个 bundle 超过 500 kB，此为既有体积提示，不影响本次导出修复。

关键业务场景验证

• 启动临时服务或复用部署服务。
• 请求分割导出包：
  • targets=segmentation,pose
  • format=nii.gz
  • segmentationScope=visible
• 解包并检查包含：
  • *-segmentation-label.nii.gz
  • *-segmentation-labels.json
  • *-pose-data.json

结果：已通过。临时服务 127.0.0.1:4100 下：

• segmentationScope=visible：HTTP 200，约 431802 bytes，用时约 6.56 s。
• segmentationScope=all：HTTP 200，约 667690 bytes，用时约 8.51 s。
• 压缩包内包含分割 NIfTI、labels JSON 与 pose JSON。

医学影像数据相关边界验证

• 读取导出的 NIfTI header，确认维度仍为 DICOM 同维度。
• 统计 label 体素分布，重点检查 头部 对应 label 的体素数量和 slice 分布不再表现为极少量散点。
• 检查导出包内 labels JSON 中 头部.stl 的 label 对应关系。

结果：已通过。

• NIfTI 维度：512 x 512 x 300，vox_offset=352。
• visible 范围下 头部.stl 对应 label 7，体素数 11742597，覆盖 slice 13-287，共 275 层，最大单层 83903 体素。
• all 范围下 label 7 体素数 9845171，label 8 头颅.stl 体素数 1930290，二者均覆盖 275 层。
• labels JSON 中 头部.stl 的 label/partId 为 7。

部署验证

• 重新部署后验证：
  • http://127.0.0.1:4000/api/health
  • http://127.0.0.1:4000/
• 对部署后的导出包端点再做一次小样本验证。

Git/Gitea 备份验证

• 提交信息包含 2026-05-20-02-55-11 和本次修复摘要。
• 推送到 Gitea 成功。

风险与回归关注点

• 完整 STL 导出比预览抽样更耗时，需要观察请求耗时。
• 多构件重叠时仍按现有顺序写入 label，后写构件会覆盖先写构件。
• 旧的未暂存历史删除状态不应混入提交。