# 实现方案-2026-05-21-09-29-47

实现方案文档路径：`工程分析/实现方案-2026-05-21-09-29-47.md`

## 修改目标

- 定位并修复自动拉伸按钮的尺度计算逻辑。
- 将缩放控件的展示精度和按钮调整步长统一为三位小数、`0.005`。
- 完成静态检查、构建和部署验证。

## 涉及路径

- `WebSite/src/components/ReverseWorkspace.tsx`
- `WebSite/src/components/ProjectLibrary.tsx`
- `工程分析/需求分析-2026-05-21-09-29-47.md`
- `工程分析/实现方案-2026-05-21-09-29-47.md`
- `工程分析/测试方案-2026-05-21-09-29-47.md`
- `工程分析/经验记录.md`

## 技术路线

1. 查找 `Z拉伸`、`Y拉伸`、`stretch`、`poseStepConfig`、`scale` 相关实现。
2. 对齐自动拉伸与三维融合视图的模型包围盒基准，避免可见构件和全局构件混用导致重复点击结果不同。
3. 将自动拉伸改为基于原始模型全局包围盒和 DICOM 物理尺寸计算目标缩放，使操作幂等。
4. 对单轴贴合增加 DICOM 体范围保护，避免 Y 等短轴贴合时把整体模型放大到超出视场。
5. 将 `scale` 的步长改为 `0.005`，数值输入/展示统一三位小数。
6. 运行 `npm run lint`、`npm run build`，并通过接口/页面验证部署。

## 执行步骤

- 阅读相关源码和当前状态。
- 修改自动拉伸计算函数与缩放格式化函数。
- 确认保存快照和导出仍使用数值型 `scale`。
- 构建并部署。
- 追加经验记录，提交并尝试推送 Gitea。

## 兼容性与回滚方案

- 修改仅限前端位姿计算与展示，不改变后端数据结构。
- 若自动拉伸回归失败，可回退本次 `ReverseWorkspace.tsx` 改动。
- 旧保存位姿仍可按数值读取，界面展示会统一为三位小数。

## 预计文件变更

- 修改 `WebSite/src/components/ReverseWorkspace.tsx`。
- 修改 `WebSite/src/components/ProjectLibrary.tsx`。
- 新增本次工程分析三件套。
- 追加 `工程分析/经验记录.md`。

## 提交与部署策略

- 暂存本次代码与工程分析文档，避免历史删除、软著目录和压缩包进入提交。
- Commit message 包含 `2026-05-21-09-29-47` 与简要说明。
- 使用 `tmux` 会话 `revoxelseg-dicom` 重新部署端口 `4000`。