# 实现方案-2026-06-23-13-38-48

## 实现方案文档路径

`工程分析/实现方案-2026-06-23-13-38-48.md`

## 修改目标

新增模型位姿的单轴拉伸能力，使逆向工作区可按某一坐标轴非等比例拉伸模型，并保证缩放、保存、导出、项目库预览和自动微调匹配都使用该拉伸后的统一模型位姿。

## 涉及路径

- `WebSite/src/types.ts`
- `WebSite/src/components/ReverseWorkspace.tsx`
- `WebSite/src/components/AutoMatchWorkspace.tsx`
- `WebSite/src/components/ProjectLibrary.tsx`
- `WebSite/server.ts`
- `工程分析/需求分析-2026-06-23-13-38-48.md`
- `工程分析/实现方案-2026-06-23-13-38-48.md`
- `工程分析/测试方案-2026-06-23-13-38-48.md`
- `工程分析/经验记录.md`

## 技术路线

- 扩展 `ModelPose` / `ModelPoseValue`，新增 `scaleX`、`scaleY`、`scaleZ`，默认值为 `1`。
- 统一归一化和 clamp 范围，让旧数据自动补齐新字段。
- 前端三维视图和二维分割映射采用同一变换顺序：
  - 原始模型中心化。
  - 应用统一缩放、镜像和旋转。
  - 在融合坐标系下应用 `scaleX/scaleY/scaleZ` 单轴拉伸。
  - 应用平移。
- 后端 `transformPointForExportPose` 使用相同变换顺序，保证导出和自动匹配评分一致。
- 逆向工作区保留现有等比例自动拉伸，再新增单轴拉伸按钮；单轴拉伸时自动把对应平移置 0。
- 自动微调匹配工作区不额外优化 `scaleX/scaleY/scaleZ`，但请求、评分、对比视图和保存结果保留并应用这些字段。

## 执行步骤

1. 扩展前后端位姿类型、默认值、格式化、归一化和 reset 行为。
2. 修改 `ReverseWorkspace` 的模型变换、二维映射和工具栏按钮。
3. 修改 `ProjectLibrary` 结果预览中的模型变换，兼容新字段。
4. 修改 `server.ts` 的位姿归一化、管线参数解析、自动匹配评分和导出分割变换。
5. 运行 `npm run lint` 与 `npm run build`。
6. 重启 `tmux` 会话 `revoxelseg-dicom` 并验证本机/局域网访问。
7. 追加经验记录并提交本次文档与源码备份 commit。

## 兼容性与回滚方案

- 兼容性：旧位姿不含 `scaleX/scaleY/scaleZ` 时默认按 `1` 处理，与旧行为完全一致。
- 回滚：如新拉伸或导出异常，可回退本次 commit 并重新构建部署。
- 数据风险：本次不修改医学数据；运行态 `state.json` 只会在用户实际保存项目时记录新字段。

## 预计文件变更

- 修改：
  - `WebSite/src/types.ts`
  - `WebSite/src/components/ReverseWorkspace.tsx`
  - `WebSite/src/components/AutoMatchWorkspace.tsx`
  - `WebSite/src/components/ProjectLibrary.tsx`
  - `WebSite/server.ts`
  - `工程分析/经验记录.md`
- 新增：
  - `工程分析/需求分析-2026-06-23-13-38-48.md`
  - `工程分析/实现方案-2026-06-23-13-38-48.md`
  - `工程分析/测试方案-2026-06-23-13-38-48.md`

## 提交与部署策略

- 只暂存本次源码和工程分析文档。
- 不提交 DICOM/STL 数据、运行态 `WebSite/data/`、导出文件或无关变更。
- commit message 使用：`2026-06-23-13-38-48 新增逆向工作区单轴拉伸`。
- 构建通过后使用 `tmux` 会话 `revoxelseg-dicom` 重新部署 `NODE_ENV=production npm run serve -- --host 0.0.0.0 --port 4000`。