57 行
5.6 KiB
Markdown
57 行
5.6 KiB
Markdown
# 大鱼调色 FxPlug4:CST 与独立折叠交接
|
||
|
||
更新时间:2026-11-01,Asia/Shanghai。
|
||
|
||
当前正式 APP 为 **1.2.0(17)**,已通过公证、唯一安装及 FCP 宿主验收。实际编译源码 `48b00c85799b0226ba32aba3f2e5397aa0e509ed`,公证 `f25ae46e-92da-4470-842e-128bdb232aa8`。后续文档、打包和 Release 记录不改变 APP 编译来源。
|
||
|
||
## 项目身份
|
||
|
||
- 当前源码:`/Volumes/备份/大鱼调色/大鱼调色`
|
||
- 远程:`https://dayu.media/git/dayu/dayu-color.git`,main
|
||
- 主 Bundle ID:`com.dayu.color`;插件:`com.dayu.color.XPC`
|
||
- 唯一正式 APP:`/Library/Plug-Ins/FxPlug/大鱼调色.app`
|
||
- 固定缓存:`/Users/mac/Library/Caches/CodexBuilds/com.dayu.color`
|
||
- Xcode 方案:`Wrapper Application`,AppKit 检查器与独立 XPC
|
||
|
||
父目录中的大鱼调色盘、CST、一级调色还原均为独立仓库;本轮仅只读参考 CST,没有改动其他产品。
|
||
|
||
## 最新用户要求与已实现行为
|
||
|
||
1. 输入相机 LUT 改为大鱼 CST 的输入转换 → 工作空间一级 → 输出转换。曲线和色域独立,工作选择由一级和输出共享。新默认输入/输出 Gamma 2.4 / Rec.709,工作 DaVinci Intermediate / Wide Gamut,自动色调映射关闭。
|
||
2. **一级调色与基础调整默认展开,其他模块折叠,所有小眼睛默认开启。** 标题只折叠/展开,小眼睛只启用/旁路;按实例保存,正常退出重开保持独立状态。全部还原恢复上述默认。
|
||
3. 全眼睛开启时保持默认画面中性:黑白混合默认 0%;未调整的显示域工具在渲染副本中旁路其有限域查表;无实际调色时不运行肤色保护,避免裁切 CST 的 HDR 输出。UI 参数和眼睛不被改写。
|
||
4. 旧 schema 1 工程和旧输入 LUT/档位保留原解释;输入组提供“旧版输入 → 改用 CST”,显式编辑 CST 参数也会迁移。旧预设可读,新预设记录有效兼容模式。
|
||
5. 原基础、HSL、色轮、曲线及五层风格 LUT 继续在 CST 输出之后工作。后台 LUT 加载、编码兼容与预览机制保留。Cube 导出复用生产路径,包含 CST/一级,不包含空间细节和逐画面统计。
|
||
|
||
## 关键实现
|
||
|
||
`DYColorManagement.h` 保存原始控制与 CST/BASIS 参数换算;`DYCSTTypes.h` 是参考布局;`tools/kernels/CSTKernel.ll`、`BasisKernel.ll` 来自固定 CST 源码节点,摘要见 `research/CSTIntegration.json`。生产构建使用仓库内文件。
|
||
|
||
`DYUniforms` 保留前 944 字节,末尾追加控制。旧参数 ID 不变,新增从 2236 开始。`DYRenderer.mm` 在直通 RGB 缓冲上运行 CST,再进入原有调色链;未加载的旧输入 LUT 不参与新 CST。`DYGrade.metal` 包含新边界,CPU/Metal 都保留透明度与预乘处理。
|
||
|
||
`DYInspectorToken` schema 2 新增 folds 字典;`toggleSection:` 只写字典,`groupEnabled:` 只写启用参数。`DYModel.mm` 定义 3 个 CST 阶段和所有新默认。输入与工作/输出的曲线、色域按稳定数学 ID 保存,不使用菜单位置代替 ID,选择参数不插值。
|
||
|
||
## 本轮验证
|
||
|
||
- `verification/CSTIntegration.json`:正式安装路径 153 项检查,含真实 AppKit 折叠动作、模型/归档、IOSurface/Metal、黑白混合、Cube 与 21 组独立 CST 像素对照。
|
||
- `verification/HostCSTAndDisclosure.json`:FCP 12.4,独立合成验收项目;默认、折叠/眼睛、曝光 0.70、Sony 输入、ACES 工作空间及正常保存重开通过。旧验收工程仅打开观察,没有改值。
|
||
- `verification/InstalledSelfTest.json`:正式安装常规自检 110 项。
|
||
- `verification/CSTRecovery.json`:远端独立恢复编译提交,151 文件和 strict/full fsck;重建 Metal 与正式库摘要一致。
|
||
- `verification/Delivery.json`:APP 签名、公证、票据、Gatekeeper、唯一登记与宿主路径。
|
||
|
||
像素对照是指定 GPU/样本的原生运算检查,宿主记录是实际界面与保存检查;没有宣称所有宿主逐像素等同。未验收 Motion、Intel 和旧系统。
|
||
|
||
## 后续交付与数据保护
|
||
|
||
本版本标签 `v1.2.0-cst-fold-20261101`;正式包位置为上级“发行包/大鱼调色-1.2.0.pkg”。最终 PKG 公证/验包与 Release 下载结果以 `verification/Package.json`、`verification/Release.json` 的本版本记录为准;生成或更新时不得引用旧版结果冒充新版本。
|
||
|
||
源码检查点:`python3 tools/checkpoint.py '<说明>' <已审查路径...>`,入口自带 Git 锁。APP:`python3 tools/deliver.py`,持有产品交付锁至宿主验收。PKG:`python3 Packaging/build_pkg.py --pkg-forge-repo /Users/mac/Documents/dayu-git/repositories/pkg-forge`。Release:`python3 Packaging/publish_release.py --tag v1.2.0-cst-fold-20261101 --notes Packaging/Release-1.2.0.md`。各脚本已管理适用锁,外层不要重复获取。
|
||
|
||
用户 LUT 在 `~/Movies/大鱼调色LUT/look LUTs`;本轮读取 N12 的 26 项测试选择,无新导入、无删除,验收实例最后全部还原。用户媒体、原有项目、收藏和偏好不进入 Git/包。`tools/create_cst_host_fixture.py` 只生成产品缓存中的合成验收资源;FCPXML 技能校验使用精确 1.12 DTD,通过无警告。
|
||
|
||
恢复完整步骤及历史节点见 `RECOVERY.md`。当前 AppKit 项目无需引入 SwiftUI 或改变产品固定身份。
|
||
|
||
## 1.2.0 正式 PKG
|
||
|
||
正式包 `../发行包/大鱼调色-1.2.0.pkg`,13,818,397 字节,SHA-256 `9fba4f0c1a313a6da8374b683f7e6b41af70388d7a7a180e26b9e236a9ba64a1`。PKG 公证 `c7b97b0f-57c8-45d3-a4d7-7db8e8694487`,Accepted;Installer 团队 B3W25FX5H5、票据、Gatekeeper 及 20 项展开验包通过。包内 APP 与已验收正式安装一致,未重复运行安装器。
|