WIP: document original automatic face-follow mechanism and prepare 1.0.4

docs/验证记录.md

@@ -1,4 +1,4 @@
-# 大鱼人像美化 1.0.3 验证记录
+# 大鱼人像美化 1.0.4 验证记录
 
 日期：2026-10-21。环境：Apple Silicon M1 Max，macOS27.2、Motion6.4、Final Cut Pro12.4、Xcode27.1、FxPlug SDK4.3.4、PluginManager1.7.4。Release包含arm64和x86_64；原生宿主实测为arm64，未在Intel机器实测。
 
@@ -14,7 +14,7 @@ FCP：使用用户给定的3840×2160、25fps蓝发人像视频。新建独立
 
 Motion：独立普通视频项目，源PTS0、1920×1080/25fps/10秒，媒体通过本机链接引用给定视频；开启50%中频、75%提亮与人脸框。切换滤镜启用、从第1帧播放到第179帧均正常出图，人脸框随画面位置更新；选中滤镜可正常建立OSC连接。此QA工程依赖外置卷原视频，不作为可移植产品资源交付。
 
-选脸控件：原生验收额外发现OBJECT坐标被二次归一化，十字落在画面角落；本轮修复和原生回写结果将在最终验收后补齐。
+选脸控件：原生验收额外发现OBJECT坐标被二次归一化，十字落在画面角落；现直接使用归一化OBJECT坐标转换至CANVAS像素。Motion点参数桥接会归一化读取，却按中心像素写入，新增事件内读回检测及兼容转换，并校验最终位置；不依赖宿主版本号猜测。50项OSC测试同时覆盖文档约定与Motion像素桥接。原生回写结果待最终安装后补齐。公开坐标依据：[Apple Creating Onscreen Controls](https://developer.apple.com/library/archive/documentation/AppleApplications/Conceptual/FXPlug_overview/OnScreenControls/OnScreenControls.html)。
 
 宿主在更新前退出，新正式版安装后重新打开。曾在旧XPC连接未释放、临时构建插件仍被注册的热替换环境出现宿主关闭挂起/OSC连接崩溃；交付流程已增加宿主关闭检查，并在原生验收前注销构建目录的插件。没有把该崩溃直接归因为某条提亮公式。
 
@@ -26,7 +26,7 @@ Motion：独立普通视频项目，源PTS0、1920×1080/25fps/10秒，媒体通
 
 ## 自动化与恢复
 
-渲染/人脸/宿主适配器/OSC测试使用公共NASA人像与合成数据，覆盖默认直通、像素格式与画面原点、极值、连续调色蒙版、蓝发抑制、选脸/分析状态和错误处理。最终计数与源节点将在代码冻结后记录。宿主适配器和OSC测试启用AddressSanitizer。
+渲染/人脸/宿主适配器/OSC测试使用公共NASA人像与合成数据，覆盖默认直通、像素格式与画面原点、极值、连续调色蒙版、蓝发抑制、选脸/分析状态和错误处理。最终代码节点为22cd96a772f84895aacd5ccc1ef24e0711e933fa，281项检查通过：渲染49、人脸65、宿主适配117、OSC50，零失败。宿主适配器和OSC测试启用AddressSanitizer。
 
 远端独立克隆核验检查受跟踪文件字节、工程资源、Git对象完整性和可执行脚本模式，无LFS与子模块。scripts/checkpoint.py以100644保存，按文档使用python3调用；它不是可直接执行的入口，恢复测试报告中该权限提示不表示源码丢失。