文件
dayu-color/大鱼调色FxPlug4交接.md
T

20 KiB
原始文件 Blame 文件历史

大鱼调色:1.4.2(31)中间帧与真实素材跟踪修复交接

当前正式版1.4.2(31),APP实际编译源码 123a6c85078e8aa41fe55577b6dab5622ed7d128。APP公证 0bb9a94e-c54a-4d87-95ec-51338579c04f Accepted,签名、票据、Gatekeeper、唯一正式安装及正式路径293项原生检查通过。固定位置 /Library/Plug-Ins/FxPlug/大鱼调色.app,Bundle ID和签名团队不变。PKG与Release最终结果见对应版本记录。

中间起点以宿主分析首帧为准,不再依赖预览缓存。4K细纹先低通再按比例缩到最高1280×720运动分析,调色渲染输出分辨率不变;拟合容差与置信度一致归一化,保留失效与过期写入保护。失跟显示具体原因、保留可信帧数并正常结束宿主任务;首帧反向使用有效种子范围正常结束;单帧经源时间到时间线转换,已有相同轨迹也正常前进。

FCP12.4正式31版在同一4K60素材的25p时间线中:中间双向285键、首帧正向285键;取消保留159键后任务闲置,可重新跟完整段;切换画面在2秒失跟、保留50键,连续重试无弹窗且任务闲置。带4秒前置片段的连续单帧7:17→7:18→7:19→7:18;首帧反向保持响应。正常退出冷重开完整预设77087字节逐字节一致。原工程、原媒体与原65键设置保留,验收只在独立副本进行。候选27–30发现的生命周期、单帧和边界问题均有记录,未发布候选包。

新增层相邻插入、加大的蒙版面板、实际鼠标钢笔/中心拖动确认等1.4.1与1.4.0历史保留。仍不是完整Color Finale移植或人物分割,遮挡/变形可能需要手工修正再从当前帧继续。Motion、Intel、变速/裁剪/非方像素工程未实机验收。

入口:实现与边界、正式宿主验收、原生及离线聚合、编译源码远端恢复、本轮清理、恢复方法。

以下为1.4.1(26)的历史交接

大鱼调色:1.4.1(26)相邻插入、蒙版面板和钢笔修复交接

当前正式版为1.4.1(26)。APP编译源码 0eb56aed126c825ca89712ce90f8cc1c05b03d89 已推送;公证 1ddc5499-2da3-4d98-8b2d-09272b0ee326 Accepted,正式位置 /Library/Plug-Ins/FxPlug/大鱼调色.app。PKG和Release结果以本版本验证记录为准。

新添加工具紧接点击处插入,重复点击原层也插在原层与既有子层之间;参数初始化且相互独立。schema2保存after锚点,实际渲染也插入对应阶段;旧schema1末尾工具保持原位置与画面。蒙版参数和数值为13pt、按钮32–36pt、滑杆单独整行,跟踪按钮两列并保留完整中文。

钢笔入口现可进入空白草稿绘制态,放点/拖柄、首点或Return/面板完成闭合、Delete回退、取消/重画、即时预览、单次撤销及连续手势已实现。修正画面提示文字上下翻转。同步内存草稿与延后作者提交分离,避免宿主回调内读写、过期目标与跨帧草稿覆盖。

跟踪按Color Finale只读行为证据独立适配实际路径范围、300特征、亚像素精炼、21×21光流及最高4K灰度帧,保留严格失效与过期写入保护。独立CPU/Metal18项通过。不能称为完整Color Finale移植;B样条、编组、人物/图像/外部蒙版、完整轨迹区段编辑等仍有差异,未做同一真实视频的完整轨迹等价对照。

正式版281项原生检查通过。FCP12.4实测相邻插入/初始化独立参数、大号面板/绘制态、钢笔蒙版正向99键、一次撤销和重做、保存重开完整预设逐字节一致。用户已用实际鼠标确认钢笔可以绘制并闭合,原答复“可以绘制并闭合”;自动化鼠标未触发画面回调。其它曲柄/删除等手势的模拟宿主原生OSC回归通过,不扩大为全部实机手势验收。1.4.0用户确认的中心拖动历史保留。

入口:本轮实现、Color Finale证据与差异、实际宿主记录、远端独立恢复、副本清理、恢复与构建。正式包和下载核验见Package.json/Release.json。

