Head_CT_Morph/工程分析/需求分析-2026-05-08-03-45-01.md

需求分析 - 2026-05-08-03-45-01

原始需求

用户要求：逆向工作区右侧“Mask 展示”应在点击“模型切分”后显示，内容是前后两张 DICOM 切分出的模型样子，且明确应为两张图片。

目标

• 模型切分未启用时，不展示 STL mask 双图结果。
• 模型切分启用且存在 STL 模型时，右侧展示起点帧、终点帧两张图片。
• 两张图片应来自当前 DICOM 平面、显示模式、切片范围端点和 STL 模型的真实切面 mask 结果。
• 保持普通 DICOM 阅览在未启用模型切分时可正常使用。

影响范围

• WebSite/src/App.tsx
  • DICOM 阅览弹窗右侧预览区域。
  • 模型切分状态、起点帧/终点帧 mask 预览显示。
• web_backend.py
  • 复核现有 /api/library/reformat-preview 是否已经支持 modelId 生成 STL mask 叠加图。

约束

• 严格使用本仓库代码编纂工作流。
• 本轮使用同一开始时间戳 2026-05-08-03-45-01。
• 本次按用户此前说明，需求分析、实现方案、测试方案和执行修改不再等待二次人工确认。
• 不得用象征性图形替代真实 STL/DICOM 切面关系。
• 不得提交 Gitea 密码、令牌或其他凭据。

风险点

• 若只改前端文案但仍展示单图或普通 DICOM 图，用户会误认为 mask 展示没有按切分结果变化。
• 若后端缓存文件名未区分模型、平面、窗宽窗位、切片索引，可能显示旧图。
• STL 与 DICOM 坐标系不一致时，mask 可能为空；前端需给出清晰状态。

待确认事项

• 无需等待二次确认；按用户此前授权直接执行。