REVOXELSEG_DICOM/工程分析/实现方案-2026-05-20-02-15-10.md

实现方案-2026-05-20-02-15-10

实现方案文档路径

工程分析/实现方案-2026-05-20-02-15-10.md

修改目标

缩小“影像与模型融合视角”右下角 XYZ 标识，并将其从静态 SVG 改为随模型位姿和三维场景旋转联动的方向指示器。

涉及路径

• WebSite/src/components/ReverseWorkspace.tsx
• 工程分析/需求分析-2026-05-20-02-15-10.md
• 工程分析/实现方案-2026-05-20-02-15-10.md
• 工程分析/测试方案-2026-05-20-02-15-10.md
• 工程分析/经验记录.md

技术路线

1. 新增轴向投影数据结构：
   • 定义 X/Y/Z 三个方向在屏幕 inset SVG 中的投影向量。
   • 提供默认轴向，避免 DICOM/模型未加载时空白。
2. 改造 CoordinateAxesInset：
   • 视觉尺寸由 72px 缩小到约 54px。
   • 线段终点、标签位置和透明度由投影数据驱动。
3. 在 FusionThreeView 中计算动态方向：
   • 在 Three.js animation loop 中让 fusionRoot 和 modelPoseGroup 更新矩阵。
   • 读取 modelPoseGroup.getWorldPosition() 与 getWorldQuaternion()。
   • 将模型局部 X/Y/Z 方向投影到当前 camera 屏幕空间。
   • 仅在投影签名变化时更新 React 状态，减少无意义重渲染。

执行步骤

• 增加 AxisProjection 类型、默认值和投影辅助函数。
• 改造坐标轴 inset 的 SVG 尺寸和绘制逻辑。
• 在融合视图动画中调用投影计算并传给 inset。
• 执行 npm run lint 和 npm run build。
• 追加经验记录、提交、推送并重新部署。

兼容性与回滚方案

• 如果动态投影出现异常，默认轴向仍可显示。
• 不修改 DICOM/STL 真实数据、模型位姿状态和实际渲染变换，仅增加可视化辅助。
• 回滚只需恢复 CoordinateAxesInset 为静态 SVG。

预计文件变更

• ReverseWorkspace.tsx：动态坐标轴投影与缩小样式。
• 工程分析文档：新增本次三份文档，更新经验记录。

提交与部署策略

• Commit message：2026-05-20-02-15-10 优化融合视角方向标识
• 显式暂存本次相关文件，避免提交历史删除状态。
• 推送到 Gitea origin/main，并使用 tmux 会话 revoxelseg-dicom 重新部署。