verify: formal FCP persistence, native wheel and spider controls; document 1.3.0 and host mouse automation limit
这个提交包含在:
1 父节点
eb2dc311cb
当前提交
132d98c584
5 个文件已更改
+129
-47
没有与搜索条件相匹配的文件
+26
-34
@@ -1,55 +1,47 @@
|
||||
# 大鱼调色 FxPlug4:CST 与独立折叠交接
|
||||
# 大鱼调色 FxPlug4:一级合并、蜘蛛盘与白平衡交接
|
||||
|
||||
更新时间:2026-11-01,Asia/Shanghai。
|
||||
|
||||
当前正式 APP 为 **1.2.0(17)**,已通过公证、唯一安装及 FCP 宿主验收。实际编译源码 `48b00c85799b0226ba32aba3f2e5397aa0e509ed`,公证 `f25ae46e-92da-4470-842e-128bdb232aa8`。后续文档、打包和 Release 记录不改变 APP 编译来源。
|
||||
当前正式 APP **1.3.0(18)**;实际编译源码 `c2818cbb1157093f80efd2a85cea0cf1509f565e`,Apple 公证 `5de714ac-dd28-4d2b-926f-6c0f424d0e5d`,Accepted,票据和 Gatekeeper 通过。后续文档和安装包提交不改变 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
|
||||
- 源码:`/Volumes/备份/大鱼调色/大鱼调色`;远程 `https://dayu.media/git/dayu/dayu-color.git`,main。
|
||||
- 主 ID `com.dayu.color`,XPC `com.dayu.color.XPC`。
|
||||
- 唯一正式 APP `/Library/Plug-Ins/FxPlug/大鱼调色.app`。
|
||||
- 固定缓存 `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color`;Xcode scheme `Wrapper Application`,Release。
|
||||
|
||||
父目录中的大鱼调色盘、CST、一级调色还原均为独立仓库;本轮仅只读参考 CST,没有改动其他产品。
|
||||
## 用户要求与实现
|
||||
|
||||
## 最新用户要求与已实现行为
|
||||
1. 大鱼 CST 输入转换 → 工作空间一级 → 输出转换已取代新实例的还原 LUT;三个阶段合并为一个一级调色卡片,曲线与色域独立选择。移除四个旁路选项,由一级眼睛统一启停。
|
||||
2. 一级白平衡改为原 CST 色轮,保留原图、+104° 方位、/5 精细拖动、圆形限幅、双击归零和 BASIS 强度平方×4,增加方向键微调。隐藏两根旧滑块;角度范围修正为 0–360°,旧值保持原解释。
|
||||
3. 直接移植父级“大鱼调色盘”的可变蜘蛛盘与 CPU/Metal 数学、固定、多选、同列联动、整环/整列及复位;点数 6/8/12/16/24,两轴可独立。中性盘精确直通,眼睛/混合独立,Cube 导出包含蜘蛛盘。
|
||||
4. 新实例与全部还原默认展开一级调色、蜘蛛盘校色仪、基础调整,其余折叠,所有眼睛开启。标题只折叠,小眼睛只启停,分别保存。用户“沉默展开”按“默认展开”实现。
|
||||
5. 蜘蛛盘完整网格、固定点、密度和联动状态随现有 DYAssetState 保存;预设 schema 3 写 JSON 网格,旧预设可读。旧阶段/旁路参数保留注册,仅打开旧工程不改变原画面;明确编辑 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/一级,不包含空间细节和逐画面统计。
|
||||
## 实现与来源
|
||||
|
||||
## 关键实现
|
||||
`DYNewPanels.inc.h` 是色轮/蜘蛛盘界面适配;`DYSpiderDisc.inc.h` 复用原盘交互,`SpiderCore` 复用原数学,`DYSpiderState.h` 管理归档与 JSON 验证。原 944 字节调色前缀和新增 CST 布局保持,控制尾部追加一级 master、蜘蛛 eye 和 mix。生产 shader 通过当前仓库内源码及已版本化 LLVM 重建。
|
||||
|
||||
`DYColorManagement.h` 保存原始控制与 CST/BASIS 参数换算;`DYCSTTypes.h` 是参考布局;`tools/kernels/CSTKernel.ll`、`BasisKernel.ll` 来自固定 CST 源码节点,摘要见 `research/CSTIntegration.json`。生产构建使用仓库内文件。
|
||||
参考仓库只读:大鱼 CST `973766b51dbcab3ab5092f1955d753575cd32d89`,大鱼调色盘 `f8950384e514685c8809fe8e8ee2dd5f16ad0bd7`。完整 SHA 摘要见 research/SpiderAndBalanceSources.json;边界见 research/SpiderAndBalanceIntegration.md。兄弟仓库和用户资料未改动。
|
||||
|
||||
`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/SpiderAndBalance.json:正式安装路径 198 项,含真实离屏 AppKit 鼠标事件、撤销配对、归档/preset、9 组原 CPU/生产 Metal 蜘蛛盘像素误差 0、Cube 和 21 组独立 CST 对照。
|
||||
- verification/SpiderMath.json:25 种网格、204,683 项,CPU/Metal 最大相对误差约 1.79e-6。
|
||||
- verification/InstalledSelfTest.json:正式版常规 155 项。
|
||||
- verification/HostSpiderAndBalance.json:FCP 12.4 实际面板、默认、键盘调整、菜单撤销/重做、联动及 12×8 密度、固定和整环、眼睛/折叠、保存重开通过,最后恢复默认。坐标注入未激活远程控件,宿主拖动/双击未确认;不能拿离屏事件冒充该项已验收。
|
||||
- verification/SpiderRecovery.json:实际编译节点远端独立克隆 168 文件,full/strict fsck,重建 Metal 摘要与正式库一致;临时 clone 已清理。
|
||||
|
||||
## 本轮验证
|
||||
Motion、Intel、旧系统和宿主逐像素导出一致性未验收。
|
||||
|
||||
- `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.3.0-spider-balance-20261101`,正式包 `../发行包/大鱼调色-1.3.0.pkg`。本版本 PKG 公证与 Release 下载校验以 verification/Package.json 和 verification/Release.json 为准。历史版本标签和附件保持。
|
||||
|
||||
## 后续交付与数据保护
|
||||
源码检查点:`python3 tools/checkpoint.py '<说明>' <路径...>`;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.3.0-spider-balance-20261101 --notes Packaging/Release-1.3.0.md`。入口自带适用锁,勿外层嵌套获取同锁。
|
||||
|
||||
本版本标签 `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 或改变产品固定身份。
|
||||
用户 LUT `~/Movies/大鱼调色LUT/look LUTs` 不导入、不删除、不打包。验收采用 tools/create_spider_host_fixture.py 生成的独立合成色卡和 1.12 DTD 校验,用户媒体和原有项目未编辑。完整恢复见 RECOVERY.md;凭据与签名私钥独立恢复。
|
||||
|
||||
## 1.2.0 正式 PKG
|
||||
|
||||
|
||||
在新工单中引用
屏蔽一个用户