docs: organize Color Finale migration research and remove prior target descriptions from current tree

这个提交包含在:
mac 于 2026-10-31 16:16:47 +08:00 提交
1 父节点 29dc4d385c
当前提交 719229ddd8
24 个文件已更改
+1012 -3028

没有与搜索条件相匹配的文件

+31
查看文件
@@ -0,0 +1,31 @@
# Color Finale 移植研究与算法来源
整理日期:2026-10-31。依据用户指出的上级工程,已核对 `../大鱼调色盘` 中的 Color Finale 移植研究,并将四份已提交的资料逐字节归档到 [color-finale/](color-finale/)。来源工程为 `dayu/dayu-colorplate`,提交 `4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca`;逐文件摘要见 [SOURCES.json](color-finale/SOURCES.json)。
## Color Finale 移植背景
该系列研究涵盖 Color Finale 2.16.2(625)的调色工具、RGB/HSL 曲线、色轮、相机矩阵、LUT 库和当前帧批量预览,以及图层、蒙版、跟踪、色彩管理与胶片处理。资料分别记录了静态观察、独立算法设计、迁移目标和验收边界:
- [研究记录](color-finale/colorfinale.md):工具结构、LUT 预览与缓存、跟踪流程及证据编号。
- [颜色工具设计](color-finale/colorfinale-color-tools-design.md):曲线、Log 色轮、相机矩阵和其他颜色算子的独立实现设计。
- [迁移矩阵](color-finale/colorfinale-2.0-matrix.md):功能目标、已实现项和开放项。
- [静态证据索引](color-finale/evidence-index/colorfinale-index.json):发行包身份与证据编号。
这些资料属于“大鱼调色盘”的移植工程。当前“大鱼调色”的 944 字节状态、CPU 查表与 GPU 链路仍按本仓库实现保存;已核对的颜色工具设计使用 1032 字节状态,自动调色的参数、阈值和计算式也不同。现有资料支持将 Color Finale 迁移研究列为相关算法与工作流背景,尚未建立当前这些实现逐段移植自该工程的代码继承关系。
## 当前实现的来源记录
| 部分 | 已核实依据 |
| --- | --- |
| Color Finale 相关研究 | 上述同系列工程的研究、设计和迁移矩阵;其功能范围和验收状态以各原文为准 |
| Camera Raw 查表与组合 | Compositor,MIT;提交 `92f5225afe7e921dbfa4c563462980e45db345fc`;数据 SHA-256 `e67ff4dbcce35cb7765752acff4405be5c934d913ef1396b2ca3fc6dc8a85190` |
| 当前 GPU 调色核 | 从已发行着色器指令图还原的 LLVM AIR 文本;输入摘要、模块范围和改动见 [PROVENANCE.json](../tools/kernels/PROVENANCE.json) |
| 当前自动调色与 CPU 数学 | 本工程的数值实现与既有对照检查;详见 [ColorTableNotes.md](ColorTableNotes.md)、`DYAutoGrade.mm` 和 `verification/` |
| 17 种输入 LUT | 随工程版本化的压缩采样表;原始采样文件和压缩资源摘要见 `大鱼调色/Plugin/Resources/InputLUTs/manifest.json` |
| 界面、主题与浏览库 | 当前 AppKit 实现和大鱼命名空间;说明见 [ThemeLUT-analysis.md](ThemeLUT-analysis.md),正式宿主结果见 `verification/` |
## 记录保留
本次清理当前主分支中的旧参考程序介绍和原始分析大文件,保留算法输入摘要、必要的第三方归属、许可证和验证记录。完整整理前资料仍可从提交 `29dc4d385c1459cd330d8a9083ec9756787afef3` 恢复;已有提交和发行标签保持原样。原始分析记录中的地址、函数身份及采样对象不改名为其他产品。
本次修改为仓库说明、研究资料与验证工具入口整理,正式安装程序仍为已验收的 1.1.2(11)。
+9 -18
查看文件
@@ -1,26 +1,17 @@
# LumiGrade → 大鱼调色
# 大鱼调色:实现与范围
参考:/Library/Plug-Ins/FxPlug/LumiGrade.app,3.0 build56,主ID com.quliang.LumiGrade。
XPC universal SHA256 33c273d6a58314f5068959fcda911d741884a1937077b41a969a990dd40d0b6d;用于静态分析的arm64切片SHA c04e911e449e888eb0d8c10f7bcf2b6bc2c4153b9ba86c1952ddf210c96c5e97。
本工程提供原生 Wrapper / XPC / FxPlug 4 结构,使用 944 字节、102 字段的 CPU/GPU 状态,Metal 调色、全帧白场统计和 LUT 导出。
## 已确认与实现
支持 17 种相机输入转换、自选 3D Cube、白平衡、光影、局部增强、鲜艳度、饱和度、独立肤色保护;最多五层风格 LUT;主/R/G/B 单调 Hermite 曲线;8 色与自定义 HSL;四区色轮;三原色、RGB/单通道色阶、黑白混色和三向色彩平衡。自动调色、自动白平衡、复制时分析、系统吸管、预设和 33³ Cube 导出均接入原生参数。
- 原生Wrapper/XPC/FxPlug4,944字节102字段GPU状态,Metal滤镜、全帧白场统计、LUT导出。
- 输入17种相机曲线、可自选3D Cube;白平衡、曝光/对比度/高光/阴影/白/黑、纹理/清晰度/去雾、鲜艳/饱和、独立肤色保护。
- 最多五层顺序风格LUT;主/R/G/B可加删点的单调Hermite曲线;8色+自定义RGB选区HSL;阴影/中间调/高光/全局色轮及明亮度、混合、平衡;三原色、RGB/单通道色阶、黑白混色、三向色彩平衡。
- 自动调色与自动白平衡、复制时自动分析、系统白平衡/自定义色吸管、预设保存加载、33³Cube导出。
- 所有调色浮点均由FxPlug原生参数保存,控件按宿主action读写;实例通知以manager对象隔离。资产独立secure coding,渲染状态使用带版本不可变plist。
Color Finale 移植研究资料、相关工程和各算法来源分别见 [ALGORITHM_SOURCES.md](ALGORITHM_SOURCES.md)。Camera Raw 数据采用 Compositor 的 MIT 许可数据与组合实现;GPU 指令图输入、模块范围和改动见 `tools/kernels/PROVENANCE.json`。正式构建使用仓库内源码和必要资源。
## 证据
浮点参数由 FxPlug 保存,控件按宿主 action 读写,实例通知按 manager 隔离。LUT 路径状态使用 secure coding,渲染状态采用带版本的不可变 plist。所有分组展开即启用、折叠即停用并隐藏参数;新实例与全部还原仅展开基础调节。旧实例按保存的启用状态显示。
LumiGrade-analysis.json包含REA/Ghidra返回的20条证据及分析限制;关键CPU行为与地址见ColorTableNotes.md,GPU来源见tools/kernels/PROVENANCE.json及README。CameraRaw数据与MIT的Compositor源码逐字节一致,原许可保留在正式资源中。17张输入LUT由指定参考应用的一次性提取生成,原始和压缩数据SHA见Resources/InputLUTs/manifest.json。构建不依赖原厂应用。
界面使用大鱼品牌。基础组汇集白平衡、光影、鲜艳度和饱和度;HSL、色阶和色彩平衡按通道切换。主题偏好和用户 LUT 使用独立大鱼目录与偏好域。浏览器支持菜单、文件选择、缩略图、导入、目录与名称过滤及尺寸记忆;实现说明见 [ThemeLUT-analysis.md](ThemeLUT-analysis.md)。
35项GPU检查与5,342,405个分量对照通过;CPU查表、83项自动分析边界、73项完整模型/IOSurface/Metal/LUT与预览方向集成分别验证。正式安装及宿主结果见verification。
GPU 数学、CPU 查表、自动分析和真实 Metal/IOSurface 集成分别验证;当前正式版本通过 82 项原生集成检查。FCP 分组展开、数值保留及保存重开见 `verification/HostGroupFolding.json`,主题/LUT 与历史导出结果见 `verification/HostThemeLUT.json`。
## 适配与边界
自动分析使用 320×180 样本,在输入转换后统计;GPU 半精度、缩略采样与图像重采样存在数值边界。局部增强和全帧统计需要完整源帧,超大图受 GPU 纹理与内存限制。Cube 保存逐像素颜色,空间纹理、清晰度和逐画面分析无法完整写入 3D LUT。
重建的是调色行为与可编辑控件,界面保留大鱼标识,并按原版收紧工具栏、主题色块、标题胶囊、参数行与分组;白平衡/光影/鲜艳度/饱和度合入基础组,HSL、色阶和色彩平衡按通道切换显示。肤色保护维持独立数学旁路,设置单独折叠。未接原厂许可、售后或联网服务。吸管使用系统取色器,未复用原厂Viewer OSC。五套主题按原版完整17色和控件用途恢复,偏好使用独立大鱼域并跨实例同步。风格 LUT 可用菜单、文件选择或缩略图浏览器;浏览器按原版760×560、16:9缩略图、70–255尺寸范围及目录/尺寸记忆实现,另支持安全导入、搜索和懒加载。原版用户LUT内容未复制,产品库在 ~/Movies/大鱼调色LUT/look LUTs。主题和浏览库的静态证据见 ThemeLUT-analysis.md。
自动分析同为320×180 RGB8,转换前后量化并先应用输入LUT;Metal双线性缩图与原CoreGraphics缩图可能在边缘产生微小差异。原GPU使用half纹理和输出;32位宿主也遵循这一原精度边界。局部增强/全帧统计需要完整源帧,超大图受GPU纹理/内存限制。Cube仅保存逐像素颜色,无法承载邻域纹理、清晰度或逐画面分析。
有限状态对照不等于对所有参数/GPU/素材的穷尽证明。自定义LUT绝对路径随预设保存,跨机器需搬移用户LUT并重新选择;用户媒体与预设不在源码备份范围内。
有限状态对照不构成所有参数、GPU、素材或宿主的穷尽验证。自定义 LUT 绝对路径随预设保存,跨机器需搬移文件并重新选择;用户媒体和个人预设需独立备份。
+18 -81
查看文件
@@ -1,97 +1,34 @@
# 颜色查表与接入核验
本记录区分发布二进制静态证据、公开源码和本项目的实现验证。没有将静态调用关系当作实际宿主运行结果。
## 参考身份
- LumiGrade 3.0,构建 56。
- 参考服务:`/Library/Plug-Ins/FxPlug/LumiGrade.app/Contents/PlugIns/LumiGrade XPC Service.pluginkit/Contents/MacOS/LumiGrade XPC Service`。
- 原始 universal Mach-O SHA-256:`33c273d6a58314f5068959fcda911d741884a1937077b41a969a990dd40d0b6d`。
- 只读抽取 arm64 SHA-256:`c04e911e449e888eb0d8c10f7bcf2b6bc2c4153b9ba86c1952ddf210c96c5e97`。
- 本记录的地址属于该 arm64 slice,image base 为 `0x100000000`。使用现有 `otool -arch arm64 -tvV` 输出核对具体 ARM 指令,不需要重新打开 REA 会话。
- REA/Ghidra 提供的相关函数伪代码属于还原结果,不是原始 Swift 源码。关键结论同时以 ARM 调用或资源字节校验确认。
本记录说明当前 CPU/GPU 数学契约和已有核验范围。Color Finale 相关迁移研究、第三方来源及历史记录入口见 [ALGORITHM_SOURCES.md](ALGORITHM_SOURCES.md)。
## MIT 查表数据
参考包的 `THIRD-PARTY-NOTICES.txt` 声明,Camera Raw 查表数据与组合行为来自 [Compositor](https://github.com/robbietilton/Compositor),MIT,Copyright 2026 Wonder Assembly LLC。
Camera Raw 查表数据和组合行为来自 [Compositor](https://github.com/robbietilton/Compositor),MIT,Copyright 2026 Wonder Assembly LLC。已核对提交 `92f5225afe7e921dbfa4c563462980e45db345fc` 的 `Compositor/Resources/CameraRawTables.bin`;项目资源 `DayuColorTables.bin` 的 SHA-256 为 `e67ff4dbcce35cb7765752acff4405be5c934d913ef1396b2ca3fc6dc8a85190`。完整许可位于正式资源 `THIRD-PARTY-NOTICES.txt`。
核对公开源提交 `92f5225afe7e921dbfa4c563462980e45db345fc` 的 `Compositor/Resources/CameraRawTables.bin`,与参考包文件逐字节相同。项目中的 `DayuColorTables.bin` 保存这份必要数学数据,保留 MIT 许可;没有复制参考应用的图标、品牌、授权代码或原始应用程序。
- `CRT3` 头;维度17、763张表、差值量化步长3。10字节头后为LZMA/xz,解压长度11,245,857字节。
- 每张表按通道累计有符号Int8差值,还原为 `round(axis * 255 / 16) + signedDelta * 3`,钳制0–255。
- 源表红轴最慢、蓝轴最快,RGB8;采用17³三线性插值。组合输出33³ RGBA32Float,Metal纹理红轴最快,alpha固定1。
- 白平衡:温度和色调各−100…100、间隔25,四张相邻表双线性混合。
- 八色HSL:依次组合明度、饱和度、色相;表起点 `285 + (kind * 8 + color) * 5`;各项−100…100、间隔50。
- 分级:先阴影、中间调、高光、全局明度,再组合全局、中间调、高光、阴影色轮;保留公开实现的插值及平衡系数。
数据 SHA-256:`e67ff4dbcce35cb7765752acff4405be5c934d913ef1396b2ca3fc6dc8a85190`。
## 字段与旁路
格式经公开 `Compositor/Document/CameraRawTables.swift` 和参考 `loadSourceTables` / `sample` 核对:
CPU/Metal共用944字节 `DYUniforms`,字段偏移由静态断言检查。白平衡、HSL和颜色分级由CPU生成有效或中性3D纹理,停用时不能复用非中性的缓存。基础分组同时控制光影与颜色子组;纹理、清晰度和去雾遵循基础组旁路,肤色保护独立启停。
- `CRT3` 头;维度 17,763 张表,差值量化步长 3。
- 10 字节头之后为 LZMA/xz;解压长度 11,245,857 字节。
- 每张表逐通道保存 running delta,累计值按有符号 Int8 解释;还原到 `round(axis * 255 / 16) + signedDelta * 3` 并钳制 0–255。原 ARM `0x10009bf28` 的 `frinta` 确认这里要四舍五入,不能直接截断。
- 源表顺序为红轴最慢、蓝轴最快;每格 RGB8。读取采用 17³ 三线性插值。
- 组合结果为 33³ RGBA32Float,Metal 纹理红轴最快,alpha 固定 1。
- 白平衡:温度、色调各 -100…100、间隔 25,四张相邻表双线性混合。
- 8 色 HSL:明亮度、饱和度、色相依次组合;表起点 `285 + (kind * 8 + color) * 5`,每项 -100…100、间隔 50。逐项运算保留 `low + (high - low) * fraction`。
- 分级:先阴影、中间调、高光、全局的明度,再全局、中间调、高光、阴影色轮;色轮在相邻色相、饱和度、混合档位间混合。分级 balance 对阴影、高光饱和度份额的系数按公开源及二进制一致恢复。
肤色保护开关阈值0.5,保护程度为0–100,内部乘0.01并钳制;中心色相除以360后参与HSL圆周距离。默认保护程度60、中心色相28。黑白六色默认系数依次为 `40,60,40,60,20,80`,着色色相与饱和度默认0。
## 已确认的字段与旁路依赖
三原色矩阵为列向量,GPU使用 `r*M0 + g*M1 + b*M2`。色相沿灰轴旋转,幅度 `hue / 100 * 0.5235987305641174`;饱和度系数 `sat / 100 * 0.55`,矩阵保持D65白点并限制极端偏移。
944 字节 CPU/GPU ABI 的每字段偏移有 `DYUniforms.h` 的静态断言。
## 自动调色与导出
### 白平衡
当前自动调色在320×180、RGB8数值域中计算分位数、饱和度和中性样本权重;先做输入转换和强度混合,再进行统计。阈值与计算式见 `DYAutoGrade.mm`。该实现与同系列 Color Finale 迁移工程的 `Core/DYAuto.hpp` 使用不同参数和公式,来源分别保存。
原 fragment 无条件读取已生成的白平衡 3D 纹理,因此组旁路必须在 CPU 构造纹理时落实。
LUT导出输出 `cubeSize³ * 3` 个float,红轴最快。输入为输入LUT、五层风格LUT、HSL、白平衡及分级纹理;参数、RGB输出和cubeSize分别绑定buffer0/1/2。空间纹理、清晰度及逐画面统计无法完整表达为3D LUT。
原渲染器 `0x100077054…0x10007708c`:
## 验证范围
1. 从 uniforms `+104/+108` 读取 temperatureEnabled/tintEnabled,分别决定是否使用对应数值。
2. 从 uniforms `+140` 读取 colorSectionEnabled,作为 `whiteBalanceTexture(... enabled:)` 的 enabled 参数。
3. `0x10007708c` 调用白平衡纹理生成方法;未启用时采用中性 LUT。
`tools/verify_color_tables.mm` 覆盖数据摘要、损坏拒绝、独立double三线性对照、白平衡、纹理轴序、24项HSL端点、四色轮、色相环绕、明度端点、三原色控制和D65保持。真实Metal纹理接口与非中性缓存后的组旁路由原生集成检查覆盖。
`DYColorTables` 已按此处理。为使自定义检查器的组旁路与实际字段含义一致,本项目把白平衡与鲜艳度、饱和度放在“白平衡与颜色”组;这是明确的界面分组适配。
HSL 与颜色分级分别以 `hslSectionEnabled`、`colorGradingSectionEnabled` 生成有效或中性纹理,旁路不能复用此前非中性的缓存结果。
纹理、清晰度、去朦胧由原 fragment 的 `baseSectionEnabled` 分支控制,属于基础组。肤色保护 shader 只检查 `skinProtection.x`,应保持独立开关,不能暗示它自动跟随颜色组。
### 肤色保护
原 `applySkinProtection`:
- `.x`:开关,阈值 0.5。
- `.y`:保护程度,乘 0.01 后钳制到 0–1。
- `.z`:中心色相,除以 360 后与像素 HSL 色相做圆周距离计算。
原 `addParameters` 对参数 `0x468` 设置默认 60、范围 0–100;对 `0x469` 设置默认 28、范围 0–60。两项不是色相范围和饱和度范围。对应静态伪代码在 `addParameters.c:504…510`,数值十六进制为 `0x404e000000000000`、`0x403c000000000000`。
### 黑白混色
原 `addParameters` 从 `DAT_1000dc7e8` 读取黑白参数默认值。该 slice 对应文件偏移的 8 个 double 是:
`40, 60, 40, 60, 20, 80, 0, 0`
依次对应红、黄、绿、青、蓝、洋红,以及着色色相、着色饱和度。原 `applyBlackWhite` 直接读取这些六色系数参与灰度计算;六项设成 100 会改变启用黑白后的明度。
### 分级与三原色
- `colorGradingHueSatA.xy` 为中间调 H/S,`.zw` 为阴影 H/S;`HueSatB.xy` 为高光 H/S。
- `colorGradingLuma` 为中间调、阴影、高光明度;`colorGradingGlobal` 为全局 H/S/L。原包装方法 `0x100083320…0x1000833e8` 的向量重排确认此顺序。
- 三原色矩阵是列向量。GPU 将 `r*M0 + g*M1 + b*M2` 相加,无需转置。
- 色相沿灰轴旋转,幅度为 `hue / 100 * 0.5235987305641174`;饱和度沿对应原色相对中性灰的轴变化,系数 `sat / 100 * 0.55`。矩阵保持 D65 白点,并沿用原版过大矩阵偏移的限制。
## 自动调色预览确实应用输入 LUT
这是已确认的静态调用与数学流程,不再只是从函数名称作推测:
1. `capturePreviewFrameIfNeeded` 位于 `0x1000833ec`。它缓存原始预览图,并保存输入 LUT、路径、强度;LUT 路径或强度改变时更新版本、清除已转换缓存。此方法本身没有直接转换图像。
2. `currentPreviewFrame` 位于 `0x10007f4f4`。缓存不命中且有输入 LUT 时,`0x10007f5ec` 明确调用 `imageByApplyingInputLUT(to:lut:strength:)`;`s0` 在前一条指令从保存的强度装入。
3. 自动调色闭包 `0x100075e00` 在 `0x100075e44` 调用 `currentPreviewFrame`,在 `0x100075e54` 把该结果传给 `autoGradeResult`。
4. `imageByApplyingInputLUT` 位于 `0x100090a34`。`0x100090a68/6c` 指定 320×180 的 RGB8 缓冲;`0x100090aec…0x100090b0c` 将 RGB8 除以 255;`0x100090b40` 调用 `CubeLUT.sample`;`0x100090b48…0x100090b50` 计算 `original + (sample - original) * strength`;`0x100090b78` 起钳制、四舍五入回 RGB8。
因此,本项目的自动调色输入应在标准线性→sRGB 编码之后应用输入 LUT 与强度,再进入统计。使用未转换的 Log 原图统计会偏离参考行为。GPU 缩略采样与原版 NSImage/CoreGraphics 320×180 重采样仍可能有量化或重采样差异,不声明逐字节相同。
## LUT 导出与验证边界
原 `lutExportKernel` 输出 `cubeSize³ * 3` 个 float,红轴最快;texture0–8 为输入 LUT、五层风格 LUT、HSL、白平衡、分级,buffer0 uniforms、buffer1 RGB 输出、buffer2 cubeSize。当前接入按此布局,不能按 float4 分配后误读。
导出核接收、输出的是 LUT 的编码域 RGB,空间纹理和清晰度操作不写入 3D LUT。画面相关统计与导出核固定处理也不等同于任意素材的逐帧渲染。
`tools/verify_color_tables.mm` 已通过严格 `-Wall -Wextra -Werror` 编译。验证覆盖数据 SHA、损坏拒绝、独立 double 三线性对照、四表白平衡、纹理轴顺序、24 项 HSL 端点、4 色轮、色相环绕、4 明度端点、6 个三原色控制及 D65 保持。带资源的 CLI 测试 bundle 另验证真实 Metal 纹理接口与非中性缓存后的 WB/HSL/分级旁路;没有运行未公证 GUI 应用。
宿主的半透明表示、图像原点、色彩空间和最终视觉结果仍须用正式安装的已公证版本验收;数学和静态结构验证不能替代宿主验证。
GPU数学、CPU表、自动分析、宿主交互和实际导出各自保留报告。有限数值检查与静态结构检查不能替代所有宿主、素材、图像原点、alpha和色彩空间的实际验收。
-1
查看文件
@@ -1 +0,0 @@
{"binding":{"analysis_profile":{"digest":"3fc72c9b4b78498fb992b938f8f3389dc670244a293c1d40abf5e1d10162ed3b","parameters":{"analyzer_preset":"ghidra-default","annotation_policy":"atomic-function-entry-metadata-v1","architecture":"arm64","available_architectures":["arm64"],"call_relationship_coverage":"function-body-call-coverage-v5","compiler_spec_id":"auto-default","decompiler_jump_loads":true,"function_body_evidence":"complete-inclusive-ranges-v1","function_boundary_observations":"ghidra-function-boundary-limitations-v4","function_dossier_coverage":"observed-facets-and-call-relationships-v1","function_references":"complete-body-and-entry-reference-manager-v2","import_mode":"ephemeral-source-immutable","instruction_flow_evidence":"decoded-return-pcode-v1","instruction_references":"exact-address-incoming-without-synthetic-entry-v2","jump_table_evidence":"typed-case-default-blocks-v1","language_id":"auto-from-header","load_image_observations":"source-mappings-entry-context-v2","loader":"auto-from-header","location_resolution":"explicit-address-exact-entry-symbol-first-v3","no_return_repair":"returning-imports-decoded-return-v2","procedure_file_offset_resolution":"address-first-unique-target-source-mapping-v2","process_launch":"inspected-jvm-launch-support-v1","string_inventory_evidence":"defined-data-coverage-v1","target_format":"mach-o","target_kind":"executable"},"provider":{"id":"ghidra","name":"Ghidra","version":"12.1.4"}},"provider":{"id":"ghidra","name":"Ghidra","version":"12.1.4"}},"entries":[],"evidence_bundle":{"artifacts":[{"architecture":"arm64","digest":{"sha256":"c04e911e449e888eb0d8c10f7bcf2b6bc2c4153b9ba86c1952ddf210c96c5e97"},"format":"mach-o"}],"captures":[],"environments":[],"providers":[{"id":"ghidra","name":"Ghidra","version":"12.1.4"}],"records":[{"analysis_profile":{"digest":"3fc72c9b4b78498fb992b938f8f3389dc670244a293c1d40abf5e1d10162ed3b","parameters":{"analyzer_preset":"ghidra-default","annotation_policy":"atomic-function-entry-metadata-v1","architecture":"arm64","available_architectures":["arm64"],"call_relationship_coverage":"function-body-call-coverage-v5","compiler_spec_id":"auto-default","decompiler_jump_loads":true,"function_body_evidence":"complete-inclusive-ranges-v1","function_boundary_observations":"ghidra-function-boundary-limitations-v4","function_dossier_coverage":"observed-facets-and-call-relationships-v1","function_references":"complete-body-and-entry-reference-manager-v2","import_mode":"ephemeral-source-immutable","instruction_flow_evidence":"decoded-return-pcode-v1","instruction_references":"exact-address-incoming-without-synthetic-entry-v2","jump_table_evidence":"typed-case-default-blocks-v1","language_id":"auto-from-header","load_image_observations":"source-mappings-entry-context-v2","loader":"auto-from-header","location_resolution":"explicit-address-exact-entry-symbol-first-v3","no_return_repair":"returning-imports-decoded-return-v2","procedure_file_offset_resolution":"address-first-unique-target-source-mapping-v2","process_launch":"inspected-jvm-launch-support-v1","string_inventory_evidence":"defined-data-coverage-v1","target_format":"mach-o","target_kind":"executable"},"provider":{"id":"ghidra","name":"Ghidra","version":"12.1.4"}},"authority":"shipped-artifact","confidence":"observed","environment":null,"evidence_id":"ev_03d96959bfe24004d31380076ff89441e1486ddbdd69a2c3d636b86b8ac02976","evidence_links":[],"limitations":["The session serves operations only after Ghidra reports default auto-analysis complete; incomplete analysis does not expose partial results.","The imported Program and temporary project are ephemeral and deleted on close. Annotation operations edit session database metadata; original executable bytes are never written.","Cancelling an active Ghidra request terminates its ephemeral database and discards session annotations. The selected target remains open; the next provider query imports the original artifact again.","Default-space addresses use lowercase 0x-prefixed hexadecimal; other address spaces use <percent-encoded-space>:0x<hex>.","Pseudocode is Ghidra decompiler output, not original source and not text-equivalent to Hopper output.","External functions and functions without an analyzable body return null; other decompiler failures remain explicit.","macOS sessions require a matching executable Ghidra native decompiler; REA checks for it but does not build native components or change Gatekeeper quarantine state."],"locations":[],"normalized_result":"\n/* adjustPrimaryHue #1 (_: Swift.SIMD3<Swift.Float>, hueShift: Swift.Float) ->\n Swift.SIMD3<Swift.Float> in static\n LumiGrade_XPC_Service.LumiGradePlugIn.computePrimariesMatrix(redHue: Swift.Float, redSat:\n Swift.Float, greenHue: Swift.Float, greenSat: Swift.Float, blueHue: Swift.Float, blueSat:\n Swift.Float) -> __C.simd_float3x3 */\n\nSIMD3<float> _adjustPrimaryHue_1(SIMD3<float> param_1,float hueShift)\n\n{\n undefined8 uVar1;\n undefined1 auVar2 [16];\n undefined1 auVar3 [16Line truncated
文件差异过大,未显示。 加载差异
+13 -38
查看文件
@@ -1,50 +1,25 @@
# LumiGrade 主题和 LUT 浏览库补充分析
# 主题与 LUT 浏览库实现说明
目标仍为已安装 LumiGrade 3.0(56),arm64 分析切片 SHA256 `c04e911e449e888eb0d8c10f7bcf2b6bc2c4153b9ba86c1952ddf210c96c5e97`。本记录基于 Ghidra 12.1.4 的静态反编译、原文件资源清单和 Swift 符号;静态布局常量不表示已经观测到窗口在宿主实际弹出。完整的 35 条新增 Evidence 位于 `ThemeLUT-analysis.json`。`ThemePalette.json` 是从原双精度常量逐值解码的颜色数据,不是截图估色。
五套主题、浏览器和预览由本工程的 `DYTheme`、`DYLUTLibrary`、`DYLUTBrowser`、`DYInspector` 与 `DYRenderer` 实现。相关 Color Finale 移植研究与来源边界见 [ALGORITHM_SOURCES.md](ALGORITHM_SOURCES.md)。本文件说明当前产品行为,历史静态观察完整保留在整理前提交中。
## 主题
- `ThemePreference.selectedIndex`(`0x100059374`,`ev_a8688461143765f6d38667a24dc736bcfcce133f76c6c1003b3e2d86ee6bfc67`)读取 `NSUserDefaults.standard`,合法整数为 0–4;缺失、错误类型、越界均回到 1。`refreshFromDisk` 为真时先 `synchronize`。
- `ThemePreference.select`(`0x1000594c4`,`ev_5dcc78a25578273dc8d179c57dc0afd79cf31d176d3cd88f806ab3a060f387df`)仅写合法索引,写后 `synchronize`,并向普通和分布式通知中心发布同一通知。因此原版主题是跨实例、跨进程的全局偏好,不是逐滤镜的可动画调色参数。
- 原偏好键 `LumiGrade.globalThemeIndex`(`ev_2dea9886c635b29b0e21643ccb31c1264ffd35280494e35f03405af8202bb692`),通知 `LumiGradeGlobalThemeDidChange`(`ev_fd94a34bf03cae7ae8a372d5c9b5b60a322d1e238115dac8e7996f8baa3b6ae5`)。复刻应使用产品自己的命名空间,不改原厂偏好。
- 依 `family(for:)`(`0x100059cec`)的比较常量和界面观测,五个色块顺序为灰、蓝、紫、绿、橙;这五个中文名称是说明性名称,不主张它们是原版 tooltip 文案。色块 RGB 分别为 `(0.30,0.33,0.38)`、`(0.28,0.72,1)`、`(0.58,0.52,1)`、`(0.30,0.86,0.52)`、`(1,0.61,0.28)`,默认蓝。
- `chromeAccent`(`0x10005b1bc`,`ev_e814744aa17fdd27bbd3b46f60561201c4bdebf068a430b2007006b5c51ee7f2`)另将灰转为 `(0.72,0.77,0.84)`、蓝转为 `(0.22,0.67,1)`,其余三个保持对应主题色。不能直接把灰色块的暗灰当文字和工具图标 tint。
- `palette`(`0x10005a028`,`ev_0a2bea4354863fd7685a919ca6dae83ba5cf582f12cd0592edb24f0816eee35a`)生成每主题 17 色,使用 `colorWithCalibratedRed:green:blue:alpha:`。数组按原 Palette 存储顺序保留。消费者确认的槽含义如下。
主题顺序为灰、蓝、紫、绿、橙,默认蓝。每套包含 17 个颜色槽,数值快照见 `ThemePalette.json`。色块 RGB 分别为 `(0.30,0.33,0.38)`、`(0.28,0.72,1)`、`(0.58,0.52,1)`、`(0.30,0.86,0.52)`、`(1,0.61,0.28)`。
| 槽 | 实际用途 | 消费函数 |
| --- | --- | --- |
| 1 | 整体面板底色 | InspectorView.applyAccent,`0x10001c9a4` |
| 3 | section 内容底色 | SectionView.applyAccent,`0x100022d98` |
| 6、7 | section 标题胶囊渐变 | SectionTitleButton.applyAccent,`0x100049e6c` |
| 8、9 | 普通滑条轨道渐变 | SliderCell.drawTrackBackground,`0x100041fa8` |
| 10、11 | 普通滑条活动段渐变 | SliderCell.drawBar,`0x10006c9c0` |
| 14 | Logo 和 section 标题文字 | InspectorView / SectionTitleButton.applyAccent |
| 15 | 参数行、输入和 LUT 标签 | InspectorView.applyAccent |
| 16 | 版本文字 | InspectorView.applyAccent |
整体底色使用槽1,分组底色使用槽3,标题胶囊渐变使用槽6/7,滑条轨道使用槽8/9,活动段使用槽10/11;标题、参数标签和版本分别使用槽14/15/16。灰色工具强调色为 `(0.72,0.77,0.84)`,蓝色为 `(0.22,0.67,1)`。主题保存到独立大鱼偏好域并通知其他实例;主题不属于可动画调色参数。
Section 描边使用 chrome accent 的 alpha 0.38;可见性、展开和其他工具按钮常用 alpha 0.92。普通滑条高度 5、圆角 2.5、黑色描边 alpha 0.28 / 线宽 0.6。其余槽在本次有完整颜色值,但不额外猜测语义。
## 用户库与浏览器
## LUT 库发现与入口
用户 LUT 库位于 `~/Movies/大鱼调色LUT/look LUTs`。支持递归发现 `.cube`、目录过滤、名称搜索、收藏、导入和 Finder 打开目录。顶层文件可归入未分类;隐藏项跳过,路径去重。导入保留源文件,重名时产生带数字后缀的副本。
- `userLookLUTFolderURL`(`0x100070058`,`ev_9a37e0a0dcdc73db9e2c58ceb5d34dfbbe0629d4b59cc2c082f68ac7d69c5c56`)使用用户 Movies 目录,回退 `~/Movies`,再拼接 `梁哥调色LUT/look LUTs`。复刻使用自己的目录,不修改原厂库。
- `lookLUTFolders`(`0x1000822b4`,`ev_abc8f7799dfd67b519733d2de59c75c013b02dd07b59f009a770fa6ab41c76b0`)另加入插件 bundleForClass 和 mainBundle 的 `Resources/LUTs/Look`,再加入用户目录。
- `discoverLookLUTOptions`(`0x100070bc8`)读取目录内容,跳过隐藏内容(options=4),文件扩展名小写比较 `cube`。顶层目录分别递归枚举;顶层文件进入「未分类」,以路径去重,再排序。此次安装包里的 17 个 `.cube` 全部为输入相机配置;清单中没有 `LUTs/Look` 内置风格文件。未在此调查中读取用户 LUT 文件内容。
- `lookLUTMenuGroups`(`0x100090360`,`ev_db2b7ee3dceb2a58706ee4515113437a34f4199bcc0508ab053933fa590529ad`)排除第 0 个「无」选项,以已有 group title 分组,无 group 时归「未分类」,保留 selection index 给点击回写。
- `openLookLUTFolder`(`0x100066c10`,`ev_82b900e1fdd53b69048bcf894b4fba6bff9f958acdbc26c4e7b7bc58320eab67`)创建用户目录并调用 `NSWorkspace.openURL`;右侧文件夹图标用于在 Finder 打开文件夹,未显示选择根目录的 open panel。
浏览器采用 760×560 点布局,缩略图比例为16:9,大小默认96、范围70–255;目录和尺寸偏好独立保存。优先使用宿主窗口接口,必要时使用锚定弹出面板。单击应用所选 LUT,目录切换和预览生成不应意外写入调色参数。
## 浏览器布局、选择和缩略图
## 真实帧与方向
- `showLookLUTPreviewBrowser`(`0x10001ee8c`,`ev_7e6daea432f64c3380b5399e539dcf6abaafc0fe4ad7efe3d507121a1d722813`)以 **760×560** 展示 `LookLUTBrowserView`;可按宿主选择原生 host presentation 或 anchored `NSPopover`。Popover behavior=1,锚在入口按钮。
- `build`(`0x10004f9fc`,`ev_70bccecb4b8d036ad6303ee9fa6b2c34dd9768db7a0a5f9428db4a4d81c4329d`)浏览器底色固定 Calibrated RGB `(0.035,0.08,0.12)`;整体内边距 12、纵间距 10;左目录宽 150,顶部左标题宽 145,右网格容器宽 560,最小高 240;左右列间距 12。顶部同时显示库标题、当前目录及文件数和缩略图大小滑杆。标题 14 semibold;文件数 10 medium。
- initializer(`0x100066534`,`ev_98b1bcc280692122ab576ba2cf0062846372dfee4db01a703307f2c4ac5d8e3d`)创建 size slider:默认 **96**、最小 **70**、最大 **255**,宽 150。读取 `LumiGrade.lookLUTPreview.thumbnailSize`(无有效正数时为 96)及 `LumiGrade.lookLUTPreview.selectedFolder`。该偏好同样应在复刻中使用独立键。
- `thumbnailClicked`(`0x100052784`,`ev_cc54cc6744ddd7a436ee769e86209c3306f4576995f7033b108ea225d803bd6f`)单击即设置所选 index、更新 tile 选择边框并调用 onSelect;该函数没有关闭浏览器。未发现必须双击才应用的路径。
- Tile initializer(`0x100066338`)设置宽度为缩略图大小,高度为 `size×9/16+24`。图像为 16:9,下方额外 24 像素放名称。
- `sizeChanged`(`0x100052814`,`ev_083dcc84539e4a5e2e388f33f77929bc857b3ef6651054aab08593f6fcd1c52a`)保存偏好,取消旧 work item,**0.22 秒 debounce** 后重建。
- `reloadThumbnails`(`0x100051238`)按当前尺寸重新分行,每行 spacing 10;后台 previewQueue 逐项生成,generationID 与弱引用用于抛弃旧代、已关闭视图或过期 tile 的结果。UI 更新回主线程。
- `currentLookLUTPreviewItem`(`0x10007f148`)缓存键为 `frameVersion|Int(size)|LUT path`,超过 600 项清空缓存;用 currentPreviewFrame 或 fallbackPreviewFrame,对每个候选施加对应 LUT。
- `currentPreviewFrame`(`0x10007f4f4`,`ev_7f13d031b53f51bd16e7cea9755f085d590d702c7dc993a31040568a17b4d9b9`)在缩略图 LUT 前先处理当前输入 LUT 及其强度,并按源帧版本缓存结果。`capturePreviewFrameIfNeeded`(`0x1000833ec`)捕获节流 **0.35 秒**;输入路径/强度变化立即递增版本并失效 processedPreviewFrame。
- `thumbnailImage`(`0x100091a04`,`ev_47a86ed56280777069e755d726b84701244573dceed4b182f9ec8de02d12fc40`)宽 `max(64,Int(size))`,高 `max(40,Int(width×9/16))`;先转 RGBA8,以每通道 `/255` 经 CubeLUT.sample,然后 clamp/量化回显示字节。此浏览器缩略图并非整套基础调色和五层 LUT 合成后的画面。
缩略图取当前素材经过输入转换后的源帧,再应用候选 LUT;解析和采样使用产品的 LUT 实现。没有源帧时显示合成色卡。分析帧保留物理行序,浏览显示根据 FxPlug 图像原点转换,避免上下翻转。
## 证据边界
图库任务采用缓存、懒加载和失效处理。用户 LUT、收藏与偏好是本机用户资料,换机时需独立搬移;源码中仅包含合成验收 LUT 的生成脚本。
地址对应本次 arm64 切片,不能当作其他版本地址。Ghidra 对 Swift 参数和 SIMD 值有类型恢复误差,本文仅将直接常量、可见 API、字段读写及可验证的堆栈偏移用作实现规格。颜色槽用途按原存储偏移与具体消费者对应;布局常量仍需正式宿主进行视觉核对。浏览器没有从此静态清单中推断出网络商店、账号收藏、搜索框或动态商业 LUT 下载功能。已关闭本次 REA 原生会话;可复用的完整 session snapshot 保存在本机产品缓存 `research/ThemeLUT-snapshot.json`。
## 验收
五主题、导入、目录与名称过滤、尺寸记忆、缩略图方向、单击应用、保存重开和 ProRes 导出见 `verification/HostThemeLUT.json`。当前分组展开与启用规则见 `verification/HostGroupFolding.json`。历史报告对应其记录的版本,不能将其范围自动扩展为所有素材、宿主与系统均已验证。
+2 -3
查看文件
@@ -554,8 +554,6 @@
]
]
},
"preferenceKey": "LumiGrade.globalThemeIndex",
"notificationName": "LumiGradeGlobalThemeDidChange",
"chromeAccentRGB": [
[
0.72,
@@ -595,5 +593,6 @@
"logoAndSectionTitleText": 14,
"rowLabelText": 15,
"versionText": 16
}
},
"historicalEvidenceCommit": "29dc4d385c1459cd330d8a9083ec9756787afef3"
}
+12
查看文件
@@ -0,0 +1,12 @@
# Color Finale 移植资料快照
四份资料来自同系列“大鱼调色盘”工程,原文逐字节保留。提交与SHA-256见 [SOURCES.json](SOURCES.json),本仓库的适用范围见 [算法来源说明](../ALGORITHM_SOURCES.md)。
| 资料 | 本地快照 | 原工程固定版本 |
| --- | --- | --- |
| 研究记录 | [colorfinale.md](colorfinale.md) | [查看原文](https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale.md) |
| 颜色工具设计 | [colorfinale-color-tools-design.md](colorfinale-color-tools-design.md) | [查看原文](https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale-color-tools-design.md) |
| 迁移矩阵 | [colorfinale-2.0-matrix.md](colorfinale-2.0-matrix.md) | [查看原文](https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale-2.0-matrix.md) |
| 证据索引 | [colorfinale-index.json](evidence-index/colorfinale-index.json) | [查看原文](https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/evidence-index/colorfinale-index.json) |
快照中的其他相对链接仍指向原工程的文件;使用上表固定版本可继续浏览其完整上下文。设计目标、独立实现与发行验收以各原文的范围说明为准。
+34
查看文件
@@ -0,0 +1,34 @@
{
"project": "大鱼调色盘",
"remote": "https://dayu.media/git/dayu/dayu-colorplate.git",
"commit": "4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca",
"verifiedRecordsMatchCommittedFiles": true,
"records": [
{
"sourcePath": "research/colorfinale.md",
"path": "research/color-finale/colorfinale.md",
"sha256": "f669841b2f0402543ad87522cf23fd17e3eced5ef481f5b0e1b0a489d6e2d70d",
"sourceURL": "https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale.md"
},
{
"sourcePath": "research/colorfinale-color-tools-design.md",
"path": "research/color-finale/colorfinale-color-tools-design.md",
"sha256": "0b5f75d50cf4427dd74c68e5612d15b8cf7748b63a99bf7101c2945663460d07",
"sourceURL": "https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale-color-tools-design.md"
},
{
"sourcePath": "research/colorfinale-2.0-matrix.md",
"path": "research/color-finale/colorfinale-2.0-matrix.md",
"sha256": "721d50ac0391b515747820632612d56aa34084251e3a347bf16911bdb3f3e7b0",
"sourceURL": "https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/colorfinale-2.0-matrix.md"
},
{
"sourcePath": "research/evidence-index/colorfinale-index.json",
"path": "research/color-finale/evidence-index/colorfinale-index.json",
"sha256": "fecb1a8e2fa23d664acbc878cc91c9cf7c0dc646212197b0dd68e34a5d2b244a",
"sourceURL": "https://dayu.media/git/dayu/dayu-colorplate/src/commit/4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca/research/evidence-index/colorfinale-index.json"
}
],
"scope": "Related-product Color Finale migration research. These documents distinguish observations, independent implementations, planned work and unverified scope; copying the research does not establish a direct code port in this repository.",
"relativeLinkPolicy": "Archived documents retain their original bytes. Relative links inside them resolve against their sourceURL in the original repository."
}
@@ -0,0 +1,169 @@
# 大鱼调色盘 2.0:Color Finale 迁移对照
研究日期:2026-10-26(Asia/Shanghai)。这是功能目标和证据矩阵,**不是已实现清单或发行验收记录**。当前正式安装为大鱼调色盘 2.0.0(56),已完成图层/空间工具、外部输入、CMS、首轮五组胶片处理和Classic24色卡匹配;矩形真实拖动及窗口一次前置已有用户确认。具体范围见verification/release-2.0.0-build56.json。完整迁移尚未完成。
色卡56进度(2026-10-29):Classic24(2014年11月后)6×4参考、射影四角、三模式、CMS前置线性校正、schema19冻结状态和原生控件已接入并正式验收;实际FCP匹配RMS 0.03309→0.00398,一次Undo/Redo与冷重开2557字节一致。Video/Passport Video仍开放,不能视作本矩阵原厂色卡条目已全部完成。自动指针拖动没有确认参数变化,真实四角手势仍未确认;合同和证据见research/chart-matching-contract.md、verification/release-2.0.0-build56.json。
CMS开发进度:根schema16/CMS作者v2、实际源/目的ICC、CPU/Metal整帧、浮点主预览/图库/取色/导出约束已接通;根CMS控件1257项和实际HDR媒体导入37950项通过。正式34完成独立PQ/HLG取帧与FCP CMS撤销/重做;35修复说明换行并通过FCP冷重开,完整调色文件141187字节一致。见 `verification/cms-controls-media-development.json` 与正式35报告。HDR显示器EDR亮度及4K实时未认证。
运动/散景已在正式36验收:方向、光环宽度/强度/柔和度、RGB/HSL、各自参数保留、撤销/重做和冷重开逐字节一致。算法为独立实现,见research/motion-bokeh-contract.md;最大半径4K HSL散景约2.06秒,不承诺实时。
胶片55进度(2026-10-29):减色/晕光/辉光/暗角/颗粒的独立算法、根级控件、schema18归档、CPU/Metal、精确有理帧保持、Undo及FCP冷重开已验证;完整处理文件重开前后7108字节一致。没有原厂同名八种印片外观,色卡和其他工作流仍开放,详见 [胶片合同](film-processing-contract.md)。
## 对照版本与证据边界
本机 `/Applications/ColorFinale.app` 为 **2.16.2(625)**,主插件可执行文件 SHA-256:
`49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f`
本次重新计算的摘要与 [已有静态研究](colorfinale.md) 及 [证据索引](evidence-index/colorfinale-index.json) 一致。REA 当前没有打开的目标,无需重复全量分析。已有证据解释的是该发行包的结构,不等于实际 FCP 运行验收。
本次读取了 Color Finale 官方文档和官方界面截图。文档可能包含比本机版更新的功能;涉及 Tone/Chroma、Texture EQ 频段和 FCP 12 的行为需另做版本核验。未改动用户的 FCP 工程,未将专有资源、图标、LUT 或反编译源码复制到项目。
## 本轮优先迁移
| 能力 | 已证实的原产品语义 | 大鱼实现与验收目标 |
| --- | --- | --- |
| 真正的工具图层 | 顶部工具入口创建工具层;同类工具可多次添加;下旧上新,底至顶处理;可排序、启停、重命名、复制、删除 | 有序、稳定身份、独立参数;选择层不改变输出;禁用层是恒等;复制生成新身份;保存和撤销不串层 |
| 图层工具区 | 左侧层列表,主区域显示选中工具,底部为混合量、混合模式、蒙版和删除 | 所有精细工具集中在独立图层编辑器;明确“添加图层”和“编辑当前层”,避免切页意外创建层 |
| 图层蒙版 | 蒙版属于层;同层可有多个形状,以 Add/Subtract/Intersect 组合 | 层全部处理受蒙版约束,包括曲线、LUT、六色向量和蜘蛛盘;无蒙版时全画面生效 |
| 区域跟踪 | 每个节点保存轨迹;按宿主 effectTime 持久化归一化变换;前后跟踪与关键帧操作 | 冻结实例、层 ID、蒙版 ID、形状修订及参考帧;删除或改形后拒绝旧回调;倒序和随机时间输出一致 |
| 六色向量 | RGBCMY 独立 H/S/L;新版另有肤色向量及可调 Skin Target | 六区独立,灰阶不染色,色相首尾连续;肤色扩展单列;不能把全图 HSL 当作六色选择调整 |
| 检查器快捷 HSL | 此位置是大鱼的产品要求,不是对原版行为的断言 | 保留原基础调色和蜘蛛盘;快捷 HSL 直接可用,作用范围及与图层关系明确 |
| 持久 LUT 目录 | Preferences 登记目录并递归发现 `.cube`;图库支持当前片段 Live Preview | 同产品进程共享配置;目录可添加、移除、重定位;空目录、离线、权限和坏文件有不同提示 |
| 当前帧批量预览 | 缓存源帧,应用项目调整,再应用候选 LUT,最终作颜色/方向转换 | 每批冻结同一真实宿主帧及图层快照;旧任务失效;预览不写工程;点击才提交 |
| LUT 插入 | 图库双击或 Insert 新建 LUT 层;可叠加不同 LUT | 默认明确新建层;替换现有 LUT 是独立操作,候选预览不能叠加被替换的原 LUT |
来源:[图层编辑器](https://docs.colorfinale.com/docs/layers/)、[六色向量](https://docs.colorfinale.com/docs/layers/sixvectors/)、[蒙版](https://docs.colorfinale.com/docs/masks/masks/)、[区域跟踪](https://docs.colorfinale.com/docs/masks/tracking/)、[LUT 工作流](https://courses.colorfinale.com/blog/post/cf-lut-management-08-23)、[偏好设置](https://docs.colorfinale.com/docs/preferences/)。
## 完整功能差距登记
以下能力不能因为本轮五个重点完成就自动标记为“全部迁移”。没有相应实现和验证时保持未验收。
| 领域 | 官方能力 | 依据 |
| --- | --- | --- |
| 色轮 | Lift/Gamma/Gain、RGB 滑块、各区亮度与饱和度、分界范围、CDL 导入导出 | [Color Wheels](https://docs.colorfinale.com/docs/layers/wheels/) |
| RGB/Luma 曲线 | Master+RGB、Luma+RGB、Luma Preserving、取色建点、S 曲线捷径 | [Curves](https://docs.colorfinale.com/docs/layers/curves/) |
| 六色与肤色 | 六个标准色区及第七肤色向量,H/S/L、肤色中心、Extended 饱和度模式 | [Six Vectors](https://docs.colorfinale.com/docs/layers/sixvectors/) |
| HSL 曲线 | 按色相改变色相/饱和度/亮度,按亮度或饱和度调饱和度;单曲线旁路及不同插值形式 | [HSL Curves](https://docs.colorfinale.com/docs/layers/hsl/) |
| 滤镜 | Box/Gaussian/Disc 模糊和锐化,RGB/HSL 分通道 | [Filter](https://docs.colorfinale.com/docs/layers/filter-layer/) |
| 通道路由与混合 | RGB 路由、直接常量/颜色、通道混合、系数归一化、通道反相 | [Shuffle](https://docs.colorfinale.com/docs/layers/shuffle-layer/) |
| 相机矩阵 | RGB 基色独立色相与饱和度,保持整体白平衡 | [Camera Matrix](https://docs.colorfinale.com/docs/layers/camera-matrix/) |
| Log 色轮 | 阴影/中间调/高光/Offset;范围分界;位于 Log 转换前处理 | [Log Wheels](https://docs.colorfinale.com/docs/layers/log-wheels/) |
| 色调映射 | 最多 11 点 HSLA 渐变、不同亮度来源、取色和预设 | [Color Atlas](https://docs.colorfinale.com/docs/layers/color-atlas/) |
| 纹理均衡 | 当前文档列六个尺度频段,基于多尺度模糊分解 | [Texture EQ](https://docs.colorfinale.com/docs/layers/texture-eq/) |
| LUT 强度扩展 | 最新文档包含 Tone 和 Chroma 独立强度;本机版对应性尚未逐项核验 | [LUTs](https://docs.colorfinale.com/docs/layers/luts/) |
| 图层组 | 多选建组、折叠、混合组与独立层;组默认 Pass-through | [Groups](https://docs.colorfinale.com/docs/layers/groups/)、[Blend Modes](https://docs.colorfinale.com/docs/layers/blend/) |
| 形状种类 | 矩形、椭圆、折线、B 样条、Bezier、渐变边缘、图像蒙版 | [Masks](https://docs.colorfinale.com/docs/masks/masks/) |
| 内外调色 | 组的父蒙版供多层共用,单层可反转父蒙版 | [Parent Masks](https://docs.colorfinale.com/docs/masks/parent/) |
| 形状组 | 形状多选编组、整体移动、组级 Add/Subtract/Intersect | [Grouping Masks](https://docs.colorfinale.com/docs/masks/grouping-mask-shapes/) |
| HSL 蒙版 | 选色范围/衰减、取色增减、输入输出阶、模糊、源阶段选择 | [HSL Mask](https://docs.colorfinale.com/docs/masks/hsl-mask/) |
| 人物与外部蒙版 | 人物分割、FCP 外部蒙版接入,四种蒙版显示方式 | [Person Mask](https://docs.colorfinale.com/docs/masks/person-mask/)、[External Masks](https://docs.colorfinale.com/docs/masks/external-mask/)、[Display Modes](https://docs.colorfinale.com/docs/masks/fourmaskdisplaymode/) |
| 蒙版发布与抠出 | 从图层或组发布蒙版,在外层检查器选择 Mask Output / Cutout,将结果用于时间线合成 | [官方2.9工作流](https://colorfinale.com/blog/post/cf-2-9-masks-09-24);准确组合与alpha语义待本机发行代码核对 |
| 色彩管理 | Assume Video/Log、ACES、相机输入变换、输出变换、工作空间 | [Color Management](https://docs.colorfinale.com/docs/inspector/cms/) |
| 色卡匹配 | ColorChecker Video/Passport,四角定位、自动匹配和色卡预设 | [Color Chart](https://docs.colorfinale.com/docs/inspector/chart/) |
| 胶片模拟 | 减色、晕光、辉光、暗角、颗粒;部分 Film Look 位于 ACES 链路 | [Film Emulation](https://docs.colorfinale.com/docs/inspector/film-emulation/) |
| LUT 导出 | 将可用纯颜色处理及已有 LUT 合成为 `.cube`;空间蒙版不可烘焙进 LUT | [Export as LUT](https://docs.colorfinale.com/docs/inspector/export-as-lut/) |
| 其他工作流 | 调色预设、跨片段组同步、图像分析、硬件控制面板 | [完整文档目录](https://docs.colorfinale.com/docs/) |
## 界面观察与独立设计
官方 [总览截图](https://docs.colorfinale.com/docs/overview/overview.png) 显示检查器一级调整和独立浮动图层面板并存。浮动面板是横向布局:顶部工具图标、左侧层栈、右侧大面积当前工具、左下层混合和蒙版入口。总览截图标示原版 2.15.0,不作为本机 2.16.2 运行证据。
官方 [六色向量截图](https://docs.colorfinale.com/docs/layers/sixvectors/images/sixvectors.png) 中,七枚颜色按钮横排,下方仅显示当前颜色的 H/S/L 三条滑块;肤色多一条 Target。右侧为可编辑数值,底部为整体和当前向量复位。
大鱼可借鉴信息层级、选择反馈和直接编辑,但不复制原图标或专有素材。清晰标注“全局快速调节”与“当前层”,比让外层控件随选层暗中改变含义更容易判断。本项目最终采用哪种绑定,以实现记录为准。
## 尚未确认的数学与运行事项
- 六色/肤色选择的确切权重、带宽和亮度公式未由公开资料确定,独立实现需自身数值与实际画面验收。
- 旧静态跟踪证据观察到仿射拟合及位置/旋转/双轴缩放输出,不能因此宣称有透视、逐节点形变或遮挡重识别。
- 官网 2025 年介绍 Texture EQ 为五个频段,当前文档为六个;两者应按版本区分。[旧说明](https://colorfinale.com/blog/post/cf-6-vectors-06-25)
- 官方 HSL 页面中“Sat vs Luma”标题与正文轴描述存在命名混淆;大鱼 UI 应使用明确的“亮度 → 饱和度”名称,不照抄含混标签。
- 原版区域跟踪的具体失败恢复、图库插入位置、原版完整运行交互尚未实际比较。不能将官方文字与已有静态分析合并声称运行验收通过。
## 关键验收
1. 两层分别处理天空和建筑;切层、复制、重排、启停、撤销、保存重开后参数与蒙版归属正确。
2. LUT/曲线/六色向量在蒙版外保持该层输入,蒙版中羽化和混合量连续;alpha 不被空间遮罩误裁。
3. 跟踪时重排或切层不改变目标;删除目标或改形后拒绝过期结果;取消保留可信段。
4. LUT 登记一次后重开可见;递归去重且不跟随目录符号链接;失败目录和坏文件可见,不删除工程中已应用的采样数据。
5. 快速切片段、移动播放头、换目标层后,整批卡片最终来自同一当前快照;点击结果与预览的位置、强度一致。
6. 六色条和连续色相环验证区域隔离、灰阶安全及首尾连续;旧 schema 归档保持原有输出和轨迹。
## 2026-10-26 第二阶段实现进度(尚待正式宿主验收)
- 已接入:Pass-through 图层组、8 种叶子混合、父蒙版内部/外部、HSL 五条曲线及线性/平滑过点插值、RGB Master/Luma/Luma-preserving 自由曲线、相机矩阵、四区 Log 调节、独立 ASC CDL 与 CC/CCC 导入导出、最多 11 点颜色映射、原生调色文件、持久预设及 17³、33³、65³ LUT 导出。
- 工具算法为独立实现。B 样条近似、取色创建曲线点、原三色轮的完整 CDL 对应、自动相机输入判定仍未覆盖。
- 组只实现 Pass-through;8 种混合用于叶子层,未声称实现所有 Color Finale 组混合模式。颜色映射的渐变显示是空间输出,明确拒绝导出成 3D LUT。
- 更多蒙版形状、HSL 与亮度键、人物或外部蒙版、手动形状动画、空间滤镜、纹理、色彩管理、胶片模拟、色卡、硬件及跨片段同步仍是开放项。
## 2026-10-26 蒙版与羽化进度
构建23已经正式验收类型蒙版、精确时间关键帧、颜色源阶段与手动/自动轨迹合并;构建24已公证安装内/外羽化双轮廓。主体宽高与羽化拖动独立,保留旧向内效果,轨迹合并保留非几何动画。布局修正版25已公证,待宿主退出后安装;最终冷重开未完成。报告及确切限制见HANDOFF.md,完整目标仍未完成。空间工具、人物/外部蒙版、色彩管理及其他上表未验收项继续保留。
## 2026-10-26 空间工具源码进度(未正式安装)
`d31b3551ca55f787605279f821c163cf3411cb75` 已接入空间滤镜(均值/高斯/圆盘/锐化柔化)、六频段纹理、逐蒙版独立模糊及可操作图层控件。CPU/Metal完整帧、schema8与原生文件、异步取消和图库预览已联通,独立远程恢复186个文件并重编译通过728项面板测试。实际正式APP/FCP验收仍待完成,不能从源码测试推定正式效果或实时性能。Motion/Bokeh、人物/外部蒙版、色彩管理、胶片、色卡及其它未覆盖细项继续保留。
## 2026-10-26 帧蒙版开发基础(未接产品界面)
`1772fd65aac5d9e13b140c82a42705a8faaacbfa` 增加共享标量帧绑定及独立帧Vision人物提供者。CPU/Metal蒙版与父组组合、9次真实人物推理、乱序/同时间换图、均衡/高质量、内存与取消和远程197文件恢复已验证。没有复用Color Finale模型;没有把执行模块当作完整人物功能。作者归档、工作空间/宿主输入适配、人物选择与轮廓细化UI、外部image well/模板和正式验收仍为开放项。见HANDOFF.md和research/colorfinale-frame-mask-design.md。
## 人物帧来源进入真实渲染的开发检查点
`b0f3d5f2563aae51fc4573c95ab629634f9b1cbd` 完成人物/外部来源schema9、精确强度动画、运行计划6与逐帧解析。人物已接CPU/Metal位图、宿主纹理和取色;使用来源RGB配置转换分析图像,保留原调色图像。6次实际人物推理、两种图像原点、透明度、失败原子性及734项离屏面板检查通过;远端独立恢复206文件和重新编译测试通过。仍未开放人物添加/质量菜单,外部输入还未接FxPlug调度,轮廓/实例细化、预览与LUT共用全幅人物分析及正式发布验证仍未完成。颜色转换仅服务人物分析,不等于CMS/ACES迁移完成。
## 2026-10-26 人物控件和 LUT 分析复用开发节点
`7b3f0ad97321b7801fe19032edd92ad05a7a56d0` 已实现人物添加、质量、公共色阶/模糊/强度动画,隐藏无关的几何和纹理跟踪,修复同名蒙版选择及延迟编辑隔离。LUT批次对完整可用面板源按不同请求分析一次并共享原始覆盖度;真实人物图库换帧/应用、807项离屏面板检查、CPU/Metal蒙版显示及212文件远端重建通过。正式24和待装25未变。面板仍是8位缩略图,主预览与图库尚未共用一次分析;人物实例/轮廓/细节细化、外部输入、四种显示模式及正式界面性能/无障碍验收仍开放,不能称人物功能完整迁移。证据见 `verification/person-mask-ui-development.json`。
## 2026-10-26 人物轮廓/细化独立模块
`64a8f56d233d003bb4ab20766c70b18aa78267eb` 完成独立欧氏轮廓、细节与柔和度CPU/Metal模块,提供人物/轮廓/组合及内/中/外位置。修复50%边界浮点分类和软内部覆盖保留问题,177个GPU案例含4K与CPU一致、默认逐位恒等;独立远端224文件恢复和重编译通过。当前仍未接入作者归档、运行计划、产品面板和正式版本,三种处理模式不替代四种显示模式;该条继续标记开发中。
## 2026-10-26 人物细化接入产品源码
人物/仅轮廓/人物加轮廓、内/中/外位置、宽度/细节/柔和度已接入schema10、计划7、原生面板及CPU/Metal完整帧。三种处理模式与四种蒙版显示模式分开;后者继续开放。人物推理请求32字节不变,LUT批次复用原始分析;旧缺省保持恒等,外部源不能误用人物细化。离屏归档、真实人物宿主纹理、父组、边缘重采样、撤销和延迟编辑验证见 `verification/person-refinement-integration-development.json`。正式24和待装25仍不变,人物实例、外部输入、完整CMS/ACES、胶片/色卡及正式界面/性能/无障碍验收继续开放。
## 2026-10-26 四种蒙版显示进入产品源码
`69fc3712f2322155b10c4ebbe3af3f72bcda2b8b` 已接入结果/输入/输入与蒙版/合成蒙版。实际图层入口、同层组合和父组内部/外部覆盖经独立像素参考及CPU/Metal核对;真实人物细化、精确时间、异步旧结果拒绝和原生下拉菜单已接通。显示方式只在窗口内生效,不写入工程、撤销或LUT;旧输出蒙版标记保持兼容。此节点补齐上节的显示模式源码,正式界面与宿主验收仍开放。详见 `research/mask-display-contract.md` 和 `verification/mask-display-development.json`。
## 2026-10-26 主预览与 LUT 共享人物分析
`c281e39a1d6ffbc3b86d18b8783f8e8fc81d072e` 将同一窗口当前精确帧的原始人物覆盖度共享给主预览、蒙版检查和图库。并发请求共用同一覆盖度对象,部分质量命中保留已有结果,颜色/轮廓编辑复用;换源、换时间及同时间上游变化隔离,取消与失败不污染其他消费者。面板仍采用RGBA8缩略图,完整HDR/全分辨率取帧和正式播放性能仍待完成。证据见 `verification/preview-sharing-development.json`。
## 2026-10-26 外部图像调度与配对快照
`a57576e3bc353f641fbd864fe0d9fa35228fb466` 已接入固定ID4图像槽、EffectClip/Parameter双路调度、冻结时间映射、独立坐标与原点、Alpha/Luma实际GPU渲染,以及主预览和LUT共享的自有外部快照。输入顺序、错帧、缺失、父组、代理范围、宿主纹理变更及精确配对已通过离屏测试;真实插件回调以模拟宿主元数据验证,不能替代FCP验收。远端248文件恢复、两目标Release链接、Address/UB与Metal验证通过。接收模板、添加/通道控件、外部轮廓、实际Drop Zone时间与保存重开仍开放;正式24及冻结25未变。见 `external-input-contract.md` 和 `../verification/external-input-development.json`。
## 外部作者与原生接收模板开发(未正式安装)
`576add796cf9daa8b74271a83f2b96d7ec3d7adc` 补齐图层/组外部蒙版入口、Alpha/Luma、轮廓位置/宽度/细节/柔和度,schema11和计划9;精确强度动画保持,矩形/椭圆羽化外框与区域跟踪回归通过。独立接收模板连接固定ID4,普通模板不变;未来正式APP安装两个缺失模板,保留用户修改。1,026项面板、19,128项输入/实际GPU、144组人物/外部细化、15项模板结构及259文件远程恢复通过,详见配套verification报告。实际FCP接收、空来源、变速、保存重开、正式UI/性能未验收;本轮不把静态模板或离屏测试视为完整外部功能交付。
## 迁移范围校正:人物实例与蒙版发布
2026-10-26重新核对:`colorfinale-frame-mask-design.md`中单独人物实例是“第二阶段可评估”的大鱼扩展设想,官方Person Mask当前说明只证明显著人物整体识别、质量和边缘细化。尚未找到单独人物选择是本机2.16.2功能的充分证据;它保留为可选评估项,不作为已证实Color Finale功能缺口。此结论不把缺失证据当作原版不支持的证明,也不减少用户原定的完整迁移范围。
反而已有明确但此前矩阵漏列的功能是“Publish Mask / Mask Output / Cutout”:官方2.9文章展示图层或组蒙版输出,用于把文字放在人物后面等时间线合成。大鱼现有maskView黑白输出、临时四种检查视图、外部输入三者都不能单独证明这一持久发布流程已完成;该项新增为必需迁移和验收项,正在核对本机发布目标及alpha行为。当前完整目标继续进行。
### 发布蒙版与抠出开发接入(2026-10-26)
`bbb4f00bc45170eab1312c6b39989a37f98c02ea` 已实现schema12的唯一图层/组目标与独立输出模式、CPU/Metal节点后发布、真实alpha、外层检查器和图层按钮、透明棋盘格以及归档/撤销/预设/LUT限制。组强度同步插值straight RGB与alpha,旧未发布结果保持。432组独立数值用例(220740断言)最大浮点差8.94069672e-8、8位差0;离屏面板1086项、真实插件回调夹具48项、解析14项通过。详见 `research/published-mask-contract.md`。正式安装、宿主叠层/冷重开及视觉验收仍开放。
原版静态证据确认发布时序和own mask,并发现其组结果后置蒙版、发布重新取样阶段与当前大鱼规则仍有差别。逐子层父蒙版与完整组混合继续列为待升级,不能因发布功能落地而勾选全等。人物已核实路径为整体分割,单人实例选择保留可选扩展。原版证据和限制见 `research/colorfinale-published-mask-design.md`。
### 组内外双链与混合开发接入(2026-10-26)
`b38bc7739f1605e81e0596e4ea942e3b4c7b8ff5` 已实现schema13/计划11的新式组:两链独立从入口开始、直属父蒙版外部路由、组混合和straight RGBA强度、最后按蒙版预乘合成。旧文件仍走旧式逐层覆盖,兼容切换可撤销;嵌套混合版本、空间工具、入口取色、临时监看、发布、LUT候选和导出接入统一流程。54场景/33231断言、1096面板及15解析测试通过,独立远端恢复281文件、两目标Release链接通过,未正式安装。原版证据及独立产品规则见 `colorfinale-group-rendering-v21.md`、`group-compositing-contract.md`。
当前组仅开放既有0–8共9模式,普通层保持8模式旧算法。底层27模式有真实Core Image独立oracle,但两例Luminosity极低alpha差异、Add的扩展alpha链、叶层版本迁移和工作空间转换尚未全部接入,不能勾选“全部混合完成”。原版真实菜单是组23项、普通层22项;四个非分离颜色枚举未出现在该菜单,不将它们当作已证实菜单必需项。正式UI/键盘/VoiceOver/宿主重开/性能、CMS/ACES、胶片/色卡、Motion/Bokeh和其它矩阵细项仍开放。
### 完整混合模式开发与正式25验收(2026-10-26)
schema14/计划12已接入26种叶层、27种组模式及版本化预乘中间链,使用系统CI真实过滤器,不以旧近似数学冒充扩展alpha一致。叶层Add设alpha1、组Add保留扩展alpha;强度和蒙版各自处理,旧节点保留原算法。84完整场景和1160面板断言通过,极端数值安全及4K动态预算修复已验证,尚未正式安装。正式25仅是羽化/布局阶段:FCP冷重开文件逐字节一致,椭圆/旋转矩形实际外框拖动与撤销重做通过,生成副本已清理。完整迁移余项仍按矩阵保持开放。
@@ -0,0 +1,147 @@
# 后续颜色工具的独立实现设计
日期:2026-10-26(Asia/Shanghai)。这是下一阶段工程设计,不是已实现清单,也不表示与 Color Finale 逐像素等价。本文件只新增设计文档;没有修改颜色源码、宿主工程或界面。
审阅基线:`19b3d80039875d09b46f4418e6cfdddf0b0d036a`。审阅时 `Core/DYColorMath.h` 的 SHA-256 为 `4ce03351e3b93b94971e15f8b68d4448c98d8bd5308580595980ef399e5ad7aa`。功能来源和本机版本边界继续见 [迁移矩阵](colorfinale-2.0-matrix.md)。
## 1. 已有实现与需要保留的约束
当前 `DYGrade` 为 1032 字节,前 808 字节是旧参数 ABI;新增 224 字节为快捷 HSL、七个向量、RGB 曲线和通道矩阵。当前五点 `curve` 分别作用于 R/G/B,是 Master RGB 语义,不是真正的单独亮度曲线。RGB 曲线随后处理各通道。当前实际顺序是:
`曝光/白平衡 → lift/gain/midtone → 黑白点/对比/阴影高光/伽马 → Master RGB 曲线 → 各 RGB 曲线 → 饱和度 → 蜘蛛盘 → 快捷 HSL/向量 → 通道混合 → LUT → 局部处理/图层蒙版与混合`。
这条链已承载保存的用户画面。增加新工具时不得重新排列旧链、把现有曲线改解释为 Luma、把现有三色轮改解释为 CDL,或因图层的显示类型改变旧参数的意义。旧参数的默认旁路、alpha、CPU/Metal 共用数学和保存重开行为继续作为回归基线。
## 2. 参数、归档与渲染计划
建议冻结 `DYGrade` 的 1032 字节布局。可变节点和新增模式另存为 `DYAdvancedColorState`,以可安全归档的命名字段编码,挂在每个 `DYSettings` 的可选 `advancedColor` 键下;归档 schema 升为 5。不要把大数组、枚举或可变数量控制点继续追加进现有按整块 float 插值的区域。
| 项目 | 建议布局与默认值 |
| --- | --- |
| `DYAdvancedColorState` | `version=1`、`kind`、`enabled=false`,一个与 kind 匹配的工具状态;空值为严格恒等 |
| 工具身份 | `hsl_curves`、`log_wheels`、`camera_matrix`、`cdl`、`color_atlas`、`rgb_curves_v2`;复用外层稳定 layer ID |
| 曲线作者数据 | 每条曲线独立 ID、enabled、interpolation、domain、点列表;每点稳定 ID、x/y、左右切线或手柄;每条最多 32 点 |
| CPU/Metal 渲染头 | 显式 `uint32_t version, kind, flags, payloadIndex`;参数、曲线采样表与节点各自有长度校验;不要持久化平台指针、`BOOL` 或 `simd_float3` padding |
| 时间采样 | 固定标量仅在同工具版本间插值;曲线、节点数量、模式为离散快照,或仅在稳定点 ID 完全匹配时插值;禁止将枚举当 float 混合 |
| 颜色上下文 | 记录工作 RGB、传递函数/Log 编码、参考白、是否已经过输入变换;未知信息明确为 unknown,不能从画面观感猜测 |
新建高级工具层把原 `DYGrade` 留在恒等值,先走旧 grade,再执行该层高级算子,再接现有 LUT、局部处理、蒙版与层混合。已有层没有高级块,输出保持原样。高级工具排列由图层栈显式决定;不在后台把 Log 色轮、矩阵或 CDL 自动移动到别处。若同层保留旧参数和高级块,工具区需说明该内部顺序。RGB 曲线 v2 是独立新算子;旧 5 点曲线不被隐式搬移。
迁移要求:
1. 808 字节:先 `dyDefaultGrade()`,只拷贝 808 字节,再执行原迁移;新增颜色参数和高级块为恒等。1032 字节:完整保留原值,高级块为空。未知长度必须报错或明确保留原数据,不能按较短长度猜测结构。
2. schema 5 仍存 1032 字节 grade 和独立高级块。解码类表、深拷贝、相等比较、撤销、渲染快照、宿主证据读取、恢复工具同时更新。
3. 新读者遇到未知但启用的高级工具版本要拒绝静默丢弃。旧已发行程序不会因为新 writer 增加一个版本字段就自动学会拒绝;因此只承诺旧→新迁移,不承诺新文件可被旧程序正确打开。恢复说明标明最低版本。
4. 旧 808 与现有 1032 的真实归档、带 LUT/钢笔/轨迹的文档都建立画面对照。新格式保存再重开、随机时间、CPU 与 Metal 必须分别验证。
## 3. HSL 曲线
**官方证据。** 文档列出按色相调色相、饱和度、亮度,以及按亮度或饱和度调饱和度的五条曲线;支持独立旁路、取色加点及不同插值。正文中 Sat vs Luma 的横轴实际描述为亮度,大鱼应直接标成“亮度 → 饱和度”。公开页没有给出精确颜色转换、区间外推和样条系数。[官方 HSL Curves](https://docs.colorfinale.com/docs/layers/hsl/)
**建议参数。** `DYHSLCurvesState` 包含五个 `DYCurveState`、`extendedSaturation=false`、`mathVersion=1`。坐标和输出单位如下:
| 曲线 | x | y 与中性值 | 建议初始界限 |
| --- | --- | --- | --- |
| 色相 → 色相 | 周期 hue,0–1 turns | hue 位移,0 | ±0.5 turns |
| 色相 → 饱和度 | 周期 hue | 饱和度倍率,1 | 0–4 |
| 色相 → 亮度 | 周期 hue | 曝光位移 EV,0 | −4 至 +4 EV |
| 亮度 → 饱和度 | 层输入的归一化代码亮度 | 饱和度倍率,1 | 0–4 |
| 饱和度 → 饱和度 | 层输入的选定饱和度定义 | 饱和度倍率,1 | 0–4 |
上述 EV、倍率和界限是大鱼的独立选择,不是对 Color Finale 数值刻度的断言。工具名中的亮度不复用当前快捷 HSL 的 lightness 字段;两者的数学语义不同。
**建议评估。** 从该算子的同一输入一次性取 hue、saturation、亮度 Y。五条曲线全部以这些原始坐标取值,避免前一条曲线移动后一条的选择区域。色相位移后合成颜色,三个饱和度倍率相乘;在亮度为零的色差子空间缩放色差。最终目标亮度为 `Y × 2^EV(hue)`,通过下节的亮度恢复函数恢复。近中性像素用平滑色度权重抑制色相选择噪声;精确灰色只响应亮度型处理,不凭无定义 hue 生成染色。扩展模式保留额外色度,不在中间强制裁到 SDR;最终有限范围沿用现有渲染策略。
饱和度轴必须有固定定义并随 `mathVersion` 保存,建议第一版沿用当前 HSL 工具使用的归一化颜色基础;亮度轴明确采用当前工作空间的代码亮度。不要按每帧直方图自动拉伸坐标,否则随机跳帧和图库预览会改变结果。对超出 0–1 的亮度/饱和度选择坐标使用端点值,RGB 输出仍可超范围。
**曲线表示。** 提供线性、平滑逼近、平滑过点三种明确模式。平滑逼近可独立用三次 B 样条(de Boor),平滑过点可用受限 Hermite/Bezier。它们不是同一个算法的三个名称。x 必须严格递增,Bezier 手柄 x 不跨邻点;周期曲线使用首尾共享约束和虚拟邻点,保证接缝值与斜率连续。作者点原样保存,编辑后后台烘焙 4097 个 float 样本,CPU/Metal 共用相同表和插值。不能把采样表作为唯一可编辑文件。若误差门限未达到,再增加分辨率或改为分段系数。
**验收。** 连续色相环跨红色接缝;原始色相选择的顺序独立性;全部曲线旁路与中性值严格恒等;色相区间外不变;黑白端去饱和渐变平滑;B 样条不过点与过点模式确实不同;重排/删除点后无重复 x、NaN 或越界。查表与双精度直接求值对照,目标归一化误差 ≤2e−4,并以视觉渐变检查条带。CPU/Metal 允许最后量化误差不超过 1 个 8-bit 色阶,alpha 必须逐位保留。
## 4. RGB 曲线模式
**官方证据。** Master + RGB 对各 RGB 值共同套主曲线;Luma + RGB 的主曲线针对亮度;Luma Preserving 在调整 RGB 曲线时保持亮度。还支持取色建点及 S 曲线快捷操作。公开说明没有给出保持亮度的确切公式或 HDR 边界处理。[官方 Curves](https://docs.colorfinale.com/docs/layers/curves/)
**建议参数。** `DYRGBCurvesState { version, enabled, mode, master, red, green, blue }`。mode 为 `masterRGB / lumaRGB / lumaPreserving`。每条最多 32 点;默认 `(0,0),(1,1)`。所有通道拥有各自旁路状态;原 `curve[5]` 与 `rgbCurve[3][5]` 保留原模式和旧插值。
令 `Y(c)=dot(w,c)`,w 为当前工作空间亮度权重。定义独立辅助函数 `setLuma(c,target)`:当原 Y 大于正 epsilon 且 target 非负时按 `target/Y` 等比缩放 RGB;其余情况采用 `c + (target−Y)·1`,避免黑色、负值和除零引起色相翻转。此回退边界应连续化并版本固定;它是工程选择,不是原产品公式。
| 模式 | 明确处理顺序 |
| --- | --- |
| Master RGB | `m_k=Master(c_k)`,再 `out_k=RGB_k(m_k)` |
| Luma RGB | `target=Master(Y(c))`,`m=setLuma(c,target)`,再逐通道 RGB 曲线 |
| Luma Preserving | 同上得到 RGB 曲线结果 q,最后 `out=setLuma(q,target)` |
对黑/负亮度的 `setLuma` 建议最终实现采用有界平滑过渡,而不是在 epsilon 处硬切。要先确定此过渡再固定 mathVersion。曲线的区间外推第一版可采用端点斜率且限制极端斜率;旧五点曲线继续原端点偏移外推。取色只在当前冻结源帧和该层输入上建点,不能从已经过该层输出的屏幕颜色反复反馈。
**验收。** 同一 S 曲线在 Master RGB 与 Luma 模式具有可解释差异;Luma Preserving 改红曲线后 `dot(w,out)` 保持目标亮度;灰阶、接近黑色、负通道、HDR、同 x 重复点、极陡曲线都保持有限输出;旧归档仍调用旧五点路径。S 曲线快捷操作只建立普通可编辑点,没有额外隐形对比度参数。
## 5. Log 色轮
**官方证据。** 原工具有阴影、中间调、高光及 Offset,带亮度控制和范围分界;推荐位于 Log 转视频空间的层之前,并保持传入 Log 状态。文档没有公布具体区域权重或相机编码公式。[官方 Log Wheels](https://docs.colorfinale.com/docs/layers/log-wheels/)
**建议参数。** `DYLogWheelsState`:四组 `chroma[3]` 和 `brightness`,全部默认 0;`shadowEnd`、`shadowSoftness`、`highlightStart`、`highlightSoftness`;`domain=encodedLog`;独立 mathVersion。参数单位是输入 Log 的代码值偏移,不标作 EV。初始范围可取阴影过渡 `[0.20,0.40]`、高光过渡 `[0.60,0.80]`,但这些只是产品初始值,不代表任何相机标准。
在层输入的代码亮度 Y 上构造 `ws=1−smoothstep(s0,s1,Y)`、`wh=smoothstep(h0,h1,Y)`、`wm=1−ws−wh`,要求 `s0<s1≤h0<h1`。边界编辑自动保持最小间隔,令权重非负且总和 1。每个色轮的色差向量减去其加权亮度分量;最终:
`out = input + offsetChroma + offsetBrightness·1 + Σ weight_region × (regionChroma + regionBrightness·1)`。
四个色轮的二维位置与 RGB 数值是同一参数的两种编辑方式,不能保存两套可能不同步的真值。输入范围外仍使用端区权重,但不裁剪 RGB。中性参数直接返回输入。
当前宿主请求的是 gamma-video 图像;如果宿主或上游相机 LUT 已把素材转换成视频空间,新增一个叫 Log 的色轮不能恢复原始 Log。应把“输入保持 Log”的上下文条件接入色彩管理和层顺序,支持用户明确指定已有输入编码,不自动检测或偷偷反转换。先完成该前提,才报告 Log 工作流可用。可验证的初版是对明确声明的 Log 代码值做上述算子,不声称具备相机自动识别。
**验收。** 灰阶 ramp 显示三个区间的局部响应;分界处无阶跃;Offset 对全范围一致;保持 Log 输入、先色轮后 Log→709 LUT 与反向顺序确实不同且可撤销;导出随机帧不依赖播放顺序。用真实指定 Log 素材对照前,不以 SDR 画面“看起来正常”代替验收。
## 6. 相机矩阵
**官方证据。** 文档说明可独立调整 R/G/B 基色的 hue/saturation,并保持整体白平衡。它没有给出矩阵构建方式,也没有说明等于某家相机的 IDT 或校准矩阵。[官方 Camera Matrix](https://docs.colorfinale.com/docs/layers/camera-matrix/)
**建议参数。** `DYCameraMatrixState { enabled, hueTurns[3]={0}, saturation[3]={1}, preserveNeutral=true, mathVersion=1 }`。建议 hue 初始可编辑范围 ±1/6 turns,saturation 0–2;这些与当前九系数 `channelMixer` 是独立工具。保存控件值,在构建渲染计划时生成 3×3 矩阵,不在每个像素重新计算三角函数。
一个可验证的独立构造:令 `1=(1,1,1)^T`、`w^T·1=1`,e_i 是 R/G/B 基向量。先将每个基色分成 `w_i·1` 与零亮度色差 `q_i=e_i−w_i·1`。在与 w 正交的平面中旋转 q_i,再乘对应饱和度,得到候选列 `A_i=w_i·1+s_i·Rotate(q_i,2πh_i)`。旋转可用绕单位 w 轴的 Rodrigues 公式。最后施加投影:
`M = A + (1−A·1)·w^T`。
这个构造满足 `M·1=1`,因此所有中性灰保持;也满足 `w^T·M=w^T`,保持所选代码亮度。默认 A 和 M 均为单位阵。白平衡保持需要对其他基色作补偿,所以“独立控件”不表示其他 RGB 数值永远不变。矩阵可输出负值,不在算子内部硬裁色域;该边界由后续显示/输出处理承担。
此公式是大鱼设计推导,未从 Color Finale 反编译所得。矩阵的工作域、亮度权重及是否保持亮度须版本固定;后续接入不同 RGB 工作空间时,不能继续无条件使用 Rec.709 系数。
**验收。** 对随机允许参数验证 `M·1=1` 和 `w^T·M=w^T`;灰阶 −2…16 保持;单个主色控件变化方向稳定;默认严格恒等;CPU/Metal 矩阵排列一致;处理负输入和高亮不产生 NaN。不能把这些数学通过项说成相机色彩科学已校准。
## 7. CDL 交换
**官方证据。** Color Finale 色轮提供单个片段/色轮的 CDL 导入导出,交换 slope、offset、power、saturation。公开页没有承诺把整条时间线或任意工具堆栈压成一个 CDL。[官方 Color Wheels](https://docs.colorfinale.com/docs/layers/wheels/)
采用明确的独立 `DYCDLState { slope[3]={1}, offset[3]={0}, power[3]={1}, saturation=1, style, id, description }`。标准前向与不裁剪前向是不同 style;不能依据数值是否中性擅自改变 style。[ACES CLF 的 ASC_CDL 定义](https://docs.acescentral.com/clf/specification/#asc_cdl) 和 [OpenColorIO CDLTransform](https://opencolorio.readthedocs.io/en/stable/api/transforms.html#cdltransform) 可作为实现/对照依据。
标准前向按通道 `q=clamp(input×slope+offset,0,1)^power`,再以 Rec.709 权重得到 Y,输出 `clamp(Y+saturation×(q−Y),0,1)`。NoClamp 省略两处 clamp,且对 SOP 的负中间值跳过 power。slope≥0、power>0、saturation≥0,输入必须为有限数。标准 clamp 模式即使数值默认也会裁超范围值,因此不能把它优化成对 HDR 的无条件恒等;NoClamp 的默认值才可直接旁路。
第一版导入 `.cc`,以及从 `.ccc` 中选择一个明确 ID;若支持 `.cdl` 则解析其中的条目结构,不能仅按扩展名选择第一个 XML 节点。保存 ID/描述与十个数值,使用足够有效位数输出。禁用外部 XML 实体/网络解析,拒绝重复必须字段、非有限值和非法数量。参数读入不写入原文件。NoClamp style 若目标文件格式无法表达,导出界面明确其互操作限制,不用注释伪装标准字段。
当前三色轮并非直接的 CDL 数据。在其他工具全中性、没有不兼容范围饱和度、LUT、混合或蒙版时,单通道的代数近似可整理为:`slope=(1−lift)×(1+gain)`,`offset=lift×(1+gain)`,`power=1/(1+midtone)`。这只是当前公式的特定条件转换,仍须数值验证并检查非负 slope 等合法性。默认优先新增真正 CDL 工具层,精确保存交换参数。不能把任意调色结果压成十个数并声称无损。
**验收。** 用公开 CDL/CLF 的固定数值案例和独立 OCIO CPU 参考比较;SDR、负值、>1 输入、power=1、零 slope、零饱和度、非法 power 分别覆盖;导入→导出→再导入十个参数稳定;Unicode 描述和多 ID 选择正确;没有颜色管理上下文时不声称跨应用显示外观必然一致。旧三色轮转换另设输出误差检查,不与直接 CDL 往返混为一项。
## 8. Color Atlas 色调渐变映射
**官方证据。** 原工具最多 11 个 HSLA 渐变点,按 Rec.709 亮度、单个 R/G/B 通道或 CIE L* 选取渐变;包含结果、亮度图、渐变输出及取色/本地预设。公开页没有给出渐变插值色彩空间。[官方 Color Atlas](https://docs.colorfinale.com/docs/layers/color-atlas/)
**建议参数。** `DYColorAtlasState` 包含 `points[2…11]`、`tonalSource`、`outputMode`、`interpolation=RGBPremultiplied` 和 mathVersion。每点存稳定 ID、position、hueTurns、saturation、lightness、alpha。position 单调,端点固定 0/1,重复位置明确拒绝或作为同一次编辑替换;不让排序随机决定结果。默认两点 alpha=0,使新层恒等,这是大鱼的产品选择。
**建议评估。** 先从该层输入计算 tonal coordinate,范围外夹到端点。HSLA 只作为点颜色的编辑表示;第一版在当前明确工作 RGB 中对预乘色和 alpha 线性插值:`P=lerp(a0·RGB0,a1·RGB1,t)`、`A=lerp(a0,a1,t)`,结果为 `input×(1−A)+P`。这样完全透明的点不会污染相邻颜色。点 alpha 控制颜色覆盖量,仍保留素材的 alpha;之后还要乘图层蒙版/混合量,不能重复把素材 alpha 当点 alpha。原版是否采用同一插值仍未知。
Rec.709 代码亮度与 CIE L* 不可共用一个未经转换的 dot。L* 要先按已知传递函数得到线性 RGB,转到 XYZ 的相对 Y/Y_n,再按 CIE 分段立方根计算并除以 100。参考白与传递函数未知时,该模式应显示需要明确颜色空间,不能把 gamma RGB 直接代入公式。[W3C 颜色转换参考](https://www.w3.org/TR/css-color-4/#color-conversion-code)
`Result` 是正常映射;`Tonal Map` 输出所选坐标的灰阶;`Gradient` 按画面水平 x 展示渐变。这三个若作为输出模式保存,必须在宿主输出中一致生效。Gradient 依赖空间坐标,不可作为纯 RGB 变换烘焙进 3D LUT;工具区只看渐变的辅助视图则另设编辑状态,不改正式输出模式。5×5 取样应来自冻结的该层输入帧,记录所选色值后才提交一次撤销。
预设保存点、模式和版本,不保存路径依赖或偷用原版预设。预设缩略图的颜色上下文和当前图像结果分别标明。重命名/删除只针对用户当前选择的本产品预设。
**验收。** 单点插入、删除、重排、复制后的 ID;0/1 alpha、透明饱和色邻点的无色边;纯灰 ramp 的映射;R/G/B 不同输入源的差异;L*=0/100 与标准灰值;11 点上限;预设重开;三个输出模式、图层蒙版和素材 alpha 正确组合。
## 9. 实施顺序与完成门槛
建议先做高级工具归档/渲染快照,再做 CDL 与相机矩阵两个易获得确定参考的算子;随后 RGB 曲线 v2、HSL 曲线、Color Atlas;Log 色轮在输入域和转换顺序清晰后接入。工具在完整图层栈中的顺序由用户决定,以上仅是开发顺序。
每个算子至少有三类证据:数学性质或独立参考、CPU/Metal 数值一致、正式宿主实际画面与保存撤销。最小跨工具案例为:Log 色轮 → 输入转换 LUT → 相机矩阵 → RGB 曲线 → HSL 曲线 → Color Atlas;分别改变顺序、混合量、图层蒙版和 alpha,验证预览与最终结果共享同一快照。
必须保留的旧格式回归是:schema1/2/3 的 808 字节状态,以及 schema4 的 1032 字节状态,在新高级块为空时完全沿用旧数学。仅增加按钮、序列化字段或静态测试不能计为对应工具已完成。官方未公开的数学只可报告为独立实现;本机 Color Finale 2.16.2 的实际界面、刻度和输出仍需另行对照,不能由本设计补写成已经观察到的事实。
+96
查看文件
@@ -0,0 +1,96 @@
# ColorFinale 2.16.2 (625) 分析
分析日期:2026-10-25。目标是以可重复行为和算法结构为依据独立实现新插件;原程序保持只读。本报告只保存事实、接口与推断,不包含其二进制、预设/LUT/图标、可复用的反编译源码。
## 已核实身份与结构
- 外层 APP:`/Applications/ColorFinale.app`,Bundle ID `com.colorfinale.app`。
- FxPlug:`Contents/PlugIns/ColorFinale.pluginkit`,ID `com.colorfinale.ColorFinaleFxPlug`。
- 主插件可执行文件 SHA-256:`49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f`。
- Ghidra 12.1.4 对 arm64 片进行完整默认静态分析;这是静态观察,不代表在 FCP 中实际运行。
- 主插件管理 AppKit 自定义窗口、LUT 画廊、图层和跟踪;链接自带 `RenderingEngine`、`GradeKit`、`StepsKit`、`ColorFinaleUtils` 与 OpenCV。OpenCV 为产品自带依赖,不能把该二进制复制成新产品依赖。
## 局部跟踪:已观察到的算法链
核心函数:`FTAreaTracker::track:trackerState:`,地址 `0x100035e40`,Evidence `ev_dcd7aa770925f63c8c14c968ae6b417fda78685c7be7fa739a78209957d40e2d`。
1. 从形状点集的 convex hull 建立 8-bit 特征选取遮罩(fillPoly),特征限定在被跟踪形状区域。
2. `goodFeaturesToTrack`:最多 300 点,qualityLevel 0.03,minDistance 10,blockSize 3,不使用 Harris,k 0.04。
3. `cornerSubPix` 精炼:10×10 半窗,20 次/0.03 终止条件。
4. 对相邻灰度帧做前向和反向 `calcOpticalFlowPyrLK`:21×21 窗口,maxLevel=3,30 次/0.01 终止条件,minEigThreshold=0.0001。
5. 保留光流成功且前后向误差严格小于 1 像素的点。有效点少于 4 则返回失败,不继续制造位置。
6. 观察到另一组基于 `max(width,height) × 0.01` 位移阈值的点筛选;当大位移点超过有效点一半时偏向该组。其产品意图尚未运行证实,可能用于优先运动主体。
7. `estimateAffine2D`,method=8(OpenCV RANSAC 常量),reprojection threshold=3,maxIters=2000,confidence=0.99,refineIters=10。空矩阵失败。
8. 分解得到平移、旋转和 X/Y 缩放,围绕当前形状中心更新点集和状态。虽然拟合 full affine,持久化形状输出为位置/旋转/双轴缩放,未观察到透视单应矩阵输出。
9. 条件分支显示会周期性重新选取特征;精确刷新策略需运行比对后再定,不把它当作已验收功能。
逐帧入口:`FTAreaTracker::trackFrame:inScene:`,`0x100036cbc`,Evidence `ev_9131db4f8dcde696cbeb6659e1da62aa76fbdbd4329f22ab8695d32b57890b68`。
- 必须收到完整一帧后才分析。输入转 IOSurface,maxSize 为 3840×2160,再转灰度 OpenCV Mat。
- 每个跟踪节点单独保存状态;无有效节点则结束。
- 每帧把结果写入节点的 `position`、`rotation`、`scale` 动画属性;位置除以分析图像宽高归一化,时间使用 effectTime。
- 说明正确实现需要持久化按时间的轨迹,不能仅在实时渲染回调保留上一帧状态,否则非顺序渲染/导出会出错。
分析对接:`FTAreaTrackerAnalyzer::effectAnalysis:analyzeFrame:session:error:`,`0x10005b47c`,Evidence `ev_1dd68409d431d9e81875b6032a81dd89f7f237ea5501d3db1d7ca92ba32e6323`。
- 适配宿主 effectAnalysis 回调,按 session 色彩空间和 effectTime 建立 frame tile;先收集 tiles,再在完整帧上调用 tracker。
- 有取消、越过片段范围、无效图像、分析结束状态;不能把失败继续当跟踪成功。
交互模式:`FTAreaTrackerController::setTrackerModeForSession:from:to:`,Evidence `ev_a455d8cd5a459e3f95e5a5c7ca4d8837481d31266ae1ee51901bc7091a3e8fac` 根据起止时间和一帧时长区分前向/后向连续跟踪及单帧步进。`FTShapeTrackerControl::trackForwardFrame:`,Evidence `ev_a3edfabaaaeb8ab7545ded0b4d392e65e39062180c60d2262363a35d9a88e803` 显示有选中形状才跟踪;自动跟踪进行时阻止再次启动。
## LUT 批量预览:已观察到的渲染与缓存
`FTLUTGalleryItem::processFrameTile:context:`,`0x1000d0b28`,Evidence `ev_f502284708e116a00f22144b4489ab51665c389f92f577e33801100da6b62af5`:
- 每个 gallery item 通过 LUT 标识从 CubeManager 请求 `previewMode` 数据。
- 建立独立 CubeFx,使用 item 的预览工作色彩空间,渲染到输入 frame tile。
- 画廊与实际 LUT 强度控件应共用解析和渲染链,避免预览与最终效果不同。
`FTAssetGalleryImageCache::renderPreviewImageForAsset:`,`0x1000f9c0c`,Evidence `ev_fe5a0a660188eb8f7be89bbc46b3e496be9b38f84643ef283339ad20c8090d5f`:
1. 获取并缓存 sourceFrame。
2. 获取当前项目 scene/adjustments。
3. 先应用工程已有调整。
4. 再应用每个待预览 LUT/asset。
5. 转输出色彩空间、处理方向,再建立 NSImage。
6. source 或渲染无效返回失败,不以空白图冒充已生成结果。
`FTAssetGalleryImageCache::fetchSourceFrame`,`0x1000f9fdc`,Evidence `ev_7c9c47eb6708f3d7003cffc1c1de8b01aeb083c59961d67d52b77dc4eac7da16`:支持 live 当前片段帧,以及用户指定默认图片。静态图片明确使用 sRGB。live 模式通过宿主 action session 请求片段帧。
`FTAssetGalleryImageCache::init`,Evidence `ev_8ffc0ac45b90bfb4aee21319d4e4627b726416957325c92b4c77be938c745e82`:NSCache 的 totalCostLimit=0x20000000(512 MiB);另有 `FTPriorityOperationQueue`,非 LIFO,QoS 0x19。`generateImageForAsset:`,Evidence `ev_65fcaf5901400eb9a82486bd4fc18775a32e404f7731b943c6ee3ffd997b1d69` 将工作封装 NSBlockOperation 投入队列。`cacheKeyForAsset:` 使用 live 状态和 asset renderKey(Exact key format 未恢复)。
LUT 元数据/图库搜索 Evidence `ev_52ed9e7aff017b889468b9b0f901f73a44e6fa7a5de8a45825ed5f913b6c7689`;图库方法显示最近使用、按组/文件夹、搜索过滤、选择预览色彩空间、注册文件夹、检测失效路径及重新链接。当前版本具体支持的 LUT 文件格式、插值方法和 domain 边界尚未进入 RenderingEngine/GradeKit 定点分析,不能据名称宣称支持。
## 自定义 UI:结构证据与独立设计
- AppKit 的 FTColorCorrectionWindowController 及 FTRemoteColorCorrectionWindowController 提供独立自定义窗口;后者背景使用 white≈0.122、alpha=1。Evidence `ev_590a46e741638ab2be5dd0da9f0c739a3d82f87e8a181d0546d64731adc081de`。
- FTColorCorrectionViewController 持有图层控制器、当前工具 viewHost,可切 Curves、Telecine/Color Wheels、Six Vectors、Cube、HSL Curves、Mask、Filter、Camera Matrix、Log Wheels;有添加层/组、LUT层、undo/redo、mask选择等入口。Evidence `ev_1631c9fca7d9780ee93449341856f7816ff1a31a2051e1dac93bbed07291bc84`。这是结构观察,未做屏幕布局验收。
- 局部形状控制器有 opacity、feather、position、scale、rotation 控件;ShapeTrackerTimeline 支持按时间选择、关键帧和区域绘制、单帧/连续跟踪。Evidence `ev_511921a9b7511facedd4f9ddf5e6cee2680de4c55dbf726a0d4f2a3b05d1cd14` 和 `ev_3cdbe7c6cd89c47105df02ef6c0019377646eca014c758b21a988d70b9164b8b`。
建议新 UI 保留暗色浮动窗口、工具切换、清晰图层栈和图像直接编辑:左侧图层/局部区域,中间画面与可拖拽形状,右侧调色/蜘蛛盘/LUT画廊/跟踪页;底部当前时间、关键帧、前后跟踪与取消。颜色、图标、布局和文案重新设计,不复制原产品资源。是否采用左右三栏属于新产品设计选择,不是 ColorFinale 运行观测。
## 对新工程的实现建议与验收边界
- 采用自行构建的官方 OpenCV 或独立实现特征+LK+RANSAC;不链接 ColorFinale 内置 framework。跟踪算子与 FxPlug/UI 分层,先用给定航拍跑完整轨迹,再把相同轨迹作为宿主分析结果保存。
- 持久化每个局部节点的初始区域、时间/矩阵/置信度/失效状态。渲染只按当前时间采样已烘焙轨迹。支持前后向重算、取消、失效手动校正和再次继续。
- 最小局部形状先做旋转椭圆、矩形/圆角矩形与多边形,含羽化/反相/透明度;不要把“整个画面自动平移”宣称为局部跟踪。
- LUT 初版用公开 .cube 规范独立解析;DOMAINS、1D/3D、强度、越界政策写清楚并做数值测试。预览以当前帧为共同输入,缓存需包含帧ID/调整快照/色彩空间/LUT内容摘要和尺寸,滚动时取消过时任务。
- 航拍验收至少选清晰静态建筑和一处边界区域,覆盖运动、旋转/缩放、遮挡或低纹理;输出叠加跟踪轮廓的连续片段并检查尾帧漂移。只在几帧上画标记不能证明整段跟踪成功。
- 仍未完成:ColorFinale 实际运行 UI 对照、LUT 插值内核、遮罩合成数学、在给定 DJI 素材上的原产品基准轨迹。新插件的行为验收不应冒充与原算法逐像素等价。
## 本地完整证据
完整 REA Evidence bundle 与 snapshot 含反编译中间产物,仅保存在本机研究缓存,不进入源码仓库:
- `/Users/mac/Library/Caches/CodexBuilds/ColorResearch/colorfinale-rea-evidence-20261025.json`(22 records)
- `/Users/mac/Library/Caches/CodexBuilds/ColorResearch/colorfinale-rea-snapshot-20261025.json`
本报告中的观测可依上述 SHA、函数地址和证据 ID 重做。REA 会话已关闭。
## 宿主接入的补充定点证据
文件选择入口取得 self.view.window 并调用 beginSheetModalForWindow。新面板采用宿主附属面板,修复独立 begin 调用在远程窗口中的焦点问题。
RenderTrigger 参数 201 为 NSUUID 自定义参数,标志 0x3(HIDDEN、NOT_ANIMATABLE),没有 DONT_SAVE;通知参数 200 的 0x13 另含 DONT_SAVE。201 位于顶层通知参数之后,原生模板并不显式保存它。捕获对象按插件实例持有期望时间及会话令牌,渲染时从源图像取帧并回主线程交给面板。
依据是只读创建函数与帧捕获调用链。本机追加记录为 ColorResearch/colorfinale-rendertrigger-facts.json、colorfinale-file-dialog-evidence-20261026.json、colorfinale-frame-capture-evidence-20261026.json;文件名后缀沿用采集名称。新插件独立实现隐藏 NSUUID 刷新通知与实例内会话标记,最终 FCP 首次打开、当前帧刷新和重开已实际通过。
@@ -0,0 +1,422 @@
{
"date": "2026-10-25",
"scope": "ColorFinale 2.16.2(625) static arm64 analysis",
"full_evidence_local_only": "/Users/mac/Library/Caches/CodexBuilds/ColorResearch/colorfinale-rea-evidence-20261025.json",
"limitations": [
"Static observation does not establish runtime behavior or exact source equivalence.",
"This compact index intentionally omits proprietary disassembly and decompiler pseudocode."
],
"records": [
{
"key": "0x100035e40",
"evidence_id": "ev_dcd7aa770925f63c8c14c968ae6b417fda78685c7be7fa739a78209957d40e2d",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100035e40"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x100036cbc",
"evidence_id": "ev_9131db4f8dcde696cbeb6659e1da62aa76fbdbd4329f22ab8695d32b57890b68",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100036cbc"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x100037334",
"evidence_id": "ev_25164340a58fb486f874b3a4d0396413aeb35dd07b78c80303d750ee2a795eed",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100037334"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x10005b47c",
"evidence_id": "ev_1dd68409d431d9e81875b6032a81dd89f7f237ea5501d3db1d7ca92ba32e6323",
"operation": "analyze_function",
"parameters": {
"procedure": "0x10005b47c"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000d0b28",
"evidence_id": "ev_f502284708e116a00f22144b4489ab51665c389f92f577e33801100da6b62af5",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000d0b28"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9800",
"evidence_id": "ev_65678a6c0f431360264b375b867ee99dd57c3baf21c77a3a4d3343e2eb604277",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9800"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9c0c",
"evidence_id": "ev_fe5a0a660188eb8f7be89bbc46b3e496be9b38f84643ef283339ad20c8090d5f",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9c0c"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9fdc",
"evidence_id": "ev_7c9c47eb6708f3d7003cffc1c1de8b01aeb083c59961d67d52b77dc4eac7da16",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9fdc"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9938",
"evidence_id": "ev_65fcaf5901400eb9a82486bd4fc18775a32e404f7731b943c6ee3ffd997b1d69",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9938"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000f9390",
"evidence_id": "ev_8ffc0ac45b90bfb4aee21319d4e4627b726416957325c92b4c77be938c745e82",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000f9390"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x100059c40",
"evidence_id": "ev_a455d8cd5a459e3f95e5a5c7ca4d8837481d31266ae1ee51901bc7091a3e8fac",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100059c40"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x100022194",
"evidence_id": "ev_a3edfabaaaeb8ab7545ded0b4d392e65e39062180c60d2262363a35d9a88e803",
"operation": "analyze_function",
"parameters": {
"procedure": "0x100022194"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x10012bd10",
"evidence_id": "ev_6b1b786733d22da9b5a67b16b8d2bcea1432d1352e0f86bccf01894b36e973a9",
"operation": "analyze_function",
"parameters": {
"procedure": "0x10012bd10"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x1000a36d8",
"evidence_id": "ev_d50e89c3f20e92c5211af1eb1946a5515da3cd4b2fd37c35a10545d8bd2e544b",
"operation": "analyze_function",
"parameters": {
"procedure": "0x1000a36d8"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "0x10010aa0c",
"evidence_id": "ev_590a46e741638ab2be5dd0da9f0c739a3d82f87e8a181d0546d64731adc081de",
"operation": "analyze_function",
"parameters": {
"procedure": "0x10010aa0c"
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "cflut",
"evidence_id": "ev_52ed9e7aff017b889468b9b0f901f73a44e6fa7a5de8a45825ed5f913b6c7689",
"operation": "search_procedures",
"parameters": {
"pattern": "FTAssetGalleryImageCache|FTLUTGallery|FTLUTManager|FTLUTList",
"mode": "regex",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "cfui",
"evidence_id": "ev_3cdbe7c6cd89c47105df02ef6c0019377646eca014c758b21a988d70b9164b8b",
"operation": "search_procedures",
"parameters": {
"pattern": "FTColorCorrectionPanel|FTShapeTracker|FTAssetGalleryViewController::viewDidLoad|FTAssetGalleryImageCache::init",
"mode": "regex",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "ui",
"evidence_id": "ev_ae6bbce355d8eae5aae27866d61d5a1628370d7c6694701517f459f6c0e37910",
"operation": "search_procedures",
"parameters": {
"pattern": "FT.*(Panel|WindowController|Inspector).*::(viewDidLoad|windowDidLoad|init|show|make|load)",
"mode": "regex",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "trackmode",
"evidence_id": "ev_b6979fd3eed28bfc381f93bedb578647444c2b213a44a3d2fbf1ac51b0a355ff",
"operation": "search_procedures",
"parameters": {
"pattern": "setTrackerModeForSession",
"mode": "literal",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "cfccvc",
"evidence_id": "ev_1631c9fca7d9780ee93449341856f7816ff1a31a2051e1dac93bbed07291bc84",
"operation": "search_procedures",
"parameters": {
"pattern": "FTColorCorrectionViewController",
"mode": "literal",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
},
{
"key": "cflayermask",
"evidence_id": "ev_511921a9b7511facedd4f9ddf5e6cee2680de4c55dbf726a0d4f2a3b05d1cd14",
"operation": "search_procedures",
"parameters": {
"pattern": "FTLayersViewModel|FTMaskShapeViewController",
"mode": "regex",
"case_sensitive": false
},
"subject": {
"name": "ColorFinale",
"digest": {
"sha256": "49121a6f5487060d322a59e7658166ab772e8a56f7dc1bcfa9d433a89436b30f"
},
"local_path": "/Applications/ColorFinale.app/Contents/PlugIns/ColorFinale.pluginkit/Contents/MacOS/ColorFinale",
"format": "mach-o-universal",
"architecture": "arm64"
},
"confidence": "observed",
"authority": "shipped-artifact"
}
]
}