文件
dayu-color/README.md
T

6.9 KiB
原始文件 Blame 文件历史

大鱼调色

原生 FxPlug 4 调色器。主方案为 Wrapper Application,包含独立 XPC 插件,正式安装在 /Library/Plug-Ins/FxPlug/大鱼调色.app。

支持 17 种相机输入转换、自选输入 LUT、基础光影、白平衡、局部增强、肤色保护、五层风格 LUT、RGB 曲线、8 色与自定义 HSL、四个色轮、三原色、色阶、黑白和色彩平衡。包含自动调色、复制时自动分析、系统吸管、JSON 预设和 Cube 导出。

当前正式版本为 1.1.5(16),交付标签 v1.1.5-lut-encoding-20261101。所有调色分组统一为展开即启用、折叠即停用;新建实例与全部还原只展开基础调节。折叠保留参数和 LUT 路径,重新展开继续使用;打开已保存的调色时按各组实际启用状态展开。基础调节同时控制其光影、白平衡与颜色子组。

程序图标与 FCP 缩略图采用统一的光谱鱼。两张原始生成图及提示词保存在 design/;运行 python3 tools/build_brand_assets.py 使用 macOS 工具导出 ICNS、640×360 与 240×135 的效果预览。

主题与 LUT 浏览库自 1.1.0(6)提供,源码标签 v1.1.0-theme-lut-20261031。灰、蓝、紫、绿、橙五套主题切换后跨实例记忆。风格 LUT 左侧网格按钮打开缩略图浏览器,右侧文件夹按钮打开 ~/Movies/大鱼调色LUT/look LUTs。可导入文件或目录,按目录与名称过滤,单击应用,缩略图大小与目录会保存。

缩略图使用当前素材先经过输入 LUT 的画面;没有源帧时显示本产品生成的色卡。显示方向与宿主图像原点一致,自动分析保留自己的原始数据。浏览器优先采用 FxPlug 宿主窗口,不能使用时回退为锚定弹出面板。品牌保留大鱼,吸管仍为系统取色器。

算法背景资料补充了同系列工程的 Color Finale 移植研究,涵盖调色工具、LUT 预览、图层与蒙版工作流;归档记录、适用范围及当前实现的来源区分见 算法说明。Camera Raw 查表数据与组合行为采用 Compositor 的 MIT 许可实现,许可证随资源保留。

大鱼调色/Plugin 保存模型、AppKit 检查器、IOSurface/Metal 渲染与 CPU 查表;tools/kernels 保存可重建的 GPU 数学文本;template 是 FCP 效果入口。正式构建使用仓库中的源码和资源。

选择自有 LUT 后,预设记录其绝对路径;跨机器搬移时同时保留 LUT 文件并重新选择。LUT 导出只保存逐像素颜色,不包含纹理、清晰度或逐画面分析。

tools/create_lut_host_fixture.py 可重建独立 FCP 验收 XML 和四个合成测试 LUT;它只写产品缓存,不会向用户库自动导入。LUT 核心检查见 verification/LUTLibrary.json,主题与浏览库实现说明见 research/ThemeLUT-analysis.md。

tools/create_group_fold_host_fixture.py 可创建独立的合成验收时间线,用于检查新实例仅基础调节默认启用、分组展开/折叠与数值保留。风格 LUT 总组停用会旁路全部五层;停用的输入或风格 LUT 不加载其文件。

LUT 文件夹扫描、逐项校验/复制和选择文件后的解析均在后台执行;导入期间可继续搜索、滚动和选择,刷新按钮临时变为“取消”。失败或取消会移除本次新复制的文件并保留既有库。目录与缩略图只为可见范围创建控件,预览逐项出现;快速切换时仅应用最后一次选择。24个65级合成LUT与3,025项库的响应测试见 LUTResponsiveness.json。

1.1.4 修复外部 Cube 的旧编码标题导致整批导入失败:标题、注释兼容旧编码,尺寸和数值仍严格校验,报错包含文件名。点击缩略图时先在后台解析并准备 GPU 纹理,宿主接受后才确认选择;已选表独立保留,不受缩略图缓存淘汰影响。用户提供的 N12 目录 26 个 LUT 已全部导入、生成缩略图并完成 Metal 渲染,FCP 中两份“青橙色”、64 级 LUT、快速切换和保存重开通过。用户 LUT 不进入源码或安装包。

1.1.5 增加整份 Cube 的 UTF-16/UTF-32 大小端、有无 BOM 识别,在后台转换工作副本,保留导入文件的原始字节。支持常见换行及 Unicode 空白,标题、注释继续兼容 ASCII 指令下的旧编码。16 份 UTF-8/16/32 与 GB18030、Big5、Shift JIS、Windows-1252、MacRoman、ISO-8859-1 样本已在 FCP 中全部导入、预览和逐项应用,无 BOM UTF-32 保存重开通过。损坏的编码、非法数字仍会报错,不使用有损转码猜测颜色值。

正式 PKG 打包使用 PKG 工坊源码中的 pkg-forge 技能。运行 python3 Packaging/build_pkg.py --pkg-forge-repo /实际/PKG工坊源码目录,默认输出到上级“发行包”目录;先使用 --prepare-only 可只检查清单。打包使用已验证的正式 APP,并从相同 APP 资源中核对、整理 FCP 模板与缩略图,不重签或重建调色 APP。生成包将要求正常退出四种 FCP/Motion 宿主并在登录用户会话验证注册;签名公证和真实展开验包由该技能的原打包器与校验器完成。已有同名版本包不会覆盖。

当前正式安装包:大鱼调色-1.1.5.pkg,包含1.1.5(16)正式APP及相同版本的FCP模板/预览图;本机Apple Silicon,最低macOS14.6。签名、公证与20项真实展开验包记录见 Package.json。本轮没有重复执行系统安装;包内APP与已验收的正式安装逐字节一致。

正式包按全局规则保存到产品仓库的版本 Release,运行 python3 Packaging/publish_release.py --tag v1.1.5-lut-encoding-20261101 --notes Packaging/Release-1.1.5.md,复用 PKG 技能的上传器。该入口核对标签中的验包记录和最终包,下载校验后才确认发布;安装包不进入普通 Git。当前发布进度见 Release.json。