以下为1.4.0(24)的历史交接

更新日期:2026-11-01,Asia/Shanghai。当前 APP 已完成正式签名、公证、票据、唯一安装与宿主工作流检查;PKG/Release 状态以本仓库相应验证记录为准。

本轮结果与入口

十二个模块标题右侧已有“添加蒙版”和“再加一层”。第二个HSL等新增工具使用独立UUID、初始化参数、折叠/启停/复位/删除和自己的蒙版;新增工具依次排在原模块之后。原固定float ID、9001资产和1104字节ABI不变,无蒙版旧工程保留原融合内核。新增一级使用Rec.709/Gamma2.4同域默认,新增肤色保护强度零。

六种蒙版是椭圆、矩形、钢笔、线性渐变、HSL、亮度;支持相加/减去/相交、启停、反转、羽化、强度和几何数值。几何跟踪从父库固定节点 f8950384e514685c8809fe8e8ee2dd5f16ad0bd7 移植Metal光流和仿射RANSAC,并适配本产品FxAnalyzer生命周期;支持正向、反向、双向、单帧、取消及单次撤销,过期目标不回写。当前没有新增对Color Finale二进制的依赖,父工程未修改。

作者状态:DYToolState.h/.mm,9002静态工具文档、9003不保存的OSC会话。渲染:DYToolRender.inc.h、DYToolGPU.h、DYGrade.metal、tools/build_masked_kernel.py。面板:DYMaskPanel.inc.h、DYInspector.mm。原生画面与跟踪:DYToolOSC.inc.h、DYToolHost*.inc.h、DYToolFlow.inc.h、DYTracking.metal、MaskCore/。归档使用安全类白名单,预设v4包含完整工具/蒙版/轨迹,兼容v1–3。

实际编译源码 dbf25fe6719f17075362538dad0404951102524d 已推送。APP公证 40fdaaaa-1821-4cc8-bec3-c5dc6d8b9f77 Accepted;正式位置仍为 /Library/Plug-Ins/FxPlug/大鱼调色.app,Bundle ID仍为 com.dayu.color。Release前后均通过222项原生检查。FCP12.4独立合成工程实测HSL第二层0→32而原层0,独立椭圆/矩形、数值编辑、正向99键、双向100键、新增层单帧2键与播放头前进;一次撤销/重做及正常退出重开后完整预设逐字节一致。

用户已确认实际鼠标可拖动蒙版中心。 初次自动化坐标点击未进入宿主回调,随后用户实测“可以拖动,蒙版随鼠标移动”;真实hit/mouseDown/mouseDragged日志已捕获,原层中心由0.6/0.5变成0.378/0.379,新增层矩形仍为0.5/0.5。用户试调结果保留,不再自动复位或重启宿主。旋转、缩放和钢笔手势未实机确认,原生模拟宿主相关检查通过;不要扩大为所有手势都已实测。Motion、Intel、变速/裁剪/非方像素工程未实测;跟踪不含透视/剪切。新增工具标量为静态作者值,只有蒙版轨迹随时间求值;空间蒙版拒绝Cube导出,应保存完整预设。

旧模板实例可能保留关闭OSC的10005值,可先存完整预设,再应用新版效果并载入;不自动覆盖旧效果。当前模板使用父库Boolean发布契约,最新插件解析。中间20–23版均未发布最终包,旧生成APP备份在24版宿主确认后清理。远端独立恢复210文件、strict/full fsck、模型模板和着色器重建一致,临时clone已清理。

证据:实现说明、移植来源、正式安装、222项原生检查、宿主结果及缺口、远端恢复、副本清理。打包入口 Packaging/build_pkg.py,发布入口 Packaging/publish_release.py;版本标签、PKG公证和下载摘要见 verification/Package.json、verification/Release.json,不要将历史版本记录当作当前发行成功。

以下为1.3.1接手时的历史快照

下面各节中的“当前”“下一阶段”和“尚未实现”均指本轮开发前的1.3.1(19),保留作为兼容背景;最新实现以上文和实现说明为准。历史说明整理本身未编译、替换或操作当时的FCP窗口。

1. 下一阶段目标与当前边界

