REVOXELSEG_DICOM/工程分析/需求分析-2026-05-20-02-55-11.md

需求分析：修复头部 STL 导出后仍呈散点

开始时间：2026-05-20-02-55-11

原始需求摘要

用户反馈在 ITK-SNAP 中打开导出的 head-ct-demo-segmentation-label.nii 后，“头部”类别仍呈散点形式；用户指出 STL 本体不是散点，头部 STL 在三维查看器中是完整实体表面，因此导出的分割影像也不应呈点云。

业务目标

• 分割影像导出必须基于真实 STL 网格生成实体 Label Map。
• 大面数构件（尤其 头部.stl、头颅.stl）不能因预览抽样导致闭合轮廓断裂。
• ITK-SNAP 中轴向、冠状、矢状视图应显示连续实体分割，而不是稀疏点云。

输入与输出

• 输入：
  • 默认项目 head-ct-demo。
  • DICOM 原始序列。
  • Head_CT_ReConstruct/头部.stl 等二进制 STL。
  • 当前模型位姿、构件显隐与导出范围。
• 输出：
  • 修复后的分割 NIfTI / NIfTI.GZ / 导出包。
  • 工程分析文档与经验记录。

影响范围

• 后端 WebSite/server.ts 中 STL 到 NIfTI Label Map 的生成逻辑。
• 导出接口：
  • /api/projects/:projectId/export-mask
  • /api/projects/:projectId/export-nifti
  • /api/projects/:projectId/export-bundle
• 前端下载入口原则上不需要改变，除非发现参数传递问题。

关键约束

• 保持 DICOM 维度、spacing、slice 数量与当前导出逻辑一致。
• 保持 labels JSON、位姿 JSON、压缩包结构兼容。
• 不将大型 DICOM/STL 数据或运行态导出文件纳入 Git 提交。
• 最终仍需重新部署并验证服务。

风险点

• 完整 STL 面数较大，不能把所有顶点长期存为大型 JS 数组造成内存膨胀。
• 需要避免继续复用预览抽样数据做医学导出。
• 若 STL 存在非闭合切口，仅靠扫描线偶奇填充可能仍出现孔洞，需要补充连通域填补。

默认假设

• 用户希望本次直接修复导出的 NIfTI 分割质量，而不是只解释原因。
• 头部散点的主要原因是后端导出使用了预览抽样网格，导致实体轮廓无法闭合。