# 大鱼人像美化 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机器实测。

## 用户报告的两个问题

FCP黑屏来自初版效果模板的输入链：Source Media=0且无clip/footage。已恢复标准Effect Source→clip→footage→本地Drop Zone.tiff。新模板在FCP的独立验收项目中成功替换为实际片段，并能调整美化参数；不能把此前XML通过当作原生输入链通过。

肤色提亮出现眼、鼻、唇周围圆洞，原因是调色复用了为磨皮扣除五官的蒙版。现在磨皮保留五官保护，肤色改用连续的人脸覆盖与柔和肤色分类，并羽化过渡、抑制蓝发溢色。提供的实际素材以75%提亮/50%中频在Motion复测，首帧及转头后画面未再见原圆洞；离线同帧旧/新算法对照保存在本机build目录，未将用户素材或截图上传源码仓库。强提亮仍会放大原素材的日光与阴影差异，不等于自动重布光。

## 宿主测试范围

FCP：使用用户给定的3840×2160、25fps蓝发人像视频。新建独立验收事件与10秒项目“ 大鱼人像美化验收-20261021 ”，位于当前已打开的素材库中，未修改原生产时间线；前5秒原片、后5秒同一段原片加效果。实际看到正常输入、非黑画面和提亮变化。勾选选脸并执行向前分析后，使用跟踪数据由0变为1，按钮路由与基本分析完成可用；未将其描述为125帧逐帧核验或复杂遮挡恢复通过。

Motion：独立普通视频项目，源PTS0、1920×1080/25fps/10秒，媒体通过本机链接引用给定视频；开启50%中频、75%提亮与人脸框。切换滤镜启用、从第1帧播放到第179帧均正常出图，人脸框随画面位置更新；选中滤镜可正常建立OSC连接。此QA工程依赖外置卷原视频，不作为可移植产品资源交付。

选脸控件：原生验收额外发现OBJECT坐标被二次归一化，十字落在画面角落；现直接使用归一化OBJECT坐标转换至CANVAS像素。Motion点参数桥接会归一化读取，却按中心像素写入，新增事件内读回检测及兼容转换，并校验最终位置；不依赖宿主版本号猜测。98项OSC测试同时覆盖文档约定与Motion像素桥接。事件现显式使用CANVAS坐标并由宿主转换回OBJECT，避免OBJECT鼠标事件的单位歧义。1.0.4的显式选脸点击回写尚未完成原生复测；界面被用户接管自测，已按要求停止自动化操作。98项离屏OSC/ASan检查不能替代这项原生验收。公开坐标依据：[Apple Creating Onscreen Controls](https://developer.apple.com/library/archive/documentation/AppleApplications/Conceptual/FXPlug_overview/OnScreenControls/OnScreenControls.html)。

宿主在更新前退出，新正式版安装后重新打开。曾在旧XPC连接未释放、临时构建插件仍被注册的热替换环境出现宿主关闭挂起/OSC连接崩溃；交付流程已增加宿主关闭检查，并在原生验收前注销构建目录的插件。没有把该崩溃直接归因为某条提亮公式。

## 功能边界与原版跟踪选项

用户给出的MS超级美颜V2.moef共发布15个入口，没有跟踪、前向或后向分析控件。没有额外分析按钮不影响原版默认自动跟随；活跃render路径与Motion运行均已确认这一点。复刻版的三目标离线分析与持久化属于独立扩展，应与默认实时跟随分开理解。

六种肤色风格采用自写调色变换，脸型使用基于Vision关键点的近似局部反向采样；未复制原版私有LUT或算法资源。没有完成原版逐像素对齐、全部脸型强度主观比对、多人交叉遮挡、所有宿主版本及Intel硬件验收。源码层保存/恢复测试不代替两宿主所有工程关闭重开场景。

## 自动化与恢复

渲染/人脸/宿主适配器/OSC测试使用公共NASA人像与合成数据，覆盖默认直通、像素格式与画面原点、极值、连续调色蒙版、蓝发抑制、选脸/分析状态和错误处理。最终代码节点为e03e460a9b3e5ad489aad24095485ba10ceb987d，380项检查通过：渲染49、人脸116、宿主适配117、OSC98，零失败。宿主适配器和OSC测试启用AddressSanitizer。

远端独立克隆核验检查受跟踪文件字节、工程资源、Git对象完整性和可执行脚本模式，无LFS与子模块。scripts/checkpoint.py以100644保存，按文档使用python3调用；它不是可直接执行的入口，恢复测试报告中该权限提示不表示源码丢失。

## 正式交付

1.0.4 build6为通用Release，已按由内到外正式签名，codesign严格验证、Apple公证Accepted（8eb96294-5935-49ff-a487-3c4f60c27395）、票据粘附/验证、Gatekeeper及安装身份验证通过。临时构建APP、旧版备份APP及公证ZIP已清理，检查的项目、DerivedData、桌面、下载、Applications、正式FxPlug目录与本次临时构建路径只剩正式APP，该产品插件注册为1个正式路径；详细扫描范围见verification/release-receipt.json。唯一正式APP路径固定为 /Library/Plug-Ins/FxPlug/beatygril.app；FCP效果模板在用户Movies/Motion Templates.localized/Effects.localized/大鱼/大鱼人像美化内，必须同时有.moef与Drop Zone.tiff。

## 1.0.4 自动跟随专项

已按原版活跃路径加入自动主体关联、矩形防跳、关键点稳定、失检保持与独立时间缓存；默认不要求分析。新增51项人脸回归，覆盖移动、多脸作用范围、重选、重复帧、失检、矩形边界、轴向保护、历史缓存、并发及不改离线存档；独立审查曾发现A→B→A重选后的回看范围混淆，修复后独立复现保持同一输出。Face116另有ASan通过。

原版完整数学系数未恢复，本版使用自有平滑公式与past-only时间策略；当前检测框未做原版77点网格级稳定，没有真正sourceID，不能声称任意同尺寸换源或首次乱序完全一致。原生1.0.4：Motion成功加载正式路径插件，实际视频在不同播放头位置正常显示提亮、脸型和黄色主要人脸框；项目未执行离线分析，“使用跟踪数据”读取为0。用户随后明确接管Motion/FCP进行自测，自动化已停止，因此尚未完成1.0.4的FCP自动跟随、显式OSC点击回写及两宿主复杂场景验收。FCP黑屏输入链与提亮此前已原生复测，不能把它们混称为1.0.4所有自动跟随场景通过。详见分析说明的具体边界。

代码节点已从远端独立克隆恢复，51项受跟踪文件与9项必要资源逐字节/对象/文件模式一致；380项检查、严格fsck与Xcode工程读取全部通过，无LFS或子模块。验收报告见 [独立恢复摘要](verification/recovery-e03e460.txt) 与 [完整记录](verification/recovery-e03e460.json)。最终文档标签另作独立克隆核验，源码构建依赖没有因文档更新改变。