REVOXELSEG_DICOM/工程分析/需求分析-2026-05-24-17-29-17.md

需求分析-2026-05-24-17-29-17

开始时间

2026-05-24-17-29-17

原始需求摘要

用户反馈在逆向工作区调整“构件层级”时，可能出现构件显示异常或暂时不显示；如果处于加载中，应在界面显示加载进度条。同时浏览器控制台反复输出 Unable to preventDefault inside passive event listener invocation，需要排查并修正相关事件监听。

业务目标

• 提升构件层级可见性切换后的反馈，避免高精度 STL 预览加载期间被误判为显示故障。
• 修正滚轮或触摸事件中被动监听器内调用 preventDefault 的浏览器警告。
• 保持现有逆向分割映射视图、项目库 DICOM 操作和部署方式兼容。

输入与输出

• 输入：用户在构件层级中切换眼睛、透明度或可见构件后触发高精度模型预览重新加载；用户在 DICOM/映射画布上滚轮缩放或拖动。
• 输出：加载可见 STL 构件时显示进度条与数量；加载完成后恢复正常 overlay；控制台不再因被动事件监听器反复打印 preventDefault 警告。

影响范围

• WebSite/src/components/ReverseWorkspace.tsx：逆向分割映射视图、构件预览加载流程、滚轮缩放事件。
• WebSite/src/components/ProjectLibrary.tsx：项目库 DICOM 画布滚轮缩放与触摸重复按钮事件。
• Docker部署/README.md：同步记录本次前端交互与部署包能力变化。
• 工程分析/经验记录.md：沉淀本次事件监听和加载反馈经验。

关键约束

• 必须继续按当前 tmux 会话 revoxelseg-dicom 和 npm run serve -- --host 0.0.0.0 --port 4000 方式部署验证。
• 不改变 STL 到 Label Map 的体素化算法语义，仅改善加载反馈与事件监听方式。
• 不能提交运行态数据、导出包、医学原始数据或无关文件。

风险点

• 高精度可见构件加载可能较快或较慢，进度状态要处理竞态，避免旧加载结果覆盖新可见状态。
• 去除或迁移 preventDefault 时不能破坏滚轮缩放、拖拽平移、长按步进等既有交互。
• 进度条必须只在加载中展示，避免常驻遮挡医学影像区域。

待确认问题或默认假设

• 默认假设用户所说的“加载”主要指逆向分割映射视图为当前可见构件重新拉取 STL preview 的阶段。
• 默认假设控制台警告来自 React onWheel 或触摸事件中的 preventDefault，优先改为原生非被动 wheel 监听和移除不必要的 touch preventDefault。