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

测试方案：导出 STL、保存分割结果与项目库复核

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

静态检查

• 运行 npm run lint，确认 TypeScript 类型检查通过。
• 运行 git diff --check，确认无空白错误。

结果：已通过。

构建检查

• 在 WebSite/ 执行 npm run build，确认生产构建通过。

结果：已通过。Vite 仍有单 bundle 超过 500 kB 的既有提示，不影响本次功能。

关键业务场景验证

• 调用 POST /api/projects/head-ct-demo/segmentation-results，确认返回项目包含保存记录。
• 调用 /api/projects/head-ct-demo/export-bundle?targets=stl，确认压缩包内包含原始 STL 文件。
• 调用 /api/projects/head-ct-demo/export-bundle?targets=segmentation,pose,stl，确认分割、位姿与 STL 可共包导出。
• 验证项目库 分割结果 右侧导出菜单参数与逆向工作区一致。

结果：已通过。

• 临时服务 127.0.0.1:4100 下保存接口返回 segmentationResults，并可看到默认 最佳位姿。
• targets=stl 返回 HTTP 200，压缩包约 116M，目录包含 9 个原始 STL：会厌、气管上段、气管狭窄段、气管下段、气管整体、声门、头部、头颅、肿瘤。
• targets=segmentation,pose,stl 返回 HTTP 200，约 121433464 bytes，用时约 7.58s，包内包含分割 NIfTI、labels JSON、pose JSON 和 STL 原始模型。

医学影像数据相关边界验证

• 分割导出仍保持 DICOM 同维度 NIfTI。
• 保存的分割结果导出时使用保存时位姿。
• visible/all 分割范围继续影响 Label Map 与 labels JSON。

结果：已覆盖导出包结构验证；分割 NIfTI 生成逻辑未改变，继续复用上一轮完整 STL 网格实体导出链路。

UI 验证

• 逆向工作区顶部出现 保存至项目库。
• 三栏布局中左侧融合视角变窄，中部工具栏和右侧映射视图变宽。
• 右侧图例只显示当前 slice 中有边或填充像素的构件；无构件时显示空状态。
• 项目库分割结果区域显示保存记录和导出入口。

文档验证

• Agent.md 存在。
• Agent.md 包含当前系统使用方式。
• 主要功能 说明在 500~1300 字范围内。

结果：已通过。Agent.md 总字数约 1105 字符，主要功能段落在 500~1300 字范围内。

部署验证

• 重新部署后验证：
  • http://127.0.0.1:4000/api/health
  • http://127.0.0.1:4000/
• 部署后验证导出包接口。

结果：已通过。

• tmux 会话 revoxelseg-dicom 已重启，服务输出 ReVoxelSeg DICOM server ready at http://0.0.0.0:4000/。
• /api/health 返回 {"ok":true,"service":"revoxelseg-dicom"}。
• 首页 HTTP 200。
• 部署后 targets=stl 导出返回 HTTP 200，约 121372189 bytes，压缩包内包含 9 个 STL 原始模型。

Git/Gitea 备份验证

• 提交信息包含 2026-05-20-03-19-25 和本次修改摘要。
• 推送到 Gitea 成功。

结果：本地 Git commit 已完成；Gitea 推送重试 2 次均失败，错误为 No route to host，说明当前环境到 192.168.31.5:5002 网络不可达。待网络恢复后执行 git push origin main 即可补推。

风险与回归关注点

• STL 原始模型打包体积较大，接口验证可先用 targets=stl 查看目录，不反复下载全量组合。
• 临时保存接口测试会修改 WebSite/data/state.json，该运行态文件不纳入提交。
• 旧的未暂存历史删除状态不应混入提交。