2026-05-04-04-12-34 优化项目库导入和三维交互

工程分析/需求分析-2026-05-04-04-12-34.md

@@ -0,0 +1,59 @@
+# 需求分析
+
+时间戳：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 可能增加浏览器渲染压力，需要保持透明度和可见性状态可控。
+- 自动保存项目名需要避免空名称提交。
+- 删除项目需要防止误删默认项目或至少提供明确二次确认。本次默认项目也允许删除前确认，但恢复出厂设置可恢复默认项目。
+
+## 待确认问题
+
+- 本次用户已明确无需二次确认，直接执行。