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

需求分析

时间戳：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 可能增加浏览器渲染压力，需要保持透明度和可见性状态可控。
• 自动保存项目名需要避免空名称提交。
• 删除项目需要防止误删默认项目或至少提供明确二次确认。本次默认项目也允许删除前确认，但恢复出厂设置可恢复默认项目。

待确认问题

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