Add project handoff with verified release and development guidance

README.md

@@ -2,6 +2,8 @@
 
 基于本仓库的 FxPlug4 初始工程制作的人像美化滤镜，支持 Motion 和 Final Cut Pro。源码使用 Objective-C、Vision、Core Image 与 Metal。
 
+代码由 OpenAI + Codex 全程编写，站长仅参与调试和测试。
+
 功能包括磨皮、肤色、细节、牙齿美白、眼睛提亮、九类脸型调整、自动人脸跟随和多人处理。原版 MSE18V2 的静态分析依据、近似实现与尚未对齐的部分见 [分析说明](docs/analysis/REA-分析与复刻说明.md)。本版尚未完成原版逐像素与复杂运动跟踪对照。
 
 ## 使用
@@ -21,7 +23,9 @@ xcodebuild -project beatygril/beatygril.xcodeproj -scheme 'Wrapper Application'
 
 工程从 `/Library/Developer/SDKs/FxPlug.sdk` 读取头文件与链接信息，从 `/Library/Developer/Frameworks` 嵌入可运行的 Apple 框架。构建默认使用团队 B3W25FX5H5 的 Developer ID Application 身份；正式交付使用 `python3 scripts/deliver.py` 完成公证、粘附和安装；安装前先关闭 Motion 与 FCP，脚本在检测到宿主仍运行时保留原安装版并停止。原生验收完成后继续脚本的清理阶段，清除临时注册与 APP 副本。
 
