2026-05-20-22-07-46 导出命名与映射视图摘要优化

工程分析/经验记录.md

@@ -1351,3 +1351,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 同一个医学视图组件被复用到“编辑工作区”和“项目库复核”时，应优先通过 `variant` 或视角预设区分展示密度，而不是复制第二套近似实现。大体积医学预览数据应使用按项目、切片、窗宽、文件和采样精度组成的缓存 key，避免跨项目串数据；加载页只阻塞首次必要数据，不把普通浏览视口变化误判为需要重新进入全屏加载。
+
+## 2026-05-20-22-07-46 导出命名与 Overlay 摘要位置要兼顾浏览器和视图语义
+
+A. 具体问题
+
+用户要求“导出项目及结果”的文件名改为“项目名_时间”，同时项目库与逆向工作区的逆向分割映射视图要共享黑底调控语言，但 Overlay Label Map 在项目库放右侧下方、在工作区保留在下方。
+
+B. 产生问题原因
+
+导出接口原先使用项目 ID 生成 `head-ct-demo-nifti-export.tar.gz`，便于程序处理但不便于用户归档。映射视图此前只区分工作区和项目库两种整体 `variant`，没有进一步区分 Overlay 摘要在右侧还是底部，导致布局需求变化时容易复制组件或堆叠条件。
+
+C. 解决问题方案
+
+后端新增项目名清洗、Asia/Shanghai 时间戳和 RFC 5987 `filename*` 响应头，导出包命名为 `项目名_时间.tar.gz`。前端在 `VoxelizationMappingView` 中增加 `overlayPlacement`，项目库使用 `side` 将 Overlay 摘要放到右侧下方，逆向工作区使用同一黑底工具行但传入 `bottom`，使 Overlay 保持在影像下方。项目库结果摘要移除切片和类别范围，仅保留构件总数、最后保存时间和模型位姿。
+
+D. 后续如何避免问题
+
+涉及中文下载名时应同时设置 ASCII fallback 和 `filename*`，并用 `curl -D -` 抽查响应头。复用医学影像组件时，布局差异应继续沉到小粒度参数，例如 `overlayPlacement`、`viewPreset`，避免为了位置差异复制整套视图；同时确认 Overlay 摘要不遮挡 DICOM 主画布。