2026-06-23-13-38-48 新增逆向工作区单轴拉伸

工程分析/经验记录.md

@@ -2031,3 +2031,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 后续无源码变更的重新部署也要记录实际启动命令、运行载体、端口监听地址、目标 IP 归属以及 API/首页双验证结果。若使用 `npm run build` 后部署，优先记录是否以 `NODE_ENV=production` 服务 `dist/`，避免开发中间件 Host 校验或源码热更新状态影响访问判断。
+
+## 2026-06-23-13-38-48 单轴拉伸位姿字段必须统一变换顺序
+
+A. 具体问题
+
+用户要求在逆向工作区新增直接沿某一个轴拉伸模型的方式，并要求后续缩放和自动微调匹配都使用拉伸后的模型。旧位姿只有统一 `scale`，现有 X/Y/Z 拉伸也都是等比例缩放，无法表达非等比例的单轴变形。
+
+B. 产生问题原因
+
+模型位姿会同时进入三维融合视图、二维逆向分割映射、项目库回放、自动匹配评分和服务端导出。如果只在某个前端按钮里临时改变显示比例，保存、导出或自动匹配会丢失该变形；如果前端和后端的变换顺序不同，又会出现页面位置和导出 Label Map 不一致。
+
+C. 解决问题方案
+
+为 `ModelPose` / `ModelPoseValue` 增加 `scaleX`、`scaleY`、`scaleZ`，默认补齐为 `1`。统一采用“中心化后统一缩放与镜像、旋转、融合坐标系单轴拉伸、平移”的变换顺序。逆向工作区保留等比例 `X拉伸/Y拉伸/Z拉伸`，新增 `X轴/Y轴/Z轴` 单轴拉伸；单轴拉伸时自动把对应 `translateX/Y/Z` 置为 `0`。前端三维、二维映射、项目库预览和后端 `transformPointForExportPose` 使用同一套字段，自动匹配继续只优化平移与统一缩放，但保留并应用单轴拉伸后的基准模型。
+
+D. 后续如何避免问题
+
+后续新增位姿字段时，必须同步检查类型、默认值、状态归一化、导入/保存、三维渲染层级、二维映射、服务端导出坐标变换、自动匹配评分和项目库回放。涉及非等比例变换时要先明确是在模型局部轴还是融合/DICOM 坐标轴上生效，并在前后端保持完全一致。