REVOXELSEG_DICOM/工程分析/实现方案-2026-05-08-03-35-22.md

实现方案：右侧实体切面预览

时间戳：2026-05-08-03-35-22

修改目标

在 Mask 展示 区域新增真实 STL 切割实体预览组件，替代旧的二维示意 Mask，并删除底部导出进度栏。

涉及路径

• WebSite/src/components/ReverseWorkspace.tsx
• 工程分析/经验记录.md

技术路线

1. 新增 CutSectionPreview 组件。
2. 组件使用 Three.js 渲染 STL preview 顶点数据。
3. 使用 DICOM physicalSize.depth 和 total 将 displayStart/displayEnd 映射到 Z 方向两张 clipping plane。
4. 当“模型切分”启用时，对 STL 材质应用两张 clipping plane，保留中间实体区域；未启用时展示完整实体模型。
5. 复用构件颜色、显示隐藏、模型位姿和高质量实体请求上限。
6. 删除旧 mappings 假 Mask 形状、MaskMapping 类型引用、exportMessage 和底部导出进度栏。

数据流或交互流程

• DICOM 范围条更新 displayStart/displayEnd。
• FusionThreeView 和 CutSectionPreview 都接收相同范围。
• CutSectionPreview 请求 STL preview，居中、缩放并应用当前模型位姿。
• 启用模型切分后，右侧实体预览显示裁切后的 STL 中间段。

兼容性与回滚方案

• 若实体预览性能不满足要求，可降低 detailLimit 或回滚到旧 Mask 展示区域。
• 本次不改 API 和数据文件，回滚只涉及前端组件。

风险控制

• 使用 npm run lint 验证类型。
• 使用 npm run build 验证构建。
• 使用 rg 确认旧 导出进度、mappings、假 Mask 结构已移除。
• 重启服务并验证 4000 端口。

预计文件变更

• 修改 ReverseWorkspace.tsx。
• 新增本次需求、实现、测试文档。
• 追加经验记录。

人工审核状态

用户已在项目工作流历史中确认后续直接执行，本次不等待二次人工审核。