用户最新需求:继续增加蒙版、跟踪,以及自行添加工具的能力。明确例子是:一层 HSL 不够时,可以再添加一个 HSL,分别调整。

这里的核心是“同类工具可有多个独立实例”。新增 HSL 不能只是另一张面板共用原 HSL 的参数。蒙版应能绑定到具体工具实例,跟踪结果应驱动对应蒙版。

上述功能尚未在“大鱼调色”实现。 当前 1.3.1 是固定模块调色器;“大鱼调色盘”的图层、蒙版和跟踪代码只是下一阶段参考,不能把父库已完成的功能写成当前产品已完成。

建议开发次序:工具实例和第二个 HSL → 每实例蒙版 → 宿主画面控件 → 蒙版跟踪 → 持久化、撤销和正式交付。设计、源码入口、迁移风险及验收清单见 蒙版跟踪与工具栈续作方案。其中标为“建议”的内容是接手方案,不代表用户已经逐项指定所有类型和操作。

2. 实际项目与可恢复节点

项目 当前值
主源码目录 /Volumes/备份/大鱼调色/大鱼调色
远程 / 分支 https://dayu.media/git/dayu/dayu-color.git / main
文档整理前 main bbdd47d1d74e241f1f144bb2c245204e86973b3f
本次交接标签 handoff-mask-tracking-tools-20261101;最终提交可通过此标签解析
当前正式版本 1.3.1(19)
APP 实际编译源码 dbb7ca4a995ef832178a32f35939aed7d3a85012
正式版本标签 v1.3.1-browser-recents-20261101
正式版本标签提交 281721bda11484c23f294b4f0d9e0b30ef829288
主 ID / 插件 ID com.dayu.color / com.dayu.color.XPC
唯一正式 APP /Library/Plug-Ins/FxPlug/大鱼调色.app
唯一 FCP 模板 /Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef
固定构建缓存 /Users/mac/Library/Caches/CodexBuilds/com.dayu.color
工程 / Scheme 大鱼调色.xcodeproj / Wrapper Application,Release

工作目录、APP 编译提交、发行标签提交与后续文档提交是不同概念。恢复正式程序源码取编译提交;恢复含包记录的发行节点取版本标签;继续下一阶段从最新 main 或本次交接标签开始。已有历史版本、标签和安装包保留。

3. 已交付行为,后续须保留

  • 一级调色将输入转换、工作空间、一级参数和输出转换放在一张卡片中。使用大鱼 CST 的固定源码数学取代新实例的输入还原 LUT;四个可见旁路选项已移除,一级眼睛统一启停。旧输入 LUT、旧参数 ID 和兼容解释仍保留。
  • 新实例及全部还原:输入 Sony S-Log3(28)/ S-Gamut3.Cine(27);工作 DaVinci Intermediate(10)/ DaVinci Wide Gamut(16);输出 Gamma 2.4(1002)/ Rec.709(22);自动色调映射关闭。不要根据曲线名称覆盖用户手选色域。
  • 一级白平衡采用原 CST 色轮,保留原图、+104° 方位、/5 精细拖动、双击复位和方向键微调。底部可见“复位”只将该色轮方向、强度置零。原 BASIS 强度平方×4 的数学不变。
  • 蜘蛛盘来自“大鱼调色盘”,默认联动 6×6、31 节点;两轴可分别选择 6/8/12/16/24。固定、多选、同列自由点联动、整环/整列、复位、归档和 Cube 导出已接入。中性盘精确直通。
  • 新实例默认展开一级调色、蜘蛛盘校色仪、基础调整,其他模块折叠,全部眼睛打开。标题仅折叠,眼睛仅启停;状态独立保存。黑白混合默认 0%。
  • 风格 LUT 最多五层。库路径 /Users/mac/Movies/大鱼调色LUT/look LUTs。后台导入、取消、最后一次选择生效和 UTF-8/16/32 等编码兼容均保留。
  • LUT 浏览器在 FCP 中使用独立宿主浮动窗口。网格/列表、缩略图大小、可调整侧栏、窗口/布局偏好按库保存。最近使用分类第一位,成功应用后去重、最新优先,最多 40 个;全部及文件夹也优先显示最近项。旧版未记录的所有历史不能凭空补造;首次打开可从已有当前 LUT 初始化。
  • 33³ Cube 导出包含开启的 CST、一级白平衡、蜘蛛盘及其它逐像素色彩操作,遵循眼睛开关,折叠不影响导出;不含纹理、清晰度、去朦胧和逐画面统计。将来出现空间蒙版/跟踪后必须重新定义并明确提示导出边界。

