2026-05-20-03-19-25 完善分割结果保存与STL导出

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

@@ -0,0 +1,62 @@
+# 实现方案：导出与项目库分割结果闭环
+
+实现方案文档路径：`工程分析/实现方案-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` 重启服务并验证。