60 lines
2.4 KiB
Markdown
60 lines
2.4 KiB
Markdown
# 实现方案-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` 重新部署。
|