2026-05-20-22-35-42 导入资产与分割导出优化

工程分析/实现方案-2026-05-20-22-35-42.md

@@ -0,0 +1,61 @@
+# 实现方案-2026-05-20-22-35-42
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-20-22-35-42.md`
+
+## 修改目标
+
+- 精简 Overlay Label Map 状态文案。
+- 导出项目及结果支持分割整体/分构件导出，并调整默认勾选与排序。
+- 为项目库 DICOM/STL 导入按钮接入真实上传流程，空项目展示导入提示。
+- 项目级上传资产独立存储，恢复演示环境仍使用默认数据。
+- 用户账号重名冲突给出可读反馈。
+- 逆向工作区无保存结果时初次加载默认执行 Z 轴等比例拉伸。
+
+## 涉及路径
+
+- `WebSite/server.ts`
+- `WebSite/src/lib/api.ts`
+- `WebSite/src/components/ProjectLibrary.tsx`
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/src/components/UserManagement.tsx`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+1. 后端新增项目上传资产目录 `WebSite/data/uploads/<projectId>/dicom|stl`，导入接口接收 base64 文件并写入项目专属目录。
+2. 后端统一项目 DICOM/STL 路径解析，预览、三维融合、模型文件、导出和分割生成均读取项目路径。
+3. 导出包接口增加 `segmentationExportMode=combined|separate` 参数；整体模式沿用现有 label map，分构件模式逐个构件生成独立 NII.GZ。
+4. 前端导出面板增加分割导出方式单选，调整默认选择和选项顺序。
+5. 项目库导入按钮使用隐藏文件输入，按当前视图选择 DICOM 或 STL 上传，并刷新项目状态。
+6. 用户管理编辑接口 409 时展示“账号已存在，请更换账号”等提示。
+7. 逆向工作区加载项目后，若没有保存结果，则在 fusion volume 和模型边界都就绪后触发一次 Z 拉伸。
+
+## 执行步骤
+
+1. 编写本次需求分析、实现方案、测试方案。
+2. 阅读并定位导出、导入、项目路径、用户管理和逆向工作区相关源码。
+3. 修改后端资产导入与导出逻辑。
+4. 修改前端项目库、逆向工作区和用户管理交互。
+5. 执行 `npm run lint` 与 `npm run build`。
+6. 使用 tmux 重启 `revoxelseg-dicom` 服务并验证 `/api/health` 与首页。
+7. 追加经验记录，提交并推送本次相关文件。
+
+## 兼容性与回滚方案
+
+- 未导入资产的默认项目继续读取 `Head_CT_DICOM/` 与 `Head_CT_ReConstruct/`。
+- 已保存的项目路径由状态文件保存，恢复演示环境可通过现有重置接口回到默认路径。
+- 若分构件导出失败，可回退为 `segmentationExportMode=combined` 的原有整体导出。
+
+## 预计文件变更
+
+- 前端：3 个组件与 API 封装。
+- 后端：1 个 Express 服务文件。
+- 工程文档：本次三件套与经验记录。
+
+## 提交与部署策略
+
+- 仅暂存本次修改的源码与工程分析文档。
+- commit message 包含 `2026-05-20-22-35-42` 与简要描述。
+- 提交后推送到既有 Gitea 远端，并重启 4000 端口服务。