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

工程分析/需求分析-2026-05-07-17-05-43.md

@@ -0,0 +1,50 @@
+# 需求分析 - 2026-05-07-17-05-43
+
+## 原始需求摘要
+
+用户要求在 `项目库 - 3D 模型` 的 `模型显示` 中：
+
+1. 去掉 `预览` 档位。
+2. 增加 `实体` 档位。
+3. 本次需求分析、实现方案、测试方案、执行修改都不需要人工二次确认。
+
+## 业务目标
+
+- 让模型显示档位更符合当前用户对实体化浏览的期望。
+- 减少低质量 `预览` 档位对视觉判断的干扰。
+- 提供更接近 STL 实体面的模型显示效果。
+
+## 输入与输出
+
+输入：
+
+- 用户在 3D 模型页点击 `模型显示` 档位。
+
+输出：
+
+- 档位变为 `标准 / 精细 / 超精细 / 实体`。
+- `实体` 档位请求更高数量的 STL 三角面，并使用更接近实体的材质透明度。
+- 页面底部 `MODEL PATH` 状态显示当前档位为 `实体`。
+
+## 影响范围
+
+- `WebSite/src/components/ProjectLibrary.tsx`
+  - `SolidityLevel` 类型。
+  - `solidityOptions` 配置。
+  - STL 材质透明度逻辑。
+- `WebSite/server.ts`
+  - STL preview 的最大抽样上限。
+
+## 风险点
+
+- 实体档位会请求更多三角面，浏览器渲染压力更高。
+- 若所有 STL 全量三角面过大，接口响应和前端渲染可能变慢。
+- 半透明构件在实体档位可能仍呈现一定透视感，需要统一提升最低不透明度。
+
+## 待确认问题
+
+- 本次用户已明确免二次确认，直接执行。
+
+## 人工审核状态
+
+- 本次免二次确认。