REVOXELSEG_DICOM/工程分析/需求分析-2026-05-20-03-19-25.md

需求分析：导出 STL、保存分割结果与工作区布局优化

开始时间：2026-05-20-03-19-25

原始需求摘要

用户提出以下修改：

1. 导出全部 NII.GZ 增加 导出 STL 原始模型 选项。
2. 逆向工作区 逆向分割映射视图 上方增加 保存至项目库 按钮，将当前分割结果推送到项目库的 分割结果 区域；项目库分割结果右侧需要具备与 导出全部 NII.GZ 一致的导出功能。
3. 影像与模型融合视角 仍占地过大，需要让 可视化工具栏 与 逆向分割映射视图 更宽。
4. 逆向分割映射视图 下方仅显示当前切片中实际出现的构件，并改为更紧密的表格形式，一行可以显示多个构件提示。
5. head-ct-demo-pose-data.json 是最合适的位姿，需要作为当前系统推荐/默认位姿使用。
6. 使用 Agent.md 撰写当前系统使用方式，并输出 500~1300 字的主要功能说明。

业务目标

• 让导出包成为 DICOM、分割、位姿、原始 STL 的统一归档入口。
• 将逆向工作区中的分割结果沉淀到项目库，便于后续复核和导出。
• 提高三栏工作区中操作区和二维校验区的可用宽度。
• 右侧切片图例只表达当前 slice 实际存在的 Overlay 构件，减少无关干扰。
• 默认加载最优位姿，降低用户每次进入项目后的手动调整成本。
• 提供清晰的系统使用说明文档。

输入与输出

• 输入：
  • 当前项目 head-ct-demo。
  • 当前模型位姿、构件样式、分割导出范围。
  • head-ct-demo-pose-data.json 中的最佳位姿。
• 输出：
  • 新增 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
• 工程分析文档与经验记录。

关键约束

• 保存至项目库必须写入后端项目状态，不能只存在组件内存。
• 导出 STL 原始模型不能把大型 STL 文件提交到 Git，只在运行时打包下载。
• 继续避免浏览器 blob 下载路径，保持后端附件直链。
• 文档备份提交只包含本次相关代码和文档，不纳入旧的未确认删除。

风险点

• 原始 STL 总体积较大，选择导出 STL 会明显增加压缩包体积和下载耗时。
• 保存分割结果若不携带位姿，会导致项目库导出的分割与保存时不一致。
• 图例改为当前 slice 构件后，需要依赖 Overlay 计算结果，不能只看全局显隐状态。

默认假设

• 保存至项目库 保存当前位姿、导出范围和当前构件样式快照。
• 项目库分割结果导出默认使用最新保存结果的位姿与范围。
• Agent.md 放在项目根目录，作为系统使用说明文档。