# 需求分析 - 2026-05-07-16-53-23

## 原始需求摘要

用户要求继续严格使用代码编纂工作流处理 3D 模型位姿问题，本次无需人工二次确认：

1. 单击旋转 X/Y/Z 效果正常，但旋转后切换 `模型显示` 的预览/标准/精细/超精细时，模型位置会明显偏移。
2. 使用鼠标拖拽旋转时，旋转中心感觉没有落在模型内部中心。
3. 将 `重置平移缩放位姿` 的字体颜色改为与 `重置旋转位姿` 一致。
4. 右下角坐标系需要随着旋转位姿变化而同步旋转。

## 业务目标

- 让 3D 模型在切换显示细节档位时保持当前视觉中心稳定，不出现跳走或离谱偏移。
- 让鼠标拖拽旋转围绕模型自身中心进行，而不是绕画布或偏移点旋转。
- 保持两个重置按钮视觉层级一致。
- 右下角坐标系成为真实的当前位姿方向参考。

## 输入与输出

输入：

- 用户在 `项目库 - 3D 模型` 中切换模型显示细节档位。
- 用户通过滑块、快捷按钮、鼠标拖拽调整旋转位姿。
- 用户点击重置按钮。

输出：

- 切换 `预览/标准/精细/超精细` 后模型仍围绕同一中心展示。
- 鼠标拖拽旋转时模型围绕内部几何中心旋转。
- `重置平移缩放位姿` 与 `重置旋转位姿` 文字颜色一致。
- 右下角 X/Y/Z 坐标系随 `rotateX/Y/Z` 变化同步旋转。

## 影响范围

- `WebSite/src/components/ProjectLibrary.tsx`
  - `NativeStlViewer` 中 Three.js 模型中心化、相机、渲染层级、重载逻辑。
  - 鼠标拖拽旋转的状态更新方式。
  - 右下角坐标系 overlay。
  - 整体位姿按钮样式。

## 风险点

- 若渲染容器重建时没有清理旧 DOM，可能出现 overlay 被清空或事件丢失。
- 若每个 STL 文件分别中心化，会破坏拼装关系；必须使用所有可见 STL 的整体包围盒中心。
- 若切换细节档位后继承了旧平移/缩放，但新模型 baseScale 不一致，视觉上仍可能变化，需要保持统一相机距离和 pivot 中心。
- HTML 坐标轴用 CSS 旋转只近似表达 3D 方位；更可靠方案是用 SVG 根据旋转矩阵投影三轴。

## 待确认问题

- 本次用户已明确“需求分析、实现方案、测试方案、执行修改都不用人工二次确认”，因此直接执行。

## 人工审核状态

- 本次免二次确认。