Document target CMS evidence, reversible transport limits and a versioned upgrade plan

这个提交包含在:
mac 于 2026-11-03 11:49:02 +08:00 提交
1 父节点 a1e49e2eb5
当前提交 5b8ef04f7e
3 个文件已更改
+1658

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

+2
查看文件
@@ -2,6 +2,8 @@
原生 FxPlug 4 调色器,当前正式安装的公测版本 **1.7.4(52)**。唯一安装位置为 `/Library/Plug-Ins/FxPlug/大鱼调色.app`;Final Cut Pro 中从“效果 → 大鱼调色”添加。
2026-11-03完成BASIS、Colour Space Transform和Color Finale的只读色彩管理调查,含原版GPU曝光/映射及当前一级颜色内核的有限检查。宿主边界、重复映射、工具工作域和旧工程迁移的改进方案见[研究报告与实施方案](research/cms-audit-20261103/report.md)。本轮仅增加研究资料和探针,正式产品仍为1.7.4(52)。
交接与恢复入口:[大鱼调色FxPlug4交接.md](大鱼调色FxPlug4交接.md)。
1.7.4 在每个模块和新增图层标题增加减号,删除时还原参数、清除关键帧及所属LUT/蒙版,再从界面隐藏。顶部“添加模块”创建初始参数的新层;一次撤销恢复原设置。436项正式原生检查和FCP删除、撤销、重做、重新添加、独立层删除、冷重开通过。见[删除实现](research/ToolDeletion1.7.4.md)及[宿主记录](verification/HostToolDeletion1.7.4.json)。
文件差异过大,未显示。 加载差异
+156
查看文件
@@ -0,0 +1,156 @@
# 三个目标插件的色彩管理分析与大鱼调色改进方案
日期:2026年11月3日,Asia/Shanghai。大鱼调色源码基线 `d0b4e9d2ba1cd27b8677cfb723f540deb9027cbe`,正式安装版1.7.4(52);本次仅增加研究、探针和方案记录,没有修改产品渲染、模板或安装。
建议保留现有算法作为有版本的兼容管线,建立独立的新版根级色彩管理:明确宿主实际空间与用户声明输入、让各调色工具在适合的空间工作、统一印片与输出顺序,并限制每条场景输入链的显示渲染次数。优先修复新增一级层的默认映射行为,再接入已有的公开OCIO与ICC基础设施。
需要修正上一轮评估的措辞:固定sRGB编解码桥本身可以构成可逆的码值载体,不能单凭该公式推断全部FCP画面有错。风险在于载体是否匹配宿主交付的实际数值、上游是否已经进行相机或显示变换,以及返回像素是否符合宿主契约。还需区分“跟随宿主”与“场景参考”:宿主已管理的像素可能已经过显示渲染,转换为宽色域不能恢复已丢失的场景信息。
**1.目标身份与调查边界**
| 目标 | 安装版本 | 核心职责 | 本轮证据 |
| --- | --- | --- | --- |
| BASIS.app | 1.0(8) | 在指定编码下进行一级调色 | 当前arm64反编译、同SHA既有AIR研究、原版GPU曝光探针 |
| Colour Space Transform.app | 2.0(8) | 输入/输出曲线与色域变换,附显示映射 | 匹配快照与当前发行字节复核、原版GPU正反映射探针 |
| ColorFinale.app | 2.16.2(625) | 根CMS、工具工作域、LUT、胶片与输出管理 | 同SHA既有CMS证据、新补宿主入口/CIContext/回写静态调用链、官方文档 |
完整文件与arm64切片摘要见 [target-identities.json](target-identities.json)。研究只读用户明确指定的安装目标;派生切片和完整反编译证据留在本机缓存,未将原版二进制、私有着色器或LUT资源加入仓库。静态调用证据、历史运行证据和本轮GPU探针分开记录;没有把静态可达性写成实机执行。
**2.BASIS的色彩逻辑**
BASIS向宿主请求 `DesiredProcessingColorInfo=2`,本机FxPlug SDK对应 `RGB_GAMMA_VIDEO`,说明为视频Gamma 2.2。它不是独立识别摄像机或负责最终显示输出的完整CMS;其“Color Space”主要决定怎样解释送入的编码值。菜单有22个模式,其中KOLOR Default与DaVinci Intermediate是不同模式。
已恢复并与原版有限样本对照的运算顺序是:所选曲线解码 → 线性曝光乘法与RGB色彩平衡 → 编码与饱和度处理 → 影调、对比、趾部/肩部等曲线 → 色度混合 → 输出。它针对不同操作切换运算域,支持“曝光按档位乘以2”的合理模型。色彩平衡色轮是一种RGB增益调整,不能仅因名称相似就当作带明确照明体、白点与色适应定义的摄影白平衡。
本轮直接调用正式原版着色器,在DaVinci Intermediate模式、曝光+1EV且旁路其他影调/对比操作的五个中性灰样本上,与Blackmagic公开公式的差异最大为1个half ULP。说明这组曝光行为有数值基础;不能外推为所有模式、颜色和参数的独立标准认证。原版着色器会经过half精度边界,使用32位输出纹理不等于内核全程32位。
证据:`ev_50cd56935bf6cf1f094ab18a87ec4fb4232745b438b362bd1ee5c377151ae152`(属性);`ev_e641b255869e8e1115bb281a6efb7b332cc2bc43edbaef769d1465c062de2292`(常量2);`ev_02df5b28e8027cb62692d5192ef9cfad1210fe271f8cb36131b2a98423c9b016`(UI到GPU参数);本轮 [gpu-observations.json](gpu-observations.json)。公式依据:[Blackmagic DWG与DI规范](https://documents.blackmagicdesign.com/InformationNotes/DaVinci_Resolve_17_Wide_Gamut_Intermediate.pdf)。
**3.Colour Space Transform的色彩逻辑**
CST也请求视频Gamma编码RGB(数值2)。CPU冻结输入色域、输入曲线、输出色域、输出曲线和映射标志,GPU完成解码、色域矩阵/相关分支、可选显示映射、再编码。曲线和色域独立选择;它是明确指定输入的转换工具,当前检查路径没有摄像机自动识别步骤。
原版按曲线ID分类:大于1000的Gamma 2.2/2.4/2.6视为显示曲线,其他曲线视为场景侧。自动标志由“输入是否显示、输出是否显示”组成。场景→显示会调用自定义DRT;显示→场景会调用另一个逆向形状函数。这套规则体现作者的渲染选择,不等同于Academy ACES输出,也不代表任意正反组合可逆。
本轮原版GPU实测,线性Rec.709经其DRT转Gamma2.4,再使用其显示→场景映射返回线性Rec.709:
| 初始线性灰 | 显示编码结果 | 逆向映射后线性灰 |
| --- | --- | --- |
| 0.18 | 0.402344 | 0.114380 |
| 1 | 0.763672 | 0.767090 |
| 4 | 0.927734 | 1.839844 |
| 16 | 0.985352 | 2.689453 |
| 64 | 1 | 3 |
两个方向不能用作无损的技术往返。这不否定单向显示渲染的创作价值;它直接影响“新增一个默认一级层应保持画面”及反复进入/退出工作空间的设计。DRT末端存在0–1限制,逆向函数也有有限范围,已被压缩或剪掉的信息不能通过逆变换恢复。
证据:`ev_bbe42e9acd5c1e0470681d56d3b4dfcd2e26b3fe1556fac4c23c999751feed84`(属性);`ev_db7337a59c2f40d85a22ecad704ea295ed7f46e65626b9e919b5641ef1bc861b`(常量2);`ev_c8e5be75668f4e69851ffc9d23901083bac7c356252b89287b9d891837bec5e5`(映射标志);[本轮GPU数据](gpu-observations.json)。原着色器SHA与既有AIR研究完全一致,见证据索引。
**4.Color Finale的色彩管理架构**
Color Finale把根级输入管理、工具工作空间与最后输出分开。当前正常入口有四种:
| 模式 | 已观察行为 | 使用边界 |
| --- | --- | --- |
| Assume Video | 新建默认;按宿主视频空间解释已经匹配的输入 | 已经由上游相机LUT还原的素材可走此入口 |
| Assume Log | 固定一般校正后进入视频路径 | 属于通用估计,静态路径没有相机识别或逐片分析 |
| ACES | 相机IDT → ACES → 选定工作编码,末端单独输出 | 新建工作空间ACEScct;旧归档缺字段回退ACEScc |
| Input LUT | 应用输入LUT并保存其输出空间声明 | 支持声明709 Gamma、2020 Gamma、PQ、HLG等输出语义 |
Generic输入分支实际使用所选ODT的逆变换,不能将它宣传为任意未知相机Log的准确解码。产品内部100/200/210等修订值也不能直接命名为Academy ACES 1.0/2.0/2.1。
正常ACES主链是:输入CMS → 基础校正/色卡匹配(有历史版本顺序差异)→ 图层树 → 胶片处理 → 印片LMT → ODT。基础校正主动转入线性域,Log Wheels/Telecine等使用stack空间;并非所有工具全程使用同一种Log编码。LUT也可以先适配到其期望空间,处理后返回工作空间。印片位置在RRT/ODT之前,与大鱼当前显示链后接入印片的方式不同。[官方CMS说明](https://docs.colorfinale.com/docs/inspector/cms/)、[官方印片说明](https://docs.colorfinale.com/docs/inspector/film-emulation/)。
当前产物保存有9种ODT、8种印片外观及具体摄像机输入表。菜单覆盖和“原版组件一致”只能支持各自已检查范围,不能代替整条CMS、所有输入和半透明图像的准确性验证。Color Finale的旧归档还显式保留Legacy ODT路径,升级时不会简单把所有历史输出替换为新算法。
新补的正常宿主衔接证据表明:
1. 属性字典请求视频Gamma RGB(2)。`FTProAPIAccessing`读取宿主 `colorPrimaries`,区分709/2020,再提供相应逻辑空间;当前实现通过API manager的KVC取值,不应照搬为大鱼对所有宿主的稳定公开API保证。
2. `FTCIRenderer`保存destination tile的实际CGColorSpace,用它包装输入图像。`CIImage`入口带有这个颜色空间标签;标签本身不表示已执行摄像机IDT。
3. 内部CIContext把自动工作空间和输出空间设为NSNull,处理空间和变换由自身CMS明确执行。
4. 最终写宿主纹理时Core Image的colorSpace参数为NULL,避免再自动叠加一轮输出转换。
因此可借鉴的是颜色语义、入口标签和变换责任的分离。仅把CIContext打开自动色彩管理,也不会自动得到相机IDT、完整ACES显示渲染和正确印片。
关键证据:`ev_e4aea5e08f51d466349c9b197ce4b2cd24677316f0593a69a4238b8575afda6d`及常量字典读数;`ev_50235366fb24a6970669d43fdbc342e4a7ecc82d3699576b3d63b2d5f1910846`(709/2020);`ev_77ac74cf117fa08eed62cb602525c2f17419ae65c561524f7a45bbbd81ecd186`(正常渲染);`ev_1144f3b54e28a3a29e13899b36fb6688d74086a75f89eb0b7d9adffbe90d91aa`(入图标签);`ev_394c260352b0906c3854e955f30582295f6c2029a2832aaa4379a3c067aaca82`(CIContext);`ev_59dc53561198edfe1effb986550de215d55316f734fa5235ffd6b4d2793ee9bd`(回写NULL)。主CMS与LMT/ODT顺序见 [evidence-index.json](evidence-index.json)。
**5.大鱼调色当前最具体的问题**
| 优先级 | 当前实现 | 影响及处理 |
| --- | --- | --- |
| P0 | 请求linear RGB,固定sRGB运输桥,未读src/dst colorSpace或宿主primaries | 与三个目标的宿主接入策略不同。先测真实数值契约,再决定新模式适配;旧模式保留 |
| P0 | 新独立一级层显式开启自动映射,input=output仍进工作空间并返回 | 逆DRT与正DRT不能相消,新层默认不具备严格中性;新版一级层应gradeOnly |
| P0 | 根级输出先完成,后段与印片继续按sRGB/709假设处理 | 选择2020/P3不能保证后续模块仍正确;每个算子必须声明并适配输入域 |
| P0 | CST mix直接混合输入代码值与另一输出编码值 | 属于旧创意混合语义;新版应在共同工作/宿主线性域混合 |
| P1 | 活跃减色夹断0–1,部分HSL/白平衡/色轮来自RGB8 17³表 | 适合有明确限制的传统SDR风格路径,不能当作全扩展范围场景算法 |
| P1 | 输出菜单、渲染算法、目标峰值和宿主线性回写没有统一描述 | PQ/HLG编码不能直接写进请求linear的目标纹理;需明确显示渲染责任和物理边界 |
| P1 | 静态Cube依赖伪造sRGB载体网格走生产链 | 应使用明确颜色描述评估;补非格点误差、33/65及有限域/shaper合同 |
独立一级层的事实来源是 `DYNewTool`、`DYToolUniforms`和`DYToolIsNeutral`。它不会默认再次按Sony S-Log3解码:新层input/output默认同为709/Gamma2.4,但显式toneMapping=1使其走逆向与正向映射。不能把问题描述成“每层重复Sony还原”。
本轮用正式安装的 `dyColorManagement`,配置为上述新层默认参数,在alpha=1、无蒙版的直接内核检查中,得到线性中性灰0.180054→0.120667、1→0.796875、2→0.796875。参数与当前源代码生成结果对应;这项检查隔离了颜色内核,没有冒充完整FCP/UI或调度器验收。它足以要求新增一级层的中性行为成为优先修复和真实宿主复测项。
源码位置:`DYPlugIn.mm:25,30–36`;`DYGrade.metal:294–313`;`DYRenderer.mm:45–49,163–177,199–211`;`DYToolState.mm:65,120–126`;`DYFilmMath.h:16–21,34–40`;`DYColorTables.mm:104–147`。本轮直接内核结果见 [gpu-observations.json](gpu-observations.json)。
**6.分阶段实施方案**
第一阶段先补诊断并锁定旧画面。新增 `DYColorContext`,在合适的宿主回调冻结项目primaries,在render中核对源/目标 `FxImageTile.colorSpace`,记录空间名称/ICC摘要、线性/非线性、alpha与纹理精度。API或元数据不足时显示未知并保留兼容行为,不静默当作709。缓存键包含这份颜色上下文,避免同一XPC内多个项目互相污染。此阶段不全局改写旧sRGB桥。
第二阶段建立独立版本的根CMS,提供三种明确入口:跟随宿主、专家相机编码、输入LUT。跟随宿主按实际空间接入,不再无条件套默认Sony解码;已渲染输入保留其显示参考语义。相机编码路径要求通过对应FCP设置和数值夹具验证,关闭某个LUT开关本身不能证明拿到了原始代码值。输入LUT附内容hash、输入/输出空间与scene/display语义。上游转换状态无法可靠读取时,保留用户声明与“未知”状态,不能伪装自动检测。
第三阶段拆开根输入、调色工具、显示渲染和宿主输出。多个一级层仅调整统一工作空间中的画面;相机输入和显示映射由根CMS统一负责。印片作为具有AP1/ACEScct合同的look阶段接入匹配的渲染变换之前。传统709 LUT和曲线保留明确的显示域修饰区域;HDR模式下未完成扩展范围适配的工具须明确限制,不能默默夹断。新版强度和蒙版在共同域混合,恒等/关闭/mix=0直接旁路,避免多余编解码及U/P往返。
推荐新版语义主链:
```text
实际宿主像素与颜色描述
→ 输入边界与输入解释
→ 统一工作空间
→ 一级与局部调色(按工具声明适配线性/Log域)
→ 场景外观与印片
→ 一次明确的显示渲染(仅在插件负责时)
→ 明确的显示域修饰
→ 转回宿主要求的颜色空间与alpha合同
```
“一次”指根级场景→显示渲染的责任,不代表所有曲线、艺术映射或系统显示管理只能出现一次。宿主已完成显示渲染的路径不应再默认执行一轮DRT;最终显示器呈现仍由宿主及系统负责。
第四阶段复用兄弟工程现成的公开CMS基础。`大鱼调色盘`固定节点 `f8950384e514685c8809fe8e8ee2dd5f16ad0bd7` 已有OpenColorIO 2.5.2、`studio-config-v2.2.0_aces-v1.3_ocio-v2.4`、ICC边界、CPU/Metal、依赖锁与许可证。可提炼 `DYColorManagement.cpp`、`DYColorManagementGPU.mm`、`DYColorManagementState.mm`、`DYColorProfile.mm`、`DYColorBoundary.mm` 及必要Core声明,构建缓存改用本产品com.dayu.color,不链接兄弟APP或依赖研究缓存。
现成模块的工作空间只允许ACEScg/cc/cct,DI目前只是输入选项。最短的标准参考路径是新模式采用ACEScct并适配现有BASIS;现有DWG/DI继续保留在兼容路径。若新版也提供DWG/DI工作空间,需要扩展工作空间合同、白点/色域适配并进入同样的验收矩阵,不能仅解锁菜单。OCIO 2.5.2、config修订和ACES 1.3是三个不同版本号;不能误写成ACES 2.5.2,也不能借用原版内部210命名。
第五阶段补齐输出目标与高级能力。将tone mapping、目标色域压缩、显示编码分开保存;固定公开输出变换及其版本,按所选算法声明参考白、黑位、峰值与显示原色。提供明确的709 SDR、P3和2020 PQ/HLG目标,但写回前仍适配宿主空间。再逐步增加有定义的场景白平衡、剪切/超色域诊断、参考帧与镜头匹配。是否全程32位由压力测试和误差预算决定,不能把half直接等同不专业,也不能把float纹理等同全程高精度。
**7.兼容与数据模型**
保留当前1312字节uniforms ABI、原参数ID和预设v1–v6读取。新版颜色状态独立归档,包含 `pipelineVersion`、输入模式/声明来源、实际host描述、工作空间、scene/display语义、渲染责任、输出目标/算法版本、LUT空间与内容hash、兼容修订。GPU新常量使用独立buffer,不继续把所有元数据塞进冻结的还原核前缀。
旧工程和旧预设固定走legacyV1;新模式单独分配schema与预设版本。不能依赖“新参数缺省值”识别旧工程:本项目已有FCP省略默认值、模板更新影响旧实例的实际记录。显式迁移操作应可撤销,并保留迁移前状态;不承诺自动迁移后与旧艺术外观逐像素一致。
alpha需逐算子约定。当前产品对非正alpha清零,兄弟工程支持隐藏RGB及区间外alpha,并对极小alpha采用1e-5分母下限;这两种语义不能直接互换。既有Color Finale印片探针也显示原版组件在半透明时直接拼链与alpha=1颜色函数不同。因此先定义新版straight/premultiplied合同,再验证所有转换、空间效果和蒙版;旧工程保留旧行为。
**8.验收与退出条件**
| 组别 | 必须覆盖 | 判断依据 |
| --- | --- | --- |
| 宿主边界 | FCP标准/宽色域库、709/2020、src/dst空间、摄像机LUT/Color Conform组合 | 实际记录tile空间、已知代码值夹具和正式导出;不能只看菜单 |
| 基础科学 | 官方相机曲线、矩阵/跨白点、18%灰、曝光档位、中性轴 | 独立double公式/官方golden vectors,避免仅以同源核为oracle |
| 范围与连续性 | 近黑、负值、超白、灰阶渐变、强饱和LED | 有限值、连续性、单调性、色相及目标色域;HDR用相对/ULP等合适误差预算 |
| 顺序 | 多一级层、空层、印片前后、scene/display工具 | 空层保持像素;输入和DRT执行次数符合计划 |
| alpha与空间 | 0/极小/0.5/1及约定支持的扩展alpha、蒙版、边界/原点 | 隐藏RGB与U/P合同、无意外彩边、预览/导出一致 |
| 兼容 | 真实旧FCP工程、v1–v6预设、撤销/重做/冷重开 | 默认升级保持旧像素;显式迁移可回退 |
| LUT | 33/65、非格点随机样本、有限域或shaper | 给出误差范围;空间/时间效果不能伪装静态Cube |
| 工程交付 | Release构建、签名、公证、正式路径启动/宿主导出 | 按全局交付约定完成;本次研究不代表新版已经实现或发布 |
本轮完成了目标身份、主要管理架构、宿主包装策略、原版有限GPU行为及按文件可实施的改造方案。真实FCP摄像机入口、宽色域/HDR导出、显示器EDR和跨素材精度仍属于实施阶段的必需验收,不能由本轮离线探针替代。
**9.复现与恢复**
探针仅执行本机目标Metal函数,不启动目标GUI或FCP。需macOS、Apple Metal与Xcode命令行工具,原版库SHA改变时探针会停止。源码 [probe.mm](probe.mm),输出 [gpu-observations.json](gpu-observations.json),完整证据位置与摘要 [evidence-index.json](evidence-index.json)。
```sh
xcrun clang++ -std=c++17 -fobjc-arc -framework Foundation -framework Metal research/cms-audit-20261103/probe.mm -o /tmp/dayu-cms-probe
/tmp/dayu-cms-probe /tmp/dayu-cms-observations.json
```
仓库为 `https://dayu.media/git/dayu/dayu-color.git`,分支main。探针与身份检查点 `a1e49e2eb55d1175e1ea52dfcf0f7aaa48eaab7b` 已推送并核对远端;本报告的最终提交可由 `git log -- research/cms-audit-20261103` 定位。本研究无LFS、子模块或新增二进制依赖。远端保存包含本文、探针、数值结果、目标身份和精简取证记录;完整REA缓存和第三方APP不属于远程恢复承诺,未来重跑需重新安装对应版本目标。