# 需求分析 - 2026-05-04-05-56-34

## 原始需求摘要

用户要求严格使用代码编纂工作流，但本次需求分析、实现方案、测试方案、执行修改均不需要人工二次确认。当前需求包括：

1. DICOM 矢状面、冠状面需要根据切片间距、单张切片内像素间距进行真实物理比例计算，当前图像看起来过扁。
2. DICOM 影像增加详细信息查询按钮，提取 DICOM 基本信息，并列出像素间距、切片间距等必要的新信息。
3. 3D 模型去掉白色实体模式和自动旋转；实体化程度在“预览、标准、精细”基础上再增加一个更细致档位；默认正向摆放；重置位姿放到“整体位姿”标题右侧；支持在图中用鼠标/滚轮操作旋转、平移、缩放，并把操作变化映射回整体位姿控件。

## 业务目标

DICOM 多平面重建应尽量符合真实空间比例，辅助用户正确理解矢状面和冠状面的解剖形态；DICOM 信息查询应展示基础元数据和关键空间参数；3D 模型交互应贴近常见三维软件操作习惯，减少无用开关，增强手动操控。

## 输入与输出

- 输入：
  - `Head_CT_DICOM/` 中 DICOM 序列及其 DICOM tag。
  - `Head_CT_ReConstruct/` 中 STL 模型。
  - 用户鼠标拖拽、滚轮、位姿滑块操作。
- 输出：
  - 物理比例修正后的矢状面/冠状面预览。
  - DICOM 详细信息面板。
  - 调整后的 3D 实体化档位和手动位姿交互。

## 影响范围

- `WebSite/server.ts`
  - 解析 Pixel Spacing、Slice Thickness、Spacing Between Slices、Image Position Patient 等 DICOM 空间信息。
  - 多平面重建按物理比例重采样。
  - 新增 DICOM 信息 API。
- `WebSite/src/types.ts`
  - 补充 DICOM 预览空间信息和详情信息类型。
- `WebSite/src/lib/api.ts`
  - 增加 DICOM 详情接口。
- `WebSite/src/components/ProjectLibrary.tsx`
  - 增加 DICOM 信息按钮/弹窗。
  - 修改 3D 模型控件和鼠标交互。

## 风险点

- 当前 DICOM 解析器是轻量解析器，不覆盖所有 DICOM 传输语法；本次仍以现有数据集可解析为目标。
- 多平面物理重采样会改变返回图像尺寸，前端布局需要继续保持自适应。
- 高实体化档位会显著增加 STL 预览顶点数和浏览器渲染压力。
- 自研鼠标旋转/平移/滚轮缩放需要与位姿滑块状态双向同步，避免 UI 状态漂移。

## 待确认问题

用户已明确本次无需人工二次确认，按合理工程假设直接执行。