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

时间戳：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`。
- 新增本次需求、实现、测试文档。
- 追加经验记录。

## 人工审核状态

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