4.3 KiB
大鱼人像美化 FCP 效果模板
版本：1.0.5。滤镜 UUID：FB14B0E6-59B2-4836-916F-CD0C559E9241。模板必须与已安装的大鱼人像美化 FxPlug APP 配套使用。
默认数值
模板首次应用时，“中频磨皮”为 50%（0.5）；直接在 Motion 添加裸 FxPlug 滤镜时为 0%（0）。模板保存了 default=0 / value=0.5，保留裸插件的重置基准；其他功能参数与插件默认一致。整体混合为100%，脸型、肤色提亮、锐化、牙齿和眼睛提亮初始为0，跟踪初始关闭。此模板不预置人脸身份或跟踪记录。
参数与输入
- 保留磨皮、肤色、细节、脸型、人脸选择与跟踪、蒙版与输出六个原生 FxPlug 参数组，发布46项可见功能参数，包括前向/后向分析及清除按钮。
- 目标1–3的隐藏分析数据以参数60/61/62保留在滤镜节点中，不发布成用户控件；分析完成后由插件写入宿主参数并随工程保存。
- 选脸位置发布为原生二维参数，并启用滤镜的“发布 OSC”宿主通道。跟踪按钮、OSC与工程关闭重开后的数据恢复须由实际 FCP 验证。
- 画面只含一个标准 Effect Source（Type=3、Drop Zone=1），其 Source Media 指向 clip
510000006，clip 位于 footage510000007。pathURL=Drop Zone.tiff为模板同目录内的相对引用，标准1200×1200占位图已随模板附带，没有外部安装目录依赖、示例人像、旧滤镜或新动画。FCP时间线片段的实际替换已在独立验收项目中确认正常出图。 - 作者与网站为两个原生空绑定展示菜单，不改变渲染。
建议模板安装位置：~/Movies/Motion Templates.localized/Effects.localized/大鱼/大鱼人像美化/。APP正式安装与模板安装、Motion/FCP原生验收由主任务处理。
结构来源与静态验证
Apple项目、群组、Effect Source和滤镜节点骨架来源于用户自有“大鱼去黑.moef”；仅保留这些原生结构，已替换滤镜UUID、名称、版本和全部功能参数。FxPlug组/字符串/点参数的原生结构交叉参照自有Number与Zoom and Pan样本；作者/网站空绑定来自ae-to-motion技能的原生版权样本。
PARAMETERS.json逐项记录参数ID、组、发布通道及初始值；VALIDATION.json记录本次静态核验。48个发布路径（46功能＋2信息）均能反查实际对象和通道，实体ID无冲突，三个隐藏数据通道未发布；必要占位媒体以相对路径随包附带，保存选择状态为0个内容对象且焦点为项目。技能motion_selection.py check与audit_motion.py --require-no-selection通过。
结构核验之外，已用实际素材在FCP和Motion完成加载、画面及提亮回归测试。详细范围及尚未覆盖的边界见 验证记录。
前版输入链错误与本次修复
前版生成稿（SHA256 3b7984e11a92487834ab67121fd3814bf13c22b77a70851298efa84206f91478）将效果源的 Source Media 设为0，并删除了原生clip/footage。用户在FCP应用后实测整幅黑屏。这是模板装配错误；保留Type=3本身并不能证明FCP输入替换链完整。此前XML解析、发布路径和无缺媒体检查通过，也没有覆盖真实FCP画面输入，不能当作该模板已经可用的证据。
黑屏修复恢复标准效果源clip/footage和Source Media关联，并随包加入标准Drop Zone.tiff，保留49个插件参数、48个发布入口与Type=3/Drop Zone=1。1.0.4同时包含独立的提亮蒙版与选脸坐标修复。该占位图从Apple Motion的Ozone.framework标准资源复制，实际运行只引用本模板内的相对副本。图像SHA256为 a7f8e3a2a431dbb3ce9e777040bb55e701cfe9ab9632e8cbb10359732bc8692e，420128字节。
本次已经静态核验Source Media→clip→相对文件链存在、文件字节一致、48项发布仍解析、隐藏数据未发布和保存选择状态；修复后已在FCP独立验收项目新增实例，确认输入替换、实际人像和提亮画面正常；Mix=0逐字节直通由宿主适配器IOSurface回归测试覆盖，未将其混称为FCP截图逐像素核验。
1.0.5将瘦脸改为76点驱动的17组局部位移，供用户在Motion/FCP自测最大瘦脸与转脸。旧跟踪记录若没有全点阵，需重新分析后才有瘦脸，或关闭“使用跟踪数据”采用当前帧自动检测。