4. 当前实现结构与兼容约束

文件 / 位置 接手用途
大鱼调色/Plugin/DYModel.h/.mm 234 个固定 float 参数、参数 ID、默认值、资产与界面归档
大鱼调色/Plugin/DYUniforms.h 当前 CPU/Metal 缓冲 1104 字节;原 944 字节前缀保持;CST 在偏移 944 追加
大鱼调色/Plugin/DYInspector.mm 固定卡片、标题/眼睛、预设 v3、LUT 提交与浏览器宿主 API
大鱼调色/Plugin/DYNewPanels.inc.h 一级白平衡色轮、可见复位、蜘蛛盘面板
大鱼调色/Plugin/DYColorTables.mm HSL、白平衡、颜色分级等 LUT 构建与缓存
大鱼调色/Plugin/DYRenderer.mm CST 前段、固定调色链、蜘蛛盘、Metal 资源、预览、Cube 导出
大鱼调色/Plugin/DYGrade.metal、tools/kernels/*.ll Metal 边界和已版本化运算内核;当前固定调色链有融合执行,尚非工具栈
大鱼调色/Plugin/DYPlugIn.mm FxTileableEffect、按宿主时间生成渲染状态、归档白名单及导出
大鱼调色/Plugin/DYLUTBrowser.mm、DYLUTLibrary.mm 窗口/布局、异步确认、最近使用;不要混入工具作者数据

当前两项 custom 参数:9000 DYInspectorToken(schema 2,folds 字典),9001 DYAssetState(LUT paths、spiderMesh、spiderLinked)。9001 注册为 NOT_ANIMATABLE,不能简单把动态工具塞进去就宣称支持宿主参数关键帧。预设 JSON 版本是 3;插件临时渲染状态的 schema 是 1;它们是不同格式的版本号。

当前 HSL 只有一组 hsl* 固定字段和一份 HSL 查表。重复工具需要独立身份、参数、缓存和撤销目标。父库 DYGrade 是 1032 字节,与本项目 DYUniforms 不同;不能直接复制其参数号、POD、Bundle ID 或整个插件入口覆盖当前产品。

归档、预设、复制、相等性、hash、允许解码类和渲染状态都必须一起演进。旧字段与数学 ID 不重排;旧工程无新增状态时保留原画面。UI 折叠键在多工具场景下应按实例 ID 隔离,不能全部共用 hsl。

5. 可复用参考:父级“大鱼调色盘”

只读目录 /Volumes/备份/大鱼调色/大鱼调色盘;远程 https://dayu.media/git/dayu/dayu-colorplate.git。本次核对干净 HEAD f8950384e514685c8809fe8e8ee2dd5f16ad0bd7。其正式 2.0.0(68)编译源码为 d05994d5f4547687511bef524efe8c881e8a5c9c,标签 v2.0.0-build68。

先读父库 HANDOFF.md、research/tracking-host-lifecycle.md 及 verification/release-2.0.0-build68.json。该库记录了矩形/椭圆/闭合钢笔区域、前后/双向/单帧、位置/旋转/独立横纵缩放、取消保留可信段和一次撤销等实现与宿主证据。它输出仿射分解后的这些变换,不能宣传为透视/剪切跟踪或任意遮挡均可靠。

下一阶段按具体功能复用其作者状态、蒙版数学、OSC 和 FxAnalyzer 生命周期适配,源文件导航见续作方案。父库现有交接另有胶片/CMS等任务,不属于本次“大鱼调色”新增范围。不改动兄弟仓库、不替换兄弟 APP、不恢复或覆盖其用户调色文件。

6. 验证现状与用户工作保护

证据 本版本实际覆盖
verification/InstalledSelfTest.json 正式路径常规 158 项原生检查
verification/BrowserNative.json 正式路径 201 项,含独立 CST 像素参照、色轮/蜘蛛盘、归档与渲染
verification/BrowserCustomization.json 23 项离屏浏览器、几何/布局/历史检查
verification/BrowserRegression.json 67 项回归,含 3,025 项目录虚拟化、取消及应用确认
verification/SpiderMath.json 25 种网格、204,683 项数学检查
verification/HostBrowserAndReset.json FCP 12.4 的 Sony 默认、可见复位、独立窗口及系统缩放、两种布局、最近排序、浏览器关闭重开
verification/BrowserRecovery.json 编译节点远端恢复 178 文件、fsck、Metal 重建与正式库一致
verification/BrowserReleaseRecovery.json 发行节点远端恢复 184 文件、fsck

自由标题栏/窗口边缘拖动未由自动化独立确认。用户开始操作浏览器后,保留其当时的网格布局、约 197.97 缩略图大小、窗口位置和 LUT 选择,未再次重启 FCP 或全部还原。这些是当时观察,不是要求下一轮强制恢复的偏好;接手以用户最新操作为准。浏览器关闭重开已测,不写成此次已重新冷启动宿主。Motion、Intel、旧系统未验收。

测试库位于 /Users/mac/Library/Caches/CodexBuilds/com.dayu.color/fcp-qa/大鱼调色_验收.fcpbundle;本轮独立项目 大鱼调色_1.3.1_浏览器与复位。只读/引用现有 LUT,未导入或删除用户 LUT。新功能用独立合成运动素材验收,不修改用户正在工作的调色、跟踪或媒体。

7. 正式交付与发布记录

  • APP 公证:9e93dc7f-04a3-44f9-a1e4-792bd7b31533,Accepted。
  • PKG 公证:85cad776-c3d7-4037-9643-24041b269002,Accepted。
  • 正式包:/Volumes/备份/大鱼调色/发行包/大鱼调色-1.3.1.pkg;14,073,683 字节。
  • SHA-256:954b10c581f31d23a8c417a6f37b24fae19939786dce8733b4d6f09c7ed3adae。
  • 1.3.1 Release,Release ID 366,附件 ID 12;附件下载链接见 verification/Release.json。
  • APP/PKG 的 Developer ID、票据、Gatekeeper、20 项展开验包通过。草稿与正式链接均完整下载校验,只上传一次。正式 APP 已安装,本轮未重复执行 PKG 安装器。

详细恢复与历史仍在 RECOVERY.md。本次整理不修改上述正式发行标签、附件或程序版本。

8. 下一位接手的操作入口

  1. 读取本文件、续作方案和本机 /Users/mac/.codex/AGENTS.md;核对 main、本地未提交改动、远端及同产品任务,保留用户正在操作的 FCP 状态。
  2. 先完成工具实例/参数/顺序/迁移合同,以“两个独立 HSL”形成可验收的第一阶段;避免先给所有模块套一个全局蒙版而日后重做。
  3. 再按续作方案接蒙版、OSC、精确时间分析、取消和单次 Undo/Redo。每阶段提交并立即推送;只暂存本任务文件。
  4. 模型修改后刷新模板:python3 tools/build_template.py --refresh-model --overwrite。
  5. 编译和 CLI 检查可在固定缓存执行;用户可见验收必须从正式安装的已公证版本进行。正式交付使用 python3 tools/deliver.py,它持有产品锁并等待宿主验收输入 complete。
  6. PKG 入口:python3 Packaging/build_pkg.py --pkg-forge-repo /Users/mac/Documents/dayu-git/repositories/pkg-forge。发布入口:python3 Packaging/publish_release.py --tag <新标签> --notes <对应说明>。不要复用本次版本号、覆盖旧包或移动旧标签。
  7. 产品身份、正式路径、逐层签名、公证、票据、PluginKit 唯一登记、生成副本清理、Release 完整下载及远端恢复都继续按全局约定执行。证书/profile/权限在下次发布时重新复核,凭据不进文档或源码。

可直接用于下一聊的任务描述:

先读“大鱼调色FxPlug4交接.md”和 research/MaskTrackingAndToolStack.md,从当前 1.3.1(19)继续。我要能添加多个独立工具,例如第二个 HSL,并给具体工具添加蒙版及蒙版跟踪。参考父级“大鱼调色盘”,保留当前 CST、折叠/眼睛、蜘蛛盘、LUT 浏览器和最近使用行为,保护已有工程和当前用户操作,分阶段验证并完成正式交付。