```

feat(Quick): 优化RegionCameraView裁剪算法

重构RegionImageCropper裁剪逻辑，改用纯几何aspect-fill反算方法，
将屏上小框坐标直接映射到照片像素rect，避免使用
metadataOutputRectConverted导致的坐标轴对调问题。

主要变更:
- 移除基于归一化rect的裁剪方式
- 新增cropRect函数进行几何反算
- 修复传感器横向坐标与竖屏照片方向不一致的问题
- 保持裁剪精度的同时提升算法稳定性
```

康康Tests/RegionImageCropperTests.swift

@@ -0,0 +1,61 @@
+import XCTest
+import CoreGraphics
+@testable import 康康
+
+/// 异常项快拍的局部裁剪几何。
+/// 回归用例:屏上「宽而矮」的小框,必须裁出「宽 > 高」的照片 rect。
+/// 旧实现用 `metadataOutputRectConverted`(传感器横向坐标)套到竖屏照片 → x/y 轴对调,
+/// 把宽框裁成竖窄条(2026-05-31 真机 bug)。本组用例钉住正确的纯几何映射。
+final class RegionImageCropperTests: XCTestCase {
+
+    /// 竖屏照片 + 竖屏屏幕 + 宽框 → 裁出的 rect 必须是横向(宽 > 高)。
+    func testWideBoxYieldsLandscapeCropRect() {
+        let photo = CGSize(width: 3024, height: 4032)   // 竖屏照片(像素)
+        let view = CGSize(width: 393, height: 852)       // 竖屏屏幕(点)
+        let box = RegionFraming.box(in: view)            // 宽 84% / 矮 160
+
+        let rect = RegionImageCropper.cropRect(photoPixelSize: photo, box: box, in: view)
+
+        XCTAssertGreaterThan(rect.width, rect.height,
+            "宽框应裁出宽 rect;若 width<height 说明轴对调 bug 复现")
+        XCTAssertGreaterThan(rect.width, 0)
+        XCTAssertGreaterThan(rect.height, 0)
+    }
+
+    /// 裁出的 rect 必须完整落在照片像素范围内(越界夹紧)。
+    func testCropRectStaysInsidePhotoBounds() {
+        let photo = CGSize(width: 3024, height: 4032)
+        let view = CGSize(width: 393, height: 852)
+        let box = RegionFraming.box(in: view)
+
+        let rect = RegionImageCropper.cropRect(photoPixelSize: photo, box: box, in: view)
+
+        XCTAssertGreaterThanOrEqual(rect.minX, 0)
+        XCTAssertGreaterThanOrEqual(rect.minY, 0)
+        XCTAssertLessThanOrEqual(rect.maxX, photo.width)
+        XCTAssertLessThanOrEqual(rect.maxY, photo.height)
+    }
+
+    /// 宽框宽高比应与照片裁剪 rect 宽高比一致(aspect-fill 等比映射,不拉伸)。
+    func testCropRectPreservesBoxAspectRatio() {
+        let photo = CGSize(width: 3024, height: 4032)
+        let view = CGSize(width: 393, height: 852)
+        let box = RegionFraming.box(in: view)
+
+        let rect = RegionImageCropper.cropRect(photoPixelSize: photo, box: box, in: view)
+
+        let boxAspect = box.width / box.height
+        let rectAspect = rect.width / rect.height
+        XCTAssertEqual(rectAspect, boxAspect, accuracy: 0.05,
+            "等比映射下,裁剪 rect 宽高比应与屏上小框一致")
+    }
+
+    /// 退化输入:零尺寸不应崩溃,返回 .zero。
+    func testZeroInputsReturnZero() {
+        XCTAssertEqual(
+            RegionImageCropper.cropRect(photoPixelSize: .zero,
+                                        box: CGRect(x: 0, y: 0, width: 10, height: 10),
+                                        in: CGSize(width: 100, height: 200)),
+            .zero)
+    }
+}