2026-05-20-02-55-11 修复头部STL实体导出

工程分析/经验记录.md

@@ -1117,3 +1117,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 任何分割影像导出都应同时考虑语义侧车文件，并保证侧车元数据与实际 mask 标签来自同一批样式和筛选条件。多文件导出优先做成一个后端归档包，避免浏览器多下载顺序、丢文件或元数据错配。
+
+## 2026-05-20-02-55-11 大面数 STL 导出不能复用预览抽样网格
+
+A. 具体问题
+
+用户在 ITK-SNAP 中查看导出的分割 NIfTI 时，`头部` 类别仍呈散点或点云状，而原始 `头部.stl` 是完整实体表面。
+
+B. 产生问题原因
+
+后端 NIfTI 分割生成复用了 `createStlPreview(file, 200000)` 的预览顶点数组。`头部.stl` 约有 257 万个三角面，但导出时最多只保留 20 万个抽样面；闭合轮廓被抽稀后，Mesh-Plane Intersection 生成的扫描线交点不连续，实体填充会退化成稀疏点/线。
+
+C. 解决问题方案
+
+保留预览抽样数据仅用于 bounds 和网页显示；NIfTI 导出路径改为逐三角读取完整二进制 STL buffer，对全部网格面执行位姿变换、平面求交和扫描线光栅化。同时后端每个构件、每个 slice 先写入临时二值 mask，再通过四边 flood fill 标记外部区域，将内部未连通孔洞补齐后写入最终 Label Map。
+
+D. 后续如何避免问题
+
+预览数据、抽样数据和医学导出数据必须明确分层。凡是 NIfTI、Mask、Label Map、体素化这类可用于医学工具复核的导出功能，都不得复用用于前端性能优化的抽样网格；验证时必须检查大面数构件的 label 体素数量、slice 覆盖范围和侧视/冠状重建是否连续。