实现方案 - 2026-05-08-03-57-51

方案路径

将右侧“Mask 展示”从 STL/3D 几何结果展示改为真实 DICOM Segmentation Mask 的二维实心切片展示。模型切分操作只决定需要展示的切分位置和上下端点；实际像素内容必须来自与当前 DICOM 数据配准的语义分割 mask 体数据。

web_backend.py
- 新增 segmentation mask 数据发现、读取、缓存和切片渲染逻辑。
- 新增或扩展 mask 预览接口，返回切分上侧/下侧两张二维实心 mask 图片。
- 保留 STL 切分用于确定范围或几何参考，但不再用 STL Cap 作为最终 mask 图像数据源。
WebSite/src/App.tsx
- 调整模型切分触发后的“Mask 展示”请求和渲染逻辑。
- 右侧面板固定展示两张二维实心 Segmentation Mask 图片。
- 对无 segmentation 数据、无交集、加载失败分别给出状态。
工程分析/经验记录.md
- 完成后追加本轮关键问题、原因、解决方案和后续避免方式。

数据源梳理：
- 检查 web_library/ 和现有接口中是否已有 DICOM SEG、RTSTRUCT、NIfTI、NRRD、PNG mask 序列或其他语义分割文件。
- 当前未发现现成 segmentation 数据源，因此新增“上传/关联 Segmentation Mask”的后端入口和前端入口，避免继续从 STL 伪造 mask。
后端 mask 体数据读取：
- 优先支持 DICOM SEG / DICOM label-map 文件。
- 将 mask 读取为与 CT 体数据对齐的三维 label map。
- 使用缓存避免每次切分重复读取整套 mask。
后端二维实心截面渲染：
- 根据当前模型切分范围计算上侧/下侧两张目标切片。
- 从 Segmentation Mask label map 中取对应切片。
- 生成二维实心 mask-only PNG，而不是 CT 叠加图、STL Cap 或点云投影。
- 多标签情况下保留标签差异，可按固定颜色表渲染。
前端“Mask 展示”调整：
- 点击“模型切分”后，右侧面板请求新的 segmentation mask 双图接口。
- 面板标题保持“Mask 展示”，内容为两张二维图片：上侧切面、下侧切面。
- 移除或隐藏任何 3D 外壳/点云/半透明模型展示路径。
错误与降级处理：
- 若没有绑定 segmentation mask 数据，提示需要上传或关联 DICOM Segmentation Mask。
- 若某一切面 mask 为空，显示“该切面无分割区域”，但不生成假 mask。
验证通过后更新经验记录、提交 Gitea，并重新部署。

若新接口或前端展示出现问题，可回滚 web_backend.py 中新增 segmentation mask 读取/渲染逻辑和 WebSite/src/App.tsx 中“Mask 展示”的请求渲染改动，恢复当前 STL mask-only 双图逻辑。