2026-05-07-18-11-12 增加模型库和可视化工具栏

工程分析/需求分析-2026-05-07-18-11-12.md

@@ -0,0 +1,56 @@
+# 需求分析 - 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，可能和 `项目库` 行为混淆。
+- 逆向工作区可视化工具栏内容较多，需要避免布局过挤。
+
+## 待确认问题
+
+- 本次用户已明确免二次确认，直接执行。
+
+## 人工审核状态
+
+- 本次免二次确认。