-源码仓库：`https://dayu.media/git/dayu/paintfcp-fxplug.git`。恢复入口见 [RECOVERY.md](RECOVERY.md)，当前验证记录见 [验证记录](docs/验证记录.md)。原始模板保存在 `baseline-20261021` 标签。
+公开源码：[GitHub · FCP-BeatyGril](https://github.com/FAMEDaYu/FCP-BeatyGril)。大鱼站备份：`https://dayu.media/git/dayu/paintfcp-fxplug.git`。恢复入口见 [RECOVERY.md](RECOVERY.md)，当前验证记录见 [验证记录](docs/验证记录.md)。原始模板保存在 `baseline-20261021` 标签。
+
+继续开发或移交时先读[项目交接文档](docs/项目交接.md)，包含当前发布状态、源码入口、坐标与交互约定、验收边界，以及签名打包和双远端保存流程。
 
 ## 1.0.5 瘦脸修复
 
@@ -57,4 +61,4 @@ xcodebuild -project beatygril/beatygril.xcodeproj -scheme 'Wrapper Application'
 
 `large.png`（640×360）和 `small.png`（192×108）与 `.moef` 同目录，安装器安装后重新锁定。手动复制或从 Git 恢复模板时，需对这两个 PNG 重新执行 `chflags uchg`，不能锁定整个模板目录。FCP 当前分类为「大鱼磨皮瘦脸」，Motion 原生滤镜分类仍为「大鱼」。
 
-仓库属性已设为公开；大鱼站统一 Git 网关目前仍要求登录并校验会员，公开属性并未绕过网关。发布文章另提供可公开下载的当前源码快照，不依赖 Git 登录；安装包始终免费。
+GitHub 提供公开源码、提交历史和版本标签；[1.2.0 Release](https://github.com/FAMEDaYu/FCP-BeatyGril/releases/tag/v1.2.0) 提供正式签名公证安装包。大鱼站 Git 备份仍受站点登录与会员网关限制，发布文章另提供公开源码快照；安装包始终免费。

RECOVERY.md

@@ -1,6 +1,7 @@
 # 恢复说明
 
-- 源码远程：`https://dayu.media/git/dayu/paintfcp-fxplug.git`
+- 大鱼备份远程（origin）：`https://dayu.media/git/dayu/paintfcp-fxplug.git`
+- GitHub 公开远程（github）：`https://github.com/FAMEDaYu/FCP-BeatyGril.git`
 - 本地项目根：`/Users/dayu/Documents/PaintFCP`
 - 工作分支：`main`
 - 修改前版本标签：`baseline-20261021`，完整 SHA：`1746f38398588e2367abb37a5c2b31cb64042429`
@@ -96,3 +97,11 @@ Motion/FCP原生验收范围及未完成项见`docs/verification/v1.1.2/native-q
 模板恢复到 `~/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/FAMEDaYu/FCP-BeatyGril.git` 已完成完整历史与七个标签的推送，`origin` 及其 main 上游保持大鱼仓库。独立匿名克隆恢复节点为 `356683b41af702d6c0143ad7fa5f540d752d6e14`，197 文件逐字节核验、strict/full fsck 和全部标签回读通过。后续 main 补充发布说明与验证文档，产品源码保持相同。GitHub Release 的公证安装包已匿名下载核对哈希、签名和票据。详见 `docs/GitHub同步说明.md` 和 `docs/verification/github/`。

THIRD_PARTY_NOTICES.md

@@ -1,10 +1,10 @@
 # 第三方资料与许可边界
 
-本项目自己的 Objective-C、Metal、脚本及原创文档按根目录 MIT License 开源。署名 Dayu 不表示第三方代码、样本与 SDK 的版权转移。
+代码由 OpenAI + Codex 全程编写，站长仅参与调试和测试。项目代码、脚本及文档按根目录 MIT License 提供。署名 Dayu 不表示第三方代码、样本与 SDK 的版权转移。
 
 - Apple FxPlug / PluginManager SDK 和随正式插件分发的运行框架属于 Apple；受 Apple 相应 SDK 与再分发条款约束，源码仓库不包含这些框架。编译需自行安装 Xcode 与 FxPlug SDK。macOS Vision、AppKit、CoreImage 属于系统组件。
 - `Templates/大鱼人像美化/Drop Zone.tiff` 是 Motion 工程的标准占位资源，随模板保留；不将其声明为 Dayu 原创作品或另行授予 MIT 权利。
-- `tests/fixtures/astronaut.png` 来源于 NASA 的 Eileen Collins 图像，经 scikit-image 样本分发，详见同目录 ATTRIBUTION.md。相关分析预览由该公开样本生成。
+- `tests/fixtures/astronaut.png` 来源于 NASA 的 Eileen Collins 图像，经 scikit-image 样本分发，详见同目录 ATTRIBUTION.txt。相关分析预览由该公开样本生成。
 - `docs/analysis` 中的对照分析、符号和反汇编摘录是互操作研究材料，不包括目标商业 APP、模型或 metallib。MIT 不为其原权利人的内容重新授权。本项目不声称与目标商业插件的模型或画面逐像素一致。
 - `Assets/Artwork/portrait-cover.png`、APP 中 `LauncherInfo.png` 及两张模板缩略图由内置图像生成工具创作。人物为虚构成年古风人物，封面是宣传插画，不是真实滤镜前后效果对比；生成说明和提示词见 `docs/design`。未使用目标插件的宣传人像。
 - 不包含用户测试素材、用户工程、真实人脸坐标数据、签名私钥、公证密码或账号令牌。签名证书与公证凭据不属于源码恢复范围。

docs/GitHub同步说明.md

@@ -0,0 +1,23 @@
+# GitHub 同步与恢复
+
+公开源码：https://github.com/FAMEDaYu/FCP-BeatyGril
+
+正式安装包：https://github.com/FAMEDaYu/FCP-BeatyGril/releases/tag/v1.2.0
+
+本地 `github` 远端指向上述 GitHub 仓库，`origin` 继续指向大鱼仓库，`main` 仍跟随 `origin/main`。当前项目的完整提交历史、main 和七个版本标签已推送，两端引用与本地一致；未改写历史或覆盖标签。后续更新需要分别推送到 origin 和 github，不会自动定时同步。
+
+## 已验证的 GitHub 恢复节点
+
+匿名恢复提交：`356683b41af702d6c0143ad7fa5f540d752d6e14`。在关闭凭据助手和交互登录的独立临时目录中成功克隆 GitHub，197 个受跟踪文件逐字节一致、七个标签引用一致，strict/full fsck 通过。正式 PKG 的源码内副本与 GitHub Release 匿名下载副本 SHA-256 相同，下载副本的 Installer 签名与公证票据通过。后续 main 提交补充文章和验证记录，产品源码与该恢复节点一致。
+
+安装包：`Dayu-Portrait-1.2.0.pkg`，5,011,005 bytes，SHA-256 `5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243`。Release 标签 `v1.2.0` 仍指向 `3c7261c3a861b9f4704cfb36055d7b500c239dab`，没有重新编译或改动正式安装包。
+
+```sh
+git clone https://github.com/FAMEDaYu/FCP-BeatyGril.git
+cd FCP-BeatyGril
+git switch --detach 356683b41af702d6c0143ad7fa5f540d752d6e14
+```
+
+本项目没有 LFS 或子模块。编译仍需自行安装 Xcode 和 Apple FxPlug SDK；签名私钥与公证凭据不在 Git 内。GitHub 公共克隆无需登录；大鱼备份仍受站点登录和会员网关限制。两边都只承诺已经提交、推送并核验的节点。
+
+源代码编写署名：代码由 OpenAI + Codex 全程编写，站长仅参与调试和测试。

docs/verification/github/article-update.json

@@ -0,0 +1,17 @@
+{
+  "article_id": 15593,
+  "url": "https://dayu.media/15593/",
+  "status": "publish",
+  "github_repository": "https://github.com/FAMEDaYu/FCP-BeatyGril",
+  "github_release": "https://github.com/FAMEDaYu/FCP-BeatyGril/releases/tag/v1.2.0",
+  "anonymous_frontend_http": 200,
+  "both_github_links_present_in_frontend": true,
+  "code_writing_credit_retained": "代码由 OpenAI + Codex 全程编写，站长仅参与调试和测试。",
+  "resource_price_download_cover_seo_and_author_preserved": true,
+  "only_content_requested": true,
+  "frontend_seo_unique_and_exact": true,
+  "idempotency_key": "55e60cc5-509a-4ae9-ba96-c0d25b2c575a",
+  "before_content_sha256": "2701991a543b80114c062cc7ee68b83afff505dd9456cfe82f0b8819ea81b119",
+  "after_content_sha256": "c66e1ddb374714a938442cd24cf5034482ea4e67d6f8dd79c07d43ba74ad1b1d",
+  "verified_at_utc": "2026-10-21T19:32:48.060004+00:00"
+}

docs/verification/github/preflight.json

@@ -0,0 +1,15 @@
+{
+  "target": "https://github.com/FAMEDaYu/FCP-BeatyGril.git",
+  "source_commit": "dffa547d92478dd471fb4926579df91084581756",
+  "all_reachable_blobs_scanned": 406,
+  "secret_pattern_matches": [],
+  "package_sha256": "5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243",
+  "connector_target_push_permission": false,
+  "local_https_credential_present": false,
+  "status": "prepared_waiting_for_GitHub_write_authentication",
+  "github_visibility": "public",
+  "github_repository_id": "1428817365",
+  "github_repository_initial_state": "empty",
+  "origin_retained": "https://dayu.media/git/dayu/paintfcp-fxplug.git",
+  "github_remote_added": true
+}

docs/verification/github/push.json

@@ -0,0 +1,19 @@
+{
+  "repository": "https://github.com/FAMEDaYu/FCP-BeatyGril",
+  "repository_id": 1428817365,
+  "visibility": "public",
+  "source_commit": "356683b41af702d6c0143ad7fa5f540d752d6e14",
+  "local_refs": {
+    "refs/heads/main": "356683b41af702d6c0143ad7fa5f540d752d6e14",
+    "refs/tags/baseline-20261021": "4124c350ce288b5fa3cf843ec0e9751e9db19b4c",
+    "refs/tags/v1.0.4": "302dc20c0a90c0b8934c4341d65c2467d4ed3386",
+    "refs/tags/v1.0.5": "1008651f6e2111a26d1420021c49f40d6f728b3a",
+    "refs/tags/v1.0.6": "5793e3de499bfe320b5e9a9db16ef7bc79a5243d",
+    "refs/tags/v1.1.0": "3bb33818eaa8033b8b1d140eb64e31f38ec3fa75",
+    "refs/tags/v1.1.2": "e9fddda5e13042f761755762fa39dfe090853c6a",
+    "refs/tags/v1.2.0": "3c7261c3a861b9f4704cfb36055d7b500c239dab"
+  },
+  "github_refs_verified": true,
+  "main_upstream_retained": "origin",
+  "auth_storage": "macOS keyring through GitHub CLI; no token included"
+}

docs/verification/github/recovery.json

@@ -0,0 +1,14 @@
+{
+  "remote": "https://github.com/FAMEDaYu/FCP-BeatyGril.git",
+  "anonymous_clone": true,
+  "credentials_disabled_for_clone": true,
+  "commit": "356683b41af702d6c0143ad7fa5f540d752d6e14",
+  "tracked_files_compared": 197,
+  "all_tag_refs_equal": true,
+  "tag_count": 7,
+  "git_fsck_full_strict": true,
+  "package_sha256": "5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243",
+  "lfs": false,
+  "submodules": false,
+  "temporary_clone_removed": true
+}

docs/verification/github/release.json

@@ -0,0 +1,18 @@
+{
+  "repository": "FAMEDaYu/FCP-BeatyGril",
+  "url": "https://github.com/FAMEDaYu/FCP-BeatyGril/releases/tag/v1.2.0",
+  "release_id": 419972270,
+  "tag": "v1.2.0",
+  "draft": false,
+  "prerelease": false,
+  "asset": {
+    "id": 663571667,
+    "name": "Dayu-Portrait-1.2.0.pkg",
+    "size": 5011005,
+    "digest": "sha256:5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243",
+    "browser_download_url": "https://github.com/FAMEDaYu/FCP-BeatyGril/releases/download/v1.2.0/Dayu-Portrait-1.2.0.pkg"
+  },
+  "sha256": "5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243",
+  "anonymous_asset_download_hash_matches": true,
+  "downloaded_pkg_signature_and_ticket_valid": true
+}

docs/verification/v1.2.0/article-attribution-update.json

@@ -0,0 +1,36 @@
+{
+  "article_id": 15593,
+  "url": "https://dayu.media/15593/",
+  "status": "publish",
+  "updated_fields": [
+    "content"
+  ],
+  "attribution": "代码由 OpenAI + Codex 全程编写，站长仅参与调试和测试。",
+  "removed_original_authorship_wording": true,
+  "anonymous_frontend_http": 200,
+  "frontend_attribution_verified": true,
+  "unrelated_settings_unchanged": true,
+  "preserved": [
+    "title",
+    "author account (article publisher)",
+    "excerpt",
+    "categories",
+    "tags",
+    "featured_media",
+    "resource including all free-download settings and URLs",
+    "seo",
+    "fcpx configuration",
+    "installation instructions and native code block"
+  ],
+  "automatic_derived_change": {
+    "field": "fcpx.article_state.checked_at",
+    "before": "2026-10-22 01:52:41",
+    "after": "2026-10-22 02:01:36",
+    "meaning": "Content save hook refreshed check timestamp; sync remains disabled."
+  },
+  "frontend_seo_exact_and_unique": true,
+  "idempotency_key": "66b51f0d-24ed-4ed9-82fd-e61e626cec4b",
+  "before_content_sha256": "5968a343e8a9116a5adb7885eafd487acb23608be32d422144196454b1434290",
+  "after_content_sha256": "2701991a543b80114c062cc7ee68b83afff505dd9456cfe82f0b8819ea81b119",
+  "verification_time_utc": "2026-10-21T18:02:35.974219+00:00"
+}

docs/verification/v1.2.0/final-copy-inventory.json

@@ -0,0 +1,17 @@
+{
+  "roots": [
+    "/Applications",
+    "/Library/Plug-Ins/FxPlug",
+    "/Users/dayu/Library/Plug-Ins/FxPlug",
+    "/Users/dayu/Documents/PaintFCP",
+    "/tmp/paintfcp-build-20261021"
+  ],
+  "product_paths": [
+    "/Library/Plug-Ins/FxPlug/beatygril.app"
+  ],
+  "errors": [],
+  "removed": [
+    "build/pkg-expanded"
+  ],
+  "scope": "bounded scan; not all mounted volumes"
+}

docs/verification/v1.2.0/final-tag-recovery.json

@@ -0,0 +1,13 @@
+{
+  "tag": "v1.2.0",
+  "commit": "3c7261c3a861b9f4704cfb36055d7b500c239dab",
+  "files_verified": 183,
+  "fsck_full_strict": true,
+  "package_sha256": "5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243",
+  "recovered_package_signature_and_ticket": true,
+  "xcode_project_readable": true,
+  "lfs": false,
+  "submodules": false,
+  "authentication": "saved member Git credential; anonymous gateway access remains restricted",
+  "temporary_clone_removed": true
+}

docs/verification/v1.2.0/final-thumbnail-locks.json

@@ -0,0 +1,22 @@
+[
+  {
+    "path": "/Users/dayu/Documents/PaintFCP/Templates/大鱼人像美化/large.png",
+    "uchg": true,
+    "sha256": "a02ddb255b1ae255c749bb837a759e2dee1c3b8ffb9bdc1167957761bd5a1b97"
+  },
+  {
+    "path": "/Users/dayu/Documents/PaintFCP/Templates/大鱼人像美化/small.png",
+    "uchg": true,
+    "sha256": "1552b838dd88f60dee0795e20aaca652f9c558ecefc93500e895fbff77c2a4d5"
+  },
+  {
+    "path": "/Users/dayu/Movies/Motion Templates.localized/Effects.localized/大鱼磨皮瘦脸/大鱼人像美化/large.png",
+    "uchg": true,
+    "sha256": "a02ddb255b1ae255c749bb837a759e2dee1c3b8ffb9bdc1167957761bd5a1b97"
+  },
+  {
+    "path": "/Users/dayu/Movies/Motion Templates.localized/Effects.localized/大鱼磨皮瘦脸/大鱼人像美化/small.png",
+    "uchg": true,
+    "sha256": "1552b838dd88f60dee0795e20aaca652f9c558ecefc93500e895fbff77c2a4d5"
+  }
+]

docs/verification/v1.2.0/publication-verification.json

@@ -0,0 +1,59 @@
+{
+  "article_id": 15593,
+  "url": "https://dayu.media/15593/",
+  "status": "publish",
+  "anonymous_http": 200,
+  "category": 3,
+  "free_for_all": true,
+  "featured_media": 15595,
+  "native_code_block_present": true,
+  "seo_tags": {
+    "title": [
+      "大鱼人像美化 1.2.0｜FCP / Motion 免费开源自动美颜插件"
+    ],
+    "description": [
+      "大鱼人像美化是适用于 Final Cut Pro 和 Motion 的免费开源 FxPlug4 插件，支持磨皮、美白、自动人脸跟随及瘦脸调整。提供 Apple 签名公证 PKG 安装包和源码，安装自动注册，无需激活码，并附具体安装、使用及红色警告排查说明。"
+    ],
+    "keywords": [
+      "大鱼人像美化,FCP美颜插件,Motion磨皮,自动瘦脸,自动跟随,FxPlug4,免费开源"
+    ],
+    "unique_and_exact": true
+  },
+  "assets": [
+    {
+      "role": "package",
+      "url": "https://dayu.media/wp-content/uploads/2026/10/1792604749-1ea4dca3cc5a5c3.pkg",
+      "anonymous_http": 200,
+      "bytes": 5011005,
+      "sha256": "5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243",
+      "matches_local": true
+    },
+    {
+      "role": "source",
+      "url": "https://dayu.media/wp-content/uploads/2026/10/1792604741-f6e09da5b67c006.zip",
+      "anonymous_http": 200,
+      "bytes": 9607987,
+      "sha256": "a235fb3168c09a1e3a4fc5f347b3957cbd9ee2a1c3848e2af1dda2e64afbb870",
+      "matches_local": true
+    },
+    {
+      "role": "cover",
+      "url": "https://dayu.media/wp-content/uploads/2026/10/1792604750-357ca780597c39f.png",
+      "anonymous_http": 200,
+      "bytes": 2776027,
+      "sha256": "a346f06e7793b4e5483ccd4b3b86f34c2036bbe6bbddb7ad9cc70c47e7d014ab",
+      "matches_local": true
+    },
+    {
+      "role": "card",
+      "url": "https://dayu.media/wp-content/uploads/2026/10/1792604743-1c99c2ba53c7614.png",
+      "anonymous_http": 200,
+      "bytes": 3065968,
+      "sha256": "239552eeea738a32fafa70922d3cd1d4c115ff75d672574fa4c5acd941381fba",
+      "matches_local": true
+    }
+  ],
+  "source_article_click_anonymous_verified": true,
+  "fcpx_app_sync_requested": false,
+  "git_visibility": "Gitea public attribute verified; anonymous gateway access still requires membership as disclosed in article"
+}

docs/verification/v1.2.0/published-article.json

@@ -0,0 +1,85 @@
+{
+  "article": {
+    "id": 15593,
+    "url": "https://dayu.media/15593/",
+    "edit_url": "https://dayu.media/wp-admin/post.php?post=15593&action=edit",
+    "status": "publish",
+    "title": "大鱼人像美化 1.2.0：FCP / Motion 免费开源自动美颜插件",
+    "content": "<!-- wp:paragraph -->\n<p>大鱼人像美化是一款适用于 Final Cut Pro 与 Motion 的免费开源人像插件，把磨皮、美白和脸型调整放进同一块原生卡片面板。插件会识别当前画面中的人脸并自动跟随，无需先点击分析；你可以按素材需要调整强度，拖动滑杆时持续查看效果。</p>\n<!-- /wp:paragraph -->\n<!-- wp:paragraph -->\n<p><strong>代码由 OpenAI + Codex 全程编写，站长仅参与调试和测试。</strong></p>\n<!-- /wp:paragraph -->\n\n<!-- wp:image {\"sizeSlug\":\"full\"} -->\n<figure class=\"wp-block-image size-full\"><img src=\"https://dayu.media/wp-content/uploads/2026/10/1792604750-357ca780597c39f.png\" alt=\"大鱼人像美化古风宣传封面，展示自动瘦脸、自动跟随与自动美颜\" /><figcaption class=\"wp-element-caption\">古风宣传插画；面部线条用于示意瘦脸与跟随功能。</figcaption></figure>\n<!-- /wp:image -->\n\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">可以做什么</h2>\n<!-- /wp:heading -->\n\n<!-- wp:list {\"className\":\"wp-block-list\"} -->\n<ul class=\"wp-block-list\"><!-- wp:list-item -->\n<li>磨皮：局部磨皮、全局磨皮与五官保护，强度分别控制。</li>\n<!-- /wp:list-item -->\n\n<!-- wp:list-item -->\n<li>美白：肤色预设、肤色亮度、皮肤色相和牙齿美白。</li>\n<!-- /wp:list-item -->\n\n<!-- wp:list-item -->\n<li>脸型：瘦脸、大眼、短脸、窄脸、下巴、V 脸、下颌骨、颧骨与小头调整。</li>\n<!-- /wp:list-item -->\n\n<!-- wp:list-item -->\n<li>自动跟随：默认跟随主要人脸，也提供多人模式、防跳脸范围与检测框预览。</li>\n<!-- /wp:list-item -->\n\n<!-- wp:list-item -->\n<li>实时预览：滑杆、数值、单项开关和重置集中在同一面板，便于反复对比。</li>\n<!-- /wp:list-item --></ul>\n<!-- /wp:list -->\n\n<!-- wp:paragraph -->\n<p>自动识别负责定位处理区域，效果强度由你控制。建议先从较小的数值开始；多人交叉、严重遮挡和极端侧脸的结果需要结合具体素材检查。</p>\n<!-- /wp:paragraph -->\n\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">版本与下载</h2>\n<!-- /wp:heading -->\n\n<!-- wp:paragraph -->\n<p>当前版本 <strong>1.2.0（14）</strong>，支持 macOS 13 或更高版本，包含 Apple Silicon 与 Intel 两种架构。下载包包含 FxPlug4 程序和一个配套 FCP 效果模板。APP 与 PKG 均已完成 Developer ID 正式签名、Apple 公证和票据粘附；安装包为所有用户免费资源。</p>\n<!-- /wp:paragraph -->\n\n<!-- wp:paragraph -->\n<p>本次更新加入古风封面与锁定缩略图、免费开源说明页和主 APP 三秒自动退出。人脸处理与面板交互沿用 1.1.2 已验收实现，不需要重新运行手动分析。</p>\n<!-- /wp:paragraph -->\n\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">安装</h2>\n<!-- /wp:heading -->\n\n<!-- wp:paragraph -->\n<p>安装前先保存工作并退出 Final Cut Pro 和 Motion，安装期间保持关闭。运行本页提供的 PKG，按安装器提示完成安装；它会把程序安装到 <code>/Library/Plug-Ins/FxPlug/beatygril.app</code>，把配套效果安装到当前登录用户的 Motion Templates 目录，并自动验证和修复系统插件注册。</p>\n<!-- /wp:paragraph -->\n\n<!-- wp:paragraph -->\n<p>本插件免费开源，<strong>无需激活码、付费注册或账号授权</strong>。主 APP 打开时显示说明图，窗口显示三秒后自动退出；宿主中的滤镜由独立服务运行。安装器还会重新锁定两张缩略图，避免被宿主自动替换。</p>\n<!-- /wp:paragraph -->\n\n<!-- wp:image {\"sizeSlug\":\"full\"} -->\n<figure class=\"wp-block-image size-full\"><img src=\"https://dayu.media/wp-content/uploads/2026/10/1792604743-1c99c2ba53c7614.png\" alt=\"主程序说明页：免费开源，自动注册，无需激活码，启动三秒后自动退出\" /></figure>\n<!-- /wp:image -->\n\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">使用</h2>\n<!-- /wp:heading -->\n\n<!-- wp:paragraph -->\n<p>Final Cut Pro：打开<strong>效果</strong>浏览器，找到<strong>大鱼磨皮瘦脸</strong>分类，将<strong>大鱼人像美化</strong>添加到人像片段。Motion：在原生滤镜资源库的<strong>大鱼</strong>分类中选择<strong>大鱼人像美化</strong>。</p>\n<!-- /wp:paragraph -->\n\n<!-- wp:paragraph -->\n<p>在检查器中按需调节磨皮、美白和脸型。每项左侧的眼睛可暂时停用该项，数值会保留；右侧回转箭头用于重置。人脸会随画面自动更新，开启检测框预览可以检查跟随位置。多人模式建议先用短片段观察稳定性。</p>\n<!-- /wp:paragraph -->\n\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">常见问题</h2>\n<!-- /wp:heading -->\n\n<!-- wp:paragraph -->\n<p>如果效果没有出现或显示红色警告，先退出 Final Cut Pro 和 Motion，Line truncated
+    "excerpt": "磨皮、美白、瘦脸与自动人脸跟随，原生卡片面板实时预览。免费开源，自动注册，无需激活码；提供签名公证安装包和源码。",
+    "author": 1,
+    "categories": [
+      3
+    ],
+    "tags": [],
+    "featured_media": 15595,
+    "resource": {
+      "cao_status": "1",
+      "cao_close_novip_pay": "0",
+      "cao_is_boosvip": "",
+      "cao_video": "",
+      "cao_is_video_free": "",
+      "cao_price": "0",
+      "cao_vip_rate": "1",
+      "cao_ref_bonus_rate": "0.25",
+      "cao_expire_day": "0",
+      "cao_downurl": "https://dayu.media/wp-content/uploads/2026/10/1792604749-1ea4dca3cc5a5c3.pkg",
+      "cao_downurl_bak": "",
+      "cao_demourl": "",
+      "video_url": "",
+      "video_poster_url": "",
+      "cao_pwd": "",
+      "cao_original_filename": "1792604749-1ea4dca3cc5a5c3.pkg",
+      "post_style": "sidebar",
+      "cao_info": [
+        {
+          "title": "版本",
+          "desc": "1.2.0（14）"
+        },
+        {
+          "title": "宿主",
+          "desc": "Final Cut Pro / Motion"
+        },
+        {
+          "title": "系统",
+          "desc": "macOS 13 或更高版本"
+        },
+        {
+          "title": "架构",
+          "desc": "Apple Silicon / Intel"
+        },
+        {
+          "title": "授权",
+          "desc": "免费开源，无需激活码"
+        }
+      ]
+    },
+    "seo": {
+      "title": {
+        "enabled": true,
+        "value": "大鱼人像美化 1.2.0｜FCP / Motion 免费开源自动美颜插件"
+      },
+      "description": {
+        "enabled": true,
+        "value": "大鱼人像美化是适用于 Final Cut Pro 和 Motion 的免费开源 FxPlug4 插件，支持磨皮、美白、自动人脸跟随及瘦脸调整。提供 Apple 签名公证 PKG 安装包和源码，安装自动注册，无需激活码，并附具体安装、使用及红色警告排查说明。"
+      },
+      "keywords": {
+        "enabled": true,
+        "value": "大鱼人像美化,FCP美颜插件,Motion磨皮,自动瘦脸,自动跟随,FxPlug4,免费开源"
+      }
+    },
+    "fcpx": {
+      "enabled": "0",
+      "kinds": [],
+      "version": "",
+      "entry": "",
+      "article_state": {
+        "code": "hidden",
+        "message": "未同步到 APP",
+        "checked_at": "2026-10-22 03:32:39"
+      },
+      "file_check": "",
+      "product_id": ""
+    }
+  }
+}

docs/verification/v1.2.0/repository-release-asset.json

@@ -0,0 +1,8 @@
+{
+  "id": 1,
+  "name": "Dayu-Portrait-1.2.0.pkg",
+  "size": 5011005,
+  "browser_download_url": "https://dayu.media/git/attachments/2d27be42-6380-421c-8475-7524574ec889",
+  "uuid": "2d27be42-6380-421c-8475-7524574ec889",
+  "created_at": "2026-10-22T01:48:05+08:00"
+}

docs/verification/v1.2.0/repository-release.json

@@ -0,0 +1,10 @@
+{
+  "id": 128,
+  "tag_name": "v1.2.0",
+  "name": "大鱼人像美化 1.2.0",
+  "html_url": "https://dayu.media/git/dayu/paintfcp-fxplug/releases/tag/v1.2.0",
+  "url": "https://dayu.media/git/api/v1/repos/dayu/paintfcp-fxplug/releases/128",
+  "draft": false,
+  "prerelease": false,
+  "body": "大鱼人像美化 1.2.0（14）\n\n免费开源。自动跟随、人像磨皮、美白和脸型调整。新增古风宣传封面与缩略图，主 APP 显示免费开源说明并在窗口显示三秒后退出。\n\nAPP 和 PKG 均已正式签名、Apple 公证并粘附票据。\n\n免费安装包与免 Git 登录源码快照：https://dayu.media/15593/\n\n安装包仓库位置：releases/1.2.0/大鱼人像美化-1.2.0.pkg\nSHA-256：5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243\n\n当前站点 Git 网关仍需登录；仓库公开属性已设为 public，站外读者可通过文章免费下载源码快照。"
+}

docs/verification/v1.2.0/source-click-download.json

@@ -0,0 +1,9 @@
+{
+  "source_click_url": "https://dayu.media?cao_direct_download=1&file_url=https%3A%2F%2Fdayu.media%2Fwp-content%2Fuploads%2F2026%2F10%2F1792604741-f6e09da5b67c006.zip",
+  "http": 200,
+  "content_type": "application/octet-stream",
+  "final_url": "https://dayu.media?cao_direct_download=1&file_url=https%3A%2F%2Fdayu.media%2Fwp-content%2Fuploads%2F2026%2F10%2F1792604741-f6e09da5b67c006.zip",
+  "bytes": 9607987,
+  "sha256": "a235fb3168c09a1e3a4fc5f347b3957cbd9ee2a1c3848e2af1dda2e64afbb870",
+  "click_download_matches_source": true
+}

docs/verification/v1.2.0/source-snapshot.json

@@ -0,0 +1,8 @@
+{
+  "commit": "788ba0d5514595cf349af33074055d70b0754185",
+  "files": 182,
+  "package_excluded": true,
+  "filename": "Dayu-Portrait-1.2.0-source.zip",
+  "bytes": 9607987,
+  "sha256": "a235fb3168c09a1e3a4fc5f347b3957cbd9ee2a1c3848e2af1dda2e64afbb870"
+}

docs/项目交接.md

@@ -0,0 +1,274 @@
+# 大鱼人像美化项目交接
+
+更新时间：2026-10-22，Asia/Shanghai。项目根目录：`/Users/dayu/Documents/PaintFCP`。
+
+当前正式版本为 **1.2.0（构建 14）**，APP 与 PKG 均已完成正式签名、公证和票据验证，APP 已安装，公开源码及文章已发布。没有待完成的发布阻塞项；后续工作应从新的用户反馈或下述已知差异继续，不必重新制作封面、重发文章或重复安装现有版本。
+
+代码由 **OpenAI + Codex 全程编写，站长仅参与调试和测试**。文章和仓库须保留这个表述，不使用“站长原创代码”等说法。免费版本无需账号、激活码或付费授权；“自动注册”指系统插件注册。
+
+本交接整理前，工作区干净，`main`、`origin/main` 与 `github/main` 均为 `189a5d7634aa69db54330c90f8711b05d8e44b10`。这是文档新增前的基线；最新文档节点以 `git log -1` 和远端引用为准。
+
+## 先读和先查
+
+接手时先查看 `git status --short --branch`、`git remote -v` 和最新提交，确认没有其他聊天的未提交改动。只读核对正式 APP 版本与模板目录，再决定是否需要编译或操作宿主。单纯修改文档不需要重建、重新公证或打开 Motion/FCP。
+
+当前状态以本交接、[恢复说明](../RECOVERY.md)、[验证记录](验证记录.md) 和最新版本回执为入口。`docs/analysis` 与旧版本回执保留了研究过程，其中“待修复”“待测试”可能是历史状态；例如 1.2.0 的 `release-plan.md` 是发布前计划，实际完成情况看 `native-qa.json` 和交付回执。
+
+| 入口 | 用途 |
+| --- | --- |
+| [README](../README.md) | 产品介绍、使用与版本变化 |
+| [恢复说明](../RECOVERY.md) | 精确源码节点、依赖、远端恢复记录 |
+| [GitHub 同步说明](GitHub同步说明.md) | 两个远端、公开克隆及 Release 验证 |
+| [1.2.0 交付回执](verification/v1.2.0/delivery-receipt.json) | 签名源码、公证、正式安装与清理结果 |
+| [1.2.0 原生验收](verification/v1.2.0/native-qa.json) | 启动器与 FCP 实测范围 |
+| [1.1.2 原生验收](verification/v1.1.2/native-qa.json) | 面板、短脸、下颌骨和连续预览验收 |
+| [第三方资料与许可](../THIRD_PARTY_NOTICES.md) | MIT 范围、Apple 依赖与宣传素材边界 |
+
+## 固定身份与安装位置
+
+| 项目 | 当前值 |
+| --- | --- |
+| 显示名称 | 大鱼人像美化 |
+| Xcode 产品名 | `beatygril`，保留现有拼写 |
+| APP 版本 | `1.2.0` / `14`，arm64 与 x86_64 通用版本 |
+| 唯一正式 APP | `/Library/Plug-Ins/FxPlug/beatygril.app` |
+| 主 Bundle ID | `com.dayu.beatygril` |
+| 嵌套插件 | `Contents/PlugIns/beatygril XPC Service.pluginkit` |
+| 插件 Bundle ID | `com.dayu.beatygril.fxplug` |
+| 滤镜 UUID | `FB14B0E6-59B2-4836-916F-CD0C559E9241` |
+| 自定义面板参数 ID | `210` |
+| FCP 效果分类 | 大鱼磨皮瘦脸 → 大鱼人像美化 |
+| Motion 原生滤镜分类 | 大鱼 → 大鱼人像美化 |
+| 签名团队 | `B3W25FX5H5` |
+
+当前 FCP 模板为：
+
+```text
+/Users/dayu/Movies/Motion Templates.localized/Effects.localized/大鱼磨皮瘦脸/大鱼人像美化/大鱼人像美化.moef
+```
+
+源码模板仍在 `Templates/大鱼人像美化/`，脚本和测试使用这个路径。磁盘安装分类与源码目录层级不同是有意保留。旧的 `Effects.localized/大鱼/大鱼人像美化` 不是当前安装位置。
+
+不要在 `/Applications`、用户级 FxPlug、Debug 或其他目录再留同产品外层 APP。替换前核对 Bundle ID 和来源；嵌套插件、Framework 及安装包内封装的有效载荷不属于重复安装。
+
+## 源码结构
+
+Xcode 工程：`beatygril/beatygril.xcodeproj`。外层 scheme 为 `Wrapper Application`，插件 target 为 `XPC Service`。
+
+下表插件文件均位于 `beatygril/beatygril/Plugin/`。
+
+| 文件或目录 | 职责与修改入口 |
+| --- | --- |
+| `beatygrilPlugIn.m` | FxPlug 参数、宿主 action、图像适配、渲染状态与整体混合 |
+| `PGFaceProcessor.m` | Vision 检测、76 点、自动跟随、几何稳定、局部变形和几何蒙版 |
+| `PGBeautyRenderer.m` | 磨皮、肤色、细节、牙齿和眼睛等外观处理 |
+| `PGInspectorView.m` | AppKit 卡片、滑杆、数值框、开关、重置和连续提交 |
+| `PGInspectorState.m` | 面板完整状态、NSSecureCoding、复制与插值 |
+| `PGFaceSelectOSC.m` | 画布选脸与检测框等屏幕控件 |
+| `PGParameterIDs.h`、`PGBeautyTypes.h` | 稳定参数 ID 和共享设置结构 |
+| `../Wrapper Application/AppDelegate.m` | 主 APP 说明图、系统注册与三秒退出 |
+| `../Wrapper Application/Resources/LauncherInfo.png` | 主 APP 古风说明图 |
+| `Templates/大鱼人像美化/`（仓库根） | FCP 效果工程、标准占位图及缩略图 |
+| `tests/`、`scripts/test*.sh`（仓库根） | 离屏像素、几何、宿主适配与面板测试 |
+
+几何和外观内核由 Objective-C 源码构造 Core Image kernel；没有复制目标插件的 metallib 或私有模型。Xcode 使用文件系统同步分组，添加文件时核对 target 排除项，防止把插件实现编入外层 APP，或把启动器资源与 `AppDelegate.m` 编入插件。
+
+## 自动跟随与脸型修复
+
+### 识别和转脸
+
+当前使用 Apple Vision `VNDetectFaceLandmarksRequestRevision3` 与 `VNRequestFaceLandmarksConstellation76Points`。实时渲染自动检测并关联主要人脸，结合防跳范围、关键点稳定、失检保持和几何历史；不需要先点击分析。多人模式另走多人几何处理。
+
+目标插件的静态证据支持 Vision 点阵与局部二维变形，已检查的瘦脸路径没有证明存在显式 yaw 切换或完整 3D 姿态模型。侧脸适应主要来自轮廓与五官点随姿态改变，不能宣称已确定某个第三方神经网络或完全恢复原版模型。证据入口见[脸型与转脸分析](analysis/脸型变形与转脸分析.md)和[自动跟随报告](analysis/auto-follow-report.json)。
+
+本项目几何历史只取当前请求之前的近时记录，原版还存在近未来历史分支；冷启动、热缓存、乱序渲染、同尺寸换源和多人交叉仍有差异边界。旧离线分析字段保留兼容，但当前新面板的渲染统一使用实时自动跟随。
+
+### 已完成的四项局部算法
+
+| 控制项 | 当前实现 | 防止回归的要点 |
+| --- | --- | --- |
+| 瘦脸 | 76 点、17 组轮廓到鼻部或瞳孔锚点的局部逆向采样 | 不恢复整脸框水平挤压；保留尺寸增益、组顺序和逐步 clamp |
+| 下巴 | `68→38`、`67→37`、`66→36` 三组局部位移 | 正值上收、负值延伸，保留正负不同系数 |
+| 下颌骨 | 六组相邻轮廓半径的顺序局部位移 | 半径来自相邻轮廓点，方向锚点为 P29；不能同时求和替代逐步更新 |
+| 短脸 | P62 至 P72 的下半脸闭合区域，沿 P46−P48 鼻梁轴位移 | 正值收短、负值延长；不是太阳穴区域或脸框纵向压缩 |
+
+这四项共享由实际图像像素尺寸计算的增益。完整合法 76 点缺失时，四项安全直通，不退回猜测的脸框场。图像与磨皮、肤色、牙齿、眼睛蒙版共用几何变形路径，避免效果与蒙版错位。
+
+**仍为近似实现的五项：大眼、窄脸、V 脸、颧骨、小头。** 原版完整链为 `thin → narrow → V → jaw → cheek → chin → short → small-head → eyes`，本项目尚未完全恢复整条组合链的数学及顺序。用户单项验收不代表所有参数组合逐像素等价。详细索引、系数和独立数值场验证见[下巴与坐标分析](analysis/下巴与坐标分析.md)、[短脸与下颌骨分析](analysis/短脸与下颌骨分析.md)。
+
+### 坐标约定
+
+宿主 CI/IOSurface 链统一按 Y 向上处理；归档坐标标记为 `hostCoordinateSpace=iosurface-ci-y-up-v1`。不要仅看到 `TOP_LEFT` 标志就再翻转图像。局部几何中需要的归一化 Y 向下 UV 在同一 kernel 内成对转换，不改变宿主图像方向。
+
+旧无标记分析档案不能靠补字符串伪装为新坐标。涉及位置的修改应同时检查非零 extent、图像宽高比、真实侧脸、歪头、正负参数和上下原点标签。历史“下巴作用在眼睛”“短脸和下颌骨作用在太阳穴”的问题已有相应修复，不应再用移动检测框来掩盖坐标或点索引问题。
+
+## 面板与连续预览
+
+界面由 AppKit 自绘磨皮、美白、瘦脸卡片及原生输入控件构成。FCP 模板只发布自定义面板 210 和两项署名信息，手动分析和多余平铺参数已隐藏；隐藏参数 ID 与旧归档仍须保留，以免破坏工程兼容。
+
+面板交互必须在真实视图对应的 **宿主 action 内** 获取读写接口，不能缓存接口后在 action 外使用。每个发生变化的拖动步进都要在松手之前完成自己的 action；把整次拖动包在一个直到 mouse-up 才结束的 action 中，会再次造成松手后才更新。重复相同步进可去重。
+
+`PGInspectorState` 保存完整且可安全归档的状态。未编辑面板时兼容旧文档参数，首次编辑采集当前设置；旧版各项独立关键帧曲线尚未自动迁移为新面板曲线。修改时同时检查数值 Return 提交、焦点切换、单项重置、宿主撤销和保存重开，不只看滑杆外观。
+
+用户于 2026-10-22 明确确认“拖动中已持续更新”。该回复未指定宿主，覆盖至少一个原生宿主的按住拖动体验；宿主调度可能合并快速更新，不能写成每个鼠标事件必定显示一帧。
+
+## 验证状态与开发命令
+
+在项目根执行：
+
+```sh
+./scripts/test.sh
+PAINTFCP_HOST_ASAN=1 ./scripts/test-host.sh
+PAINTFCP_OSC_ASAN=1 ./scripts/test-osc.sh
+PAINTFCP_INSPECTOR_ASAN=1 ./scripts/test-inspector.sh
+python3 scripts/inspector-template.py audit 'Templates/大鱼人像美化/大鱼人像美化.moef'
+```
+
+1.1.2 完整回归为 **1551 项**：Beauty 49、Face 116、几何 796、宿主适配 ASan 335、OSC ASan 98、Inspector ASan 157。额外真实帧 ASan 专项 886 项包含重复基础用例，未计入 1551。28 种控制与原点组合核对了解剖位置，改变原点标签时输出逐字节一致。详见[自动验证汇总](verification/v1.1.2/automated-tests.json)。
+
+| 验证范围 | 已完成结果与边界 |
+| --- | --- |
+| Motion 1.1.2 | 正式插件、数值输入、重置、撤销、焦点和保存关闭重开；短脸与下颌骨隔离画面检查 |
+| FCP 1.1.2 | 正式面板启用、数值与重置；短脸和下颌骨分别隔离渲染，画面有响应 |
+| 连续预览 | 模拟宿主确认 mouse-up 前发布中间状态；用户实际拖动已确认 |
+| 主 APP 1.2.0 | 古风说明图和无障碍文字正确，窗口显示后计时三秒退出，系统注册成功 |
+| FCP 1.2.0 | 新启动后显示新缩略图，QA 工程加载滤镜、亮度调到 20%，画面正常无黑屏 |
+| Motion 1.2.0 | 未重新进行该版界面视觉验收；渲染和面板源码沿用已验收 1.1.2 |
+| 安装包 | 有效载荷与正式 APP、四个模板文件一致；隔离脚本验证初装、替换锁定图和失败回滚 |
+
+1.2.0 只修改外层启动器、版本与宣传资源，没有重新运行全部 1.1.2 自动测试，不能把历史测试写成该版全量重跑。原生 VoiceOver、旧独立关键帧迁移、多脸交叉、重遮挡和所有极端姿态仍未完整验收。
+
+现有 PKG **未通过真实 installer 再次安装到当前用户目录**：APP 由 `deliver.py` 安装，缩略图另行同步；PKG 的安装脚本在隔离目录执行，重定向用户身份、替代 chown 并跳过其中的真实 FxPlug 验证。正式 APP 的签名与发现另有真实验证。不要把隔离测试表述成完整系统安装实测。
+
+用户测试视频位于：
+
+```text
+/Volumes/DayuMedia 4TB/LCQ荒野乱斗/LCQ赛事回放/teen-with-blue-hair-smiling-at-beach-2026-10-02-18-55-48-utc.mov
+```
+
+该视频、宿主 QA 工程、截图、完整 AX 和人脸坐标仅保留在本机或忽略的 `build/` 下，不是构建依赖，不要上传。仓库自动测试另有带来源说明的 NASA 公共领域样本。宿主验收在独立 QA 工程进行，避免修改用户工作时间线。
+
+## 宣传图和缩略图
+
+最终设计为虚构成年古风人物的面部近景，深青玉色与金色、下颌收缩线和箭头、跟随角标。文字包含“自动瘦脸、自动跟随、自动美颜”，已按用户反馈减小字号。保持与目标宣传人物的区别，不回用目标肖像。
+
+| 资源 | 文件 |
+| --- | --- |
+| 项目封面 | `Assets/Artwork/portrait-cover.png` |
+| APP 说明图 | `beatygril/beatygril/Wrapper Application/Resources/LauncherInfo.png` |
+| 大缩略图 | `Templates/大鱼人像美化/large.png`，640×360 |
+| 小缩略图 | `Templates/大鱼人像美化/small.png`，192×108 |
+| 生成记录 | `docs/design/artwork-manifest.json`、`artwork-prompt.json` |
+
+这些是生成的宣传插画，不是真实美颜效果前后对比。文字已烘焙进 PNG，没有需要额外分发的可编辑字体依赖。
+
+运行时模板目录必须包含 `.moef`、`Drop Zone.tiff`、`large.png`、`small.png` 四个文件。仅两张 PNG 设置 BSD `uchg`，不锁工程或目录。Git 和普通 ZIP 不保存该标志，手工恢复后需要重新设置：
+
+```sh
+chflags uchg "$HOME/Movies/Motion Templates.localized/Effects.localized/大鱼磨皮瘦脸/大鱼人像美化/large.png" "$HOME/Movies/Motion Templates.localized/Effects.localized/大鱼磨皮瘦脸/大鱼人像美化/small.png"
+ls -lO "$HOME/Movies/Motion Templates.localized/Effects.localized/大鱼磨皮瘦脸/大鱼人像美化"
+```
+
+替换图前仅解除对应 PNG 的 `uchg`，替换后重锁。同步 `.moef` 前先比较用户磁盘最新文件与源码，保留手改，不能盲目覆盖。当前四文件 SHA-256 见[安装包验证](verification/v1.2.0/pkg-verification.json)。本次交接核对时，正式 APP 为 1.2.0（14），两张安装缩略图均有 `uchg`。
+
+## Release 构建签名与安装
+
+依赖为 Xcode 27.1、FxPlug SDK 4.3.4、PluginManager 1.7.4，最低 macOS 13。头文件和链接信息来自 `/Library/Developer/SDKs/FxPlug.sdk/Library/Frameworks`；嵌入的可运行框架来自 `/Library/Developer/Frameworks`。不要把 SDK 链接存根当作运行框架。
+
+完整正式交付入口：
+
+```sh
+python3 scripts/deliver.py
+```
+
+脚本获取 `/Users/dayu/.codex/app-delivery-locks/com.dayu.beatygril.lock`，使用固定暂存 `/tmp/paintfcp-build-20261021`，记录到 `build/delivery/`。它构建通用 Release，由内到外签名 Framework、嵌套插件、外层 APP，验证严格签名，提交公证并要求 `Accepted`，粘附并验证票据，等待宿主退出后替换唯一正式路径，检查 Gatekeeper 与 PluginKit。默认停在 `HOST_VALIDATION_PENDING`，完成实际宿主验收及副本盘点后才回车进入清理。
+
+| 选项 | 用途 |
+| --- | --- |
+| `--wait-for-hosts` | 保持交付锁，只读等待 Motion/FCP 自行退出，不操作或结束宿主 |
+| `--user-tests` | 静态安装验证后清理已知生成副本，把原生效果验收明确保留给用户 |
+| `--resume-prepared` | 仅恢复已有 Accepted、stapled 暂存产物；核对 CDHash、版本和产品源码未改变 |
+
+运行脚本前先提交并推送待交付源码。用户已长期授权正式 Release 的签名、公证、安装，不必对相同范围重复询问。用户曾明确授权接手 Motion/FCP 验收，并允许需要释放插件时直接退出 Motion；涉及 FCP 工作工程仍应保护用户内容。本次交接没有操作宿主。
+
+签名身份为 `Developer ID Application: zhong luo (B3W25FX5H5)`，安装包身份为同团队的 `Developer ID Installer`。每次重新检查有效证书和私钥，不能退回临时签名。公证使用登录钥匙串中的 profile `codex-dayu-notary-B3W25FX5H5`；密码和私钥不在仓库，不能输出到聊天、日志或命令行参数。
+
+1.2.0 APP 公证 ID：`3999fe91-a80e-49d3-9ed0-4003b82f6f54`；PKG 公证 ID：`96a3d1be-a751-4fb8-b062-33a09c01ddf2`，两者状态均为 Accepted。完整记录在 `docs/verification/v1.2.0/`。
+
+交付锁不能绕过，也不能删除活跃持有者的锁。签名、公证或权限失败时保留原安装版。完成后只清理核对身份属于本产品的生成 APP、旧 APP 和公证 ZIP；最后的有界扫描覆盖 `/Applications`、两个 FxPlug 目录、项目及固定暂存路径，只发现正式 APP，不代表已经扫描所有卷。
+
+## PKG 与发布资料
+
+正式包：`releases/1.2.0/大鱼人像美化-1.2.0.pkg`，**5,011,005 bytes**。
+
+```text
+SHA-256  5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243
+```
+
+GitHub Release 下载名为 `Dayu-Portrait-1.2.0.pkg`，字节相同，已匿名下载并核对哈希、Installer 签名和公证票据。
+
+后续打包使用 `/Applications/PKG工坊.app/Contents/MacOS/PKG工坊`，本次版本为 CLI 1.4（8）。先读 `/Users/dayu/.codex/skills/dayu-publish-article/SKILL.md` 的当前打包规范及 CLI 帮助，使用独立发布副本。
+
+资源输入应是分类根 `大鱼磨皮瘦脸`，内含 `大鱼人像美化` 和上述四文件；另外加入唯一正式已公证 APP。不要把更外层“发布版”容器作为分类输入，也不要把 `PARAMETERS.json`、`VALIDATION.json`、开发 README 混入运行模板。PKG postinstall 负责备份、解除旧图锁、复制、重锁并验证；失败回滚当前模板项目，不能扩大为整个安装包的原子回滚。
+
+`scripts/verify-release-package.py` 是 **1.2.0 专用验证脚本**：依赖已展开的 `build/pkg-expanded/Payload.pkg`、当前正式 APP 和固定 `build/pkg-isolation`；不是接收任意包路径的通用工具。先阅读源码并准备展开目录，验证后清理展开出的额外 APP。当前 `.gitignore` 只为 `releases/1.2.0/*.pkg` 放行，下一版本的二进制入库或 Release 附件策略需明确处理。
+
+文章及发布入口：
+
+- [公开源码仓库](https://github.com/FAMEDaYu/FCP-BeatyGril)
+- [1.2.0 GitHub Release](https://github.com/FAMEDaYu/FCP-BeatyGril/releases/tag/v1.2.0)
+- [大鱼站文章 15593](https://dayu.media/15593/)
+- [大鱼 Git 备份](https://dayu.media/git/dayu/paintfcp-fxplug)
+
+文章为“免费资源”，价格为 0，非会员可获取，特色封面为当前古风图；正文已有 GitHub 仓库和 Release 链接，保留免费开源、安装注册、三秒退出、故障排查及准确署名。FCPX APP 列表同步本次未启用。
+
+文章另附历史源码 ZIP，对应 `788ba0d5514595cf349af33074055d70b0754185`，包含构建源码，排除 PKG 和 Git 历史；不是最新 main 快照。后续源码和署名修订以 GitHub main 为准。
+
+`scripts/publish-release.py` 用于首次发布并保留 `build/publish-operation.json` 状态；已有 `post_id` 时不会重新提交正文，不要将它当成通用文章更新器。更新 15593 时先读最新正文及元数据，只提交所需字段，保持免费权限、下载、SEO 和其他未改字段；密钥只在进程内存中使用。具体发布流程继续遵循上述技能，不因接手文档自动重发。
+
+## Git 保存与恢复
+
+| 本地远端 | 地址 | 说明 |
+| --- | --- | --- |
+| `origin` | `https://dayu.media/git/dayu/paintfcp-fxplug.git` | 保持为原远端及 main 上游；网站 Git 网关仍要求登录和有效会员 |
+| `github` | `https://github.com/FAMEDaYu/FCP-BeatyGril.git` | 公开仓库，匿名克隆可用，完整历史和七个标签已保存 |
+
+本项目没有 LFS 或子模块。不要改写原远端、强推、覆盖现有标签或把双端同步描述成自动定时同步。
+
+| 节点 | 完整提交 SHA |
+| --- | --- |
+| 1.2.0 正式签名源码 | `696d5f39b30404ed5d1d4c25f61d17475c7fc91b` |
+| `v1.2.0` 发布标签 | `3c7261c3a861b9f4704cfb36055d7b500c239dab` |
+| 1.1.2 已验收渲染及面板源码 | `a2e33e8e00a99b95dc29d67a819cb0897eda5756` |
+| GitHub 独立匿名恢复节点 | `356683b41af702d6c0143ad7fa5f540d752d6e14` |
+
+标签包含相应发布资料，签名源码节点表示实际构建代码；两者不同是正常的。后续文章、署名、GitHub 和交接文档提交没有改变已签名产品。GitHub 恢复核验覆盖 197 个受跟踪文件、全部七标签及 strict/full fsck；大鱼 `v1.2.0` 恢复核验为该历史节点的 183 文件，不把不同节点的文件数混用。
+
+恢复正式发行源码可以：
+
+```sh
+git clone https://github.com/FAMEDaYu/FCP-BeatyGril.git
+cd FCP-BeatyGril
+git switch --detach v1.2.0
+```
+
+需要最新文档时留在 main。继续开发则基于所需节点创建 `codex/` 前缀分支。Apple SDK、有效签名证书和公证凭据需在新机器单独安装或恢复；Git 不包含它们。
+
+保存本任务文件可用 `python3 scripts/checkpoint.py '提交说明' <明确文件...>`，该脚本只对当前分支提交、推送并核验 **origin**，不会推送 GitHub，也不要在外层已持有同一 origin 锁时嵌套调用它。GitHub 还需单独推送当前分支，发布时明确推送新的标签，两端都读回对应引用与本地 SHA 比较。
+
+提交和推送使用 `/Users/dayu/.codex/git-backup-locks/` 中的共享互斥锁。锁名为无凭据、转小写并去尾斜线的完整 HTTPS 仓库地址（保留 `.git`）的 SHA-256 加 `.lock`，`owner.json` 记录 PID、cwd、remote；不清理其他仍在工作的持有者。
+
+本机 GitHub CLI 为 `/opt/homebrew/bin/gh`，本次已由用户登录 `FAMEDaYu`，HTTPS 凭据在钥匙串中。接手时用 `gh auth status` 确认；连接器曾使用其他只读账号，不能用连接器权限推断 CLI 登录失效，也不打印令牌。大鱼仓库管理使用 `dayu-git` CLI，指南在 `/Users/dayu/Documents/dayu-git/README.md` 与 `API.md`。
+
+恢复范围仅覆盖已经提交、推送并核验的节点与实际上传的必要资源。用户素材、忽略的 build、私钥不在此范围。大鱼服务器当前只有手动备份，不能据此承诺本机与服务器同时损坏也可恢复。
+
+## 后续开发优先入口
+
+当前无需自动执行以下工作；收到相应需求后再开展。
+
+1. 用户继续反馈脸型差异时，先隔离单项、核对实际加载版本、原点与 76 点解剖索引，再分析目标对应局部数学。优先补齐仍近似的五项及组合顺序，不能仅调大整体强度。
+2. 跟随异常时，围绕多人交叉、遮挡、切镜、冷缓存、乱序和同尺寸换源制作明确样本，比较主体关联和历史选择，而不是先增加手动分析按钮。
+3. 面板改动时，覆盖真实 action 生命周期、持续步进、输入焦点、撤销、重置、保存重开及旧工程；补充原生 VoiceOver 和实际关键帧交互验收。
+4. 新版本发布时，沿用固定身份和唯一正式路径，记录本次真实签名源码，完成 APP/PKG 公证与恢复验证，更新原文章和两个远端，不覆盖旧标签。
+
+目标参考为 `/Applications/MSE18V2.app` 及用户原 MS 模板，仅用于只读分析。现有 REA、CPU 和 AIR 证据在 `docs/analysis/`；新分析按 `reverse-engineer-anything` 技能继续。不上传或打包原版 APP、模型、metallib、用户视频和完整人脸坐标。

releases/1.2.0/RELEASE.md

@@ -0,0 +1,22 @@
+# 大鱼人像美化 1.2.0（14）
+
+- 发布文章：https://dayu.media/15593/
+- 公开源码：https://github.com/FAMEDaYu/FCP-BeatyGril
+- 大鱼备份：https://dayu.media/git/dayu/paintfcp-fxplug
+- GitHub Release：https://github.com/FAMEDaYu/FCP-BeatyGril/releases/tag/v1.2.0
+- 大鱼 Release：https://dayu.media/git/dayu/paintfcp-fxplug/releases/tag/v1.2.0
+- 标签完整 SHA：3c7261c3a861b9f4704cfb36055d7b500c239dab
+- 正式 APP 源码：696d5f39b30404ed5d1d4c25f61d17475c7fc91b
+- 源码快照节点：788ba0d5514595cf349af33074055d70b0754185
+- PKG：大鱼人像美化-1.2.0.pkg，5,011,005 bytes
+- PKG SHA-256：5bd77c28b3a7e54f3d4060be1f16bcb145d9bc4d6b9cfb9eb137c01130440243
+- APP Apple 公证：Accepted 3999fe91-a80e-49d3-9ed0-4003b82f6f54
+- PKG Apple 公证：Accepted 96a3d1be-a751-4fb8-b062-33a09c01ddf2
+
+安装包本体已推入 Git，并附在 Release 下载区；文章另有免费安装包和免 Git 登录源码快照。仓库属性为 public，但站点统一 Git 网关仍要求登录 / 会员；这不是已解决的匿名 Git 访问。
+
+APP 与 PKG 均完成正式签名、公证、票据和 Gatekeeper 核验。APP 已安装到唯一正式路径；PKG 做了解包、逐字节载荷对照及隔离模板脚本测试，没有在用户当前模板目录运行本 PKG 安装器。实际模板目录中的两张图已直接更新并锁定。FCP 已显示新缩略图，正式插件可加载并修改亮度；Motion未重新进行1.2.0原生视觉测试，渲染/面板保持1.1.2验收源码。
+
+验证详情见 docs/verification/v1.2.0。生成宣传图与提示词见 docs/design，未使用目标商业插件人像。
+
+GitHub 提供完整历史和七个版本标签；独立匿名克隆恢复节点356683b41af702d6c0143ad7fa5f540d752d6e14核验197文件，Release安装包匿名下载哈希、签名和票据均通过。GitHub源码与Release链接已补充至文章15593。代码由 OpenAI + Codex 全程编写，站长仅参与调试和测试。

releases/1.2.0/article-payload.json

@@ -0,0 +1,55 @@
+{
+  "title": "大鱼人像美化 1.2.0：FCP / Motion 免费开源自动美颜插件",
+  "slug": "dayu-portrait-beauty",
+  "status": "publish",
+  "content": "<!-- wp:paragraph -->\n<p>大鱼人像美化是一款适用于 Final Cut Pro 与 Motion 的免费开源人像插件，把磨皮、美白和脸型调整放进同一块原生卡片面板。插件会识别当前画面中的人脸并自动跟随，无需先点击分析；你可以按素材需要调整强度，拖动滑杆时持续查看效果。</p>\n<!-- /wp:paragraph -->\n<!-- wp:paragraph -->\n<p><strong>代码由 OpenAI + Codex 全程编写，站长仅参与调试和测试。</strong></p>\n<!-- /wp:paragraph -->\n<!-- wp:image {\"sizeSlug\":\"full\"} -->\n<figure class=\"wp-block-image size-full\"><img src=\"{{media.cover.url}}\" alt=\"大鱼人像美化古风宣传封面，展示自动瘦脸、自动跟随与自动美颜\"/><figcaption>古风宣传插画；面部线条用于示意瘦脸与跟随功能。</figcaption></figure>\n<!-- /wp:image -->\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">可以做什么</h2>\n<!-- /wp:heading -->\n<!-- wp:list -->\n<ul class=\"wp-block-list\"><li>磨皮：局部磨皮、全局磨皮与五官保护，强度分别控制。</li><li>美白：肤色预设、肤色亮度、皮肤色相和牙齿美白。</li><li>脸型：瘦脸、大眼、短脸、窄脸、下巴、V 脸、下颌骨、颧骨与小头调整。</li><li>自动跟随：默认跟随主要人脸，也提供多人模式、防跳脸范围与检测框预览。</li><li>实时预览：滑杆、数值、单项开关和重置集中在同一面板，便于反复对比。</li></ul>\n<!-- /wp:list -->\n<!-- wp:paragraph -->\n<p>自动识别负责定位处理区域，效果强度由你控制。建议先从较小的数值开始；多人交叉、严重遮挡和极端侧脸的结果需要结合具体素材检查。</p>\n<!-- /wp:paragraph -->\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">版本与下载</h2>\n<!-- /wp:heading -->\n<!-- wp:paragraph -->\n<p>当前版本 <strong>1.2.0（14）</strong>，支持 macOS 13 或更高版本，包含 Apple Silicon 与 Intel 两种架构。下载包包含 FxPlug4 程序和一个配套 FCP 效果模板。APP 与 PKG 均已完成 Developer ID 正式签名、Apple 公证和票据粘附；安装包为所有用户免费资源。</p>\n<!-- /wp:paragraph -->\n<!-- wp:paragraph -->\n<p>本次更新加入古风封面与锁定缩略图、免费开源说明页和主 APP 三秒自动退出。人脸处理与面板交互沿用 1.1.2 已验收实现，不需要重新运行手动分析。</p>\n<!-- /wp:paragraph -->\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">安装</h2>\n<!-- /wp:heading -->\n<!-- wp:paragraph -->\n<p>安装前先保存工作并退出 Final Cut Pro 和 Motion，安装期间保持关闭。运行本页提供的 PKG，按安装器提示完成安装；它会把程序安装到 <code>/Library/Plug-Ins/FxPlug/beatygril.app</code>，把配套效果安装到当前登录用户的 Motion Templates 目录，并自动验证和修复系统插件注册。</p>\n<!-- /wp:paragraph -->\n<!-- wp:paragraph -->\n<p>本插件免费开源，<strong>无需激活码、付费注册或账号授权</strong>。主 APP 打开时显示说明图，窗口显示三秒后自动退出；宿主中的滤镜由独立服务运行。安装器还会重新锁定两张缩略图，避免被宿主自动替换。</p>\n<!-- /wp:paragraph -->\n<!-- wp:image {\"sizeSlug\":\"full\"} -->\n<figure class=\"wp-block-image size-full\"><img src=\"https://dayu.media/wp-content/uploads/2026/10/1792604743-1c99c2ba53c7614.png\" alt=\"主程序说明页：免费开源，自动注册，无需激活码，启动三秒后自动退出\"/></figure>\n<!-- /wp:image -->\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">使用</h2>\n<!-- /wp:heading -->\n<!-- wp:paragraph -->\n<p>Final Cut Pro：打开<strong>效果</strong>浏览器，找到<strong>大鱼磨皮瘦脸</strong>分类，将<strong>大鱼人像美化</strong>添加到人像片段。Motion：在原生滤镜资源库的<strong>大鱼</strong>分类中选择<strong>大鱼人像美化</strong>。</p>\n<!-- /wp:paragraph -->\n<!-- wp:paragraph -->\n<p>在检查器中按需调节磨皮、美白和脸型。每项左侧的眼睛可暂时停用该项，数值会保留；右侧回转箭头用于重置。人脸会随画面自动更新，开启检测框预览可以检查跟随位置。多人模式建议先用短片段观察稳定性。</p>\n<!-- /wp:paragraph -->\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">常见问题</h2>\n<!-- /wp:heading -->\n<!-- wp:paragraph -->\n<p>如果效果没有出现或显示红色警告，先退出 Final Cut Pro 和 Motion，再打开一次主 APP，等待其自动退出，然后重新启动宿主。可在“终端”执行下面这条命令：</p>\n<!-- /wp:paragraph -->\n<!-- wp:code -->\n<pre class=\"wp-block-code\"><code>open '/Library/Plug-Ins/FxPlug/beatygril.app'</code></pre>\n<!-- /wp:code -->\n<!-- wp:paragraph -->\n<p>该流程可重新触发系统注册，并不能解决所有报错。仍异常时请核对 macOS、Line truncated
+  "excerpt": "磨皮、美白、瘦脸与自动人脸跟随，原生卡片面板实时预览。免费开源，自动注册，无需激活码；提供签名公证安装包和源码。",
+  "categories": [
+    3
+  ],
+  "tags": [],
+  "resource": {
+    "cao_status": true,
+    "cao_price": 0,
+    "cao_vip_rate": 1,
+    "cao_close_novip_pay": false,
+    "cao_expire_day": 0,
+    "cao_pwd": "",
+    "cao_info": [
+      {
+        "title": "版本",
+        "desc": "1.2.0（14）"
+      },
+      {
+        "title": "宿主",
+        "desc": "Final Cut Pro / Motion"
+      },
+      {
+        "title": "系统",
+        "desc": "macOS 13 或更高版本"
+      },
+      {
+        "title": "架构",
+        "desc": "Apple Silicon / Intel"
+      },
+      {
+        "title": "授权",
+        "desc": "免费开源，无需激活码"
+      }
+    ]
+  },
+  "seo": {
+    "title": {
+      "enabled": true,
+      "value": "大鱼人像美化 1.2.0｜FCP / Motion 免费开源自动美颜插件"
+    },
+    "description": {
+      "enabled": true,
+      "value": "大鱼人像美化是适用于 Final Cut Pro 和 Motion 的免费开源 FxPlug4 插件，支持磨皮、美白、自动人脸跟随及瘦脸调整。提供 Apple 签名公证 PKG 安装包和源码，安装自动注册，无需激活码，并附具体安装、使用及红色警告排查说明。"
+    },
+    "keywords": {
+      "enabled": true,
+      "value": "大鱼人像美化,FCP美颜插件,Motion磨皮,自动瘦脸,自动跟随,FxPlug4,免费开源"
+    }
+  }
+}

releases/1.2.0/article.html

@@ -1,6 +1,9 @@
 <!-- wp:paragraph -->
 <p>大鱼人像美化是一款适用于 Final Cut Pro 与 Motion 的免费开源人像插件，把磨皮、美白和脸型调整放进同一块原生卡片面板。插件会识别当前画面中的人脸并自动跟随，无需先点击分析；你可以按素材需要调整强度，拖动滑杆时持续查看效果。</p>
 <!-- /wp:paragraph -->
+<!-- wp:paragraph -->
+<p><strong>代码由 OpenAI + Codex 全程编写，站长仅参与调试和测试。</strong></p>
+<!-- /wp:paragraph -->
 <!-- wp:image {"sizeSlug":"full"} -->
 <figure class="wp-block-image size-full"><img src="{{media.cover.url}}" alt="大鱼人像美化古风宣传封面，展示自动瘦脸、自动跟随与自动美颜"/><figcaption>古风宣传插画；面部线条用于示意瘦脸与跟随功能。</figcaption></figure>
 <!-- /wp:image -->
@@ -59,8 +62,8 @@
 <h2 class="wp-block-heading">源码与开源许可</h2>
 <!-- /wp:heading -->
 <!-- wp:paragraph -->
-<p>源码仓库：<a href="https://dayu.media/git/dayu/paintfcp-fxplug" target="_blank" rel="noreferrer noopener">大鱼人像美化 · paintfcp-fxplug</a>。仓库已设为公开属性；目前大鱼站的统一 Git 网关仍要求登录并校验会员。为方便所有读者获取源码，另外提供 <a href="{{source_url}}">1.2.0 源码快照 ZIP（免费、免 Git 登录）</a>，可直接下载研究和自行编译。</p>
+<p>公开源码仓库：<a href="https://github.com/FAMEDaYu/FCP-BeatyGril" target="_blank" rel="noreferrer noopener">GitHub · FCP-BeatyGril</a>，可直接浏览源码、完整提交历史和版本标签。<a href="https://github.com/FAMEDaYu/FCP-BeatyGril/releases/tag/v1.2.0" target="_blank" rel="noreferrer noopener">1.2.0 Release</a> 提供正式签名公证安装包。大鱼站仓库作为备份保留：<a href="https://dayu.media/git/dayu/paintfcp-fxplug" target="_blank" rel="noreferrer noopener">paintfcp-fxplug</a>（该入口仍受站点登录与会员网关限制）。也可下载 <a href="{{source_url}}">1.2.0 源码快照 ZIP</a>，源码与安装包均免费提供。</p>
 <!-- /wp:paragraph -->
 <!-- wp:paragraph -->
-<p>项目原创代码采用 MIT 许可，源码包含 Xcode 工程、Objective-C / Metal 实现、模板及构建与验证说明。Apple SDK、运行框架及样本按各自许可使用，详见源码中的 LICENSE 和 THIRD_PARTY_NOTICES.md。自行编译需要 Xcode 与 FxPlug SDK；证书和签名私钥不包含在源码中。</p>
+<p>项目代码按仓库中的 MIT 许可文件提供，源码包含 Xcode 工程、Objective-C / Metal 实现、模板及构建与验证说明。Apple SDK、运行框架及样本按各自许可使用，详见源码中的 LICENSE 和 THIRD_PARTY_NOTICES.md。自行编译需要 Xcode 与 FxPlug SDK；证书和签名私钥不包含在源码中。</p>
 <!-- /wp:paragraph -->

scripts/publish-release.py

@@ -3,7 +3,7 @@
 Secrets are read from macOS Keychain into memory; no auth material is persisted.
 """
 from pathlib import Path
-import base64,hashlib,html,json,mimetypes,ssl,subprocess,urllib.error,urllib.parse,urllib.request,uuid
+import base64,hashlib,html,json,mimetypes,ssl,subprocess,urllib.error,urllib.parse,urllib.request,uuid,zipfile
 ROOT=Path(__file__).resolve().parent.parent
 STATE=ROOT/'build/publish-operation.json';STATE.parent.mkdir(exist_ok=True)
 state=json.loads(STATE.read_text()) if STATE.exists() else {'operation':str(uuid.uuid4())}
@@ -15,10 +15,10 @@ class NoRedirect(urllib.request.HTTPRedirectHandler):
  def redirect_request(self,*args,**kwargs):return None
 opener=urllib.request.build_opener(NoRedirect,urllib.request.HTTPSHandler(context=ssl.create_default_context(cafile='/etc/ssl/cert.pem')))
 def request(path,method='GET',body=None,headers=None):
- assert path.startswith('/wp-json/') and '\n' not in path
+ assert path.startswith(('/wp/v2/','/dayu-publisher/v1/')) and '\n' not in path
  h={'Authorization':auth,'Accept':'application/json'};h.update(headers or {})
  if isinstance(body,dict):body=json.dumps(body,ensure_ascii=False).encode();h['Content-Type']='application/json'
- req=urllib.request.Request('https://dayu.media'+path,data=body,headers=h,method=method)
+ req=urllib.request.Request('https://dayu.media/wp-json'+path,data=body,headers=h,method=method)
  with opener.open(req,timeout=180) as f:return json.load(f)
 def upload(name,path,mime):
  if name in state:return state[name]
@@ -30,8 +30,12 @@ def upload(name,path,mime):
    with urllib.request.urlopen(item['source_url'],context=ssl.create_default_context(cafile='/etc/ssl/cert.pem'),timeout=90) as r:data=r.read()
    if hashlib.sha256(data).digest()==hashlib.sha256(path.read_bytes()).digest():
     state[name]={'id':item['id'],'url':item['source_url']};save();return state[name]
- result=request('/wp/v2/media','POST',path.read_bytes(),{'Content-Type':mime,'Content-Disposition':"attachment; filename*=UTF-8''"+urllib.parse.quote(filename)})
+ result=request('/wp/v2/media','POST',path.read_bytes(),{'Content-Type':mime,'Content-Disposition':'attachment; filename="'+filename+'"'})
  state[name]={'id':result['id'],'url':result['source_url']};save();return state[name]
+source_zip=ROOT/'build/Dayu-Portrait-1.2.0-source.zip'
+assert zipfile.is_zipfile(source_zip), 'Build a valid reviewed source ZIP before any upload'
+with zipfile.ZipFile(source_zip) as z:
+ assert z.testzip() is None and any(n.endswith('/Wrapper Application/AppDelegate.m') for n in z.namelist())
 status=request('/dayu-publisher/v1/status');assert status['can_publish'] and status['can_upload'] and 'seo' in status['fields']
 source=upload('source',ROOT/'build/Dayu-Portrait-1.2.0-source.zip','application/zip')
 card=upload('card',ROOT/'beatygril/beatygril/Wrapper Application/Resources/LauncherInfo.png','image/png')