2026-05-07-16-35-52 优化3D模型位姿控制

工程分析/需求分析-2026-05-07-16-35-52.md

@@ -0,0 +1,56 @@
+# 需求分析 - 2026-05-07-16-35-52
+
+## 原始需求摘要
+
+用户要求继续严格使用代码编纂工作流处理本次 3D 模型位姿交互优化：
+
+1. 将 `整体位姿` 旁边的 `重置位姿` 拆分/改为两个按钮：`重置旋转位姿`、`平移缩放位姿`。
+2. 给 `整体位姿` 中的旋转和平移控制新增左右 90 度或快捷调整按钮。
+3. 将模型旋转中心设定为模型正中间，避免当前旋转中心偏移导致的交互异常。
+4. 在模型右下方增加 X/Y/Z 三个轴的旋转坐标或方位提示，方便查看模型当前方位。
+
+## 业务目标
+
+- 让 3D 模型位姿调整更加符合医学三维模型浏览习惯。
+- 区分旋转重置和平移/缩放重置，避免用户只想恢复一个维度时丢失全部位姿设置。
+- 让模型围绕自身几何中心旋转，提升旋转、平移、缩放的可控性。
+- 增加可视化方向参考，帮助用户判断当前 3D 模型朝向。
+
+## 输入与输出
+
+输入：
+
+- 用户在 `项目库 - 3D 模型` 页面对整体位姿滑块、快捷按钮、鼠标拖拽、滚轮等交互。
+- 当前项目中的 STL 文件及后端返回的 STL preview 数据。
+
+输出：
+
+- UI 中出现 `重置旋转位姿` 和 `平移缩放位姿` 两类按钮。
+- 旋转项支持 ±90 度快捷调整；平移项支持正负方向快捷步进；缩放项支持快捷放大/缩小。
+- 3D 模型以整体几何中心为旋转中心。
+- 3D 预览右下角显示 X/Y/Z 方位坐标和当前旋转角度。
+
+## 影响范围
+
+- `WebSite/src/components/ProjectLibrary.tsx`
+  - `ModelPose` 状态更新逻辑。
+  - `NativeStlViewer` 中 Three.js group 层级、模型居中、旋转中心、位姿同步。
+  - `整体位姿` 控制区按钮和布局。
+  - 3D 画布右下角方位提示 overlay。
+
+## 风险点
+
+- 若旋转中心调整不当，可能导致 STL 构件之间相对位置被破坏。
+- 若快捷按钮步进与滑块范围不一致，可能出现 UI 数值越界。
+- 若右下角方位提示遮挡模型或底部状态栏，可能影响可视化体验。
+- 平移没有“90 度”的物理含义，需要以正负方向固定步进方式解释。
+
+## 待确认问题
+
+1. “平移新增左右 90 度调整按钮”在空间变换中没有直接物理含义，本方案拟解释为平移 X/Y/Z 的正负方向快捷步进按钮，旋转 X/Y/Z 使用 ±90 度按钮。
+2. `平移缩放位姿` 按钮文案是否需要完整写为 `重置平移缩放位姿`；实现方案中会优先使用完整文案，避免歧义。
+
+## 人工审核状态
+
+- 需求分析：用户已确认。
+- 确认信息：用户回复“都确认，后续直接搞”。