2026-05-04-04-58-36 优化DICOM缓存和三维融合预览

工程分析/经验记录.md

@@ -325,3 +325,75 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 列表页面应减少常驻表单噪声；破坏性操作必须二次确认；轻量编辑可采用失焦保存，但需要避免空名称提交。
+
+## 2026-05-04-04-58-36 项目列表按钮布局
+
+A. 具体问题
+
+项目列表标题旁的 `+` 创建按钮和侧栏收缩按钮靠得太近，视觉上发生重叠。
+
+B. 产生问题原因
+
+两个操作都放在项目列表标题区右侧，且侧栏宽度固定，未给低频收缩操作独立位置。
+
+C. 解决问题方案
+
+保留 `+` 在标题区，收缩按钮移动到项目列表侧栏中线外侧，并调整容器为 `overflow-visible`，避免按钮被卡片裁剪。
+
+D. 后续如何避免问题
+
+同一区域的高频操作和布局控制应分区放置；绝对定位按钮如果超出容器，要同步检查父容器裁剪策略。
+
+## 2026-05-04-04-58-36 DICOM 三方向缓存与显示模式
+
+A. 具体问题
+
+矢状面和冠状面切换后图像变化慢或不明显，且 DICOM 只能用单一窗宽窗位显示。
+
+B. 产生问题原因
+
+每次重建非横断面都要重新读取 DICOM 序列，前后端没有把显示模式作为预览参数，也没有复用已解析的体数据。
+
+C. 解决问题方案
+
+后端按显示模式缓存 DICOM 体数据和预览结果，API 增加 `mode=default|bone|soft|contrast`；前端切换方向时重置到对应方向中间层，并提供显示模式分段按钮。
+
+D. 后续如何避免问题
+
+DICOM 多平面重建应优先设计缓存键和窗宽窗位参数；后续接入真实医学影像库时继续保留 plane、slice、mode 的稳定 API 契约。
+
+## 2026-05-04-04-58-36 STL 大文件预览
+
+A. 具体问题
+
+3D 模型页容易空白，直接加载 9 个原始 STL 总量约 240MB，浏览器解析慢且缺少可靠进度反馈。
+
+B. 产生问题原因
+
+前端承担了原始 STL 解析和渲染的全部工作，大体积二进制模型会阻塞交互并放大 WebGL 环境差异。
+
+C. 解决问题方案
+
+后端新增 STL 二进制采样预览 API，只返回抽样三角面顶点；前端用原生 Three.js 按采样顶点生成 BufferGeometry，并显示加载进度。WebGL 不可用时改用二维 canvas 投影预览兜底。
+
+D. 后续如何避免问题
+
+大模型浏览应区分“预览网格”和“原始精度文件”；列表/项目库优先加载轻量预览，进入精修或导出阶段再读取完整 STL。
+
+## 2026-05-04-04-58-36 逆向工作区项目上下文与融合视图
+
+A. 具体问题
+
+逆向工作区没有明确显示当前项目，融合视图没有展示 DICOM 与 STL 归一化中心对齐的效果。
+
+B. 产生问题原因
+
+工作区初版更多是流程面板，缺少从项目库传入项目后继续呈现项目上下文和影像/模型叠加结果的状态。
+
+C. 解决问题方案
+
+工作区进入后读取当前项目详情，顶部显示项目名、DICOM 数量、STL 数量和路径；融合视图加载 DICOM 软组织窗切片，并叠加中心对齐的模型轮廓、十字参考线和切片滑块。
+
+D. 后续如何避免问题
+
+跨页面工作流必须在目标页面重新显示当前操作对象；医学影像配准类视图至少应具备影像层、模型层、对齐标识和当前切片控制。