diff --git a/Packaging/Release-1.5.0.md b/Packaging/Release-1.5.0.md new file mode 100644 index 0000000..7f4c213 --- /dev/null +++ b/Packaging/Release-1.5.0.md @@ -0,0 +1,7 @@ +新增通道混合器:RGB三输出矩阵、保持亮度、保持饱和度和混合强度。新增胶片模拟:减色、晕光、辉光、颗粒、暗角五组,独立启停;颗粒支持固定种子与1–5帧保持。新模块均支持蒙版、区域跟踪、相邻初始化叠层和完整预设保存,既有调色链与旧工程数据保留。 + +参考本机Color Finale 2.16.2组件独立实现,产品运行和构建不加载原厂二进制。减色/颗粒接入既有sRGB边界,其余在线性纹理上;本版不含八种ACES印片外观,不承诺原版任意ACES链完全等价。纯矩阵及减色可导出Cube,活跃空间/时间效果或蒙版会提示无法保存为静态Cube。 + +349项原生检查、四种尺寸184项原版组件对照通过。FCP12.4验证用户旧234参数、资产路径、蜘蛛盘和287键蒙版载荷保持,新增层/蒙版/折叠及删除撤销重做通过。正式ProRes导出确认颗粒两帧保持,组合与颗粒完整预设冷重开前后逐字节一致,三项目FCPXML回导通过。Motion、Intel未实机验收。 + +版本1.5.0(34),Apple Silicon,macOS14.6起。APP实际编译源码 `06d531c443b0bb2f179022a4e64148394f5d0690`;APP公证 `164abf2b-4e67-4504-b72a-04122da9e381`、PKG公证 `05f849da-5567-4351-9556-742d17b95723` 均Accepted,签名、票据、Gatekeeper和20项展开验包通过。包 `大鱼调色-1.5.0.pkg`,14,380,104字节,SHA-256 `3ecabc7a8bfd675b228a5f00016aa17a35b65b544055e57793ec3bff3d7e0294`。唯一正式APP位置 `/Library/Plug-Ins/FxPlug/大鱼调色.app`,包内不含用户预设、媒体或LUT。APP已独立安装并在FCP验收;PKG仅展开验包,未再次运行系统安装器。历史标签和发行包保留。 diff --git a/README.md b/README.md index 596a992..712a175 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,20 @@ # 大鱼调色 -原生 FxPlug 4 调色器,当前正式安装版本 **1.4.3(33)**。唯一安装位置为 `/Library/Plug-Ins/FxPlug/大鱼调色.app`;Final Cut Pro 中从“效果 → 大鱼调色”添加。 +原生 FxPlug 4 调色器,当前正式安装版本 **1.5.0(34)**。唯一安装位置为 `/Library/Plug-Ins/FxPlug/大鱼调色.app`;Final Cut Pro 中从“效果 → 大鱼调色”添加。 -下一阶段接续入口:[交接文档:Color Finale胶片模拟](大鱼调色FxPlug4交接.md)。当前尚未注册独立胶片模拟工具;父工程研究快照与当前实现范围已在交接中分开列明。 +交接与恢复入口:[大鱼调色FxPlug4交接.md](大鱼调色FxPlug4交接.md)。 + +## 胶片模拟与通道混合器 + +新增可重复的胶片模拟和通道混合器,现有调色、蒙版、区域跟踪和相邻叠层保留。每个新工具都有独立眼睛、折叠、复位、蒙版、数量标记和“再加一层”;新增层从默认值开始。 + +通道混合器按红、绿、蓝输出分组,每个输出有三个输入系数,并提供保持亮度、保持饱和度和混合强度。胶片包含减色、晕光、辉光、颗粒、暗角五组,各自启停;颗粒支持精确帧时间、1–5帧保持和固定种子。默认保持中性,旧工程缺省不改变画面。 + +本机Color Finale 2.16.2的相关数学已单独取证并对照,产品独立构建,不加载原版APP或原版二进制。新阶段位于既有显示域链之后;减色/颗粒沿用本工程sRGB边界,其余在线性域。活跃减色沿用原核的0–1限幅;不宣称与原版全部ACES管理路径完全等价。原版ACES输出中的八种印片外观未纳入本版五组处理。 + +完整预设升级为v5,兼容旧版。纯通道矩阵和减色可导出Cube;活跃晕光、辉光、颗粒、暗角和蒙版不能保存为静态Cube,导出时说明原因。 + +349项原生检查、四种尺寸184项原版组件对照通过。FCP12.4验证旧234参数、LUT路径、蜘蛛盘和全部287键蒙版载荷不变;新增层默认值、蒙版数量、折叠、删除撤销/重做、冷重开通过。1920×1080正式导出验证“两帧保持”,组合预设8987字节及颗粒预设8420字节重开前后逐字节一致。见[研究与边界](research/ColorFinaleFilmMixer.md)、[组件对照](verification/FilmMixerReference.json)、[宿主验收](verification/HostFilmMixer1.5.0.json)。 ## 蒙版折叠与标题标记 @@ -38,9 +50,9 @@ LUT 缩略图浏览器使用宿主的独立可调整窗口:拖动标题栏移 ## 每工具蒙版与再次添加工具 -十二个模块标题均有“添加蒙版”和“再加一层”。新增工具紧接点击的原工具或新增工具插入,从本工具的初始化参数开始,拥有独立启停、折叠、复位、删除、LUT 和蒙版;不会复制原层当前设置。新增一级采用 Rec.709/Gamma 2.4 同域输入输出,新增肤色保护强度为零。 +十四个模块标题均有“添加蒙版”和“再加一层”。新增工具紧接点击的原工具或新增工具插入,从本工具的初始化参数开始,拥有独立启停、折叠、复位、删除、LUT 和蒙版;不会复制原层当前设置。新增一级采用 Rec.709/Gamma 2.4 同域输入输出,新增肤色保护强度为零。 -蒙版包括椭圆、矩形、钢笔、线性渐变、HSL 和亮度选区,支持相加、减去、相交、反转、羽化和强度。矩形、椭圆和闭合钢笔区域可正向、反向、双向或单帧跟踪。算法从“大鱼调色盘”固定源码适配,随本产品独立构建;不依赖安装父插件。完整预设 v4 保存新增工具、蒙版和逐帧轨迹,兼容旧预设。空间蒙版不能导出到 Cube,导出时会提示。 +蒙版包括椭圆、矩形、钢笔、线性渐变、HSL 和亮度选区,支持相加、减去、相交、反转、羽化和强度。矩形、椭圆和闭合钢笔区域可正向、反向、双向或单帧跟踪。算法从“大鱼调色盘”固定源码适配,随本产品独立构建;不依赖安装父插件。完整预设 v5 保存新增工具、蒙版和逐帧轨迹,兼容旧预设。空间蒙版不能导出到 Cube,导出时会提示。 蒙版检视器采用13pt参数文字和数值、32–36pt按钮、独立整行滑杆及两列跟踪操作。钢笔菜单直接进入绘制态,可点击放点、拖出曲柄、点首节点/Return/“完成绘制”闭合,Esc/取消保留原路径;支持重画、Delete回退和即时预览。跟踪改进实际路径搜索边界、300点特征、亚像素精炼和21×21光流,运动分析按显示比例限制到1280×720,4K细纹先低通再缩小,调色渲染和输出分辨率保持原设置。 @@ -79,6 +91,6 @@ LUT 缩略图浏览器使用宿主的独立可调整窗口:拖动标题栏移 正式发行包由 PKG 工坊技能生成,包含 APP 与 FCP 模板,不含用户 LUT、预设或媒体。安装与发布证据分别保存在 [Package.json](verification/Package.json) 和 [Release.json](verification/Release.json);以其中记录的版本和成功状态为准。 -正式发行包:[大鱼调色-1.4.3.pkg](../发行包/大鱼调色-1.4.3.pkg);APP与PKG均已签名、公证、粘附票据并通过Gatekeeper,20项展开验包通过。[1.4.3 Release](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.4.3-mask-fold-20261102)已发布,草稿和发布后的完整下载字节数、SHA-256均一致。历史[1.4.2 Release](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.4.2-tracking-midpoint-20261102)及更早发行包、标签和验收记录保留。 +正式发行包:[大鱼调色-1.5.0.pkg](../发行包/大鱼调色-1.5.0.pkg);APP与PKG均已签名、公证、粘附票据并通过Gatekeeper,20项展开验包通过。发行标签 `v1.5.0-film-mixer-20261102`,上传与下载核验结果以 [Release.json](verification/Release.json) 中匹配本版的记录为准。历史[1.4.3 Release](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.4.3-mask-fold-20261102)及更早发行包、标签和验收记录保留。 1.3.1 的历史验收包含 Sony 默认、可见复位、浮动浏览器、系统窗口缩放、两种布局、最近排序与关闭重开。原生检查单独覆盖几何/布局持久化和鼠标事件;当时自动化没有独立确认自由标题栏/边缘拖动。1.4.0 另在独立合成工程中完成上文的宿主检查,用户确认中心拖动后保留其试调状态。 diff --git a/RECOVERY.md b/RECOVERY.md index 30c5b9a..87f75ec 100644 --- a/RECOVERY.md +++ b/RECOVERY.md @@ -1,8 +1,18 @@ # 大鱼调色恢复说明 -下一阶段胶片模拟移植接手入口:[大鱼调色FxPlug4交接.md](大鱼调色FxPlug4交接.md)。2026-11-02本轮仅整理文档,APP仍为已公证1.4.3(33),编译节点与发行标签未变;历史交接移至[归档](research/handoffs/DayuColorThrough1.4.3-20261102.md)。 +当前交接:[大鱼调色FxPlug4交接.md](大鱼调色FxPlug4交接.md)。 -## 当前 1.4.3(33):蒙版折叠与数量标记 +## 当前1.5.0(34):胶片与通道混合器 + +正式路径 `/Library/Plug-Ins/FxPlug/大鱼调色.app`;Bundle ID `com.dayu.color` / `com.dayu.color.XPC`。实际编译源码 `06d531c443b0bb2f179022a4e64148394f5d0690`;APP公证 `164abf2b-4e67-4504-b72a-04122da9e381` Accepted,签名、票据和Gatekeeper通过。安装与启动从唯一正式位置执行,FCP12.4已验收,记录见 `verification/Delivery.json` 与 `verification/HostFilmMixer1.5.0.json`。 + +主分支远程 `https://dayu.media/git/dayu/dayu-color.git`,无LFS或子模块。新增胶片与RGB混合的全部源码、Metal、参数/模板均在仓库,不依赖本机Color Finale、REA缓存或父工程。42个参数追加,944字节GPU前缀和1104字节旧版完整前缀保持。恢复时使用固定标签/提交,证书与私钥须单独恢复,不能由Git替代。 + +远端独立clone已完成Release构建及349项检查,四种尺寸原版组件对照184项通过。组件证据、域/顺序及限制见 `research/ColorFinaleFilmMixer.md`。当前用户媒体、完整预设、FCP资源库和验收导出只在本机,不进入仓库或安装包。安装包与Release元数据见本轮Package/Release记录。 + +正式PKG `../发行包/大鱼调色-1.5.0.pkg`,14,380,104字节,SHA-256 `3ecabc7a8bfd675b228a5f00016aa17a35b65b544055e57793ec3bff3d7e0294`;PKG公证 `05f849da-5567-4351-9556-742d17b95723` Accepted,签名、票据、Gatekeeper与20项展开验包通过。本轮未再次运行系统安装器,正式APP已有独立安装和宿主验收。发行标签 `v1.5.0-film-mixer-20261102`;发布与全量下载结果见匹配本版的 `verification/Release.json`。 + +## 历史 1.4.3(33):蒙版折叠与数量标记 当前正式版1.4.3(33),APP实际编译源码 `26a888f4534792481c6a9933091cb0b23307cd24`,公证 `e755670d-8fb3-46d2-95c3-1206f014d16d` Accepted。签名、票据、Gatekeeper、唯一正式安装及正式路径293项既有原生检查通过。正式位置和Bundle ID不变。 diff --git a/research/ColorFinaleFilmMixer.md b/research/ColorFinaleFilmMixer.md index e095a19..481241f 100644 --- a/research/ColorFinaleFilmMixer.md +++ b/research/ColorFinaleFilmMixer.md @@ -45,3 +45,8 @@ Cube只允许可静态表示的颜色数学;空间效果、颗粒和蒙版必 正式构建准备:1.5.0(34),349项原生检查通过;独立原版对照在64×48、63×47、1×17、17×1四种尺寸共184项全部通过,含零矩阵/灰矩阵退化分支。上下纹理方向的颗粒固定全帧坐标验证通过;元数据旧前缀、原有跟踪/钢笔检查仍包含在原生回归中。静态3D Cube允许通道矩阵和纯减色,拒绝活跃的晕光/辉光/颗粒/暗角。FCP夹具只有三个独立合成项目,FCPXML1.12严格DTD与素材检查通过,不把内部FxPlug ID冒充模板发布参数路径;通过正式检视器设置验收参数。 兼容边界:新模块关闭/零混合以及旧工程缺省走原融合链;活跃减色沿用原SubSat对0…1的限幅。晕光/辉光保留邻域alpha权重,所有新处理保留入口alpha,非正alpha旁路;颗粒全帧种子不依赖Core Image内部切块顺序。原厂八种印片外观是ACES输出的另外一组资源,本轮五组胶片处理未使用这些资源,也不以相机F-Log名称冒充印片外观。 +## 正式1.5.0(34)验收完成 + +实际编译源码 `06d531c443b0bb2f179022a4e64148394f5d0690`。正式安装349项原生检查通过,FCP12.4对用户旧234参数、资产路径、蜘蛛盘及287键蒙版载荷核验保持。新工具、胶片椭圆蒙版、折叠数量、独立初始化叠层及删除撤销/重做通过。正式ProRes导出验证颗粒两帧保持,组合/颗粒完整预设冷重开前后逐字节相同。三项目原生FCPXML回导严格校验与字段比较通过。见 `verification/HostFilmMixer1.5.0.json`;四尺寸184项独立组件对照见 `verification/FilmMixerReference.json`。本轮交付五组胶片处理及矩阵,不含八种ACES印片外观。 + +APP和PKG均Developer ID签名、公证Accepted、票据/Gatekeeper通过;PKG有20项展开验包,未再次执行安装脚本。发行包、标签、全量下载和恢复结果分别见 `verification/Package.json`、`verification/Release.json` 与本版恢复记录。 diff --git a/research/handoffs/DayuColorFilmStart1.4.3-20261102.md b/research/handoffs/DayuColorFilmStart1.4.3-20261102.md new file mode 100644 index 0000000..0fdd10f --- /dev/null +++ b/research/handoffs/DayuColorFilmStart1.4.3-20261102.md @@ -0,0 +1,122 @@ +# 大鱼调色交接:1.4.3 基线与 Color Finale 胶片模拟接续 + +更新日期:2026-11-02(Asia/Shanghai)。本轮只整理交接文档,未改程序、未重新安装或重启宿主,也未开始胶片模块的算法迁移。下一阶段目标是从本机 Color Finale 分析并移植胶片模拟模块。 + +## 1. 先认准项目与可恢复基线 + +| 项目 | 当前值 | +| --- | --- | +| 当前源码根目录 | `/Volumes/备份/大鱼调色/大鱼调色` | +| 远程 / 分支 | `https://dayu.media/git/dayu/dayu-color.git` / `main` | +| 交接文档编辑前 main | `7814a03f95f9f3c3461af2566e7412c1e5c561e1`;后续文档提交在此节点之上 | +| 正式 APP | `/Library/Plug-Ins/FxPlug/大鱼调色.app`,1.4.3(33) | +| 主 / XPC Bundle ID | `com.dayu.color` / `com.dayu.color.XPC` | +| APP 实际编译源码 | `26a888f4534792481c6a9933091cb0b23307cd24` | +| 已发布标签 | `v1.4.3-mask-fold-20261102` | +| 标签对应提交 | `301b31438e8da95dc4e6e1c09498ad814a0ebcfc`,含最终交付记录,区别于 APP 编译节点 | +| FCP 模板 | `/Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef` | +| 固定构建缓存 | `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color` | +| 父“大鱼调色盘”源码 | `/Volumes/备份/大鱼调色/大鱼调色盘`,只读参考固定提交 `f8950384e514685c8809fe8e8ee2dd5f16ad0bd7` | + +接手后先查看实际工作区、分支和远端;不要用本表覆盖其他任务的新改动。当前大鱼调色是独立 FxPlug 程序,不依赖父项目或 Color Finale APP 才能运行。历史各轮说明已归档到 [历史交接](research/handoffs/DayuColorThrough1.4.3-20261102.md)。 + +## 2. 已完成并应保留的行为 + +- 一级调色包含输入 CST → 工作空间一级处理 → 输出 CST;后续基础调整、HSL、曲线等仍按既有显示域链处理。胶片接入时要重新确定域和位置,不能把父项目的顺序直接套进来。 +- 各模块标题只控制展开/折叠,眼睛控制启用/旁路。再次添加工具在点击处相邻插入初始化层,旧 schema1 尾层保留位置;新增层参数独立。 +- 每工具蒙版含椭圆、矩形、钢笔、线性渐变、HSL、亮度选区;支持组合、反转、羽化和强度。矩形/椭圆/闭合钢笔有区域运动跟踪。 +- 1.4.1 已有用户实际鼠标确认钢笔可绘制并闭合;1.4.0 已有中心拖动确认。自动化鼠标未可靠进入 FCP 的画面回调,不能把其余手势扩大为实鼠验收。 +- 1.4.2 修复中间帧起跟、4K细纹误失跟、取消/失跟后的宿主任务结束、偏移片段单帧定位和边界互等。运动分析最高1280×720,先低通再降采样;调色渲染和输出分辨率不变。区域仿射跟踪不是人物分割或非刚性描边。 +- 1.4.3 蒙版面板随所属模块一起折叠;标题栏蒙版按钮旁显示数量标记,无蒙版时隐藏。计入已停用蒙版,原模块和独立层分别计数,删除/撤销即时更新。 + +正式1.4.3通过293项既有原生检查。FCP12.4验证折叠/展开、数量2/1、删除到零和撤销、正常退出冷重开;用户当时完整77276字节预设逐字节一致,286个轨迹键保留,独立合成片段8471字节预设操作前后及重开也一致。293项检查不是对尚未实现的胶片模块的验收。 + +最近用户试调位于独立验收项目“大鱼调色_28_中间帧双向”,不能当作随时可复位的空白实例。完整预设和 FCPXML 仅在本机 `.../com.dayu.color/fcp-qa/`:`fold31-before.json`、`fold33-user-after.json`、`fold33-fixture-reopen.json` 等;不要写进 Git、PKG 或覆盖原素材。 + +## 3. 源码接入入口 + +下表路径相对于当前源码根目录。 + +| 入口 | 用途 | +| --- | --- | +| `大鱼调色/Plugin/DYModel.mm`、`DYModel.h` | 参数描述、分组、默认值、宿主参数与预设 | +| `大鱼调色/Plugin/DYUniforms.h` | CPU/Metal ABI;当前自检1104字节,`cm`偏移944的前缀有静态断言 | +| `大鱼调色/Plugin/DYRenderer.mm` | Metal设备、渲染调度、LUT资源、输入输出与导出 | +| `大鱼调色/Plugin/DYGrade.metal` | 现有 GPU 包装、色彩管理及逐像素处理入口 | +| `大鱼调色/Plugin/DYToolRender.inc.h`、`DYToolGPU.h` | 独立工具计划、逐层处理与蒙版混合 | +| `大鱼调色/Plugin/DYToolState.mm`、`DYToolState.h` | `DYToolTypes`、工具默认状态、schema1/2、after锚点、蒙版与安全归档 | +| `大鱼调色/Plugin/DYInspector.mm` | 模块布局、`toggleSection:`、`DYMaskCountBadge`、蒙版数量刷新 | +| `大鱼调色/Plugin/DYToolInspector.inc.h` | 相邻插入、独立层界面及其布局 | +| `大鱼调色/Plugin/DYMaskPanel.inc.h` | 蒙版控件、状态和跟踪按钮 | +| `大鱼调色/Plugin/DYToolHostMethods.inc.h` | FxAnalyzer 生命周期;胶片任务无需顺带改写 | +| `tools/build_kernels.py`、`tools/kernels/` | 可版本恢复的 AIR/Metal 生成与链接,不能只替换某个本机 metallib | +| `tools/build_template.py`、`template/sources/` | 原生模板与参数档案;模型改变后重建并核对 | + +当前 `DYToolTypes` 有12类,未注册独立胶片模拟工具。相机输入项里的 Blackmagic Film / Fujifilm F-Log 是色彩管理输入名称,不能据此认定已有胶片模拟模块。完整预设当前为 v4,已有9000/9001/9002自定义载荷及9003画布会话;参数ID、归档兼容和既有 Uniform 前缀不能挪作新用途。 + +## 4. Color Finale 参考身份与已有证据 + +本次只复核了本机包元数据和可执行文件摘要,未新做胶片函数分析或原版输出对照。 + +| 项目 | 本机已核对值 | +| --- | --- | +| APP | `/Applications/ColorFinale.app`,2.16.2(625),`com.colorfinale.app` | +| 主插件二进制 | `/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale` | +| 插件 Bundle ID | `com.colorfinale.ColorFinaleFxPlug` | +| 二进制 SHA-256 | `49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f` | +| 胶片界面定位线索 | `Contents/PlugIns/ColorFinale.pluginkit/Contents/Resources/zh-Hans.lproj/FTFilmEmulationViewController.strings`(相对APP) | +| 既有只读研究 | [ColorFinaleMasksFollowup.md](research/ColorFinaleMasksFollowup.md) 与对应 JSON | +| 既有本机 REA 缓存 | `/Users/mac/Library/Caches/CodexBuilds/ColorResearch/dayu-mask-followup-20261101/` | + +现有 REA 证据主要对应蒙版/跟踪,不能当作胶片模块已分析。下一轮先核对目标摘要、可用会话及保留证据;仅复用身份匹配的资料。原版胶片的参数、默认值、阶段、数学、资源依赖和实际图像行为均需要单独取证。 + +REA 技能入口:`/Users/mac/.agents/skills/reverse-engineer-anything/SKILL.md`。分析原厂二进制时使用其目标绑定和证据流程;查看当前完整源码则直接读工程,不为普通源码阅读启动逆向工具。静态字符串/类名只是定位线索,不能代替执行行为或图像对照。 + +## 5. 父项目可以参考什么 + +`research/color-finale/` 内四份研究资料是父工程提交 `4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca` 的快照,见 [快照来源](research/color-finale/README.md)。其中“已接入”“正式版”等表述属于父工程,不能当作当前大鱼调色的完成项。快照里部分相对链接没有随包文件,应回到父工程查找。 + +父工程固定提交 `f8950384e514685c8809fe8e8ee2dd5f16ad0bd7` 中可只读参考: + +- `research/film-processing-contract.md`、`research/colorfinale-film-chart-findings.md`; +- `Core/DYFilm.h`、`Core/DYFilmCPU.hpp`; +- `Sources/DYFilmState.h`、`DYFilmState.inc`、`DYPanelFilm.inc`、`DYFilmEditor.inc`; +- `Tools/film_test.mm`、`film_panel_test.inc`、`test_film.py` 与 `verification/film-development.json`。 + +父合同记录的是独立算法v1:减色→晕光→辉光→暗角→颗粒,父工程根级状态、线性域处理及保守拒绝活跃胶片的LUT导出。可复用其工程组织、时间一致性和边界测试思路;不代表当前工程已有相同链路,更不代表与 Color Finale 数学或同名胶片外观一致。不要把父工程“只在根级”的约束当作用户已经确定的本工程设计。 + +## 6. 下一阶段建议的工作顺序 + +1. **先建立原版功能与参数表。** 从本机胶片面板定位 Film Look、减色、Halation、Bloom、Vignette、Grain 等候选功能,逐项确认本机版本是否具备、名称、默认、范围、单位、开关、预设及资源依赖;候选清单不是已证实功能清单。 +2. **确认处理域和顺序。** 跟进面板状态→归档/参数→渲染调度→CPU/Metal/表格资源,明确与输入、工作空间、输出CST、HDR、alpha和混合的关系。先记录已观察、推断、未知,再决定当前大鱼的接入位置。 +3. **确定模块形态。** 尚未定为全局胶片阶段还是可重复工具。若进入现有工具模块体系,接好独立初始化、眼睛、折叠、蒙版及数量标记;若全局阶段有不同语义,先把具体设计说明写清。保留旧工程缺省时的旁路与原画面。 +4. **做可比较的图像验证。** 同一输入、同一色彩空间、同一参数分别取得原版与大鱼输出,覆盖灰阶/色块/高光、真实素材、不同分辨率及透明边缘。不能只靠“视觉像胶片”或加一个LUT宣称等价;确属独立重建的部分写明差异。 +5. **补齐空间与时间行为。** 晕光/辉光若涉及邻域需独立中间纹理和预算;颗粒若随时间变化需精确帧时间、固定种子/状态、随机访问/并发/重开的一致性。零强度与关闭保持中性,保留负值/HDR、alpha与非有限值处理。 +6. **完成持久化、导出和正式验收。** 新参数ID不复用,归档/预设兼容旧版本;纯色变换与空间/时间效果的Cube能力分别判定,不能把颗粒、晕光等错误写成静态3D LUT。随后做撤销/重做、保存重开、旧工程、蒙版/重复层、FCP实际渲染和正式交付。 + +## 7. 构建、交付与恢复入口 + +沿用本机全局规则与项目现有工具。本轮是文档更新,未生成新构建或移动已发布标签;下一轮真正改程序后再递增构建与版本。 + +```sh +# 在源码根目录;模型改变时先更新原生参数档案和模板 +python3 tools/build_template.py --refresh-model --overwrite +# Release构建、由内到外签名、公证Accepted、票据、唯一安装;等待宿主验收 +python3 tools/deliver.py +# 宿主验收通过后才在交付进程输入complete,并补写本轮hostVerification记录 +python3 Packaging/build_pkg.py --pkg-forge-repo /Users/mac/Documents/dayu-git/repositories/pkg-forge +``` + +- 正式宿主测试使用固定位置的已公证APP;不从DerivedData启动临时GUI,不强制结束宿主绕过保存。 +- 产品交付锁:`/Users/mac/.codex/app-delivery-locks/com.dayu.color.lock`。Git检查点用 `tools/checkpoint.py` 的仓库锁;只提交已审查的本任务文件。 +- 签名团队 `B3W25FX5H5`;Application / Installer身份和公证profile按本机规则重新验证。公证profile `codex-dayu-notary-B3W25FX5H5`,钥匙串 `/Users/mac/Library/Keychains/login.keychain-db`。文档中不存凭据。 +- 正式PKG生成后,标签先推送核验,再用 `Packaging/publish_release.py` 上传草稿;完整下载核对大小及SHA-256后发布,再核验已发布下载。保持现有仓库可见性,不覆盖旧附件或移动标签。 +- 无LFS/子模块。恢复任一已保存源码:克隆上述远程,检出明确提交或标签,再依 RECOVERY 构建;证书私钥、用户媒体与预设独立保存。 + +当前发行包:`/Volumes/备份/大鱼调色/发行包/大鱼调色-1.4.3.pkg`,14,340,650字节,SHA-256 `41bba698a70a7629438688a4be74947f424f3af04190090c44f248827b4c3bb2`。APP公证 `e755670d-8fb3-46d2-95c3-1206f014d16d`,PKG公证 `f9218078-8fd0-4a0c-9240-4b1acf7d9655`,均Accepted;签名/票据/Gatekeeper、20项展开验包通过。PKG未再次运行安装器,APP已有独立正式安装和宿主验收。 + +[Release371](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.4.3-mask-fold-20261102) / 附件16已在草稿与发布后完整下载核验。对应证据:[Delivery](verification/Delivery.json)、[Package](verification/Package.json)、[Release](verification/Release.json)、[本轮宿主验收](verification/HostMaskFolding1.4.3.json)、[编译源码恢复](verification/MaskFoldingRecovery.json)、[发行标签恢复](verification/MaskFoldingReleaseRecovery.json)、[RECOVERY](RECOVERY.md)。 + +## 8. 新对话的接手提示 + +> 阅读 `/Volumes/备份/大鱼调色/大鱼调色/大鱼调色FxPlug4交接.md`。以当前正式1.4.3(33)和已推送源码为基线,接下来分析本机Color Finale 2.16.2(625)的胶片模拟模块,先产出功能/参数/处理域与顺序的证据表,再按现有大鱼调色架构移植并完成正式交付。父“大鱼调色盘”的胶片代码仅作有出处的参考;保留用户现有调色、蒙版、轨迹、相邻叠层、折叠和数量标记行为。 diff --git a/verification/Delivery.json b/verification/Delivery.json index 1ca11db..328e5ec 100644 --- a/verification/Delivery.json +++ b/verification/Delivery.json @@ -2,15 +2,17 @@ "status": "verified", "path": "/Library/Plug-Ins/FxPlug/大鱼调色.app", "bundleID": "com.dayu.color", - "version": "1.4.3", - "build": "33", + "version": "1.5.0", + "build": "34", "team": "B3W25FX5H5", - "notaryID": "e755670d-8fb3-46d2-95c3-1206f014d16d", + "notaryID": "164abf2b-4e67-4504-b72a-04122da9e381", "notaryStatus": "Accepted", "gatekeeper": "/Library/Plug-Ins/FxPlug/大鱼调色.app: accepted\nsource=Notarized Developer ID", - "sourceCommit": "26a888f4534792481c6a9933091cb0b23307cd24", + "sourceCommit": "06d531c443b0bb2f179022a4e64148394f5d0690", "templatePath": "/Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef", - "templateSHA256": "9b8f6e407545429b77c1de88d4cceb738760771c5a7f1dbd9732bdcc95c23738", - "shaderSHA256": "b3258b903ed485b4b738a823a7de929bca9380365ad2de9c2c7781660293df7e", - "hostVerification": "verification/HostMaskFolding1.4.3.json" + "templateSHA256": "7476fb5a3cfad5f4dafb7a887dcc787b9cbcba6ad64df3b4939b336444cf8bfc", + "shaderSHA256": "b05051fa34cf68bfb7fd3cc77f277620c7e744f927c35dd956e144ed1f748679", + "hostVerification": "verification/HostFilmMixer1.5.0.json", + "nativeChecks": 349, + "referenceChecks": 184 } diff --git a/verification/FilmMixerDevelopment.json b/verification/FilmMixerDevelopment.json index bf17e24..371d250 100644 --- a/verification/FilmMixerDevelopment.json +++ b/verification/FilmMixerDevelopment.json @@ -1,5 +1,5 @@ { - "status": "ready-for-formal-delivery", + "status": "verified-formal-install-and-host", "baseline": "1.4.3 (33)", "nativePass": true, "checks": 349, @@ -25,7 +25,12 @@ ] ] }, - "formalInstallUnchanged": true, + "formalInstallUnchanged": false, + "formalVersion": "1.5.0", + "formalBuild": "34", + "compiledSource": "06d531c443b0bb2f179022a4e64148394f5d0690", + "hostVerification": "verification/HostFilmMixer1.5.0.json", + "packageVerification": "verification/Package.json", "targetVersion": "1.5.0", "targetBuild": "34" } diff --git a/verification/FilmMixerRecovery.json b/verification/FilmMixerRecovery.json new file mode 100644 index 0000000..1d3a3f8 --- /dev/null +++ b/verification/FilmMixerRecovery.json @@ -0,0 +1,16 @@ +{ + "status": "verified", + "remote": "https://dayu.media/git/dayu/dayu-color.git", + "commit": "eeeee102cd78b8f99be743be634739286fed8a76", + "clone": "/Users/mac/Library/Caches/CodexRecovery/dayu-color-film-1.5.0", + "lfs": false, + "submodules": false, + "releaseBuild": true, + "nativeChecks": 349, + "nativePass": true, + "sourceHasAllFilmMath": true, + "generatedAppsRemoved": [ + "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/RecoveryDerivedData/Build/Products/Release/大鱼调色.app", + "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/RecoveryDerivedData/Build/Products/Release/大鱼调色 XPC Service.pluginkit" + ] +} diff --git a/verification/HostFilmMixer1.5.0.json b/verification/HostFilmMixer1.5.0.json new file mode 100644 index 0000000..4f2fe27 --- /dev/null +++ b/verification/HostFilmMixer1.5.0.json @@ -0,0 +1,100 @@ +{ + "status": "passed", + "targetVersion": "1.5.0", + "build": "34", + "sourceCommit": "06d531c443b0bb2f179022a4e64148394f5d0690", + "formalPath": "/Library/Plug-Ins/FxPlug/大鱼调色.app", + "host": "Final Cut Pro 12.4", + "baseline": { + "version": 4, + "presetBytes": 77437, + "presetSHA256": "02b4f0e8ff52b9d27449d208fd7b2b09ed92440a578f09688a1a5f461cfcc172", + "floatParameterCount": 234, + "toolLayers": 0, + "masks": 1, + "trackKeys": 287 + }, + "nativeChecks": 349, + "referenceCases": 184, + "privacy": "User media, project and full presets stay local; report contains aggregate counts and hashes.", + "userCompatibility": { + "allExisting234ValuesUnchanged": true, + "assetPathsAndSpiderUnchanged": true, + "toolsAndAll287KeysByteIdentical": true, + "uiTrustedKeys": 286, + "newDefaultParameters": 42, + "afterVersion": 5, + "afterBytes": 78460, + "afterSHA256": "40772a5b481f197a4f1bf75e51f14159d02416ef68a7e68fca2397c2fc26e094" + }, + "hostGrainExport": { + "width": 1920, + "height": 1080, + "fps": "25/1", + "duration": "4.000000", + "codec": "prores", + "frames": [ + "7719df2ae1cf5ea9375041270cf71e926472250e6813797b31f0a7a76bed11fb", + "7719df2ae1cf5ea9375041270cf71e926472250e6813797b31f0a7a76bed11fb", + "84b06b3dbb1f4acf6540a93f3f9ddfec1e806ca09bf6523bcf2f4853c292b252", + "84b06b3dbb1f4acf6540a93f3f9ddfec1e806ca09bf6523bcf2f4853c292b252", + "36fb6225db64ecafbc98bac0c864b9b7406226ff452e1b8c32b52f7fe282c4e1", + "36fb6225db64ecafbc98bac0c864b9b7406226ff452e1b8c32b52f7fe282c4e1" + ], + "adjacentEqual": [ + true, + false, + true, + false, + true + ], + "presetHold": 2 + }, + "hostChecks": { + "newModulesVisible": true, + "mixerThreeOutputsAndPreserveControls": true, + "filmFiveTabs": true, + "subtractiveHalationBloomVignetteAdjusted": true, + "filmMaskCount": 1, + "foldHidesMaskControlsKeepsBadge": true, + "independentMixerLayerInitialized": true, + "layerDeleteUndoRedoRestored": true, + "normalQuitConfirmed": true, + "coldReopenAllStatePreserved": true + }, + "combinedPresetBefore": { + "bytes": 8987, + "sha256": "6c7c08c8b17add17c22d165b2190eff3919c742b8dfae46703ff399cabd71581" + }, + "roundtrip": { + "projects": 3, + "format": "FCPXML 1.14", + "strictDTD": "pass", + "missingMedia": 0, + "comparedFields": "match", + "differences": [] + }, + "hostCombinedExport": { + "width": 960, + "height": 540, + "fps": "25/1", + "durationSeconds": 4, + "allFramesDecode": true + }, + "coldReopen": { + "combined": { + "semanticEqual": true, + "byteIdentical": true, + "bytes": 8987, + "sha256": "6c7c08c8b17add17c22d165b2190eff3919c742b8dfae46703ff399cabd71581" + }, + "grain": { + "semanticEqual": true, + "byteIdentical": true, + "bytes": 8420, + "sha256": "f87d0cf75c77c01ffa5076592f133f3a957a0480077752f0fcdef8be765c468d" + } + }, + "passResult": true, + "appSourceIdenticalToReferenceCandidate": "eeeee102cd78b8f99be743be634739286fed8a76" +} diff --git a/verification/InstalledSelfTest.json b/verification/InstalledSelfTest.json index ce0e5c1..04ec364 100644 --- a/verification/InstalledSelfTest.json +++ b/verification/InstalledSelfTest.json @@ -1,6 +1,6 @@ { "bundlePath": "/Library/Plug-Ins/FxPlug/大鱼调色.app/Contents/PlugIns/大鱼调色 XPC Service.pluginkit", - "checks": 293, + "checks": 349, "gpu": "Apple M4", "limitations": [ "Finite states and a 64x48 frame; live FCP discovery, inspector interaction, timeline persistence and real host export require separate acceptance.", @@ -12,14 +12,14 @@ "error": "未提供错误信息", "name": "runtime-directory", "pass": true, - "path": "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/verification-runtime/1625CF86-D762-4A0B-9515-6DE9981F8A19" + "path": "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/verification-runtime/395FA613-8C28-4323-B4F3-6447EE317F60" }, { - "descriptors": 234, + "descriptors": 276, "name": "descriptor-unique-id-offset-key", "pass": true, - "sections": 15, - "uniformBytes": 1104 + "sections": 17, + "uniformBytes": 1296 }, { "name": "finite-real-model-defaults", @@ -65,7 +65,7 @@ "pass": true }, { - "modules": 12, + "modules": 14, "name": "default-primary-spider-base-expanded-all-eyes-on", "pass": true }, @@ -154,7 +154,7 @@ "pass": true }, { - "name": "complete-version-four-preset-includes-mesh", + "name": "complete-version-five-preset-includes-mesh", "pass": true }, { @@ -816,7 +816,7 @@ "error": "未提供错误信息", "name": "renderer-export-33cube", "pass": true, - "path": "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/verification-runtime/1625CF86-D762-4A0B-9515-6DE9981F8A19/diagnostic-export.cube" + "path": "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/verification-runtime/395FA613-8C28-4323-B4F3-6447EE317F60/diagnostic-export.cube" }, { "bytes": 1186074, @@ -836,7 +836,7 @@ }, { "heartbeats": 0, - "maximumGapMS": 84.72579158842564, + "maximumGapMS": 110.79099983908236, "name": "external-activation-main-loop-responsive", "pass": true }, @@ -1339,6 +1339,285 @@ "name": "cube-export-follows-identical-anchored-tool-order", "pass": true }, + { + "error": "未提供错误信息", + "name": "film-neutral-production-render", + "pass": true + }, + { + "name": "new-tools-default-to-neutral", + "pass": true + }, + { + "name": "new-neutral-tools-preserve-existing-alpha", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "channel-mixer-production-render", + "pass": true + }, + { + "changedComponents": 5387, + "maxAbsoluteError": 0.283203125, + "name": "channel-mixer-affects-real-frame", + "nonfiniteComponents": 0, + "nonzeroComponents": 9832, + "pass": true + }, + { + "error": "未提供错误信息", + "name": "channel-mixer-eye-bypass-render", + "pass": true + }, + { + "name": "channel-mixer-eye-exact-bypass", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "channel-mixer-zero-render", + "pass": true + }, + { + "name": "channel-mixer-zero-exact-bypass", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-0-production", + "pass": true + }, + { + "changedComponents": 7368, + "maxAbsoluteError": 0.135498046875, + "name": "film-stage-0-finite-active-alpha", + "nonfiniteComponents": 0, + "nonzeroComponents": 9832, + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-0-zero-mix", + "pass": true + }, + { + "name": "film-stage-0-zero-is-exact", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-0-eye-off", + "pass": true + }, + { + "name": "film-stage-0-eye-preserves-old-frame", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-1-production", + "pass": true + }, + { + "changedComponents": 4916, + "maxAbsoluteError": 0.3251953125, + "name": "film-stage-1-finite-active-alpha", + "nonfiniteComponents": 0, + "nonzeroComponents": 9832, + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-1-zero-mix", + "pass": true + }, + { + "name": "film-stage-1-zero-is-exact", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-1-eye-off", + "pass": true + }, + { + "name": "film-stage-1-eye-preserves-old-frame", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-2-production", + "pass": true + }, + { + "changedComponents": 7374, + "maxAbsoluteError": 0.37451171875, + "name": "film-stage-2-finite-active-alpha", + "nonfiniteComponents": 0, + "nonzeroComponents": 9832, + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-2-zero-mix", + "pass": true + }, + { + "name": "film-stage-2-zero-is-exact", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-2-eye-off", + "pass": true + }, + { + "name": "film-stage-2-eye-preserves-old-frame", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-3-production", + "pass": true + }, + { + "changedComponents": 7351, + "maxAbsoluteError": 0.1650390625, + "name": "film-stage-3-finite-active-alpha", + "nonfiniteComponents": 0, + "nonzeroComponents": 9832, + "pass": true + }, + { + "error": "未提供错误信息", + "name": "grain-random-access-repeat", + "pass": true + }, + { + "name": "grain-identical-frozen-frame-is-bit-exact", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "grain-next-frozen-frame", + "pass": true + }, + { + "name": "grain-frame-changes-noise", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-3-zero-mix", + "pass": true + }, + { + "name": "film-stage-3-zero-is-exact", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-3-eye-off", + "pass": true + }, + { + "name": "film-stage-3-eye-preserves-old-frame", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-4-production", + "pass": true + }, + { + "changedComponents": 7374, + "maxAbsoluteError": 0.85009765625, + "name": "film-stage-4-finite-active-alpha", + "nonfiniteComponents": 0, + "nonzeroComponents": 5168, + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-4-zero-mix", + "pass": true + }, + { + "name": "film-stage-4-zero-is-exact", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-stage-4-eye-off", + "pass": true + }, + { + "name": "film-stage-4-eye-preserves-old-frame", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "grain-top-origin-render", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "grain-bottom-origin-render", + "pass": true + }, + { + "changedComponents": 0, + "maxAbsoluteError": 0, + "name": "grain-canonical-coordinates-survive-texture-origin", + "nonfiniteComponents": 0, + "nonzeroComponents": 9832, + "pass": true + }, + { + "name": "grain-exact-ntsc-signed-frame-and-hold", + "pass": true + }, + { + "name": "film-mixer-adjacent-schema-two-valid", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-mixer-adjacent-render", + "pass": true + }, + { + "name": "film-mixer-adjacent-layers-affect-frame", + "pass": true + }, + { + "name": "film-mixer-mask-archive-exact-roundtrip", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "film-zero-mask-render", + "pass": true + }, + { + "name": "film-zero-mask-exact-source", + "pass": true + }, + { + "name": "grain-rejected-by-static-cube", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "pure-subtractive-cube-supported", + "pass": true + }, + { + "error": "未提供错误信息", + "name": "channel-mixer-cube-supported", + "pass": true + }, { "name": "tracking-captures-real-full-input-texture", "pass": true @@ -1537,6 +1816,6 @@ "pass": true } ], - "runtimePath": "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/verification-runtime/1625CF86-D762-4A0B-9515-6DE9981F8A19", + "runtimePath": "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/verification-runtime/395FA613-8C28-4323-B4F3-6447EE317F60", "scope": "Native model and renderer integration with real Metal/IOSurface textures and fake FxPlug host selectors; no GUI or live host document." } diff --git a/verification/Package.json b/verification/Package.json index c4d547b..70ad3cd 100644 --- a/verification/Package.json +++ b/verification/Package.json @@ -1,7 +1,7 @@ { - "package": "/Volumes/备份/大鱼调色/发行包/大鱼调色-1.4.3.pkg", - "sha256": "41bba698a70a7629438688a4be74947f424f3af04190090c44f248827b4c3bb2", - "bytes": 14340650, + "package": "/Volumes/备份/大鱼调色/发行包/大鱼调色-1.5.0.pkg", + "sha256": "3ecabc7a8bfd675b228a5f00016aa17a35b65b544055e57793ec3bff3d7e0294", + "bytes": 14380104, "testUnsigned": false, "installationExecuted": false, "checks": [ @@ -31,34 +31,34 @@ "source": "/Library/Plug-Ins/FxPlug/大鱼调色.app", "payload": "Library/Plug-Ins/FxPlug/大鱼调色.app", "bundleID": "com.dayu.color", - "version": "1.4.3", - "build": "33" + "version": "1.5.0", + "build": "34" }, { "source": "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/pkg-inputs/大鱼调色", - "payload": "Library/Application Support/PKGForge/Payload/com.dayu.color.installer.29f7e0ee-d1bf-4b70-bb5c-21ccae60aa70/282BF18F-3687-45E3-8DC8-DA8A2CD0F8B3/大鱼调色" + "payload": "Library/Application Support/PKGForge/Payload/com.dayu.color.installer.210510f9-2b2c-4b85-8a6d-055789dd7acf/8FC61176-5CC6-435D-BD1C-99D0AF0117E6/大鱼调色" } ], - "signature": "Package \"大鱼调色-1.4.3.pkg\":\n Status: signed by a developer certificate issued by Apple for distribution\n Notarization: trusted by the Apple notary service\n Signed with a trusted timestamp on: 2026-11-02 04:37:48 +0000\n Certificate Chain:\n 1. Developer ID Installer: zhong luo (B3W25FX5H5)\n Expires: 2027-02-01 22:12:15 +0000\n SHA256 Fingerprint:\n C0 19 01 3C 67 88 8F 34 65 56 C5 91 3C E5 B6 12 4C 5D A6 DA F9 D8 \n DA 00 37 52 DF F0 F3 E6 00 B4\n ------------------------------------------------------------------------\n 2. Developer ID Certification Authority\n Expires: 2027-02-01 22:12:15 +0000\n SHA256 Fingerprint:\n 7A FC 9D 01 A6 2F 03 A2 DE 96 37 93 6D 4A FE 68 09 0D 2D E1 8D 03 \n F2 9C 88 CF B0 B1 BA 63 58 7F\n ------------------------------------------------------------------------\n 3. Apple Root CA\n Expires: 2035-02-09 21:40:36 +0000\n SHA256 Fingerprint:\n B0 B1 73 0E CB C7 FF 45 05 14 2C 49 F1 29 5E 6E DA 6B CA ED 7E 2C \n 68 C5 BE 91 B5 A1 10 01 F0 24", - "gatekeeper": "/Volumes/备份/大鱼调色/发行包/大鱼调色-1.4.3.pkg: accepted\nsource=Notarized Developer ID", + "signature": "Package \"大鱼调色-1.5.0.pkg\":\n Status: signed by a developer certificate issued by Apple for distribution\n Notarization: trusted by the Apple notary service\n Signed with a trusted timestamp on: 2026-11-02 06:12:29 +0000\n Certificate Chain:\n 1. Developer ID Installer: zhong luo (B3W25FX5H5)\n Expires: 2027-02-01 22:12:15 +0000\n SHA256 Fingerprint:\n C0 19 01 3C 67 88 8F 34 65 56 C5 91 3C E5 B6 12 4C 5D A6 DA F9 D8 \n DA 00 37 52 DF F0 F3 E6 00 B4\n ------------------------------------------------------------------------\n 2. Developer ID Certification Authority\n Expires: 2027-02-01 22:12:15 +0000\n SHA256 Fingerprint:\n 7A FC 9D 01 A6 2F 03 A2 DE 96 37 93 6D 4A FE 68 09 0D 2D E1 8D 03 \n F2 9C 88 CF B0 B1 BA 63 58 7F\n ------------------------------------------------------------------------\n 3. Apple Root CA\n Expires: 2035-02-09 21:40:36 +0000\n SHA256 Fingerprint:\n B0 B1 73 0E CB C7 FF 45 05 14 2C 49 F1 29 5E 6E DA 6B CA ED 7E 2C \n 68 C5 BE 91 B5 A1 10 01 F0 24", + "gatekeeper": "/Volumes/备份/大鱼调色/发行包/大鱼调色-1.5.0.pkg: accepted\nsource=Notarized Developer ID", "pass": true, "scope": "Expanded package structural and payload verification only; no installer scripts executed and no host quit or registration performed.", "notarization": { - "name": "大鱼调色-1.4.3.pkg", - "id": "f9218078-8fd0-4a0c-9240-4b1acf7d9655", + "id": "05f849da-5567-4351-9556-742d17b95723", "message": "Successfully received submission info", - "createdDate": "2026-11-02T04:37:49.851Z", - "status": "Accepted" + "name": "大鱼调色-1.5.0.pkg", + "status": "Accepted", + "createdDate": "2026-11-02T06:12:31.089Z" }, - "appCompiledSource": "26a888f4534792481c6a9933091cb0b23307cd24", - "appBuild": "33", + "appCompiledSource": "06d531c443b0bb2f179022a4e64148394f5d0690", + "appBuild": "34", "packageBuilderRemote": "https://dayu.media/git/dayu/pkg-forge.git", "packageBuilderCommit": "eb53707c0e67d8ddeab8c1270bb079f1050cfafe", "templateSHA256": { - "大鱼调色.moef": "9b8f6e407545429b77c1de88d4cceb738760771c5a7f1dbd9732bdcc95c23738", + "大鱼调色.moef": "7476fb5a3cfad5f4dafb7a887dcc787b9cbcba6ad64df3b4939b336444cf8bfc", "large.png": "ab12611e8801cff86332ccc505a4cffa0c1120541c2efb9bb9908be2c9fe631a", "small.png": "41fec3138aee904fc39d6982e6fde809243ffec55298dbfe966f4f48d89caf8a" }, - "installedAppHostAcceptance": "verification/HostMaskFolding1.4.3.json", + "installedAppHostAcceptance": "verification/HostFilmMixer1.5.0.json", "installScope": "本轮仅生成并验包,未再次执行系统安装;正式 APP 已有独立宿主验收。" } diff --git a/大鱼调色FxPlug4交接.md b/大鱼调色FxPlug4交接.md index 0fdd10f..f0396b3 100644 --- a/大鱼调色FxPlug4交接.md +++ b/大鱼调色FxPlug4交接.md @@ -1,122 +1,50 @@ -# 大鱼调色交接:1.4.3 基线与 Color Finale 胶片模拟接续 +# 大鱼调色FxPlug4交接:1.5.0胶片与通道混合器 -更新日期:2026-11-02(Asia/Shanghai)。本轮只整理交接文档,未改程序、未重新安装或重启宿主,也未开始胶片模块的算法迁移。下一阶段目标是从本机 Color Finale 分析并移植胶片模拟模块。 +2026-11-02(Asia/Shanghai)。当前正式1.5.0(34),APP已经签名、公证、粘附并安装,FCP12.4宿主验收完成。安装包/Release最终结果读取 `verification/Package.json`、`verification/Release.json`,与APP编译节点分别记录。 -## 1. 先认准项目与可恢复基线 +## 身份与恢复 -| 项目 | 当前值 | -| --- | --- | -| 当前源码根目录 | `/Volumes/备份/大鱼调色/大鱼调色` | -| 远程 / 分支 | `https://dayu.media/git/dayu/dayu-color.git` / `main` | -| 交接文档编辑前 main | `7814a03f95f9f3c3461af2566e7412c1e5c561e1`;后续文档提交在此节点之上 | -| 正式 APP | `/Library/Plug-Ins/FxPlug/大鱼调色.app`,1.4.3(33) | -| 主 / XPC Bundle ID | `com.dayu.color` / `com.dayu.color.XPC` | -| APP 实际编译源码 | `26a888f4534792481c6a9933091cb0b23307cd24` | -| 已发布标签 | `v1.4.3-mask-fold-20261102` | -| 标签对应提交 | `301b31438e8da95dc4e6e1c09498ad814a0ebcfc`,含最终交付记录,区别于 APP 编译节点 | -| FCP 模板 | `/Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef` | -| 固定构建缓存 | `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color` | -| 父“大鱼调色盘”源码 | `/Volumes/备份/大鱼调色/大鱼调色盘`,只读参考固定提交 `f8950384e514685c8809fe8e8ee2dd5f16ad0bd7` | +- 源码:`/Volumes/备份/大鱼调色/大鱼调色`;远程 `https://dayu.media/git/dayu/dayu-color.git`,main。 +- 正式:`/Library/Plug-Ins/FxPlug/大鱼调色.app`,主ID `com.dayu.color`、XPC `com.dayu.color.XPC`。 +- APP实际编译源码:`06d531c443b0bb2f179022a4e64148394f5d0690`。 +- APP公证:`164abf2b-4e67-4504-b72a-04122da9e381` Accepted;团队B3W25FX5H5。 +- 固定构建缓存:`/Users/mac/Library/Caches/CodexBuilds/com.dayu.color`。 +- 模板唯一位置:`/Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef`。 +- 无LFS/子模块;程序不依赖Color Finale安装、REA缓存或父“大鱼调色盘”。 -接手后先查看实际工作区、分支和远端;不要用本表覆盖其他任务的新改动。当前大鱼调色是独立 FxPlug 程序,不依赖父项目或 Color Finale APP 才能运行。历史各轮说明已归档到 [历史交接](research/handoffs/DayuColorThrough1.4.3-20261102.md)。 +正式PKG `../发行包/大鱼调色-1.5.0.pkg`,14,380,104字节,SHA-256 `3ecabc7a8bfd675b228a5f00016aa17a35b65b544055e57793ec3bff3d7e0294`。PKG公证 `05f849da-5567-4351-9556-742d17b95723` Accepted,20项展开验包通过;本轮未再次运行系统安装器。发行标签 `v1.5.0-film-mixer-20261102`,最终发布及远端恢复结果见本版记录。 -## 2. 已完成并应保留的行为 +## 本轮实现 -- 一级调色包含输入 CST → 工作空间一级处理 → 输出 CST;后续基础调整、HSL、曲线等仍按既有显示域链处理。胶片接入时要重新确定域和位置,不能把父项目的顺序直接套进来。 -- 各模块标题只控制展开/折叠,眼睛控制启用/旁路。再次添加工具在点击处相邻插入初始化层,旧 schema1 尾层保留位置;新增层参数独立。 -- 每工具蒙版含椭圆、矩形、钢笔、线性渐变、HSL、亮度选区;支持组合、反转、羽化和强度。矩形/椭圆/闭合钢笔有区域运动跟踪。 -- 1.4.1 已有用户实际鼠标确认钢笔可绘制并闭合;1.4.0 已有中心拖动确认。自动化鼠标未可靠进入 FCP 的画面回调,不能把其余手势扩大为实鼠验收。 -- 1.4.2 修复中间帧起跟、4K细纹误失跟、取消/失跟后的宿主任务结束、偏移片段单帧定位和边界互等。运动分析最高1280×720,先低通再降采样;调色渲染和输出分辨率不变。区域仿射跟踪不是人物分割或非刚性描边。 -- 1.4.3 蒙版面板随所属模块一起折叠;标题栏蒙版按钮旁显示数量标记,无蒙版时隐藏。计入已停用蒙版,原模块和独立层分别计数,删除/撤销即时更新。 +通道混合器采用RGB三输出×三输入矩阵,含保持亮度、保持饱和度与混合。胶片含减色、晕光、辉光、颗粒、暗角,五页参数各自启停。两类工具沿用原启停、折叠、蒙版、数量标记、区域跟踪和相邻初始化层;工具类型由12追加到14,原索引不移动。 -正式1.4.3通过293项既有原生检查。FCP12.4验证折叠/展开、数量2/1、删除到零和撤销、正常退出冷重开;用户当时完整77276字节预设逐字节一致,286个轨迹键保留,独立合成片段8471字节预设操作前后及重开也一致。293项检查不是对尚未实现的胶片模块的验收。 +42个宿主参数只追加,旧参数ID、944字节GPU前缀及1104字节完整旧Uniform前缀保留。完整预设v5兼容v1–v4;读旧预设时新参数恢复中性。schema1尾层、schema2锚点、已有9000–9003载荷保留。新工具置于既有显示域/蜘蛛盘之后、历史尾层之前,不能因此推断UI中全部旧工具都按视觉顺序渲染。 -最近用户试调位于独立验收项目“大鱼调色_28_中间帧双向”,不能当作随时可复位的空白实例。完整预设和 FCPXML 仅在本机 `.../com.dayu.color/fcp-qa/`:`fold31-before.json`、`fold33-user-after.json`、`fold33-fixture-reopen.json` 等;不要写进 Git、PKG 或覆盖原素材。 +减色与颗粒用既有sRGB编码边界,晕光/辉光/暗角在线性纹理上。减色是原SubSat归一化幂函数,活跃时限幅0–1。晕光为高斯散射后R/G通道加权归一化;辉光为稀疏预滤→向量Sobel→扩散→相加。颗粒使用PCG/Box-Muller、MPS扩散、精确有理帧和规范化全帧坐标;与原版CI内部切块的空间噪声排列不做全局逐像素等效承诺。暗角复用相同系统CIVignetteEffect。纯矩阵和减色支持Cube,活跃空间/时间效果及蒙版明确拒绝Cube。 -## 3. 源码接入入口 +原厂八种印片外观属于另外的ACES输出资源,本版五组处理未纳入这些外观。不能把F-Log输入菜单当作胶片外观,也不能将本工程接入域声称为原版任意ACES链等效。来源、证据ID与边界见[研究记录](research/ColorFinaleFilmMixer.md)。 -下表路径相对于当前源码根目录。 +## 验收与用户资料 -| 入口 | 用途 | -| --- | --- | -| `大鱼调色/Plugin/DYModel.mm`、`DYModel.h` | 参数描述、分组、默认值、宿主参数与预设 | -| `大鱼调色/Plugin/DYUniforms.h` | CPU/Metal ABI;当前自检1104字节,`cm`偏移944的前缀有静态断言 | -| `大鱼调色/Plugin/DYRenderer.mm` | Metal设备、渲染调度、LUT资源、输入输出与导出 | -| `大鱼调色/Plugin/DYGrade.metal` | 现有 GPU 包装、色彩管理及逐像素处理入口 | -| `大鱼调色/Plugin/DYToolRender.inc.h`、`DYToolGPU.h` | 独立工具计划、逐层处理与蒙版混合 | -| `大鱼调色/Plugin/DYToolState.mm`、`DYToolState.h` | `DYToolTypes`、工具默认状态、schema1/2、after锚点、蒙版与安全归档 | -| `大鱼调色/Plugin/DYInspector.mm` | 模块布局、`toggleSection:`、`DYMaskCountBadge`、蒙版数量刷新 | -| `大鱼调色/Plugin/DYToolInspector.inc.h` | 相邻插入、独立层界面及其布局 | -| `大鱼调色/Plugin/DYMaskPanel.inc.h` | 蒙版控件、状态和跟踪按钮 | -| `大鱼调色/Plugin/DYToolHostMethods.inc.h` | FxAnalyzer 生命周期;胶片任务无需顺带改写 | -| `tools/build_kernels.py`、`tools/kernels/` | 可版本恢复的 AIR/Metal 生成与链接,不能只替换某个本机 metallib | -| `tools/build_template.py`、`template/sources/` | 原生模板与参数档案;模型改变后重建并核对 | +- 349项原生检查;四种尺寸64×48、63×47、1×17、17×1共184项原版组件对照通过。 +- FCP12.4正式版加载;用户234个既有参数、资产路径、蜘蛛盘和蒙版载荷逐项/逐字节保持。界面显示286个可信跟踪键,载荷共287键(含作者键)。 +- 新模块、五页胶片控制、独立混合器初始化、胶片椭圆蒙版、折叠数量1、删除/撤销/重做通过。 +- 1080p/25fps/4秒ProRes正式导出验证grainHold2:0/1、2/3、4/5帧分别相同,组间不同。 +- 960×540/25fps/4秒组合导出全部帧解码通过;三个项目FCPXML1.14原生回导严格校验与比较通过。 +- 正常退出冷重开,组合预设8987字节、颗粒预设8420字节前后均逐字节相同。 -当前 `DYToolTypes` 有12类,未注册独立胶片模拟工具。相机输入项里的 Blackmagic Film / Fujifilm F-Log 是色彩管理输入名称,不能据此认定已有胶片模拟模块。完整预设当前为 v4,已有9000/9001/9002自定义载荷及9003画布会话;参数ID、归档兼容和既有 Uniform 前缀不能挪作新用途。 +记录:`verification/HostFilmMixer1.5.0.json`、`FilmMixerNative.json`、`FilmMixerReference.json`、`FilmMixerRecovery.json`。私有完整预设与FCPXML只在本机 `.../com.dayu.color/fcp-qa/`,文件名前缀 `film-mixer-`。不写入Git、PKG或覆盖用户原素材。 -## 4. Color Finale 参考身份与已有证据 +## 源码入口 -本次只复核了本机包元数据和可执行文件摘要,未新做胶片函数分析或原版输出对照。 +- `DYFilmTypes.h`、`DYFilmMath.h`:状态/中性判断与共享数学。 +- `DYFilmKernels.inc.h`:原生Metal点处理、PCG、辉光预滤与Sobel;由DYGrade.metal包含,经tools/build_kernels.py构建。 +- `DYFilmRender.inc.h`:惰性缓冲、CI/MPS空间阶段、内存预算、混合及现有蒙版。 +- `DYFilmTime.h`、DYPlugIn.mm:冻结宿主帧长/起点,精确签名帧索引和1–5帧保持。 +- DYModel.mm / DYUniforms.h:只追加描述符、Uniform;DYInspector.mm五页分组和RGB三输出分组。 +- DYToolState.mm / DYToolRender.inc.h:新类型、独立初始化、相邻锚点、尾层和Cube限制。 +- tools/verify_film_reference.mm:本机原版只读CI/Metal对照,不参与产品运行。 -| 项目 | 本机已核对值 | -| --- | --- | -| APP | `/Applications/ColorFinale.app`,2.16.2(625),`com.colorfinale.app` | -| 主插件二进制 | `/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale` | -| 插件 Bundle ID | `com.colorfinale.ColorFinaleFxPlug` | -| 二进制 SHA-256 | `49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f` | -| 胶片界面定位线索 | `Contents/PlugIns/ColorFinale.pluginkit/Contents/Resources/zh-Hans.lproj/FTFilmEmulationViewController.strings`(相对APP) | -| 既有只读研究 | [ColorFinaleMasksFollowup.md](research/ColorFinaleMasksFollowup.md) 与对应 JSON | -| 既有本机 REA 缓存 | `/Users/mac/Library/Caches/CodexBuilds/ColorResearch/dayu-mask-followup-20261101/` | +按本机全局规则继续交付。`tools/deliver.py`持有产品锁,正式宿主完成后才输入complete;其自检输出现在会先保存诊断再判定,避免失败时丢失输出。首次预检曾在与恢复自检并行时退出1,旧工具未保留当次JSON;未替换旧版。随后串行349项、正式安装349项和独立恢复349项全部通过,不把未知原因写成已证实的程序缺陷。 -现有 REA 证据主要对应蒙版/跟踪,不能当作胶片模块已分析。下一轮先核对目标摘要、可用会话及保留证据;仅复用身份匹配的资料。原版胶片的参数、默认值、阶段、数学、资源依赖和实际图像行为均需要单独取证。 - -REA 技能入口:`/Users/mac/.agents/skills/reverse-engineer-anything/SKILL.md`。分析原厂二进制时使用其目标绑定和证据流程;查看当前完整源码则直接读工程,不为普通源码阅读启动逆向工具。静态字符串/类名只是定位线索,不能代替执行行为或图像对照。 - -## 5. 父项目可以参考什么 - -`research/color-finale/` 内四份研究资料是父工程提交 `4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca` 的快照,见 [快照来源](research/color-finale/README.md)。其中“已接入”“正式版”等表述属于父工程,不能当作当前大鱼调色的完成项。快照里部分相对链接没有随包文件,应回到父工程查找。 - -父工程固定提交 `f8950384e514685c8809fe8e8ee2dd5f16ad0bd7` 中可只读参考: - -- `research/film-processing-contract.md`、`research/colorfinale-film-chart-findings.md`; -- `Core/DYFilm.h`、`Core/DYFilmCPU.hpp`; -- `Sources/DYFilmState.h`、`DYFilmState.inc`、`DYPanelFilm.inc`、`DYFilmEditor.inc`; -- `Tools/film_test.mm`、`film_panel_test.inc`、`test_film.py` 与 `verification/film-development.json`。 - -父合同记录的是独立算法v1:减色→晕光→辉光→暗角→颗粒,父工程根级状态、线性域处理及保守拒绝活跃胶片的LUT导出。可复用其工程组织、时间一致性和边界测试思路;不代表当前工程已有相同链路,更不代表与 Color Finale 数学或同名胶片外观一致。不要把父工程“只在根级”的约束当作用户已经确定的本工程设计。 - -## 6. 下一阶段建议的工作顺序 - -1. **先建立原版功能与参数表。** 从本机胶片面板定位 Film Look、减色、Halation、Bloom、Vignette、Grain 等候选功能,逐项确认本机版本是否具备、名称、默认、范围、单位、开关、预设及资源依赖;候选清单不是已证实功能清单。 -2. **确认处理域和顺序。** 跟进面板状态→归档/参数→渲染调度→CPU/Metal/表格资源,明确与输入、工作空间、输出CST、HDR、alpha和混合的关系。先记录已观察、推断、未知,再决定当前大鱼的接入位置。 -3. **确定模块形态。** 尚未定为全局胶片阶段还是可重复工具。若进入现有工具模块体系,接好独立初始化、眼睛、折叠、蒙版及数量标记;若全局阶段有不同语义,先把具体设计说明写清。保留旧工程缺省时的旁路与原画面。 -4. **做可比较的图像验证。** 同一输入、同一色彩空间、同一参数分别取得原版与大鱼输出,覆盖灰阶/色块/高光、真实素材、不同分辨率及透明边缘。不能只靠“视觉像胶片”或加一个LUT宣称等价;确属独立重建的部分写明差异。 -5. **补齐空间与时间行为。** 晕光/辉光若涉及邻域需独立中间纹理和预算;颗粒若随时间变化需精确帧时间、固定种子/状态、随机访问/并发/重开的一致性。零强度与关闭保持中性,保留负值/HDR、alpha与非有限值处理。 -6. **完成持久化、导出和正式验收。** 新参数ID不复用,归档/预设兼容旧版本;纯色变换与空间/时间效果的Cube能力分别判定,不能把颗粒、晕光等错误写成静态3D LUT。随后做撤销/重做、保存重开、旧工程、蒙版/重复层、FCP实际渲染和正式交付。 - -## 7. 构建、交付与恢复入口 - -沿用本机全局规则与项目现有工具。本轮是文档更新,未生成新构建或移动已发布标签;下一轮真正改程序后再递增构建与版本。 - -```sh -# 在源码根目录;模型改变时先更新原生参数档案和模板 -python3 tools/build_template.py --refresh-model --overwrite -# Release构建、由内到外签名、公证Accepted、票据、唯一安装;等待宿主验收 -python3 tools/deliver.py -# 宿主验收通过后才在交付进程输入complete,并补写本轮hostVerification记录 -python3 Packaging/build_pkg.py --pkg-forge-repo /Users/mac/Documents/dayu-git/repositories/pkg-forge -``` - -- 正式宿主测试使用固定位置的已公证APP;不从DerivedData启动临时GUI,不强制结束宿主绕过保存。 -- 产品交付锁:`/Users/mac/.codex/app-delivery-locks/com.dayu.color.lock`。Git检查点用 `tools/checkpoint.py` 的仓库锁;只提交已审查的本任务文件。 -- 签名团队 `B3W25FX5H5`;Application / Installer身份和公证profile按本机规则重新验证。公证profile `codex-dayu-notary-B3W25FX5H5`,钥匙串 `/Users/mac/Library/Keychains/login.keychain-db`。文档中不存凭据。 -- 正式PKG生成后,标签先推送核验,再用 `Packaging/publish_release.py` 上传草稿;完整下载核对大小及SHA-256后发布,再核验已发布下载。保持现有仓库可见性,不覆盖旧附件或移动标签。 -- 无LFS/子模块。恢复任一已保存源码:克隆上述远程,检出明确提交或标签,再依 RECOVERY 构建;证书私钥、用户媒体与预设独立保存。 - -当前发行包:`/Volumes/备份/大鱼调色/发行包/大鱼调色-1.4.3.pkg`,14,340,650字节,SHA-256 `41bba698a70a7629438688a4be74947f424f3af04190090c44f248827b4c3bb2`。APP公证 `e755670d-8fb3-46d2-95c3-1206f014d16d`,PKG公证 `f9218078-8fd0-4a0c-9240-4b1acf7d9655`,均Accepted;签名/票据/Gatekeeper、20项展开验包通过。PKG未再次运行安装器,APP已有独立正式安装和宿主验收。 - -[Release371](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.4.3-mask-fold-20261102) / 附件16已在草稿与发布后完整下载核验。对应证据:[Delivery](verification/Delivery.json)、[Package](verification/Package.json)、[Release](verification/Release.json)、[本轮宿主验收](verification/HostMaskFolding1.4.3.json)、[编译源码恢复](verification/MaskFoldingRecovery.json)、[发行标签恢复](verification/MaskFoldingReleaseRecovery.json)、[RECOVERY](RECOVERY.md)。 - -## 8. 新对话的接手提示 - -> 阅读 `/Volumes/备份/大鱼调色/大鱼调色/大鱼调色FxPlug4交接.md`。以当前正式1.4.3(33)和已推送源码为基线,接下来分析本机Color Finale 2.16.2(625)的胶片模拟模块,先产出功能/参数/处理域与顺序的证据表,再按现有大鱼调色架构移植并完成正式交付。父“大鱼调色盘”的胶片代码仅作有出处的参考;保留用户现有调色、蒙版、轨迹、相邻叠层、折叠和数量标记行为。 +上一阶段详细基线保留于[1.4.3胶片接续原文](research/handoffs/DayuColorFilmStart1.4.3-20261102.md),更早历史见[历史交接](research/handoffs/DayuColorThrough1.4.3-20261102.md)。