Build native card inspector and secure state; hide manual analysis and unify automatic follow (validation in progress)
这个提交包含在：
dayu 于
1 父节点
5793e3de49
当前提交
f4c0d608a4
20 个文件已更改
+1492
-236
没有与搜索条件相匹配的文件
+26
-20
@@ -1,37 +1,43 @@
|
||||
# 大鱼人像美化 FCP 效果模板
|
||||
|
||||
版本：1.0.6。滤镜 UUID：`FB14B0E6-59B2-4836-916F-CD0C559E9241`。模板必须与已安装的大鱼人像美化 FxPlug APP 配套使用。
|
||||
版本：1.1.0。滤镜 UUID：`FB14B0E6-59B2-4836-916F-CD0C559E9241`。需配套同版大鱼人像美化 FxPlug APP。
|
||||
|
||||
## 默认数值
|
||||
## 三卡片与自动跟随
|
||||
|
||||
模板首次应用时，“中频磨皮”为 **50%（0.5）**；直接在 Motion 添加裸 FxPlug 滤镜时为 **0%（0）**。模板保存了 `default=0 / value=0.5`，保留裸插件的重置基准；其他功能参数与插件默认一致。整体混合为100%，脸型、肤色提亮、锐化、牙齿和眼睛提亮初始为0，跟踪初始关闭。此模板不预置人脸身份或跟踪记录。
|
||||
FCP 发布列表仅保留作者、网站两个空绑定展示项，以及一个空名称的自定义面板入口 `./210`，共3项。面板内提供“磨皮、美白、瘦脸”三张卡片和“更多”附加设置。主体人脸由当前画面自动选择并实时跟随，无需手动前向/后向分析。多人模式、预览框、防跳脸与各项调节由插件自定义面板承载。
|
||||
|
||||
## 参数与输入
|
||||
原有46个平铺功能入口已撤下。旧49个参数定义及六组路径仍保留供旧项目兼容，插件以 SDK 隐藏标记注册；旧手动分析按钮、跟踪目标/状态、选脸点和目标数据不再发布为界面入口。隐藏的目标数据60/61/62不删除。发布 OSC 初始为0；旧OSC类注册由插件保留。
|
||||
|
||||
- 保留磨皮、肤色、细节、脸型、人脸选择与跟踪、蒙版与输出六个原生 FxPlug 参数组，发布46项可见功能参数，包括前向/后向分析及清除按钮。
|
||||
- 目标1–3的隐藏分析数据以参数60/61/62保留在滤镜节点中，不发布成用户控件；分析完成后由插件写入宿主参数并随工程保存。
|
||||
- 选脸位置发布为原生二维参数，并启用滤镜的“发布 OSC”宿主通道。跟踪按钮、OSC与工程关闭重开后的数据恢复须由实际 FCP 验证。
|
||||
- 画面只含一个标准 Effect Source（Type=3、Drop Zone=1），其 Source Media 指向 clip `510000006`，clip 位于 footage `510000007`。`pathURL=Drop Zone.tiff` 为模板同目录内的相对引用，标准1200×1200占位图已随模板附带，没有外部安装目录依赖、示例人像、旧滤镜或新动画。FCP时间线片段的实际替换已在独立验收项目中确认正常出图。
|
||||
- 作者与网站为两个原生空绑定展示菜单，不改变渲染。
|
||||
## 默认与旧项目
|
||||
|
||||
建议模板安装位置：`~/Movies/Motion Templates.localized/Effects.localized/大鱼/大鱼人像美化/`。APP正式安装与模板安装、Motion/FCP原生验收由主任务处理。
|
||||
模板首次应用时，旧原生“中频磨皮”仍保存 `default=0 / value=0.5`，即初始局部磨皮50%；直接添加裸插件时为0%。自定义 `PGInspectorState` 初始 `hasEdits=NO`，因此读取并保留旧原生参数，不会用面板归档中的默认0覆盖模板0.5或旧项目数值。面板经过编辑后由自定义状态持久保存调节值。此模板不预置任何人脸身份或跟踪记录。
|
||||
|
||||
## 结构来源与静态验证
|
||||
## 自有状态归档
|
||||
|
||||
Apple项目、群组、Effect Source和滤镜节点骨架来源于用户自有“大鱼去黑.moef”；仅保留这些原生结构，已替换滤镜UUID、名称、版本和全部功能参数。FxPlug组/字符串/点参数的原生结构交叉参照自有Number与Zoom and Pan样本；作者/网站空绑定来自ae-to-motion技能的原生版权样本。
|
||||
参数210使用本插件生成的 `PGInspectorState` 安全键控归档：内部 `Custom Data` 对象、外部 `BlindDataObject` 与 `DataIsLegacy=false`，再按已核对的Motion文本编码和长度封装。保存 `schema=1 / edited=false`，不使用原版私有数据、类名、品牌资源或空 `<dataValue>` 猜测初始化。默认和当前归档相同，可完整解码并往返核验。
|
||||
|
||||
`PARAMETERS.json`逐项记录参数ID、组、发布通道及初始值；`VALIDATION.json`记录本次静态核验。48个发布路径（46功能＋2信息）均能反查实际对象和通道，实体ID无冲突，三个隐藏数据通道未发布；必要占位媒体以相对路径随包附带，保存选择状态为0个内容对象且焦点为项目。技能`motion_selection.py check`与`audit_motion.py --require-no-selection`通过。
|
||||
该编码依据原生文件静态结构及独立Foundation归档检查；1.1.0自定义面板在Motion/FCP中的实际创建、显示、交互、撤销和关闭重开恢复仍待用户验收，不能以XML可解析或归档解码成功代替宿主加载通过。
|
||||
|
||||
结构核验之外，已用实际素材在FCP和Motion完成加载、画面及提亮回归测试。详细范围及尚未覆盖的边界见 [验证记录](../../docs/验证记录.md)。
|
||||
## 输入、媒体与版权
|
||||
|
||||
## 前版输入链错误与本次修复
|
||||
输入链沿用已修复的标准 Effect Source（Type=3、Drop Zone=1）：Source Media→clip `510000006`→footage `510000007`→相对文件 `Drop Zone.tiff`。该占位图随模板附带，420128字节，SHA256 `a7f8e3a2a431dbb3ce9e777040bb55e701cfe9ab9632e8cbb10359732bc8692e`。没有外部素材、示例人像或新动画。
|
||||
|
||||
前版生成稿（SHA256 `3b7984e11a92487834ab67121fd3814bf13c22b77a70851298efa84206f91478`）将效果源的 Source Media 设为0，并删除了原生clip/footage。用户在FCP应用后实测整幅黑屏。这是模板装配错误；保留Type=3本身并不能证明FCP输入替换链完整。此前XML解析、发布路径和无缺媒体检查通过，也没有覆盖真实FCP画面输入，不能当作该模板已经可用的证据。
|
||||
作者与网站仍是同一个Rig下的两个无受控参数菜单：“FCP 版本作者→／大鱼先森Media”和“更多模板浏览器访问→／dayu.media”。仅展示信息，不改变渲染。
|
||||
|
||||
黑屏修复恢复标准效果源clip/footage和Source Media关联，并随包加入标准`Drop Zone.tiff`，保留49个插件参数、48个发布入口与Type=3/Drop Zone=1。1.0.4同时包含独立的提亮蒙版与选脸坐标修复。该占位图从Apple Motion的Ozone.framework标准资源复制，实际运行只引用本模板内的相对副本。图像SHA256为 `a7f8e3a2a431dbb3ce9e777040bb55e701cfe9ab9632e8cbb10359732bc8692e`，420128字节。
|
||||
建议安装位置：`~/Movies/Motion Templates.localized/Effects.localized/大鱼/大鱼人像美化/`。本轮不安装模板，不操作Motion/FCP，由主任务完成正式交付，用户自测原生面板。
|
||||
|
||||
本次已经静态核验Source Media→clip→相对文件链存在、文件字节一致、48项发布仍解析、隐藏数据未发布和保存选择状态；修复后已在FCP独立验收项目新增实例，确认输入替换、实际人像和提亮画面正常；Mix=0逐字节直通由宿主适配器IOSurface回归测试覆盖，未将其混称为FCP截图逐像素核验。
|
||||
## 验证边界与历史修复
|
||||
|
||||
1.0.5将瘦脸改为76点驱动的17组局部位移，供用户在Motion/FCP自测最大瘦脸与转脸。旧跟踪记录若没有全点阵，需重新分析后才有瘦脸，或关闭“使用跟踪数据”采用当前帧自动检测。
|
||||
`PARAMETERS.json`记录新旧参数和3条发布路径；`VALIDATION.json`分开记录结构/归档核验与当前宿主待验项。内容选择状态保持为空，效果源、clip/footage、占位资源和版权绑定结构均保留。
|
||||
|
||||
1.0.6移除Core Image/IOSurface链按宿主原点重复翻转，修正下巴三组局部位移及正负方向。旧版未标记坐标空间的分析记录保留但不再重放，自动回退实时跟随；需要离线记录时重新分析当前目标。
|
||||
早期模板曾误删clip/footage、将Source Media设为0，用户在FCP实测黑屏；随后恢复完整标准输入链，历史版本已实际出图。该历史结果只支持输入链，不能证明新1.1.0自定义面板已加载。1.0.5加入76点17组局部瘦脸；1.0.6移除IOSurface重复翻转并修复下巴三组局部位移。旧未标记坐标空间的跟踪数据保留但不重放，自动回退实时跟随。
|
||||
|
||||
## 可复现的只读核验
|
||||
|
||||
在仓库根目录执行：
|
||||
|
||||
```sh
|
||||
python3 scripts/inspector-template.py audit "Templates/大鱼人像美化/大鱼人像美化.moef"
|
||||
```
|
||||
|
||||
脚本可提取内外归档并核验自有类、schema、初始状态、3条发布和媒体引用；`encode --inner <本插件生成的Custom Data归档> --text-output <输出文件>` 可重新包装文本值，不启动宿主。其结果明确保留宿主加载待验状态。
|
||||
在新工单中引用
屏蔽一个用户