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

实现方案-2026-05-20-02-02-37

实现方案文档路径

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

修改目标

让“模型位姿”每一项都支持直接数字输入，并新增导入位姿数据功能，兼容当前导出的位姿 JSON，导入后同步当前位姿和保存位姿列表。

涉及路径

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

技术路线

1. 增加位姿归一化辅助函数：
   • 对每个位姿字段按 poseStepConfig 执行数字校验、clamp 和默认值补齐。
   • 对导入的保存位姿列表补齐默认/俯视/侧视，并去重。
2. 模型位姿数值输入：
   • 将原只读数值改成 <input type="number">。
   • 使用现有 step/min/max/precision。
   • 输入合法时立即更新 modelPose，继续触发三维与二维映射联动。
3. 导入位姿数据：
   • 新增隐藏 file input 与“导入”按钮。
   • 读取 JSON，兼容 { activePose, modelPoses }、{ pose }、直接 pose 对象三种形式。
   • 导入 modelPoses 时调用现有 commitSavedPoses 持久化。
4. 反馈与容错：
   • 导入成功设置提示；导入失败设置 fusionError。
   • 清空 file input value，允许重复导入同一文件。

执行步骤

• 更新 ReverseWorkspace.tsx 的 import、ref、辅助函数和 handlers。
• 调整模型位姿 UI，将保存按钮组改为保存/导入两个操作。
• 将数值展示替换为可编辑数字输入。
• 运行 npm run lint 与 npm run build。
• 重新部署并验证服务。

兼容性与回滚方案

• 旧滑条、加减按钮、保存位姿、重命名位姿逻辑继续保留。
• 导入功能只读本地 JSON，不改后端接口。
• 如导入格式异常，只提示错误，不覆盖当前状态。

预计文件变更

• ReverseWorkspace.tsx：位姿数字输入、导入按钮、JSON 解析与归一化。
• 工程分析文档：新增本次三份文档并追加经验记录。

提交与部署策略

• Commit message：2026-05-20-02-02-37 支持位姿输入与导入
• 显式暂存本次相关文件，避免提交历史删除状态。
• 推送到 Gitea origin/main 后，沿用 tmux 会话 revoxelseg-dicom 重新部署。