2026-05-24-20-06-08 修正可见构件映射错位

工程分析/需求分析-2026-05-24-20-06-08.md

@@ -0,0 +1,43 @@
+# 需求分析-2026-05-24-20-06-08
+
+## 开始时间
+
+2026-05-24-20-06-08
+
+## 原始需求摘要
+
+用户反馈在逆向工作区中，如果不点击 `liver_artery`，`liver_segment_S2`、`liver_segment_S3` 不显示；同时在 `liver_artery` 未显示时，`liver_segment_S2/S3` 的二维映射位置疑似偏移，原本约 70 多层可见的内容跑到 100 多层。
+
+## 业务目标
+
+- 构件显示隐藏应彼此独立，关闭 `liver_artery` 不应导致 `liver_segment_S2/S3` 消失。
+- 逆向分割映射视图中，每个构件应使用自己的 STL preview、颜色和 partId，不应因可见构件增减发生错位。
+- 切片层号和模型位姿不应因隐藏某个构件而漂移。
+
+## 输入与输出
+
+- 输入：用户在构件层级中切换 `liver_artery`、`liver_segment_S2`、`liver_segment_S3` 等眼睛状态，并浏览 DICOM 切片。
+- 输出：仅眼睛开启且当前切片有交集的构件显示；关闭任一构件只影响该构件，不改变其他构件的映射位置和切片覆盖范围。
+
+## 影响范围
+
+- `WebSite/src/components/ReverseWorkspace.tsx`：逆向工作区构件可见列表、STL preview 加载、overlay 统计和绘制。
+- `Docker部署/README.md`：同步说明可见构件映射独立性。
+- `工程分析/经验记录.md`：记录异步可见构件加载不能按数组索引错配的经验。
+
+## 关键约束
+
+- 不改变用户现有位姿数据、DICOM/STL 原始数据和导出文件结构。
+- 不回退“只加载当前可见构件”的性能优化。
+- 保证可见构件增减时 overlay 加载状态明确，且最终绘制只使用最新请求结果。
+
+## 风险点
+
+- 如果 preview 结果按数组顺序写回，某个构件隐藏后可能让后续构件拿到错误 STL 顶点，造成消失或位置漂移。
+- 如果异步请求返回顺序晚于最新可见状态，旧结果可能覆盖新 overlay。
+- 如果过滤逻辑把 partId、fileName 或 label 映射错位，Overlay 统计和导出语义会不一致。
+
+## 待确认问题或默认假设
+
+- 默认本次聚焦逆向工作区右侧“逆向分割映射视图”的显示和切片位置，不改变项目库导出范围逻辑。
+- 默认 `liver_segment_S2/S3` 的眼睛打开时，应与 `liver_artery` 是否打开无关。