REVOXELSEG_DICOM/工程分析/实现方案-2026-05-24-19-11-30.md

实现方案-2026-05-24-19-11-30

实现方案文档路径

工程分析/实现方案-2026-05-24-19-11-30.md

修改目标

• 将平移 X/Y/Z 和缩放的控件步进统一改为 0.001。
• 保证项目库和逆向工作区两处位姿控件同步。
• 保证显示格式和状态精度支持三位小数。

涉及路径

• WebSite/src/components/ReverseWorkspace.tsx
• WebSite/src/components/ProjectLibrary.tsx
• WebSite/server.ts
• Docker部署/README.md
• 工程分析/经验记录.md

技术路线

• 检查现有 poseStepConfig、项目库位姿控件数组和格式化函数。
• 将 translateX/translateY/translateZ/scale 的 step、按钮文案、快捷 delta 调整为 0.001。
• 为平移字段补充三位小数精度处理，避免浮点累积或显示截断。
• 服务端保存和读取模型位姿时，对平移和缩放执行三位小数归一化。
• 保持旋转字段不变。

执行步骤

1. 定位所有平移和缩放步进配置。
2. 修改逆向工作区位姿控件。
3. 修改项目库位姿控件。
4. 修改服务端位姿归一化精度。
5. 更新 Docker 部署说明与经验记录。
6. 运行类型检查和构建。
7. 重新部署并验证服务。
8. 提交并推送到 Gitea。

兼容性与回滚方案

• 位姿字段结构不变，只改变前端输入步进和精度。
• 已保存的旧位姿仍可正常读取。
• 如需回滚，恢复本次 commit 并重新部署即可。

预计文件变更

• 2 个前端组件文件。
• 1 个服务端文件。
• 1 个 Docker 部署说明文件。
• 3 个工程分析当次文档。
• 1 个经验记录追加。

提交与部署策略

• Commit message 使用 2026-05-24-19-11-30 调整位姿微调步进为0.001。
• 构建通过后重启 tmux 会话 revoxelseg-dicom。
• 验证本机和公网入口。