# 大鱼调色开发交接 更新于 2026-11-08(Asia/Shanghai)。这是新对话的接手入口。历史设计和实现细节按需查阅专项交接,复现和交付证据以对应版本的报告为准。 ## 1.21.1(116)首次示波器与人脸肤色保护 用户反馈首次打开控制面板没有波形、人脸相关预览卡顿。控制面板从宿主动作读取当前时间,并优先按项目帧长验证本效果实例最后一次最终输出。缓存时间相同或播放头仍在该帧区间时立即送测量队列,下一帧边界等待对应渲染。参数写入与蜘蛛盘仍用原时间规则。 Skin 的 Vision 轮廓、眼眉嘴排除及强度沿用原算法。Metal 先检查实际轮廓外接范围,外部跳过多边形计算,无覆盖时跳过五官权重;按需读取设备端路径。人脸马赛克仍独立检测每个不同画面的矩形。4K 活跃人脸肤色保护旧版中位 1176.07 ms,其中取样及 Vision 平均 10.73 ms,主要耗时在逐像素轮廓。M4 同一公开人像的 12 帧中位数降至 21.78 ms,1080p 从 308.08 降至 10.07 ms;六组末帧 SHA-256 完全一致。以上是渲染器耗时。 候选 115 已公证并在 FCP 12.4 实测。片尾请求 11.383333333 秒,实际输出 11.360000000 秒。素材 60p 帧长 16.667 ms 导致仍拒绝缓存,因此候选未发布。116 改用 25p 项目帧长并等待同位置复测,再打包和发布。既有项目文件的 Security 引用排序未纳入本轮。 ## 1.21.0(114)流畅性优化 按首帧、连续渲染和检查器刷新优化。Metal 管线首次使用才创建,中性画面跳过通用调色与查找纹理,保留原来的半精度透明度规则;无蒙版 CST 将解除预乘并入原转换内核。最终画面取样合并进输出命令并复用小缓冲,仍保留暂停帧的示波器样本。检查器复用本轮的宿主读参和工具文档,只在切换色彩管理模式时移动输出控件。胶片颗粒未参与时省去宿主帧时序查询。 正式 1.21.0(114)已在唯一 FxPlug 路径安装,编译提交 `90e512aabe72fff30046b4bf18d6a35f91c0c113`。APP 公证 `505ed5a4-7b32-49a2-8eef-70c7757a98b4` Accepted,正式版 1050 项原生检查通过,包括 21 组独立 CST 参考。FCP 12.4 的独立验收副本从 00:00:00:00 播到 00:00:11:09,检查器和工作区混合滑杆均写入 0.50 后复位至 1.00,四种示波器回读 57,600 个有效 sRGB 样本。首次打开时请求时间与缓存帧不一致,下一次实际渲染后显示;同帧重开、宿主撤销、拖动延迟、掉帧、Motion 与完整导出未确认。[安装](verification/Delivery1.21.0.json) · [宿主](verification/HostFluidity1.21.0.json) M4 两组交错顺序的渲染加隐藏取样基准,1080p 中性 HSL 从 2.10–2.33 降到 1.39–1.62 ms,4K 加基础曝光从 19.15–19.69 降到 14.91–15.03 ms。4K 默认整合版中位数跨运行从 17.47–23.04 到 15.13–19.29 ms,存在重叠。每组的六个末帧及对应示波器样本均与 113 逐字节一致。默认整合版计算管线从 16 套降到 3 套。全尺寸中间纹理按帧释放,小型示波器缓冲按设备复用。[基准](verification/Fluidity1.21.0.json) PKG 公证 `29d5f921-6cd4-48a4-856a-2632f9a85e2b` Accepted。20 项验包、192 条载荷权限、签名及票据检查通过,44508770 字节,SHA-256 `ec1a57f23bf369d7a7841848d71d8ab78a7c229cbb5abe1c502e9964f87dbbcb`。本机通过独立正式 APP 验收,未执行包内安装脚本。[验包](verification/Package1.21.0.json) 公测 Release **414** 的安装包附件 **60** 已发布,草稿和发布后均完整下载并核对字节数及 SHA-256。发行标签 `v1.21.0-fluidity-20261108` 指向 `3a5ead0ce07eb2ed3009490af316b9edec186c62`。独立远端检出核对编译节点 805 个文件、发行节点 810 个文件及 Git 完整性。旧替换 APP、公证 ZIP、构建 APP、草稿下载与恢复副本已清理。站点文章和主 APP 更新通道未参与本轮交付。[发行](verification/Release1.21.0.json) · [恢复](verification/Recovery1.21.0.json) 入口为 `DYRenderer.mm`、`DYGrade.metal`、`DYScopeCapture.inc.h`、`DYPlugIn.mm` 与 `DYInspector.mm`。用户有新卡顿反馈时,先记录宿主、分辨率、发生阶段和启用的实际工具,再用正式安装路径复测。既有工程文件的 Security 引用排序差异留在工作区。 ## 2026-11-08 默认参数渲染排查 核对正式安装 1.20.2(113)、编译提交 `046411ba8b2c2bf8549601b2e5a080fd9dccd31b`。整合版、HSL、一级调色和 CST 独立效果的已安装模板、APP 内置模板和源码逐字节一致。整合模板没有额外工具层、LUT 或变形网格,默认执行 Sony S-Log3 / S-Gamut3.Cine 到 Gamma 2.4 / Rec.709 的 CST,自动色调映射开启。独立 HSL 的工具文档移除了一级调色。 - **模块执行**:`bypassNeutralTools` 跳过默认曲线、HSL、颜色分级、三原色、色阶和色彩平衡。空 LUT、零混合黑白、中性蜘蛛盘、通道混合器、胶片和畸变也不会因眼睛开启而各自运行。`DYToolIsNeutral` 过滤默认的独立工具层。本次对照均未触发 Vision 人脸检测。[渲染入口](大鱼调色/Plugin/DYRenderer.mm#L66) · [工具调度](大鱼调色/Plugin/DYToolRender.inc.h#L59) - **首帧准备**:首次创建设备资源会初始化 16 套计算管线,包括尚未使用的畸变、图章和胶片。融合渲染仍获取白平衡、HSL、分级三张查找纹理,每个新渲染器的中性状态也会创建 33³ 纹理。已确认准备工作存在,未单独计量各项耗时。[设备准备](大鱼调色/Plugin/DYRenderer.mm#L188) · [查找纹理](大鱼调色/Plugin/DYColorTables.mm#L229) - **每帧剩余工作**:整帧无有效调色时仍分配中间纹理,解除预乘并运行融合着色器,没有整帧直通。输出回调在示波器关闭时也同步读取 320×180 画面以保留同帧缓存,供工作区或蜘蛛盘打开时立即取样。[融合渲染](大鱼调色/Plugin/DYRenderer.mm#L248) · [输出取样](大鱼调色/Plugin/DYScopeCapture.inc.h#L83) Mac mini M4 无界面基准复用正式 113 的 Release 对象和安装资源,按安装模板的参数与归档构造状态,用逐帧变化的 RGBA16Float 合成渐变,每组跳过首 5 帧,取 12 帧中位数。渲染与隐藏示波器读回分别计时。 | 对照 | 1080p 渲染 | 4K 渲染 | | --- | ---: | ---: | | 整合模板默认 | 5.12 ms | 16.42 ms | | 整合模板保留一级调色,其余眼睛关闭 | 4.62 ms | 16.30 ms | | 整合模板只关闭一级调色 | 1.72 ms | 4.71 ms | | 独立 HSL 默认 | 1.70 ms | 4.66 ms | | 仅用现有 GPU 图像复制函数 | 0.73 ms | 2.09 ms | 保留一级调色的两组在末帧逐像素一致。只关一级、独立 HSL 和复制对照的末帧与输入一致。整合默认状态隐藏示波器另耗约 0.68 ms(1080p)和 0.65 ms(4K)。正式安装服务的 980 项基础自检通过,覆盖默认状态无 Vision、无多边形蒙版管线和关闭示波器时缓存最后一帧。以上是渲染器及读回耗时,未测宿主参数桥、解码、播放调度、掉帧或交互延迟,也未操作用户工程。 本轮仅记录排查,未修改运行代码、模板或安装。接手优化时先以中性独立 HSL 验证整帧直通,并单独计量首帧管线准备与隐藏示波器取样。复核 HDR、负值、透明度、坐标原点以及同帧示波器取样,保留默认 CST 的实际输出。既有工程文件的 Security 引用排序差异留在工作区。 ## 1.20.2(113)蜘蛛盘示波器 用户实看 1.20.0 后指出轨迹盖过控制网、肤色线与控制面板方向不同。1.20.1 将两处统一到同一份最终输出的色彩转换、Cb/Cr 取样、比例和肤色线方向。蜘蛛盘显示坐标同步投影,底层保留 HSV 网格和预设,拖动与方向键反向映射回原坐标。参照用户配图改为暗中性中心、平滑色相外圈、受限的轨迹透明度、灰色节点与深色描边。1.20.2 按用户追加反馈把网格前景线的白色不透明度由 55% 提至 72%,保留深色底描边。 新 FCP 整合效果、独立模板和新插入的肤色工具默认关闭保护。FCP 模板显式写入关闭值,注册默认保留历史开启值,兼容省略该参数的旧片段。Motion 直接添加原生滤镜沿用注册默认。显式开启时保护程度默认 60,仅保护人脸默认开启。 1.20.0(111)与 1.20.1(112)均为本轮正式签名公证的验收候选。1.20.1 安装后通过 1002 项原生检查,在 FCP 实片同帧并排核实两个矢量示波器方向及肤色保护关闭。两版均为本机验收候选。[111 实看](verification/HostSpiderScope1.20.0.json) · [112 实看](verification/HostSpiderScope1.20.1.json) · [112 安装](verification/Delivery1.20.1.json)。最终 **1.20.2(113)已公证安装并在 FCP 12.4 同帧实看**。1002 项原生检查通过,17 套模板静态校验通过。实际编译提交 `046411ba8b2c2bf8549601b2e5a080fd9dccd31b`,APP 公证 `e8c27c08-a78e-4be2-9adf-235e7bfad1f6` Accepted,固定插件路径 `/Library/Plug-Ins/FxPlug/大鱼调色.app`。同一帧确认网格提亮后仍能看清色度轨迹,两处肤色线均朝左上,检查器肤色保护为关闭。[实片核验](verification/HostSpiderScope1.20.2.json) · [安装](verification/Delivery1.20.2.json)。 正式 PKG 公证 `1a6834df-840f-47da-9ee8-be6a0a808fee` Accepted,20 项展开验包、票据、Gatekeeper 与 192 条载荷权限通过。包大小 44505420 字节,SHA-256 `8edd792c6a9be629263baee68c4c3e7b67221ffd1e995bd8c9ab1f753eefd2b4`。已独立安装正式 APP,本机验收未再次运行 PKG 安装脚本。[验包](verification/Package1.20.2.json)。Git Release **413** 的 PKG 附件 **59** 已发布,草稿浏览器及发布后均完整下载并核对大小和 SHA-256。标签 `v1.20.2-spider-scope-20261108` 指向 `bc9021271d5e4992a6a63011e4ff197812029ab3`。已独立从远端检出编译节点和发行标签,分别核对 798 与 802 个跟踪文件和 Git 完整性。[Release](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.20.2-spider-scope-20261108) · [发行核验](verification/Release1.20.2.json) · [恢复](verification/Recovery1.20.2.json)。 本轮两个未发布候选包、草稿下载副本、旧替换 APP、公证 ZIP 和恢复克隆已清理,保留正式包与用户原有历史发行包。[清理](verification/Cleanup1.20.2.json)。入口为 `大鱼调色/Plugin/DYSpiderScopeDrawing.h`、`DYScopeCapture.inc.h`、`DYViewerGraphics.inc.h` 和 `DYModel.mm`。既有工程文件的 Security 引用排序差异留在工作区。 ## 1.19.1 交付基线(历史) **1.19.1(110)已正式公证安装,完成本轮默认预览宿主验证,PKG 与 Git Release 已交付。** 实际编译提交 `3642a1dba6cbbc4423bd6928944e0e95d76d9cfa`,APP 公证 `c965f687-ab0b-442b-99e1-4b5013065f50` Accepted。固定路径仍为 `/Library/Plug-Ins/FxPlug/大鱼调色.app`;994 项正式安装原生检查、票据、Gatekeeper、唯一 PluginKit 路径通过。 修复“添加整合效果、未调参数,预览极卡”:空 LUT 默认强度与零混合黑白眼睛错误触发 Vision,随后无效的 `skinFaceOnly` 令整帧执行人脸多边形蒙版。现在按实际有效渲染参数决定检测和人脸蒙版;默认开关、预设、模板和调色算法不变。公开人像基准在 Apple M4 上,1080p 324.37 → 5.23 ms,4K 1248.90 → 16.99 ms;每组 14 次默认渲染不再调用人脸分析。该数字是渲染器耗时,不是宿主显示 FPS。[原因与范围](research/IdlePreview1.19.1.md) · [性能](verification/IdlePreview1.19.1.json)。 FCP 12.4 使用独立副本 `1.19.1 默认预览性能验收`,先复测恢复默认的旧效果,再移除并新加整合效果,两次播放到 00:00:11:09;真实渲染四秒采样均不含 `prepareFaceSupport`。基础曝光字段测试后恢复 0,默认三组展开恢复。未量化掉帧数、未确认宿主撤销、未重复导出或实片跟踪,不记这些项目为通过。[宿主记录](verification/HostIdlePreview1.19.1.json) · [安装](verification/Delivery1.19.1.json)。 发行标签 `v1.19.1-idle-preview-20261106` 指向 `6add6f29e357d37e94a8430d6963ec7f91993537`。PKG 公证 `5bf23d87-857d-48d9-856c-f6f05e97867b` Accepted,20 项展开验包和 192 条载荷权限检查通过;本机 APP 独立安装验收,未重复执行 PKG 系统安装脚本。包 44,488,264 字节,SHA-256 `7513be46cc86eb5df26401c9cb4368c8290d276cdcc478e5f16f727a1be4d647`。Release **404**/PKG **51**/符号 **52** 已发布,沿用公测标记和原仓库可见性;草稿附件经已登录浏览器下载,发布后再次完整下载,大小与 SHA-256 均一致。独立远端检出核对编译节点 778 个文件、标签 786 个文件,Git 完整性通过。 [Release](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.19.1-idle-preview-20261106) · [发行核验](verification/Release1.19.1.json) · [安装包](verification/Package1.19.1.json) · [符号](verification/Symbols1.19.1.json) · [恢复](verification/Recovery1.19.1.json)。本轮构建 APP、公证 ZIP、旧替换 APP、打包暂存、基准可执行文件、下载副本和恢复 clone 已清理;正式包、匹配符号、历史发行包、原素材及 QA 库保留。原始宿主采样仅留本机诊断缓存。[清理记录](verification/Cleanup1.19.1.json)。 **2026-11-06 文章更新补记:**按用户要求,已将[文章 15792](https://dayu.media/15792/)的主下载、标题、摘要、相关 SEO 和安装说明更新到 **1.19.1(110)**,补充默认预览卡顿修复,明确同一 PKG 已含整合效果与全部 16 个独立模块。再次展开正式包,核对 17 个可安装效果与 34 张预览图,共 51 个文件逐字节匹配项目及 APP 内资源;安装脚本目标为当前登录用户的 `Movies/Motion Templates.localized/Effects.localized/大鱼调色`。包内完整 APP 为 110,签名与票据通过,复用已发布正式包,未重新打包或执行系统安装。 文章保存回读、正常地址与新请求的前台标题/SEO/代码区块/全部模块名称/原图片均通过。网站主下载完整取得 44,488,264 字节,SHA-256 与上述 Release 包一致,签名、票据和 Gatekeeper 通过。价格 50 元、会员免费、封面、分类和原 FCPX 同步开关保留;付费资源直链未写入公开正文。发布正文保存在 [文章更新内容](Packaging/article-1.19.1.json),证据见 [文章核验](verification/Article1.19.1.json) 和 [包内模块清单](verification/PackageModules1.19.1.json)。本轮下载和展开副本已清理,原始回读仅留本机缓存。 **2026-11-06 独立模块配图补记:**用户提供的效果浏览器截图已原样加入同一文章,在 1.19.1 更新说明之后新增“新增独立模块示意”,附图注与替代文本。媒体附件 **15879**,原图 1364×748、384,718 字节,上传后下载 SHA-256 与原图一致;前台仅有一处新图,浏览器实看图像和图注正常。标题、SEO、封面、主下载、价格会员规则及原正文图片保持原样,本轮未重打 PKG。原图保存在 [独立模块示意图](Publishing/1.19.1/independent-modules.png),[文章内容](Packaging/article-1.19.1.json)已同步,证据见 [配图核验](verification/ArticleModuleImage1.19.1.json)。 接手重点:本次消除默认/无效状态的额外开销;真正启用调色时的人脸肤色保护仍用原逐帧检测和轮廓算法,其性能未优化。文章已为 1.19.1(110),含本次新增独立模块示意图;主 APP 更新通道仍为上次核对的 1.19.0(109),此次仅更新文章,未部署 NAS 后端或更新通道。既有 project.pbxproj 三处 Security 排序差异保留未提交。接手先核对本机 110、以上发行记录及用户真实工程播放反馈,勿用旧版发布记录替代。 ## 1.19.0 交付基线(历史) **1.19.0(109)已正式公证安装、通过宿主验收,PKG/Release/文章及更新通道已交付。** 实际编译提交 `867bcfbad3f566ced2170925e8eadd9414cc3b75`,APP 公证 `b83655db-23a9-4312-91e4-bfd697143e44` Accepted。全部正式跟踪改为 Apple Vision,APP 无 OpenCV 符号与资源。马赛克用对象外观跟踪;普通蒙版/钢笔及图章双区用局部图像配准。短时丢失最多预测 0.8 秒,确认回归后补齐,未确认尾部删除;旧工程需重新跟踪。979 项正式原生检查通过。FCP 验收副本 `1.19.0 Vision 全跟踪验收` 完成 285 帧,起点、6 秒与 11.36 秒实际马赛克覆盖头部,两种跟踪回调日志 main=0;面板关闭重开、参数修改/复位、普通蒙版反向单帧与撤销通过。未量化 UI 延迟,未重复完整实片图章或导出。[宿主证据](verification/HostVisionTracking1.19.0.json) · [算法比较](research/TrackingRecoveryCandidates.md)。 发行标签 `v1.19.0-vision-tracking-20261106` 指向 `a0178f994d71c19e95c70e23f9b056947b063b1c`。PKG 公证 `99abefcb-c1cb-4aff-8b85-8109eab00df9` Accepted,20 项验包与 192 条载荷权限通过,本轮 APP 独立安装,未重复运行系统 PKG 安装脚本。Release **403**/PKG **49**/符号 **50** 已发布,草稿和正式下载分别核对完整大小与哈希。包 44,486,766 字节,SHA-256 `0287d9e153463059730e99aade32a8b24cac19312e00d2450aa3c0819ae44745`;符号 3,472,206 字节,SHA-256 `401cb46a38838a5605b7a1cb6eb3cd5ee03a649a80c7cf6655741a57ec0deb31`。独立远端恢复核对编译节点 766 个文件、发行标签 771 个文件。文章 15792 与 beta 通道均为 1.19.0/109,站点两路完整包下载和票据通过,旧版提示更新/109 不提示更新;价格、会员、封面与既有图片保留。NAS `beta.json` 同目录旁路备份为 `beta-202611062006.jsonbak`,未修改后端 PHP。 [Release](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.19.0-vision-tracking-20261106) · [文章](https://dayu.media/15792/) · [发行记录](verification/Release1.19.0.json) · [站点记录](verification/Article1.19.0.json) · [更新通道](verification/BetaPublication1.19.0.json) · [清理记录](verification/Cleanup1.19.0.json)。本轮清理旧替换 APP、对照环境、用户素材派生帧、模型、候选符号、下载及恢复副本;保留原素材、QA 库、历史发行包。原工作区的 project.pbxproj 三处 Security 排序差异继续保留,未混入提交。 接手第一步核对正式 109 与以上报告;用户已有工程重新执行追踪后播放复核,优先收集真实复杂遮挡和多人交叉片段。不要把单段 285 帧通过推断为所有素材不偏移,也不要把原生图章回归当作本轮完整实片图章验收。 107 为过渡候选未发布;108 全 Vision 候选公证后,FCP 菜单/浮动面板重开时插件 XPC 服务闪退,FCP 宿主仍运行。定位到 `DYColorWorkspace` 的 `_remoteParent` 借用指针在延后布局时已释放,109 改为持有至关闭,新增两项生命周期回归,正式面板重开未复现。[崩溃证据](verification/WorkspaceCrash108.json)。这不是对所有历史闪退原因的结论。 前一版本记录:**1.18.1(106)曾正式安装、发布 Git Release,并更新文章 15792 与主 APP 公测通道,现由 109 接替。** 实际编译提交 `1cc7f8edb2acb3cfc62bd72447c2956ad7a01601`;发行标签 `v1.18.1-tracking-ui-20261106` 指向 `5fe4b1933e015a906fab36b65dcbc45a0d6bee49`。APP 公证 `2c4e6cba-8178-4a50-9198-83e66be37add` Accepted。安装后 964 项原生检查通过,FCP 独立副本完成两轮 285 帧跟踪及模块/参数交互。 - 跟踪保留 OpenCV LK,Metal 灰度回读减少 75%,目标区域特征检测与金字塔复用减少 CPU 工作。同一 4K 片段算法计算 8.78 秒降至 1.31 秒(约 6.72 倍),轨迹逐帧一致;不含宿主供图、解码、预览与渲染,不等于全流程速度。 - 界面减少完整参数重建、重复宿主读取及图层列表重建。未测 UI 延迟分位数,不宣称所有界面卡顿已根治。 - 人脸转身仍有偏移,原版在同一离线输入上也存在;当前优化未改进精度。旧 Metal LK 实验在第 133 帧丢轨,已拒收,没有启用到正式路径。 - 证据:[性能](verification/TrackingPerformance1.18.1.json) · [宿主验收范围](verification/HostTrackingUI1.18.1.json) · [实现与限制](research/TrackingMetal1.18.1.md)。继续处理时优先关注交互流畅与转身/遮挡精度,避免把渲染平均耗时当作 UI 延迟。 - PKG 公证 `5b0f2573-e603-49a5-91b6-fa0582c8c782` Accepted,20 项展开及 198 条载荷权限检查通过,包内 APP 对应上述编译提交。本机未重复执行系统安装器脚本。正式 PKG 46,654,687 字节,SHA-256 `e149555c46cc6196eb12601196d70121d79b796be852f9a2e89688b20483a6b2`。 - Release **402** 的 PKG 附件 **47** 与匹配 dSYM 附件 **48** 已发布,草稿及发布后均完整下载核对;[发行页](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.18.1-tracking-ui-20261106) · [发布记录](verification/Release1.18.1.json) · [符号](verification/Symbols1.18.1.json)。独立远端检出编译节点 739 个、标签 742 个文件,逐字节与 Git 完整性通过。[恢复](verification/Recovery1.18.1.json) - [文章 15792](https://dayu.media/15792/) 已绑定 1.18.1 主包并更新正文/SEO;价格、会员规则、封面、分类与原图保持。公开页和下载验票/哈希通过。beta 通道备份 `beta-202611061819.jsonbak`,105 提示更新、106 不重复提示,下载校验通过。[文章](verification/Article1.18.1.json) · [通道](verification/BetaPublication1.18.1.json) - 正式路径仍为 `/Library/Plug-Ins/FxPlug/大鱼调色.app`,主 APP 常驻与自动诊断保留。原项目未改;FCP 当前打开独立副本 `1.18.1 追踪与界面验收`。前序 project.pbxproj 的三处 Security 引用排序继续留在工作区,未混入提交。 - 本轮约 2.86 GB 临时灰度帧、基准可执行文件、下载副本和上传暂存已清理;生成 APP/公证 ZIP/旧版替换备份由正式交付流程清理,PluginKit 只有一个正式路径。保留正式发行包、符号和用户历史归档;不作全盘唯一副本承诺。[清理](verification/Cleanup1.18.1.json) ## 1.18.0 交付基线(历史) **1.18.0(105)已正式安装、发布 Git Release,并上线主 APP 公测更新通道。** 本轮完成云端报告调查、取消主 APP 自动退出、增强可关闭的后台诊断。已验证真实卡顿调用栈到达云端;已有用户卡顿的具体算法根因仍待继续分析,不能宣称已根治。 | 项目 | 已核对状态 | | --- | --- | | 工程与源码 | `/Volumes/备份/大鱼调色/大鱼调色`,`main`,远程 `https://dayu.media/git/dayu/dayu-color.git`。实际编译 **`d0187695581fa3a8fe5c3cfa8a1bc6337425f5f6`**;发行标签 `v1.18.0-diagnostics-20261106` 指向 **`a03a056bff17daadce77128f767a08e98dc830dd`**。原有 project.pbxproj 三处 Security 引用排序保留未提交。 | | 正式安装 | **1.18.0(105)**,`/Library/Plug-Ins/FxPlug/大鱼调色.app`。APP 公证 `5a98cab1-23af-4034-abc9-0c9e7b1dc77d` Accepted,票据、Gatekeeper、唯一 PluginKit 路径通过;961 项原生回归、75 项离线诊断检查、FCP 12.4 加载及播放验收完成。[交付](verification/Delivery.json) · [实际范围](verification/Diagnostics1.18.0.json) | | Git Release | Release **401**,PKG 附件 **45**(46,620,783 字节,SHA-256 `4a52742a393ecaaa30f758d72c9e0ba68c606ed8e805316d48b9868068378a3f`),匹配 dSYM 附件 **46**。两附件均在草稿及发布后完整下载核验;保留公测标记及原仓库可见性。[发行页](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.18.0-diagnostics-20261106) · [发布记录](verification/Release1.18.0.json) · [符号](verification/Symbols1.18.0.json) | | 云端诊断后端 | 仅更新 `wp-content/mu-plugins/dayu-color-beta.php`;生产旁路备份 `dayu-color-beta-202611061649.phpbak`,增加限定字段并分开展示上传版本/故障版本。27 项合同检查及线上 ACK/重试/隔离核验通过。[部署](verification/BetaBackendDeployment.json) · [线上检查](verification/BetaBackendLive.json) | | 更新通道与文章 | 主 APP beta 通道已从 1.12.0(79)更新到 **1.18.0(105)**,清单旁路备份 `beta-202611061726.jsonbak`;线上 PKG 完整下载大小与 SHA-256 一致,95 收到更新、105 不重复提示。文章 15792 已更新 **1.18.0(105)** 主下载、标题、SEO、自动诊断说明和 16 个独立效果查找位置;价格、会员规则与封面保留,全文及正式下载验票/哈希通过。[文章验证](verification/Article1.18.0.json)。[更新验证](verification/BetaPublication1.18.0.json) | | 包与清理 | PKG 公证 `8c4fa3f6-4866-429a-8750-8567f7db4766` Accepted;票据、Gatekeeper、20 项展开、198 条载荷权限检查及常驻主 APP 正常退出规则通过。本机从正式 APP 独立验收,未再次运行 PKG 系统安装脚本。当前正式包与符号 ZIP 位于项目上级“发行包”;本轮临时 APP/旧替换备份/采样原文/下载副本/恢复 clone 已清理。[验包](verification/Package.json) · [清理](verification/Cleanup1.18.0.json) | ## 1.18.0:报告结论、后台采集与待跟进 - **历史闪退**:云端 43 条崩溃摘要中 7 条属于本机开发测试;外部 36 条中 34 条是 1.10.0 通知回调对象生命周期故障,1.11.0 起的既有提交 `1c3e294ce991b0205969486c330dba57714aeacc` 已修复。上传版本 1.14.x 不等于崩溃实际版本。两条 1.7.4 dyld 旧摘要不足以判定原因。完整脱敏分析见 [调查记录](research/CloudDiagnostics1.18.0.md)。 - **常驻与采集**:取消注册后的倒计时退出;关窗后台运行,菜单栏可重新打开、发送摘要或主动退出。每分钟扫描本产品 APP/XPC 的系统崩溃报告,记录实际版本、终止类别、UUID/偏移,排除 ASAN/原生自检;卡顿探针使用公共运行循环,限频对自身进程采样。渲染、状态构建、检视器、跟踪按分钟汇总,避免每帧上传。只提取允许的摘要,不传素材、LUT、预设、账号或原始系统报告,沿用诊断开关与 30 天保留。 - **正式实测**:候选 104 的采样首次超时,未分发;105 移除采样前的符号预读并给后台解析 30 秒上限。受控 12 秒主 APP 卡顿已在云端捕获 `runDiagnosticsProbe → sleepForTimeInterval → nanosleep`,标记 verification。关闭诊断超过一分钟,待发清零且无新增上报;恢复原开启状态后主 APP 与 XPC 恢复发送。关窗后同一普通进程持续跨两轮分钟统计,不含测试启动参数;这是短时实测,不是长期压力测试。 - **已经得到的新性能线索**:当前 3840×2160 素材的 28 次渲染平均 **601.4 ms**、最大 **1716.8 ms**;同期 41 次状态构建平均 **4.31 ms**、最大 **8.68 ms**。主要耗时落在渲染阶段,尚未细分到 GPU 等待、读回、具体算法或资源竞争,也不能直接换算为播放 FPS。本轮只建立诊断证据,没有顺带重写渲染器。 - **刚才疑似本机闪退**:17:03/17:06 与本轮 Cmd-Q 退出时间一致,系统 `(0,0,0)`,无新增 FCP 崩溃报告;用户已确认可能为本轮正常退出。另有今天 10:30 的历史 FCP ProOSC 绘制中止、主线程重建检视器,报告不含大鱼栈,不能归因到本插件或此次诊断。[退出核对](verification/LocalHostExit1.18.0.json)。本产品自动上传范围不包含其他 APP 的完整崩溃报告;若 FCP 自身再次崩溃,仍需对应宿主 IPS 与插件时间线关联。 - **恢复**:实际编译节点 724 个文件、发行标签 728 个文件独立远端检出并逐字节核对,Git 完整性通过;无 LFS/子模块,未重复第三方冷构建。符号 ZIP 与主 APP/XPC 二进制 UUID 精确匹配,已随 Release 保存。[恢复记录](verification/Recovery1.18.0.json) · [恢复步骤](RECOVERY.md)。 用户最新优先级(2026-11-06):先完成文章自动收集版更新(已完成),随后优先保证界面操作流畅;普通渲染速度可暂缓。新增要求:尝试用 Metal 加速马赛克跟踪。接手先核对 1.18.0(105)和新云端事件,区分 UI 主线程、逐帧供图、追踪算法、预览更新的耗时。处理用户崩溃时按 source_version/source_build 和 UUID 匹配符号,不用上传版本推断故障版本。以下为前序交付记录。 ## 1.17.1 交付时基线(历史) **1.17.1(103)已正式安装并完成 Git Release 交付。** 本轮按用户要求恢复检视器折叠与内部滚动,默认只展开一级调色、基础调整、蜘蛛盘;修复手绘蒙版跨宿主时间起点写回,马赛克改用轻量人脸框检测,并接入多个人脸/蒙版选择。用户要求代码接入后自行实测,真实运动多人、遮挡和流畅度尚未验收。 | 项目 | 已核对状态 | | --- | --- | | 工程与源码 | `/Volumes/备份/大鱼调色/大鱼调色`,`Wrapper Application` / Release;远程 `https://dayu.media/git/dayu/dayu-color.git`,`main`。实际编译提交 **`3b4c612edf99c0ef2b972b7305cd7ba44244a7c6`**。 | | 本机正式安装 | **1.17.1(103)**,`/Library/Plug-Ins/FxPlug/大鱼调色.app`。Developer ID 签名、APP 公证 `36ecb7e6-5cfc-4b85-8363-11272d880b18` Accepted、票据、Gatekeeper、唯一 PluginKit 路径、961 项原生自检及 FCP 12.4 加载/折叠滚动/菜单验证通过。[交付](verification/Delivery.json) · [宿主范围](verification/HostInspectorMosaic1.17.1.json) | | Git Release | `大鱼调色-1.17.1.pkg`,46,600,407 字节,SHA-256 `5c1240d9f262c977495016cd9c19bd55cc0e374fcf9f99128e8cb2231309d710`。标签 `v1.17.1-inspector-mosaic-20261106` 指向 **`7c0bfa5352f282bcec0aedf43be29af4432f2ba8`**。Release **400**/附件 **44** 已发布,保留公测标记与仓库可见性;草稿及发布后完整下载大小与哈希一致。[发行页](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.17.1-inspector-mosaic-20261106) · [发布记录](verification/Release.json) · [验包](verification/Package.json) | | 站点及自动更新 | 本轮未操作。原文章 15792 主下载上次核对为 **1.14.4(95)**;主 APP 公测更新通道上次回读为 **1.12.0(79)**。[原文章](https://dayu.media/15792/) · [文章核验](verification/Article1.14.4.json) · [更新通道核验](verification/BetaPublication1.12.0.json) | | 环境与验收库 | Xcode 27.1、FxPlug SDK 4.3.5、Apple Silicon、macOS 14.6+、FCP 12.4。固定缓存 `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color`。QA 库 `fcp-qa/level-1.15.0/未命名.fcpbundle`,事件“大鱼调色1.17.0全链路与马赛克验收”。接手重新检查产品交付锁。 | ## 1.17.1:恢复折叠、手绘保存和指定人脸 - 检视器按窄宽测量默认三组与其余折叠标题,内部最大高度 3501 pt;默认无内部滚动,展开/追加超出容量才滚动。已保存的折叠状态继续读取,独立效果默认展开唯一根模块。FCP 外层仍保留首次分配的高度,内部视窗可缩短,较宽检视器末尾有预留空白;没有恢复失败的参数删除/重建方案。 - 手绘草稿用 OSC 时钟保存几何,宿主 Action 时钟负责读取非动画文档与检查换帧。重绘时间不同不再丢掉草稿;真实输入换帧、Esc 和外部改动冲突仍取消。原生检查覆盖松手保存及安全回读;用户反馈的实鼠复位仍须在其问题素材复测。 - 全部人脸模式改用长边 640 的 Vision 人脸框检测,独立同画面缓存,减少特征点开销。肤色保护原算法保留;本次没有同场景前后播放帧率基准,不能保证所有素材流畅。 - 指定目标入口:开启“全部人脸 · 快速逐帧识别”→ 暂停目标画面 → 再开“局部马赛克”→“将本帧 N 张人脸转为可选跟踪蒙版”→ 勾选需要遮挡的人脸。在控制面板蒙版页逐个运行正向、反向或双向跟踪。每个框有稳定 UUID;生成后未跟踪前是静态,不是全片身份识别。矩形、椭圆和钢笔也能多选用于马赛克。 - 961 项正式原生检查通过;双人测试使用 NASA 公有人像并排合成,取消一人后其像素变化为 0。16 个独立模板与整合模板静态检查通过。FCP 实窗看到初始三组、折叠标题、展开胶片和曲线产生内部滚动、收起后滚动条消失;本帧单人转换入口可用。[专项记录](research/InspectorMosaic1.17.1.md) · [回归](verification/InspectorMosaic1.17.1.json) - 编译节点 714 个文件、发行标签 718 个文件独立远端检出并逐一校验,差异仅为记录与模板模型来源哈希;无 LFS/子模块,未重复第三方冷构建。原有 project.pbxproj 三处 Security 引用排序保持未提交。[恢复](verification/Recovery1.17.1.json) - PKG 公证 `8e122236-9ca6-4d92-ad6a-b9c2411280e7` Accepted,票据、Gatekeeper、20 项展开检查和 198 条载荷权限检查通过;正式 APP 独立安装验收,本机未重复执行 PKG 系统脚本。本轮构建 APP、公证 ZIP、旧替换备份、包暂存、恢复 clone 和草稿下载副本已清理,保留正式包与用户历史包,交付锁已释放。[清理](verification/Cleanup1.17.1.json) 接手第一步核对 1.17.1(103),按用户实拍反馈复测手绘松手、目标脸选择、轨迹及播放耗时;不要把原生回调测试或静态人像验证当作真实多人运动验收。下方为历史记录。 ## 1.17.0:独立缩略图、全展开检查器、输出层与马赛克 - **缩略图**:`tools/build_module_previews.swift` 生成 16 套有功能名称和对应图形的缩略图,640×360 / 240×135。`tools/template_payload.py` 使用独立资源路径;MOEF 与旧版逐字节一致,整合版保留品牌图。FCP 效果浏览器实见风格 LUT、肤色、黑白、基础调整的不同图形;全部图片由 [缩略图报告](template/verification/ModulePreviews.json)、安装哈希和模板静态检查覆盖。 - **全部展开并测高**:`DYInspector.mm` 在返回视图前同步布局,按 280 pt 窄宽和各页签最大内容测量,预留颜色设置及输出卡片需要的高度。整合版显示全部未删除模块,独立效果仍仅显示其根模块;仅改变呈现,不修改参数、启用状态或旧折叠存档。模块标题用于选择,双击仍可还原,不再折叠。FCP 外层检查器可滚动,插件内部没有纵向 ScrollView。实测冷启动顶部与底部完整、追加一层镜头畸变后输出设置仍可达、独立 HSL 完整展示;未复现 101 的整片空白。 - **高度边界**:FCP 12.4 仍会缓存初始高度,本版采用用户选定的初次全量测高,并未修复宿主动态高度接口。较宽检查器底部可能留有页签/模式的预留空间。已实测追加一层,不能承诺任意数量新层都可无限增长;大量追加超出初始容量时,重新选择片段重新测量。其余行为和覆盖范围见 [宿主报告](verification/HostUnified1.17.0.json)。 - **V4 全链路**:在颜色设置显式选择“全链路 · 输出转换层”,输出默认末层并可上下移动。保留 nil/V2/V3,避免静默改变旧工程;原模板 custom dataValue 也保留兼容值。`DYUnifiedRender.inc.h` 按真实节点顺序执行,统一输入/输出和当前节点工作域,一级旁路不关闭全局转换,蒙版在 AP1 线性域混合,保留负值与超白残差,曝光按场景线性处理。创意 LUT、胶片和旧有界工具仍使用明确局部参考域/增量延拓,不宣称全部旧算法都已改写成场景线性。FCP 实测输出末层、上移至镜头之前和一次撤销恢复。 - **局部马赛克**:OSC 网格按钮与检查器同名按钮使用同一菜单和写入桥,可选逐帧人脸、任意已绘制共享蒙版及方块大小;复用现有识别和蒙版轨迹。人脸区域包含眼睛、鼻子、嘴。FCP NASA 公有人像实测人脸覆盖和矩形来源切换,冷启动保存状态正确。运动轨迹插值、无蒙版旁路、区域外像素和空间工具共存由原生检查覆盖。本轮未完成运动视频实窗跟踪,也未取得自动 OSC 鼠标点击回调,不能说这些已有人手验收。空间马赛克需保存完整预设,不能完整导出 Cube。 - **正式交付与恢复**:APP 公证 `6143097e-7a1b-4e95-9388-434e82acf3bc`,PKG 公证 `a9bba972-0743-469f-9869-13f94e1a1a83`,均 Accepted;票据、Gatekeeper、20 项验包和 198 条载荷权限检查通过。APP 独立正式安装并完成 FCP 验收,本轮未重复运行 PKG 安装脚本。编译节点 709 个文件、发行标签 711 个文件已独立远端检出核对;没有 LFS 指针/子模块,未重复冷构建第三方依赖。[恢复](verification/Recovery1.17.0.json) · [清理](verification/Cleanup1.17.0.json)。工作区原有 `project.pbxproj` 三处 Security 引用排序未提交、未改动。 ### 候选 98—101 的历史结果 98 移除内滚动后 FCP 固定初始 406 pt;99 提前布局使首次完整,但折叠留下空白;100 即时隐藏/恢复参数标志未刷新宿主;101 动态参数重建/延时标志切换仍导致空白,切换片段才恢复。因此四个候选均未发布,回滚 97 后清理;950 项原生检查和公证通过没有替代宿主验收。候选 101 编译提交 `2c2af3695b6dbe661db7adf544a60c58766a4e73`,公证 `4e9e5a94-a707-4733-b75c-846445d02ebd`;[拒收与回滚](verification/RejectedBuild101.json)、[候选宿主报告](verification/HostUnified1.17.0-candidate101.json) 和 [研究记录](research/UnifiedPipeline1.17.0.md) 保留。用户随后明确选择全展开测高,102 已删除 `inspectorHeightChanged:` 参数重建及标志切换实验,当前没有待答的浮窗方案问题。 接手第一步核对正式 1.17.0(102)和本段记录;若继续优化大量追加层高度或 OSC 实鼠操作,直接使用正式路径版本及既有 QA 库复核。不要恢复已拒收的参数隐藏/重建路线。 ## 1.16.0 畸变切换修复、保留参考线与全部独立模块 - 用户明确反馈“应用水平校正后畸变就没反应”。原逻辑在已有畸变面板打开、进入水平校正、再点击畸变时,会按普通开关关闭已有面板;现改为恢复畸变编辑。水平校正期间隐藏其他画布面板及其命中区域,结束后恢复。原生检查覆盖该顺序及两种空间变换同时渲染;正式 FCP 检视器实测校正后修改畸变 0→80,画面继续变化,冷重开保留。 - 水平校正把两点、参考方向和角度写入完整工具文档。完成后线仍保留;拖动端点可二次修正,每次落位一次撤销,重新进入工具会恢复。画布显示 FCP 旋转角度、总缩放及增加百分比。新增“仅测量”保留线和结果、关闭插件的旋转放大,便于使用 FCP 原始变换;已有缩放应相乘,异比例、位移或裁剪需检查边缘。 - 共 16 个独立 MOEF:一级调色、蜘蛛盘校色仪、基础调整、肤色保护、风格 LUT、HSL、曲线、颜色分级、三原色、色阶、黑白混色、色彩平衡、通道混合器、胶片模拟、镜头畸变修复、CST 色彩空间转换。每个保留屏幕工具、控制面板和追加模块,只发布自定界面;没有模板版权或网址发布项。CST 根模块隐藏一级调色参数并关闭根一级处理。原整合版、一级和 HSL 模板与 1.15.0 逐字节一致。 - 新版本没有实现可移动输出转换层。现有 V3 会把一级调色和印片集中执行,部分后续算法也会裁切颜色;必须改为真实节点顺序并逐项定义工作域,才能可靠实现全栈宽色域、最后转 709。兼容和质量方案见 [分析](research/LevelingModules1.16.0.md)。 - 922 项正式安装原生检查全部通过,16 个模板静态检查和独立远端恢复校验通过。FCP 自动指针点击没有进入 OSC 鼠标回调,故两点、拖线、参考线可见性和端点修改的实鼠验证仍待补充,不能把原生回调检查当成人手实测。接手打开独立验收库中的 `1.16.0 全独立模块`,镜头畸变片段已加载含参考线校正并设置畸变 80%;手动进入水平工具、拖线后切回畸变复核。4K→HD 的画质对照尚未实测。 - APP 已正式安装;1.16.0 PKG 已签名公证、票据和 20 项验包通过。Release 398/附件 42 已发布,发布前后两次完整下载校验通过。编译节点 657 个文件、发行标签 660 个文件独立远端检出一致。已清理构建 APP、公证 ZIP、旧替换备份、验包暂存、恢复 clone 和浏览器下载副本。[恢复](verification/Recovery1.16.0.json) · [清理](verification/Cleanup1.16.0.json)。站点文章仍为 1.14.4,主 APP 更新通道仍为上次核对的 1.12.0。 ## 1.15.0 深色默认、独立效果与水平校正 - 新用户默认深色,保存过的浅色选择会被读取。独立效果使用既有的 FxPlug 和工具文档,分别预置并展开一级调色、HSL 混色。整合版保持原路径、滤镜 UUID 和发布项。独立 `.moef` 只发布自定义检查器,模板无版权或网址发布项。三个效果随同一 PKG 安装。 - 「水平校正」支持水平或垂直、两点或拖线。按实际画面宽高比计算旋转及覆盖四角的最小放大倍率。校正应用于完整效果输出,屏幕蒙版和图章位置按同一变换映射。校正状态随效果和完整预设保存,Cube 导出会提示改用完整预设。 - FCP 12.4 独立验收库确认两个独立效果的初始模块、控制面板和继续添加模块,整合版原四组及混合仍可见。载入 −8° 校正预设后,合成网格拉平、画面覆盖四角,冷重开继续生效。两点、拖线、撤销、重置和 Esc 由 898 项正式原生自检中的 OSC 回调覆盖。自动实窗鼠标未进入 FCP 的 OSC,手动实机画线仍待复核。[验收范围](verification/HostLevel1.15.0.json) - 接手续测时可打开缓存中的独立资源库 `fcp-qa/level-1.15.0/未命名.fcpbundle`,选中 HSL 或一级调色片段,从画面右下角校正图标手动画线,复测保存与撤销。 ## 1.14.4 安装权限和启动验签 - 94 版分发后,多名用户反馈“安装完整性验证失败”。用户提供的修复记录指出有四个不可读资源及一份放在 `/Applications` 的重复 App。94 正式 PKG 的 BOM 恰有四个 `root:wheel`、`0700` 文件,分别为外层 App 的 `Basis_balanceWheel.png` 和内置模板的 `large.png`、`small.png`、`大鱼调色.moef`。在原签名副本上模拟读权限丢失可复现严格验签的 `Permission denied`,修正为 `0644` 后通过,不需要重签。PKG 自身的载荷与脚本均指向固定 FxPlug 路径并禁用重定位。未获取受影响设备的诊断或确认重复副本来源。 - 94 包中主 App 和插件服务的 Apple Developer ID 证书链均完整。单独使用系统信任根、排除用户钥匙串和联网,两条链均通过。开发机本轮复核的 94 App 是由交付脚本复制、当前用户持有的正式安装,能读取这些文件,未覆盖安装器改为 `root` 后的权限场景。 - 95 版启动和注册检查两个可执行文件、Apple Developer ID 团队、签名标识、位置关系和版本一致性。全资源和嵌套框架扫描保留给下载更新包,签名改动、重签、缺失及混装对照检查通过。交付脚本将上述四个资源设为 `0644`,打包前检查实际 App,公证后检查最终 BOM。未发布的原始 95 候选经新权限门槛确认失败后重制,历史 94 包保留。第三方机器的新版安装结果仍需回访。 - 原文 15792 已绑定附件 15865「大鱼调色-1.14.4.pkg」,在正文顶部提示验签修复并请遇到报错的用户重装。原标题和 SEO 继续描述 1.14.3 的跟踪更新,安装段已指向 1.14.4。正式下载目标取回 45,381,319 字节,与本地正式包逐字节一致,下载副本的公证票据验证通过。封面、分类、价格和会员规则回读一致。[站点验收](verification/Article1.14.4.json) ## 1.14.3 站点文章 - 在原文 15792 就地发布 1.14.3(94),更新版本介绍、安装说明、SEO、特色图片与站内主包。正文展示用户提交的 2046×1570 原图。1672×941 封面注明「不加密 · 不限制安装数量」。文章的历史界面图片、普通用户 50 元和鱼粉会员 0 元均经前台核验。 - 文章主包下载名为「大鱼调色-1.14.3.pkg」,完整下载与公证发行包的字节数及 SHA-256 一致。发布输入与两张图片保存在 [1.14.3 发布目录](Publishing/1.14.3/),前后台和附件验证见 [站点验收](verification/Article1.14.3.json)。下次更新从文章 15792 的当前内容和资源字段回读开始。 ## 1.14.3 图章稳定与逐帧跟踪预览 - `DYToolState.mm` 在连续分析段写入前,使用最多五帧的对称窗口平滑图章两侧坐标和对数缩放,起点与最后可信帧保持原值。Metal 跟踪渲染支持连续的亚像素取样,相对缩放经过 1 倍时连续过渡。取样跨出画面边缘时在最后一个像素内过渡。旧图章重新执行双向跟踪即可应用轨迹平滑。 - 仿制图章和普通蒙版共用控制面板右侧的进度和同步预览。预览采用同一分析帧的画面与轮廓,图章显示青色取样和黄色覆盖,普通蒙版显示黄色轮廓。进度统计双向分析时的唯一帧数,进度条直接按比例绘制。自动分析期间时间线播放头停在起始位置,单帧跟踪仍按宿主时间映射移动播放头。 - 在上次 257 帧 4K 轨迹离线回放中,取样中心二阶帧差 RMS 从 2.71 降到 0.95 像素,覆盖中心从 2.43 降到 0.92 像素。独立实拍副本中,图章和矩形蒙版均完成 190 帧跟踪,保存回读为连续 25 fps。94 版重跑验证了画面、轮廓和进度,51% 时条形填充与数值一致。验收覆盖本机 Final Cut Pro 12.4 与原生自检。[实拍验收](verification/HostTrackingPreview1.14.3.json) - 接续实拍反馈时,先在原问题片段重新跟踪旧图章,记录方向、首个异常时间码和取样区。若需复测,可使用本机验收库的独立副本。 ## 1.14.0 图章取样与覆盖跟踪 - 用户在 1.13.4 的实拍工程中确认图章可落位、拖动,随后要求取样点和覆盖目标都参与跟踪并识别缩放。[1.13.4 实鼠确认](verification/HostCloneStampSave1.13.4.json) - 两个区域各自使用同一宿主源帧运行 OpenCV 分析。写入的每个轨迹键同时记录两点的位置与缩放。任一侧跟丢时,提交本次最后一段两侧均可信的连续轨迹。普通蒙版沿用原分析。旧图章单点轨迹仍按位移求值,可重新跟踪以获得双点数据。 - 覆盖圈随覆盖区域缩放。渲染按取样区域和覆盖区域的相对缩放映射当前帧的源像素,两侧缩放相同时保留整数像素平移。调大或调小覆盖范围仍可独立操作。清除轨迹时将当前帧的图章外观保留为静态值。 - 89 版在 FCP 12.4 实拍素材上完成正向和双向跟踪。双向导出得到 257 个连续双点键,并发现片尾一个原有自动键与最后的新键只差 6.33 毫秒。90 版按半帧识别同帧自动键,在分析范围边缘替换旧键,同时保留手工编辑和分析范围之外的轨迹。90 版在同一 4K 源帧上生成 257 个连续双点键,无旧键残留。最终帧横纵缩放分别约为取样 1.387 / 1.689 倍,覆盖 1.169 / 1.203 倍。两边各有独立的中心轨迹。[1.14.0 实拍与原生核验](verification/HostCloneTracking1.14.0.json) ## 1.13.1 等像素复制与取样十字拖动 - 选中图章后可拖动青色取样十字。拖动时更新标记,松手后换取样位置并形成一次撤销。Esc 取消,旧图章可直接编辑。源点调整适用于图章的全部帧,目标位置轨迹保持原样。 - Metal 按整数像素偏移直接复制当前帧中的原像素,羽化只混合覆盖边缘。改变椭圆宽高只修改覆盖范围。画布和工作区移除图章旋转控件。跟踪继续用现有分析器求解运动,图章只应用中心位移。旧项目的轨迹键保留,历史缩放与旋转分量在图章求值时忽略。普通蒙版仍使用原有变换。 - 入口为 `DYToolOSC.inc.h`、`DYToolCanvasEditing.inc.h`、`DYToolHostMethods.inc.h`、`DYToolState.mm` 和 `DYGrade.metal`。画布写回继续校验时间、图章 ID 和外部修改冲突。原生检查覆盖一次撤销、Esc 取消、拖动和调尺寸时保持跟踪键,以及实际 Metal 输出的等像素复制。 ## 1.13.0 历史交付 · 画布响应与仿制图章 - 旧版工具栏重绘会清零并上传整张 CPU 位图。无蒙版、未进入图章取样时,新版只绘制工具栏和已打开面板所需的区域,并沿用宿主提供的透明画布。4K、2 倍缩放的空闲工具栏位图为 1000×134,约占 3840×2160 的 1.6%。蒙版与图章绘制仍可能使用整画布。 - 工具文档复制改用内存深拷贝,已验证的不可变文档副本共享内容。每帧快照直接从选中的关键帧生成,不再绕一次序列化往返,也只为胶片层读取颗粒参数。M4 合成测试用四条各含 2400 个键的轨迹,40 次复制平均耗时从 18.018 ms 降到 10.949 ms。上述是局部测量,第三方反馈缺少触发动作、素材和工程,尚无法对同一场景前后复测。 - 点击画布右下角仿制图章,点选取样中心,再拖出椭圆覆盖区。Esc 取消未保存操作。选中图章可直接在画布启动正向、反向或双向跟踪,也可在工作区选择图章,调整几何、强度和羽化、清除轨迹、旁路或删除。 - 图章用现有共享蒙版文档和跟踪轨迹保存,使用独立标识,每次创建为一组撤销。取样位置和原取样尺寸固定,目标跟踪位移、缩放和旋转。Metal 从每帧同一源画面采样,在调色前处理预乘 RGBA,重叠图章按创建顺序合成。完整预设保留图章,启用图章时拒绝导出无法表达空间修改的 Cube。 - 关键路径为 `DYToolOSC.inc.h`、`DYViewerControls.inc.h`、`DYToolHostMethods.inc.h`、`DYToolState.mm`、`DYManagedRender.inc.h` 和 `DYGrade.metal`。下一次排查卡顿时,先区分空闲画布、曲线拖动、工作区示波器和有蒙版的 4K 播放,再抓取对应场景的运行时间。 ## 1.12.1 历史交付 - 检视器以紧凑高度打开,顶部按钮固定在参数滚动区外。80 版在接入宿主后强改视图高度,造成顶部裁切。81 版由 FCP 管理已挂载视图的空间,超出可用高度的模块在参数区内滚动。 - 画布工具栏与曲线默认在右下。曲线顶部手柄可移动面板。松手后保留最终点位,等宿主写回后接续正式参数;保留时间和图层校验及一次手势一次撤销。 - 画布与检视器的曲线直方图取样自当前效果的输出。画布按显示帧匹配,检视器接收效果输出更新。曲线直方图与工作区四宫格示波器各有显示用途,继续沿用各自的取样和色彩说明。 - 画布新增白平衡吸管,复用基础调整的求解和参数写入;畸变修复使用枕形网格图标。独立图层被宿主拒绝写入时增加本机诊断 `dayu_tool_save_rejected`。 ## 接手时的代码入口 下表中的文件位于 `大鱼调色/Plugin/`。 | 范围 | 入口 | | --- | --- | | 检视器高度、滚动和曲线刷新 | `DYInspector.mm` 的 `layout`、`curveOutputChanged:` | | 画布工具、曲线拖动和写回 | `DYViewerControls.inc.h`、`DYViewerParameterPanel.inc.h`、`DYViewerParameterBridge.inc.h` | | 效果输出取样与直方图 | `DYScopeCapture.inc.h`、`DYScopeSample.mm`、`DYHistogram.h` | | 画布白平衡与宿主写入诊断 | `DYPlugIn.mm`、`DYColorTables.h`、`DYToolState.mm` | | 工作区、共享蒙版与跟踪 | `DYColorWorkspace.mm`、`DYToolState.mm`、`DYToolOSC.inc.h`。共享蒙版以工具文档 schema 3 为编辑源,渲染展开副本只用于渲染。[工作区与跟踪专项交接](自定控件开发交接.md) | ## 验收与待跟进 - **86 版安装完整性加固。** `Shared/DYCodeIntegrity.m` 固定 Apple Developer ID Application、团队和签名标识,验证正在运行的代码及磁盘上的外层 APP、插件服务与签名资源。外层注册前拒绝改包并撤销此副本登记。XPC 在进入 FxPrincipal 前独立校验。更新器验签失败后取消本次运行的更新任务,停用检查、下载、安装,恢复须安装原包并重开。 - **分发与边界。** 原始 PKG 允许原样转发,无机器码或账号授权。用户选择保留后端自动更新策略,由新版本在本地拒绝改包。对方若保留签名内件,只在外部加装控制,内件验签仍可通过。缺少倒卖样本,实际改法待确认。拒绝路径、旧包校验、原版更新及宿主画面均有独立记录。[完整性测试](verification/Integrity1.13.2.json) - **85 版历史防护评估。** 1.13.1(85)的正式 APP `com.dayu.color` 与 FxPlug 服务 `com.dayu.color.XPC` 都由 `B3W25FX5H5` 的 Developer ID Application 签名。该版的外层 `AppDelegate.m` 在调用 `pluginkit -a` 前只检查组件元数据。插件 `Plugin/main.m` 直接进入 `FxPrincipal`,效果清单为静态登记。 - **验签实测。** 用临时 Security.framework 探针对正式安装与独立副本执行静态签名校验,要求 Apple 签发的 Developer ID Application、指定 Team ID 和各自的签名标识。正式 APP 与服务均通过,错误标识、服务掉签、服务临时重签、Metal 资源被改及外层 APP 临时重签均被拒绝。仅重签外层时,原版内层服务单独校验仍通过。临时副本已清理。本轮未运行改包,也未获得倒卖样本,无法确认对方实际改动。 - **85 版像素复制与十字。** 正式安装的 864 项原生检查通过,实际 Metal 输出验证扩大覆盖只增加复制面积,重合像素逐值相同。FCP 12.4 独立项目副本读入 83 版图章,画布和工作区都只提供中心与尺寸控制,导出后原图章和 99 个轨迹键逐项一致。实窗自动拖动未产生宿主写入,十字拖动、一次撤销和 Esc 取消由正式安装版的原生回调覆盖。工作区“画面编辑”按钮仍沿用通用蒙版提示文字。[验收证据](verification/HostCloneSource1.13.1.json) - **83 版图章与跟踪。** 安装后的 858 项原生检查通过。FCP 12.4 独立验收项目副本中已看到图标、取样十字、目标区及实际贴图。工作区触发真实正向跟踪,冷重开后导出的预设保留 99 个轨迹键,目标几何变化,取样坐标和尺寸一致。宿主测试通过载入验收预设创建图章。画布点击及拖选由原生 FxPlug 回调测试覆盖,自动鼠标输入没有进入实窗的 OSC 回调。[验收证据](verification/HostCloneStamp1.13.0.json) - 正式 81 版通过 844 项原生检查。FCP 12.4 冷重开后,检视器顶部完整显示,曲线读到 57,600 个输出样本,原调色参数成功读回。同帧输出变更和检视器直方图刷新已通过原生检查。用户手动确认的是 80 版的画布曲线和实时直方图。[宿主验收](verification/HostCanvasInspector1.12.1.json) - **画布白平衡待实机复核。** 已验证取样入口分发、播放头改变后的写入保护、白平衡求解、色温和色调写入及一次撤销。下一次实机验收补做系统取样界面的点选和取消,核对取样后色温与色调的实际变化。[宿主验收范围](verification/HostCanvasInspector1.12.1.json) - **第三方 FCP 保存告警待反馈。** 本机内置 APFS 验收库未复现,退出重开读回正常。收到报错前的操作、时间、FCP 和插件版本、素材库位置后,再区分卷写入故障、素材库异常与特定插件写入触发;先保护原库与备份,复现在独立验收库进行。[保存告警排查](research/FinalCutSaveFailure-20261105.md) - 站点文章、自动更新通道和 Git Release 分别交付。接手通道更新时,以实时清单、正式包和对应的生产回滚记录为准。[更新部署说明](Backend/README.md) ## 继续工作 1. 核对 `git status --short --branch`、远端引用、正式安装版本与交付锁。先在独立 FCP 验收库重现用户本轮指定的问题,保留原工程和既有参数语义。 2. 代码变更按 [RECOVERY.md](RECOVERY.md) 恢复和验收。常用入口为 `tools/checkpoint.py`、`tools/deliver.py` 与 `Packaging/build_pkg.py`;交付脚本等待宿主验收时,通过后才输入 `complete`。 3. 按 [AGENTS.md](AGENTS.md) 在结束前更新本文并提交、推送、回读。 可复制到新对话: > 在 `/Volumes/备份/大鱼调色/大鱼调色` 继续优化大鱼调色。先读项目 `AGENTS.md` 和 `开发交接.md`,以核实后的正式安装和验收记录为基线,按我接下来指定的内容修改。完成后更新交接文档。 ## 任务记录 | 日期 | 任务 | 结果与接续 | | --- | --- | --- | | 2026-11-05 | 检视器、画布控件与保存告警排查 | 81 版正式安装并发布。80 版的画布反馈已复核,81 版修复检视器裁切与直方图刷新。剩余实机取样和第三方告警见上。 | | 2026-11-05 | 建立每次任务的交接流程 | 新建本入口及项目规则,为历史专项交接加指引。回读核对了正式安装 81、远程版本标签、站点文章及公测通道 79。本轮成果为项目文档。 | | 2026-11-05 | 画布响应与仿制图章 | 83 版正式安装,补齐图章渲染、现有跟踪复用及工作区编辑。性能局部测量、FCP 实帧和冷重开证据见本页,反馈场景待复现。 | | 2026-11-05 | 仿制图章等像素复制与取样十字拖动 | 加入源点拖动和撤销,复制改为整数像素平移,目标跟踪保留中心位移。 | | 2026-11-05 | 二次打包与重签防护评估 | 已核对注册和 XPC 启动入口,并用正式 85 版和改动副本验证候选验签规则。下一步可接入双入口校验并在正式安装版上复测 FCP。 | | 2026-11-05 | 防二次加密和重签 | 1.13.2(86)正式安装。注册、服务启动和更新入口加入验签,FCP 和安装包通过验收。公测 Release 393 已发布并完整下载核对,站点及自动更新策略沿用原配置。 | | 2026-11-05 | 更新 1.13.2 站点文章 | 在原文章 15792 更新正文、SEO 和主下载包,加入验签、原包转发规则、仿制图章与故障排查说明。原售价、会员权益、封面和历史图片均已回读,主包完整下载校验通过。公测自动更新通道回读为 1.12.0。 | | 2026-11-06 | 仿制图章松手消失和拖动回弹 | FCP 在同一次手势给出相差约 32 毫秒的绘制时间与参数写入时间。88 版将图章文档写入与几何时间分开,用户实拍确认可拖动。本机正式安装和 88 安装包已验收;接续实现取样与覆盖区域独立跟踪及缩放后再发 Release。 | | 2026-11-06 | 图章跳动闪烁与逐帧跟踪预览 | 1.14.3(94)正式安装和发布。图章与矩形蒙版实拍双向跟踪、轨迹回读、进度和取样连续性通过验收。 | | 2026-11-06 | 1.14.3 更新到站点文章 | 原文已发布新版本,绑定界面原图、新封面和 94 版主下载包。前台 SEO、原图与封面、商业字段和完整下载均已核验。 | | 2026-11-06 | 复核分发后的完整性失败 | 核实 94 包四个资源的落盘权限并复现严格验签失败。95 版修正权限、缩小启动检查范围并加入打包权限检查。现场证书链和宿主核验见上。 | | 2026-11-06 | 更新文章 15792 的正式包 | 原文章下载替换为 95 版,发布修复和重装提醒。前台和站内下载完整校验通过。 | | 2026-11-06 | 深色默认、独立效果与水平校正 | 1.15.0(96)已正式安装并发布,安装包完整下载校验通过。两款独立效果可添加模块。实窗手动画线待复核。 |