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

实现方案：导出与项目库分割结果闭环

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

修改目标

补齐原始 STL 导出、分割结果保存到项目库、项目库复用导出包功能、工作区布局与右侧构件提示优化，并新增系统使用说明 Agent.md。

涉及路径

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

技术路线

1. 后端导出目标新增 stl，在 /export-bundle 中将 Head_CT_ReConstruct 下的原始 STL 文件写入同一个 tar.gz。
2. 项目状态新增 segmentationResults，保存当前分割结果的名称、时间、位姿、分割范围与构件样式快照。
3. 新增 POST /api/projects/:projectId/segmentation-results，供逆向工作区 保存至项目库 调用。
4. 项目库 分割结果 视图读取保存记录，并提供与逆向工作区一致的导出内容选择、分割范围选择和压缩包下载。
5. 将默认/推荐位姿加入前后端默认位姿列表，逆向工作区加载项目时优先选择 最佳位姿。
6. 工作区三栏布局从 6/3/3 调整为更偏向工具栏与映射视图的比例，压缩左侧融合视角。
7. OverlayStats 增加当前 slice 的构件明细，图例仅显示当前切片中实际有边或像素的构件，并用紧凑表格呈现。
8. 编写 Agent.md，包含系统使用方式和 500~1300 字主要功能说明。

执行步骤

1. 增加类型定义和后端状态归一化。
2. 扩展导出包生成逻辑与 API 参数解析。
3. 增加项目库保存接口与前端 API。
4. 修改逆向工作区按钮、布局、右侧图例。
5. 修改项目库分割结果区域和导出菜单。
6. 编写 Agent.md。
7. 运行 lint、build、接口导出验证、保存接口验证、部署验证。
8. 追加经验记录、提交、推送、重新部署。

兼容性与回滚方案

• 原有导出目标 dicom/segmentation/pose 保持兼容。
• stl 为新增可选目标，默认可不选以避免包过大。
• 旧项目没有 segmentationResults 时归一化为空数组。
• 回滚到上一提交会移除项目库保存结果和 STL 导出选项，但不影响原始医学数据。

预计文件变更

• 后端状态、导出和保存接口。
• 前端 API、类型、逆向工作区与项目库 UI。
• 新增 Agent.md。
• 工程分析与经验记录。

提交与部署策略

• 只暂存本次相关文件。
• commit message 包含 2026-05-20-03-19-25 和简要说明。
• 推送 Gitea 后使用 tmux 会话 revoxelseg-dicom 重启服务并验证。