# 大鱼调色 原生 FxPlug 4 调色器,当前正式安装版本 **1.6.0(39)**。唯一安装位置为 `/Library/Plug-Ins/FxPlug/大鱼调色.app`;Final Cut Pro 中从“效果 → 大鱼调色”添加。 交接与恢复入口:[大鱼调色FxPlug4交接.md](大鱼调色FxPlug4交接.md)。 ## 胶片模拟与通道混合器 新增可重复的胶片模拟和通道混合器,现有调色、蒙版、区域跟踪和相邻叠层保留。每个新工具都有独立眼睛、折叠、复位、蒙版、数量标记和“再加一层”;新增层从默认值开始。 通道混合器按红、绿、蓝输出分组,每个输出有三个输入系数,并提供保持亮度、保持饱和度和混合强度。胶片包含减色、晕光、辉光、颗粒、暗角五组,各自启停;颗粒支持精确帧时间、1–5帧保持和固定种子。默认保持中性,旧工程缺省不改变画面。 本机Color Finale 2.16.2的相关数学已单独取证并对照,产品独立构建,不加载原版APP或原版二进制。新阶段位于既有显示域链之后;减色/颗粒沿用本工程sRGB边界,其余在线性域。活跃减色沿用原核的0–1限幅;不宣称与原版全部ACES管理路径完全等价。1.6.0追加第六页“印片”:Kodak2383、Kodak2393、Kodak2302 BW、Fuji3510、Fuji3513、Fuji3519、Fuji3521、AgfaCP30,支持独立强度,默认“无”。以明确的Rec.709线性↔AP1/ACEScct边界接入原版LMT颜色函数;不代表原版完整CMS/ODT链。 完整预设升级为v6,兼容v1–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)。 FCP新实例、全部还原及新加一级层的自动色调映射默认开启;已保存的关闭设置和旧独立一级层的缺省关闭保持。在主标题区增加可点击的“更多插件访问 https://dayu.media”。 ## 1.6.0 八种印片与简洁模板 正式安装393项原生检查和四尺寸136项原版印片颜色函数对照通过,最大线性RGB绝对差0.000004828。FCP12.4逐个选择八种外观、独立印片层、100帧椭圆蒙版跟踪、折叠计数、删除/撤销/重做通过;彩色、黑白、蒙版叠层三段ProRes共300帧完整解码,黑白RGB通道完全一致。冷重开后8474、8456、32554字节三份预设分别逐字节一致;升级前276个用户参数及既有路径/蜘蛛盘/蒙版载荷保持。 按用户要求移除MOEF作者和网站两行,已有实例与新实例均已确认。模板采用真实原生样本支持的ozml5.11 / Motion5.4.5格式,保留自定义检查器和混合。FCP12.4加载和渲染通过;低版本FCP未实机测试,程序仍要求Apple Silicon / macOS14.6或更新。全局技能检查器不支持5.11,原始guard报告保留;项目原生字段验证与宿主验收分别记录。 见[印片来源与适配](research/PrintLooks1.6.0.md)、[原版对照](verification/PrintLooksReference.json)、[正式宿主验收](verification/HostPrintLooks1.6.0.json)、[模板兼容验证](template/verification/Compatibility.json)。 ## 蒙版折叠与标题标记 蒙版面板随所属模块一起折叠,展开后恢复已有控件。标题栏蒙版按钮旁显示已添加的蒙版数量,无蒙版时隐藏标记;原模块与独立叠层分别计数,已停用的蒙版也计入数量。标记在折叠后仍可见,不改变蒙版和轨迹。 1.4.3正式路径293项既有原生检查通过;FCP12.4验证原模块、独立层、删除到零/撤销、折叠后数量标记及冷重开,完整预设逐字节一致。当前用户设置中的286个轨迹键保留。见[本轮宿主验收](verification/HostMaskFolding1.4.3.json)。 ## 1.4.2 跟踪修复 中间帧启动直接使用宿主分析首帧,预览缓存缺失或陈旧不会阻止开始。真实素材的细纹运动采样和拟合容差已调整,仍保留可信度与错误变换保护。失跟说明原因与保留帧数;正常取消标记结束宿主后台任务。单帧跟踪会把源时间转换到时间线位置,支持片段前有其它内容时连续操作。 1.4.2的293项原生检查和19项独立CPU/Metal跟踪检查通过。该版FCP12.4实测同一4K素材中间双向285键、首帧正向285键;取消后重启、失跟后连续重试、边界停止与连续单帧通过,后台任务正常闲置。正常退出冷重开后完整预设逐字节一致。APP已公证、粘附票据并安装;安装包与Release结果见对应版本验证记录。用户媒体、预设和项目快照只保存在本机。 ## 色彩管理与一级调色 前段已改为 **输入转换 → 工作空间一级调色 → 输出转换**,复用大鱼 CST 仓库的固定源码与原生 GPU 数学。曲线和色域独立选择,工作空间统一供一级调色及输出使用,不经相机还原 LUT 近似。 新实例输入为 Sony S-Log3 / S-Gamut3.Cine,输出为 Gamma 2.4 / Rec.709,工作空间为 DaVinci Intermediate / DaVinci Wide Gamut,自动色调映射默认开启。请按素材实际编码选择相机输入;不会根据片段或曲线名称猜测、覆盖手选色域。一级调色包含曝光、色彩平衡、饱和度、对比度与轴心、分区影调、黑白点、趾部/肩部压缩。输入、工作空间和输出已合并到一级调色卡片,四个旁路选项移除,由一级眼睛统一启停。一级白平衡改用原 CST 色轮,支持精细拖动、方向键微调、双击复位,以及可见的“复位”按钮;按钮只重置一级白平衡。 CST 后的基础调整、HSL、曲线、色轮、五层风格 LUT 等仍属于既有显示域调色链。保留肤色保护、三原色、色阶、黑白、自动调色、吸管、预设和 Cube 导出。Cube 导出包含 CST、一级调色(含白平衡色轮)、蜘蛛盘及其它已启用的逐像素颜色操作。折叠不影响导出,眼睛关闭的模块不计入;纹理、清晰度、去朦胧和逐画面统计不写入 LUT。导出为 33³ Cube,应应用于与导出时相同编码的输入,避免重复叠加 CST/一级处理。 旧工程的输入 LUT / 相机档位和原画面保持兼容;在一级调色中看到“旧版输入 → 改用 CST”时,可明确切换。编辑 CST 参数也会启用新链路。旧参数 ID、LUT 路径与预设读取保留。 ## 模块界面 新实例和“全部还原”默认展开 **一级调色、蜘蛛盘校色仪、基础调整**,其余折叠,所有眼睛开启。标题只控制展开;眼睛只负责启用/停用,两者分别保存,正常重开仍保留。折叠保留参数、LUT 选择和效果。黑白混合默认 0%,避免全眼睛开启时直接变成黑白。 蜘蛛盘直接移植“大鱼调色盘”的可变网格与数学,默认联动 6×6;支持 6/8/12/16/24 点数、独立两轴、固定点、多选、整环/整列和复位,随工程与预设保存。中性盘精确直通。 LUT 缩略图浏览器使用宿主的独立可调整窗口:拖动标题栏移动,拖动窗口边缘调整大小;文件夹与预览之间的分隔条可调整侧栏宽度,底部可切换网格/列表和缩略图大小。位置、大小、布局与分类按库记忆,宿主可能限制最大窗口尺寸。“最近使用”固定在分类首位,仅在成功应用后记录、去重并按最新优先显示,保留最多 40 个;当前文件夹和全部列表也优先显示最近使用项。旧版已保存的当前 LUT 可在首次打开时作为历史起点,不虚构旧版未记录的其它历史。 五套主题跨实例记忆。风格 LUT 网格打开缩略图浏览库;用户库为 `~/Movies/大鱼调色LUT/look LUTs`。后台扫描、导入、解析、预览、取消和最后一次选择生效的机制保留;支持既有 UTF-8/16/32 与旧编码 Cube 兼容。用户文件不进入源码或安装包。 ## 每工具蒙版与再次添加工具 十四个模块标题均有“添加蒙版”和“再加一层”。新增工具紧接点击的原工具或新增工具插入,从本工具的初始化参数开始,拥有独立启停、折叠、复位、删除、LUT 和蒙版;不会复制原层当前设置。新增一级采用 Rec.709/Gamma 2.4 同域输入输出,新增肤色保护强度为零。 蒙版包括椭圆、矩形、钢笔、线性渐变、HSL 和亮度选区,支持相加、减去、相交、反转、羽化和强度。矩形、椭圆和闭合钢笔区域可正向、反向、双向或单帧跟踪。算法从“大鱼调色盘”固定源码适配,随本产品独立构建;不依赖安装父插件。完整预设 v6 保存新增工具、蒙版和逐帧轨迹,兼容旧预设。空间蒙版不能导出到 Cube,导出时会提示。 蒙版检视器采用13pt参数文字和数值、32–36pt按钮、独立整行滑杆及两列跟踪操作。钢笔菜单直接进入绘制态,可点击放点、拖出曲柄、点首节点/Return/“完成绘制”闭合,Esc/取消保留原路径;支持重画、Delete回退和即时预览。跟踪改进实际路径搜索边界、300点特征、亚像素精炼和21×21光流,运动分析按显示比例限制到1280×720,4K细纹先低通再缩小,调色渲染和输出分辨率保持原设置。 1.4.1的281项原生检查、独立CPU/Metal跟踪18项通过。FCP实测相邻插入、初始化与独立参数、大号面板、绘制态切换、钢笔蒙版正向99键、一次撤销/重做及保存重开完整预设一致。画面提示文字方向已修正。用户随后用实际鼠标确认“可以绘制并闭合”,钢笔放点和闭合实机验收通过;自动化输入未进入OSC回调,曲柄/删除等其它手势仍以原生模拟宿主检查为据。1.4.0的中心拖动已有用户确认。新增工具标量仍为静态值,蒙版轨迹按时间求值,跟踪不含透视/剪切。 旧schema1末尾层保持原保存位置与渲染,避免改变旧工程外观;新添加的层使用schema2插入锚点。原生固定模块的既有处理顺序保留。当前实现参考本机Color Finale的行为和参数独立适配,并非全部功能完整移植;B样条、编组、人物/图像/外部蒙版及完整轨迹区段编辑等差异见专项清单。 旧模板实例可能保留关闭画面控件的状态;可先保存完整预设,再重新应用新版效果并载入预设。不会自动覆盖旧实例。实现与验收边界见 [实现说明](research/ToolMaskImplementation.md)、[宿主记录](verification/HostToolMasks.json) 和 [恢复核验](verification/ToolMaskRecovery.json)。 ## 验证与恢复 - [本轮交接](大鱼调色FxPlug4交接.md) - [当前正式路径原生检查](verification/InstalledSelfTest.json) - [中间帧与真实素材跟踪修复](research/TrackingMidpoint1.4.2.md) - [跟踪宿主验收](verification/HostTrackingMidpoint1.4.2.json) - [跟踪源码独立恢复](verification/TrackingMidpointRecovery.json) - [插入、钢笔和跟踪工作流](research/MaskWorkflow1.4.1.md) - [1.4.1 FCP验收及用户实际钢笔确认](verification/HostMaskWorkflow1.4.1.json) - [Color Finale对照和未迁移范围](research/ColorFinaleMasksFollowup.md) - [1.4.1远端源码独立恢复](verification/MaskWorkflowRecovery.json) - [每工具蒙版、跟踪、保存重开与用户实际拖动](verification/HostToolMasks.json) - [1.4.0 发行标签独立恢复](verification/ToolMaskReleaseRecovery.json) - [CST 来源与集成边界](research/CSTIntegration.md) - [CST 固定源码节点与摘要](research/CSTIntegration.json) - [蜘蛛盘与色轮来源和适配](research/SpiderAndBalanceIntegration.md) - [1.3.1 的 201 项原生与独立像素对照](verification/BrowserNative.json) - [浏览器布局与最近使用专项检查](verification/BrowserCustomization.json) - [大规模 LUT 加载与取消回归](verification/BrowserRegression.json) - [204,683 项网格数学检查](verification/SpiderMath.json) - [正式 FCP 界面与保存重开](verification/HostBrowserAndReset.json) - [正式安装与公证](verification/Delivery.json) - [远端独立恢复与着色器重建](verification/BrowserRecovery.json) - [完整恢复说明和历史](RECOVERY.md) - [原有算法来源](research/ALGORITHM_SOURCES.md) 构建使用 `Wrapper Application` 方案、Release。运行 `python3 tools/deliver.py` 完成签名、公证、唯一安装和正式宿主验收;更改模型后运行 `python3 tools/build_template.py --refresh-model --overwrite`。`tools/create_browser_host_fixture.py` 重建独立合成验收 XML,不写用户 LUT 库。 正式发行包由 PKG 工坊技能生成,包含 APP 与 FCP 模板,不含用户 LUT、预设或媒体。安装与发布证据分别保存在 [Package.json](verification/Package.json) 和 [Release.json](verification/Release.json);以其中记录的版本和成功状态为准。 正式发行包:[大鱼调色-1.6.0.pkg](../发行包/大鱼调色-1.6.0.pkg)。当前安装、公证、验包与Release下载结果分别以[Delivery](verification/Delivery.json)、[Package](verification/Package.json)、[Release](verification/Release.json)为准。[1.6.0 Release](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.6.0-print-looks-20261102)用于保存最终发行包。历史[1.5.0 Release](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.5.0-film-mixer-20261102)及更早标签和发行包保留。 1.3.1 的历史验收包含 Sony 默认、可见复位、浮动浏览器、系统窗口缩放、两种布局、最近排序与关闭重开。原生检查单独覆盖几何/布局持久化和鼠标事件;当时自动化没有独立确认自由标题栏/边缘拖动。1.4.0 另在独立合成工程中完成上文的宿主检查,用户确认中心拖动后保留其试调状态。