REVOXELSEG_DICOM/工程分析/实现方案-2026-05-20-22-07-46.md

实现方案-2026-05-20-22-07-46

实现方案文档路径

工程分析/实现方案-2026-05-20-22-07-46.md

修改目标

1. 后端导出压缩包文件名改成 项目名_时间.tar.gz，兼容中文项目名。
2. VoxelizationMappingView 支持把 Overlay Label Map 摘要放到右侧下方或底部下方。
3. 项目库使用右侧 Overlay 摘要布局；逆向工作区使用项目库风格的黑底工具行和右侧切片导航，但 Overlay 仍在下方。
4. 项目库“逆向分割结果”摘要只显示构件总数、最后保存时间和模型位姿。

涉及路径

• WebSite/server.ts
• WebSite/src/components/ReverseWorkspace.tsx
• WebSite/src/components/ProjectLibrary.tsx
• WebSite/src/index.css
• 工程分析/经验记录.md

技术路线

• 在后端新增项目名/时间文件名格式化函数，并用于 bundle 下载响应头。
• 在 VoxelizationMappingView 中抽出 Overlay 摘要渲染片段，通过 variant 与布局参数区分项目库和逆向工作区。
• 逆向工作区把窗宽、旋转和位置重置按钮传入映射视图内部，外层只保留模块标题或直接交给组件渲染。
• 项目库结果摘要卡片移除切片和类别范围字段，增加位姿字段的紧凑网格。

执行步骤

1. 定位 server.ts 导出 bundle 的文件名生成逻辑。
2. 定位 ProjectLibrary.tsx 结果摘要和映射视图调用逻辑。
3. 调整 ReverseWorkspace.tsx 的映射视图 variant、工具栏和 Overlay 位置。
4. 更新样式文件中的暗色竖向滑块或新增必要类名。
5. 执行 npm run lint、npm run build。
6. 重启 tmux 服务并验证 /api/health 与页面响应。
7. 追加经验记录，提交并推送到 Gitea。

兼容性与回滚方案

• 导出文件名只改响应头，不改变压缩包内部结构，回滚时恢复旧 filename 即可。
• 视图布局通过组件参数控制，若项目库右侧摘要不合适，可回退为下方摘要或隐藏摘要。
• 逆向工作区仍使用同一 VoxelizationMappingView，回滚风险集中在一个组件。

预计文件变更

• 修改 server.ts 导出文件名。
• 修改 ReverseWorkspace.tsx 和 ProjectLibrary.tsx 视图布局与摘要字段。
• 视需要修改 index.css 滑块样式。
• 新增三份工程分析文档，追加 经验记录.md。

提交与部署策略

• 只暂存本次相关源码和本次工程分析文档。
• commit message 使用 2026-05-20-22-07-46 导出命名与映射视图摘要优化。
• 推送到 Gitea main 分支。
• 构建后重启 tmux 会话 revoxelseg-dicom。