# 需求分析 - 2026-05-07-18-11-12

## 原始需求摘要

用户要求：

1. 修复 `项目库 - 3D模型 - 构件层级` 右侧眼睛按钮不好使的问题。
2. 左侧导航增加一个功能：`模型库`。
3. `项目库 - 3D模型 - 构件层级` 中每个层级显示 `ID: XX`，默认从 1 到 N；ID 可修改为 1 到 255 的整数，不能改成 0。
4. 逆向工作区中 `分割 Mask` 文案改为 `可视化工具栏`。
5. 在 `可视化工具栏` 中加入模型显示、整体位姿保存和选择、构件层级功能。
6. 本次需求分析、实现方案、测试方案、执行修改都不需要人工二次确认。

## 业务目标

- 让模型构件显示/隐藏、颜色、透明度和 ID 管理成为稳定可用的可视化控制基础。
- 将模型相关控制从项目库扩展到逆向工作区，使三维融合视角具备更完整的模型可视化工具栏。
- 让用户可以保存常用整体位姿并快速切换，降低重复调整成本。

## 输入与输出

输入：

- 用户点击构件层级眼睛按钮。
- 用户修改构件 ID。
- 用户在逆向工作区调整模型显示、模型位姿、保存/选择位姿。

输出：

- 构件眼睛按钮能正确隐藏/显示对应 STL。
- 构件层级显示并可编辑 1 到 255 的 ID。
- 左侧导航出现 `模型库`，点击后进入项目库的模型页。
- 逆向工作区中出现 `可视化工具栏`，包含模型显示、整体位姿保存/选择、构件层级。

## 影响范围

- `WebSite/src/types.ts`
- `WebSite/src/App.tsx`
- `WebSite/src/components/Sidebar.tsx`
- `WebSite/src/components/ProjectLibrary.tsx`
- `WebSite/src/components/ReverseWorkspace.tsx`

## 风险点

- 项目库和逆向工作区各自维护构件状态，若状态结构不一致会导致行为差异。
- 构件 ID 是前端可视化 ID，不应被误认为已写入 mask 标签或后端分割 ID。
- 新增 `模型库` 导航若没有正确带入初始 tab，可能和 `项目库` 行为混淆。
- 逆向工作区可视化工具栏内容较多，需要避免布局过挤。

## 待确认问题

- 本次用户已明确免二次确认，直接执行。

## 人工审核状态

- 本次免二次确认。