2026-05-07-17-05-43 增加3D实体显示档位

工程分析/经验记录.md

@@ -613,3 +613,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 任何用于配准、视角稳定、旋转中心的几何参数都必须来自全量模型或稳定元数据，不能来自随性能档位变化的抽样数据；坐标系、状态文字和模型实际位姿应共用同一份 pose 状态。
+
+## 2026-05-07-17-05-43 模型显示实体档位
+
+A. 具体问题
+
+用户不再需要低质量 `预览` 档位，希望在 `模型显示` 中增加更接近 STL 实体面片的 `实体` 档位。
+
+B. 产生问题原因
+
+原有档位以性能抽样为主，最高 `超精细` 仍受后端 `72000` 三角面上限约束，且材质继续使用用户设置的半透明度，视觉上仍偏点状或半透明预览。
+
+C. 解决问题方案
+
+前端删除 `预览` 档位，新增 `实体` 档位并设置更高请求上限 `200000`；后端 STL preview clamp 同步提升到 `200000`；实体档位下将材质不透明度下限提高到 `0.94`，在保留构件颜色的同时增强实体感。
+
+D. 后续如何避免问题
+
+模型显示档位应明确区分“性能抽样”和“实体查看”；若新增高质量档位，需要同步检查前端请求 limit、后端 clamp、材质表现和浏览器性能边界。