Fix FxPlug CI orientation and preserve incompatible legacy tracks; prepare tested 1.0.6 Release

2026-10-21 20:56:54 +08:00
@@ -39,12 +39,28 @@
    "face": 116,
    "thin_chin": 394,
    "failures": 0,
-    "maximum_uv_oracle_error": 1.09828022e-05
+    "maximum_uv_oracle_error": 1.09828022e-05,
+    "realVideoASanChecks": 494,
+    "realVideoFrames": 11,
+    "independentAnatomicalChecks": 12,
+    "fullChecks": 904,
+    "hostAdapterASanChecks": 247,
+    "oscASanChecks": 98,
+    "allOriginTagsPixelIdentical": true,
+    "maxByteErrorVsIndependentCIReference": 2
  },
  "limitations": [
    "Seven other shape controls remain approximations.",
    "Combined analytic controls and multi-face resampling order is not fully reference equivalent.",
-    "FxPlug adapter imageOrigin handling is under separate investigation.",
    "Motion/FCP final visual validation is reserved for user."
-  ]
+  ],
+  "adapterCorrection": {
+    "change": "remove imageOrigin-based input/output flips to match reference CI/IOSurface path",
+    "legacyTrackPolicy": "preserve unmarked strings but use realtime follow; reanalysis writes hostCoordinateSpace=iosurface-ci-y-up-v1",
+    "referenceOutputEvidence": [
+      "ev_88a71ec62fade296495f1e3f5428cdb15ad4cda43866e09fb040fa3a4bdb0440",
+      "ev_110d76f7958decb0c56b7daafe292d60a8bc56cd035b40a997f61395cb91ebfe"
+    ],
+    "nativeBufferCaptured": false
+  }
 }
@@ -21,3 +21,18 @@
 纯CI图像中，76点落在真实瞳孔和下巴，没有全局Y轴反置。但FxPlug适配层曾根据imageOrigin在输入、输出各翻转一次。以相同物理top-first照片字节离屏构造TOP_LEFT输入输出时，旧代码默认直通仍精确一致，却能复现下巴作用到眼部的现象；这说明直通测试无法排除中间处理倒置。

 imageOrigin描述坐标轴方向，不能单凭枚举推断IOSurface的物理行序。原版render主入口包装CIImage后仅见正尺度和位移，仍需核对其输出helper，不能仅凭主函数的有界检索宣称原版整个链条无翻转。原生FCP本次实际缓冲行序未捕获，最后视觉交由用户自测。临时照片、完整人脸坐标和探针输出均留在被忽略的build目录。
+
+## 原版输出链闭环与适配修复
+
+继续REA分析两个输出helper后，确认主入口所见的无额外翻转不是仅靠字符串缺失作出的猜测：
+
+- `0x10002911c`直接调用`CIContext render:toIOSurface:bounds:colorSpace:`，没有修改图像方向。证据`ev_88a71ec62fade296495f1e3f5428cdb15ad4cda43866e09fb040fa3a4bdb0440`。
+- `0x1000291b4`备用路径先render到BGRA8/RGBAh/RGBAf位图，再按源、目的行步长同时正向递增复制到IOSurface，没有倒行。证据`ev_110d76f7958decb0c56b7daafe292d60a8bc56cd035b40a997f61395cb91ebfe`，另有汇编交叉核对。完整记录见[rea-image-orientation.json](rea-image-orientation.json)。
+
+已移除我们输入/输出两处基于TOP_LEFT的额外翻转，保持与原版同类CI→IOSurface路径一致。独立探针在相同物理top-first字节下验证默认/大眼/下巴正负×四种源/目的标签共16组，全部与upright CI参考逐字节一致；旧代码在相同构造下出现下巴到眼部的热点，且默认直通0误差不能揭示内部倒置。这里验证的是物理缓冲构造与修复链，未捕获本次实际FCP缓冲。
+
+Apple[FxImageOrigin](https://developer.apple.com/documentation/professional_video_applications/fximageorigin)和本机SDK说明其描述坐标轴方向；[FxPlug渲染说明](https://developer.apple.com/documentation/professional-video-applications/rendering-in-fxplug)确认FxPlug4经IOSurface传入图像。文档本身未规定每个宿主的物理行序，本次改动依据为原版链和独立物理测试，不能把文档扩张成原生内存捕获。
+
+旧档案没有记录图像适配坐标契约，无法安全判断是否由旧翻转链产生。adapter现为新分析结果加`hostCoordinateSpace=iosurface-ci-y-up-v1`；未标记记录保留原字符串，渲染和续分析均不载入旧坐标。当前目标暂用实时跟随，新分析后恢复离线记录。不改通用PGFaceProcessor的旧档案读取能力，也不把用户记录直接删除或静默改写成新坐标。
+
+独立生理热点检查：NASA、实际素材0秒、4秒侧脸三张图均在真实下巴1.2–2.9像素内获得最大位移，实际下巴正值上收、负值延伸，双瞳孔采样位移不超过0.00003像素；12项专项检查通过。另同一素材11帧共494项瘦脸/下巴ASan检查通过，含重复基础用例，不与完整回归简单相加。用户照片、帧及完整点位均没有入库。
@@ -82,3 +82,5 @@ xcrun clang -fobjc-arc -Wall -Wextra \
 ## 后续修复状态

 1.0.5已实现并安装76点/17组局部瘦脸，旧的矩形框瘦脸已移除。上文“安装版未修复”为本次分析开始时1.0.4的历史状态。新增独立数值场与真实素材回归，签名公证及安装记录见 `../验证记录.md`。Motion/FCP最终视觉由用户自测，其他8类脸型控制与快速多人重叠的既有近似边界仍保留。
+
+1.0.6继续分析下巴与宿主图像轴，新增原版三pin下巴及CI/IOSurface无额外翻转修复，详见[下巴与坐标分析](下巴与坐标分析.md)。其余七类控制仍为近似实现。