23 KiB
恢复说明
当前产品身份自1.3.2（17）统一为FCP-BeautyGirl：工程 FCP-BeautyGirl/FCP-BeautyGirl.xcodeproj、scheme FCP-BeautyGirl、APP /Library/Plug-Ins/FxPlug/FCP-BeautyGirl.app、主ID com.dayu.fcpbeautygirl、插件ID com.dayu.fcpbeautygirl.fxplug。签名源码 767bba8ac11e9bf9268a1e02d1a06d3c120c46aa，APP公证Accepted 559eedf0-048f-4d0e-b013-6a187695f2da，已安装并迁移清理旧APP；程序与滤镜参数、UUID保持兼容。中央身份定义见product.json，旧名称只用于经过ID、签名团队和滤镜UUID验证的迁移。下文历史版本保留各自当时的名称与路径。
- 大鱼备份远程（origin）：
https://dayu.media/git/dayu/paintfcp-fxplug.git - GitHub 公开远程（github）：
https://github.com/dayumeida/FCP-BeautyGirl.git - 本地项目根：
/Users/dayu/Documents/PaintFCP - 工作分支：
main - 修改前版本标签：
baseline-20261021，完整 SHA：1746f38398588e2367abb37a5c2b31cb64042429 - 无 Git LFS 或子模块；源码及必要 Xcode 工程资源均入库。
/Applications/MSE18V2.app是只读参考目标，不属于本项目资源，不随仓库保存。
在新机器登录大鱼站并生成自己的 Git 令牌后，以安全 credential helper 登录，然后：
git clone https://dayu.media/git/dayu/paintfcp-fxplug.git
cd paintfcp-fxplug
git switch --detach v1.2.0
需要继续编辑时，基于该提交创建新分支。安装 Xcode 与 Apple FxPlug 4 SDK；盘点版本和构建入口见 README.md。SDK/framework 为 Apple 外部开发依赖，应重新安装匹配版本。证书、私钥和公证凭据需从独立加密备份恢复或重新申请；Git 不包含它们。
恢复承诺仅覆盖已成功推送且核验的提交与仓库内资源。大鱼服务当前只有手动服务端备份，不能据此承诺本机与服务器同时丢失后的恢复。
首次远端恢复核验（2026-10-21）
已在本任务创建的独立临时目录从远端克隆 baseline-20261021，核验 HEAD 为 1746f38398588e2367abb37a5c2b31cb64042429，并与本地该提交的 23 个受跟踪文件逐字节比对一致；恢复目录可通过 xcodebuild -list 读取两个 target / scheme。远端 main 与标签解引用 SHA 均回读一致。临时恢复目录已清理。
初始模板存在行尾空白，修改前基线保留原样。本次核验未执行初始 APP 编译、签名、公证、安装或宿主加载；这些将由最终实现阶段单独验证。
1.0.4 恢复入口
最终交付标签为 v1.0.4，工作分支为 main；本次实际编译和独立恢复测试的代码节点为完整 SHA e03e460a9b3e5ad489aad24095485ba10ceb987d。最终标签还包含验证文档。需要精确恢复已测试源码时可执行 git switch --detach e03e460a9b3e5ad489aad24095485ba10ceb987d。两者都保留初始模板及全部中间提交。
依赖：Xcode27.1、FxPlug SDK4.3.4、PluginManager1.7.4，系统最低macOS13；Metal与Vision由系统提供。SDK头文件/链接存根安装到 /Library/Developer/SDKs/FxPlug.sdk/Library/Frameworks，可执行运行框架在 /Library/Developer/Frameworks；不要把SDK链接存根当运行框架嵌入APP。两者属于需重新安装的Apple外部依赖，仓库不保存证书/私钥或登录凭据。
测试与通用Release构建命令见README。关闭Motion和FCP后，执行 python3 scripts/deliver.py 完成正式签名、公证、粘附、唯一目录安装与验收后的副本清理；签名团队为B3W25FX5H5，公证使用登录钥匙串profile codex-dayu-notary-B3W25FX5H5。新机器需要自行恢复凭据或重新签发，不要把凭据加入Git。
FCP模板从 Templates/大鱼人像美化/ 恢复，将 .moef 和 Drop Zone.tiff 一起放入 ~/Movies/Motion Templates.localized/Effects.localized/大鱼/大鱼人像美化/；只放 .moef 会缺少标准效果源输入资源。正式APP仅安装在 /Library/Plug-Ins/FxPlug/beatygril.app，不是从工作树或构建目录运行。没有LFS或子模块，必要工程资源、NASA测试人像及配套模板资源均在Git中。
用户用于宿主验收的外置卷视频及build内的验收工程/截图属于测试素材与可重建产物，不属于产品构建依赖，也没有远程上传。原MSE18V2 APP与原版MS模板仅为只读参考，不作为运行依赖。远端恢复记录及实际宿主测试范围见 docs/验证记录.md。
瘦脸与侧脸问题的分析节点
v1.0.4之后的分析提交包含docs/analysis/脸型变形与转脸分析.md、slim-pose-report.json、REA证据包及独立Vision离线检测工具scripts/inspect-face-geometry.m。产品源码与安装版没有因该分析改变；已查明的问题仍存在于1.0.4。复现检测工具的依赖与命令见分析文档，用户视频、完整人脸坐标和帧图保留本地，不是产品恢复依赖。
1.0.5 当前恢复入口
当前发布标签为 v1.0.5，APP版本1.0.5、build7。签名构建的完整源码SHA为 abe97ed0cbd5a2b5ffda6ebdb486d3bff9170964；最终标签还包含交付脚本恢复修正及验证记录，产品源码与该SHA一致。该节点已从独立远端克隆恢复，69文件及9项必要资源完整、389项核心测试通过。主工作区另通过604项完整回归及同一用户视频11帧的264项瘦脸ASan场景。
从最终标签恢复后，关闭Motion/FCP，运行 python3 scripts/deliver.py --wait-for-hosts --user-tests 可完成签名公证安装、只读宿主退出等待、静态发现及副本清理；它不会操作宿主界面。若上次因非产品错误在Accepted且stapled后停止，可加 --resume-prepared，脚本必须重新核对签名CDHash、版本、票据及产品源码未变才会继续。缺少原staging或回执时应完整重新构建，不能伪造回执。
1.0.5瘦脸需要完整76点；旧离线记录缺该字段时保留其余功能并跳过瘦脸。关闭使用跟踪数据可使用当前帧自动76点，或重新分析生成新记录。没有引入原版metallib或CoreML模型，运行只依赖本产品及Apple系统框架。最终安装、配套模板和扫描范围见验证记录。
1.0.6 恢复入口
本次签名构建源码SHA为ad54726b17fabd11f46bc6121e664eac38960a23，APP版本1.0.6、build8；最终发布标签为v1.0.6。恢复该SHA可重建相同产品源码，最终标签另包含交付文档与回执。Release恢复仍用上节同一构建/公证命令、固定Bundle ID和正式安装路径；用户自测模式不会操作Motion/FCP界面。
新增下巴三pin与图像适配轴修复；新分析档案使用hostCoordinateSpace=iosurface-ci-y-up-v1。旧未标记档案保留原字符串但回退实时跟随，重新分析后才能用于离线重放，不能直接补字段伪装成新档案。七类剩余脸型项及组合顺序仍有近似边界。
ad54726b17fabd11f46bc6121e664eac38960a23已独立从上述远程克隆，87文件的byte/blob/mode与14项资源一致，strict/full fsck和559项核心测试通过，无LFS、子模块或APP产物。临时恢复目录已清理，完整报告见docs/verification/v1.0.6/recovery-ad54726.json。
1.0.6已完成正式签名、公证（Accepted ab0271c8-0c4b-4b10-9474-cebe9b55385b）、票据粘附、唯一正式目录安装和配套模板同步；临时APP/旧备份APP/公证ZIP已清理。完整回执及有界副本扫描见docs/verification/v1.0.6/installed-verification.json。未操作Motion/FCP界面，最终视觉验收保留为用户自测。
1.1.0 面板与自动处理
1.1.0（9）使用自有原生卡片面板和PGInspectorState安全归档。源代码、面板资源（全部程序绘制）、Motion模板与自有自定义参数数据均在仓库；新增./scripts/test-inspector.sh及scripts/inspector-template.py audit验证入口。恢复时需完整保留.moef中的自定义参数210、实际dataValue/defaultVal和两项版权发布；不要删掉仍用于旧工程迁移的隐藏参数定义和组路径。不得拿其他插件的自定义归档替换本产品自己的归档。
新渲染统一实时自动人脸跟随，旧手动分析数据仍保存在旧文档中但不参与本版渲染；主界面不再显示前后分析、目标列表、蒙版调试与平铺控件。三张卡片之外的细调收在更多设置。自定义对象保存完整界面状态，首次编辑前兼容旧参数；数值、开关、启停mask按已测试的复制/插值规则恢复。真实宿主UI及工程重开仍需用户自测。
正式构建、公证、安装仍使用同一python3 scripts/deliver.py --wait-for-hosts --user-tests，保持固定Bundle ID与APP路径，仅在用户自行退出Motion/FCP后替换，最终版本节点与回执随交付记录补齐。
兼容边界：未编辑面板时读取旧文档原参数；首次编辑会把当前数值采集为完整面板状态。旧版各项独立关键帧曲线尚未自动迁移为新面板关键帧，不宣称编辑前后任意旧动画逐帧等价。面板本身的数值插值与开关保持已做离屏验证，实际宿主关键帧交互仍待用户测试。
1.1.0签名构建源码为完整SHAf79d24eb0185f31feaae58b83b632f92dcb3ca91，源码工作区在构建时干净。该节点已独立从大鱼远程克隆，111文件的bytes/blob/mode及16项必要资源一致，strict/full fsck、134项Inspector ASan和模板审计通过，无LFS或子模块，临时克隆已清理。报告见docs/verification/v1.1.0/recovery-f79d24e.json。Apple公证Accepted（ce26be63-9dcd-436a-bcb5-bd294fcc92a9）和票据验证已通过；安装前曾等待用户自行退出宿主，随后完成下述正式替换。
1.1.0（9）现已安装到固定正式路径；APP与嵌套插件为arm64/x86_64通用版本，Developer ID团队、可信时间戳、Hardened Runtime、严格签名、公证票据、Gatekeeper及PluginKit正式路径全部核验通过。配套.moef SHA256为e1c0cff1dd3541ed97cab2cb39a76ad4f28dc659b3be7991cc7ac92dd8ea090b，和TIFF一起同步到正式模板目录并逐字节核对。本次临时/旧APP及公证ZIP已清理；扫描范围和回执在docs/verification/v1.1.0/。最终恢复标签为v1.1.0，后续记录提交不改变签名产品源码f79d24e。原生UI和视觉仍由用户自测。
交付偏好（2026-10-21用户明确更新）：后续本产品安装需释放Motion时，可直接结束Motion进程，不再重复请求保存退出；用户说明不在Motion里进行工作。保持不自动操作Motion/FCP界面的约定。本次检查时两个宿主已经退出，没有执行强退。
1.1.2 合并修复准备
版本1.1.2（13）合并面板action上下文修复和76点短脸/下颌骨局部场。构建/恢复依赖、正式路径、签名公证入口保持不变；自动检查1551项及额外886项真实帧ASan专项通过。原生验收使用build/native-112独立Motion副本，用户素材、截图和完整AX数据不随源码上传。用户已明确授权接手Motion/FCP进行测试；先前不操作界面的偏好已被本次授权更新。
1.1.2 正式恢复入口
发布标签v1.1.2，版本1.1.2（13），正式签名源码完整SHA为a2e33e8e00a99b95dc29d67a819cb0897eda5756；后续交付记录不改变产品源码。独立远程恢复核验149个文件的bytes/blob/mode、16项资源、strict/full fsck和157项Inspector ASan全部通过，无LFS或子模块。恢复依赖与构建入口同前文；PAINTFCP_INSPECTOR_ASAN=1 ./scripts/test-inspector.sh可运行新增数值焦点与每步预览检查。
正式Release已使用固定团队逐层签名，Apple公证Accepted 5f5ce378-8430-467b-ae97-048e6bc81573，票据、Gatekeeper、通用架构和PluginKit正式路径全部通过。唯一正式安装APP为/Library/Plug-Ins/FxPlug/beatygril.app，模板moef SHA256为e9fa97dc14323d0daa7d3d61b06a78ba4000a70ab9f5e67ebffd750d49df1e15，TIFF逐字节一致。临时APP、旧APP和公证ZIP已清理，有界目录及现存Spotlight索引产品路径中仅发现正式APP，扫描错误0，不宣称扫描了所有卷。
Motion/FCP原生验收范围及未完成项见docs/verification/v1.1.2/native-qa.json：数值、重置、隔离短脸/下颌骨响应通过；Motion撤销和保存关闭重开通过。连续步进已改为每步完整宿主action，模拟宿主确认鼠标松开前可发布中间设置；用户于2026-10-22实测确认拖动中持续更新；未指定宿主，未测量逐事件排帧时序。后续人脸素材和全AX只保留本机build，不是产品依赖或上传资源。
最终标签v1.1.2完整提交SHA为e9fddda5e13042f761755762fa39dfe090853c6a，已独立从远端恢复，158文件的bytes/blob/mode与strict/full fsck通过，产品目录与签名源码a2e33e8逐字节一致，无LFS或子模块，恢复临时目录已清理。详见docs/verification/v1.1.2/final-tag-recovery.json；后续main仅补充恢复报告和用户验收记录，产品源码保持不变。
1.2.0 恢复入口
源码构建节点为 696d5f39b30404ed5d1d4c25f61d17475c7fc91b，版本1.2.0（14）。使用同一 Apple SDK、签名团队与正式安装路径；本次仅改变外层启动器、版本及宣传资源，渲染和面板保留1.1.2验收实现。最终安装包和验证记录随 v1.2.0 保存。无 LFS / 子模块。正式 APP 只保留 /Library/Plug-Ins/FxPlug/beatygril.app；源代码不包含私钥。
模板恢复到 ~/Movies/Motion Templates.localized/Effects.localized/大鱼磨皮瘦脸/大鱼人像美化/，需同时保留 .moef、Drop Zone.tiff、large.png、small.png。Git 不保存 BSD 文件标志，手工复制后对两张 PNG 执行 chflags uchg 并核对 ls -lO；不要锁目录和工程。自动安装 PKG 会恢复这两个锁。
仓库已为公开属性，但当前网站 Git 网关仍执行登录 / 会员校验。匿名 ls-remote 未通过，不宣称无需登录的 Git 恢复已通过；认证的远端克隆和文章的公开源码快照分别核验。服务端备份边界与前文相同。
1.2.0 的最终标签完整 SHA 为 3c7261c3a861b9f4704cfb36055d7b500c239dab，已从认证远端独立克隆恢复并比对183个受跟踪文件，strict/full fsck、Xcode工程读取、恢复出的PKG签名和票据验证通过。正式PKG SHA-256 为 5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243。后续main修正发布助手和补充文档，不改变已签名产品源码696d5f3或正式包。
公开文章：https://dayu.media/15593/ ，包含免费安装包、免登录源码快照与仓库链接。源码快照对应 788ba0d5514595cf349af33074055d70b0754185；它包含完整构建源码，排除PKG二进制，不包含Git历史。完整历史可从仓库恢复，仍需满足当前站点Git网关登录条件。
GitHub 公开恢复副本
GitHub 远端 https://github.com/dayumeida/FCP-BeautyGirl.git 已完成完整历史与七个标签的推送，origin 及其 main 上游保持大鱼仓库。独立匿名克隆恢复节点为 356683b41af702d6c0143ad7fa5f540d752d6e14，197 文件逐字节核验、strict/full fsck 和全部标签回读通过。后续 main 补充发布说明与验证文档，产品源码保持相同。GitHub Release 的公证安装包已匿名下载核对哈希、签名和票据。详见 docs/GitHub同步说明.md 和 docs/verification/github/。
1.3.0 新面板参数恢复
签名源码节点 2f2c081980dc610ac810f8daf92da8966f310802 已推送并读回核验 origin 与 github 的 codex/new-beauty-controls 分支。两个远端地址沿用本文既有配置。独立远端克隆与 strict/full fsck、205 个受跟踪文件逐字节比较通过，见 docs/verification/v1.3.0/recovery-verification.json。无 LFS、子模块；依赖与签名凭据仍需单独恢复。
本节点增加五官保护强度、非肤色区保护和局部微细锐化，PGBeautySettings v2 兼容旧 160 字节 v1 状态，面板归档仍为 schema 1。测试命令不变，1636 项通过。恢复签名源码时克隆并切换该分支，或 git switch --detach 2f2c081980dc610ac810f8daf92da8966f310802。
1.3.0（15）已正式安装到 /Library/Plug-Ins/FxPlug/beatygril.app。签名、通用架构、公证票据、Gatekeeper 和 PluginKit 正式路径均通过，已清理本次构建、旧 APP 备份和公证 ZIP。最终回执见 docs/verification/v1.3.0/delivery-receipt.json、installed-verification.json；prepared-release.json 保留安装前状态。v1.3.0 标签包含签名源码及后续交付文档。本次没有生成新 PKG 或更新文章，1.2.0 的公开发行资料继续有效；新滑杆的原生宿主视觉仍由用户测试。
1.3.1 V 脸下颌修复恢复
签名源码完整 SHA 为 7fa3298e022946e77dfd8cfba1bb5ff2c2a6361f，APP 1.3.1（16），分支 codex/v-face-jaw-fix。origin 与 github 同名分支已推送并回读一致。已从 origin 独立克隆该节点，219个受跟踪文件字节和执行位一致、strict/full fsck及Xcode工程读取通过，无LFS或子模块；见 docs/verification/v1.3.1/recovery-verification.json。恢复依赖和签名入口沿用本文现有配置，用户帧和私钥不作为源码依赖保存。
V 脸现在为四组下颌到外唇局部 pin，映射为 V×0.065，无新版目标已取消的旧尺寸增益。此前瘦脸/下巴/短脸/下颌骨仍保留旧版本映射，大眼/窄脸/颧骨/小头和整体组合保留近似边界。1901项全套及1561项重叠真实帧几何ASan通过。Apple公证 Accepted e353b701-2fc2-4fcc-b03e-69af7735400f、staple/validate通过；已在用户确认退出宿主后完成1.3.1正式安装、身份/票据/注册核验和临时副本清理。后续FCP仍有后台进程，通过正常退出菜单结束后才替换APP。PKG由本机PKG工坊CLI制作，包含用户指定分类4项资源，Installer签名、公证Accepted 78105340-306f-4629-8670-772760d4cb9a、票据、Gatekeeper、载荷及隔离脚本均通过；详见同版本交付回执和验证记录。
1.3.1最终发行标签为 v1.3.1，完整SHA b35b4a5d1ca252d2f83c798613560a768274de3c。GitHub已匿名独立克隆恢复并比对232个受跟踪文件的字节/执行位、strict/full fsck和恢复PKG签名/票据；产品源码与签名节点7fa3298完全一致。见 docs/verification/v1.3.1/final-tag-recovery.json。两个远端main纳入该标签后继续记录交付文档，不移动标签。文章15593和GitHub/大鱼Release已更新，GitHub与文章安装包/源码下载字节均校验，完整入口见 docs/GitHub同步说明.md。
GitHub于2026-10-22更正仓库名为 FCP-BeautyGirl，远端为 https://github.com/dayumeida/FCP-BeautyGirl.git。更名后的恢复检查点 6a29d52a9ad667665da4acf75017c008fa0a566d 已通过新地址匿名独立克隆、239个文件字节/执行位和strict/full fsck核验，产品源码与此前正式版相同。Release、附件和原有标签保留，文章及本地远程/仓库目录表均已更新；详见 docs/verification/github/rename-recovery-20261022.json。
GitHub用户名现为 dayumeida，账号ID117798680保持一致。当前公开远端 https://github.com/dayumeida/FCP-BeautyGirl.git 的恢复检查点 2faf7de77929cf7707645ebb38095b03d5729647 已通过匿名独立克隆、241文件字节/执行位和strict/full fsck核验，产品源码与账号更名前一致。两个仓库的全部分支/标签及Release附件均保留；当前文章、本地github远端和仓库目录表已同步。回执见 docs/verification/github/username-recovery-20261022.json。
1.3.2 统一产品身份
发行入口为 v1.3.2；正式 APP 源码为 767bba8ac11e9bf9268a1e02d1a06d3c120c46aa。新机器按 product.json 的工程、scheme 与路径恢复，运行 python3 scripts/deliver.py --wait-for-hosts --user-tests；旧产品先验证 Bundle ID、签名团队和滤镜 UUID，再迁移并支持失败回滚。最终包为 releases/1.3.2/FCP-BeautyGirl-1.3.2.pkg，SHA-256 20a88dacf68cc8812f5af86cfe94c1c0614414a68a019eaeac7ca9d078165ae1，签名、公证 Accepted 4a831775-2317-4372-a4cc-102415657ea3、票据和 Gatekeeper 均通过。正式 APP 已安装并清理旧身份。1901 项自动回归、8 项 APP 迁移、8 项最终 PKG 身份脚本迁移与模板隔离测试通过；未运行真实 installer，原生旧工程重开仍待用户检查。
源码包须从发行标签导出，排除 PKG 二进制并加入 SOURCE-SNAPSHOT.json。发布与独立克隆恢复回执位于 docs/verification/v1.3.2/，不包含用户人脸素材、签名私钥或公证凭据。历史标签和旧版本安装包保留，不覆盖。
1.3.2 发行标签完整 SHA 为 8a70d38b7cd17e0ea530c5226f2be8c2df4308b3。独立匿名 GitHub 克隆 271 个文件的字节/blob/执行位、strict/full fsck、Xcode 工程读取和恢复包签名/票据/Gatekeeper 均通过，无 LFS/子模块，临时克隆已清理。见 docs/verification/v1.3.2/final-tag-recovery.json。GitHub 与文章的安装包、源码快照已匿名下载核对哈希，源 ZIP 对应本标签；后续 main 补充回执，不移动发行标签或改变已签名产品源码。
1.3.2 后续跟踪闪烁分析
分析节点 a0c5357efd87a63dbee6269d9335e6aa3ba78799 保留新目标2.4.0静态证据、实际当前FCP草帽素材的469帧独立采样摘要与两个通用诊断入口；产品源码和安装版仍为v1.3.2，未宣布闪烁修复。独立匿名克隆284文件/fsck/合成诊断重建复现通过，无LFS或子模块。具体运行与边界见 docs/analysis/跟踪闪烁对齐分析.md，用户素材和完整真实关键点不在仓库中。
1.3.3 跟踪稳定链
签名产品源码为 edf64ace6bc17f4db3b2dba71897997809c1029d，工作分支 codex/tracking-stability-240，发行入口 v1.3.3。Release通用APP保持固定身份与路径，公证Accepted 379a432b-ccca-4676-9567-30dc49bb2400；PKG由本机PKG工坊基础包加入已验证的身份迁移脚本后重新签名，公证Accepted 3b44edbb-612d-47b2-8b11-e79874b2c635，4,905,560 bytes，SHA-256 214c109af60bce72046c89ff12b364938b6c00c3a348fa3740dabef661649e0d。包含用户指定“大鱼磨皮瘦脸”分类的moef、Drop Zone.tiff与两张锁定缩略图，payload字节及隔离安装/回滚核验通过；没有执行真实installer。
当前本机正式APP仍为1.3.2，FCP/Motion运行中，待用户保存退出后以 python3 scripts/deliver.py --resume-prepared --wait-for-hosts --user-tests 安装已公证精确构建并清理。新机器不存在本机暂存APP时，从标签恢复并按既有 deliver.py --wait-for-hosts --user-tests 重新编译签名公证，或安装发行PKG；不要复制本机prepared回执当作新机器已安装证明。
独立匿名GitHub克隆签名源码节点304文件字节/模式及strict/full fsck通过，重建跟踪87项和眼部126项；无需目标APP、用户视频或Apple私钥即可运行这两组合成检查。完整正常回归2122项；目标同点坐标场40例最大误差0.005523px。469帧离线草帽采样均通过质量筛选，不能代表原生时间线闪烁已消除。无LFS/子模块；SDK、签名私钥和公证凭据按本文既有说明独立恢复。最终标签恢复与发布回执补充至 docs/verification/v1.3.3/，历史标签不移动。