# 需求分析

时间戳：2026-05-04-04-12-34

## 原始需求摘要

用户要求严格使用代码编纂工作流处理本次修改，并在开始时确认工作流整体流程；本次需求分析、实现方案、测试方案和执行修改均不需要人工二次确认。

具体需求：

1. 项目库中 `DICOM 影像`、`3D 模型` 视图右侧按钮应为“导入”，不是“导出”；`分割结果` 视图右侧不需要顶部导出按钮，因为下方已有下载按钮。
2. DICOM 影像右侧滚动条展示差，圆圈不在条上；切片进度不应显示为 `0~NAV`，应显示当前第几张/总张数；除横断面外，增加矢状面、冠状面选择。
3. 3D 模型右侧眼睛表示整体显示开关；不同 STL 前面应为 RGB 颜色框，可调整颜色与透明度，并在模型显示中生效；删除无意义状态点样式。
4. 项目列表中已有项目右侧除编辑外增加删除按钮，删除需要二次确认。
5. 创建项目交互改为点击 `+` 后弹窗创建，删除常驻的“新增项目名称”输入栏。
6. 项目名称编辑后不需要保存按钮，点击其他区域自动保存。

## 业务目标

- 优化项目库的资产管理交互，使导入、下载、创建、编辑、删除的语义明确。
- 改善 DICOM 浏览体验，支持横断面、矢状面、冠状面三方向预览。
- 改善 STL 多模型浏览体验，支持每个 STL 独立颜色和透明度，并提供整体显示开关。
- 降低项目列表的视觉噪声，创建项目采用弹窗，编辑项目采用自动保存。

## 输入与输出

输入：

- 用户在项目库中选择 DICOM 方向与切片。
- 用户调整 STL 模块颜色、透明度、可见性。
- 用户创建、编辑、删除项目。

输出：

- DICOM 预览支持 `axial`、`sagittal`、`coronal`。
- 右侧切片控制显示为 `第 n / 总数`。
- 3D 模型视图同时显示多个 STL，并应用颜色/透明度。
- 项目创建弹窗。
- 项目删除确认弹窗。
- 项目名编辑失焦自动保存。

## 影响范围

- `WebSite/server.ts`
- `WebSite/src/lib/api.ts`
- `WebSite/src/types.ts`
- `WebSite/src/components/ProjectLibrary.tsx`
- `工程分析/经验记录.md`

## 风险点

- 矢状面/冠状面预览需要从多个 DICOM 切片采样，性能比横断面低。本次以演示可用为主，后续可加入缓存或 Python 预处理。
- 同时加载 9 个 STL 可能增加浏览器渲染压力，需要保持透明度和可见性状态可控。
- 自动保存项目名需要避免空名称提交。
- 删除项目需要防止误删默认项目或至少提供明确二次确认。本次默认项目也允许删除前确认，但恢复出厂设置可恢复默认项目。

## 待确认问题

- 本次用户已明确无需二次确认，直接执行。