REVOXELSEG_DICOM/工程分析/实现方案-2026-05-20-14-19-23.md

实现方案：逆向分割结果单结果化与入口统一

实现方案文档路径：工程分析/实现方案-2026-05-20-14-19-23.md

修改目标

调整项目库与逆向工作区的逆向分割结果保存、展示、读取和导出交互，使结果只保留一个、命名统一、入口集中、退出有保存提醒。

涉及路径

• WebSite/src/App.tsx
• WebSite/src/components/ProjectLibrary.tsx
• WebSite/src/components/ReverseWorkspace.tsx
• WebSite/src/types.ts
• WebSite/src/lib/api.ts
• WebSite/server.ts
• 工程分析/需求分析-2026-05-20-14-19-23.md
• 工程分析/实现方案-2026-05-20-14-19-23.md
• 工程分析/测试方案-2026-05-20-14-19-23.md
• 工程分析/经验记录.md

技术路线

1. 后端保存分割结果接口改为覆盖保存，只保留最新一条记录。
2. 项目归一化时保留最新一条 segmentationResults，兼容旧状态中已有多条记录。
3. 扩展 SegmentationResult 存储必要的切片范围、当前映射切片、显示/融合配置等上下文，用于重新进入工作区恢复。
4. 逆向工作区加载项目时读取最新保存结果，恢复位姿、构件样式、分割范围和映射切片。
5. App.tsx 接入工作区离开保护：离开逆向工作区时调用工作区注册的保存确认逻辑。
6. 项目库页签改名为“逆向分割结果”，内容改为两张视图预览卡片和右侧导出面板。
7. 顶部导出文案统一改为“导出项目及结果”，并将保存按钮移动到旁边。
8. 删除映射视图标题旁边的 NII、NII.GZ 小下载按钮。
9. 保存成功后显示顶部悬浮提示并渐隐消失。

执行步骤

• 阅读现有类型、API、后端保存接口、项目库和逆向工作区组件结构。
• 更新类型定义与后端归一化/保存逻辑。
• 更新 API payload 和前端保存调用。
• 更新项目库 UI 与导出按钮文案。
• 更新逆向工作区顶部操作区和映射视图标题区。
• 接入退出保存确认和进入工作区结果恢复。
• 运行类型/构建检查、服务部署验证。

兼容性与回滚方案

• 后端归一化兼容旧的多条 segmentationResults，只取最后一条作为当前结果。
• 若保存上下文字段缺失，前端继续使用默认位姿、默认切片范围和默认显示配置。
• 若导出按钮菜单异常，可继续调用现有 /api/projects/:projectId/export-bundle 后端接口。

预计文件变更

程序文件：

• WebSite/src/App.tsx
• WebSite/src/components/ProjectLibrary.tsx
• WebSite/src/components/ReverseWorkspace.tsx
• WebSite/src/types.ts
• WebSite/src/lib/api.ts
• WebSite/server.ts

工程分析：

• 本轮三份分析文档。
• 工程分析/经验记录.md。

提交与部署策略

• 暂存本轮程序改动与工程分析文档。
• 避免提交软著材料、运行态导出文件、旧历史文档删除状态。
• commit message 包含 2026-05-20-14-19-23。
• 构建通过后重启 tmux 会话 revoxelseg-dicom 并验证服务。

实际实现记录

• 后端 segmentationResults 归一化改为只保留最新一条，并扩展保存切片、显示、边界与切割状态字段。
• 导出接口默认使用最新保存结果的位姿、构件样式和类别范围。
• 逆向工作区进入时恢复最新保存结果，退出时注册保存确认守卫。
• 项目库“逆向分割结果”改为两张预览图加右侧统一导出面板。
• 顶部保存按钮迁移到导出按钮旁，并加入保存成功悬浮渐隐提示。