release: deliver 1.2.0 CST and independent module disclosure with verified signed installer
这个提交包含在:
1 父节点
48b00c8579
当前提交
c2c65aaaff
11 个文件已更改
+319
-202
没有与搜索条件相匹配的文件
+34
-92
@@ -1,114 +1,56 @@
|
||||
# 大鱼调色 FxPlug4 输入 LUT 浏览器交接
|
||||
# 大鱼调色 FxPlug4:CST 与独立折叠交接
|
||||
|
||||
更新时间:2026-11-01,Asia/Shanghai。
|
||||
|
||||
本次接手对象为 **大鱼调色**,主 Bundle ID 为 `com.dayu.color`,源码仓库为 `dayu/dayu-color`。当前正式安装及 Release 为 **1.1.5(16)**。下一项工作是用户反馈的“输入 LUT 的缩略图浏览器不可用”;该问题尚未修复,须先在正式安装版本的 Final Cut Pro 中复现,再完成优化和正式交付。
|
||||
当前正式 APP 为 **1.2.0(17)**,已通过公证、唯一安装及 FCP 宿主验收。实际编译源码 `48b00c85799b0226ba32aba3f2e5397aa0e509ed`,公证 `f25ae46e-92da-4470-842e-128bdb232aa8`。后续文档、打包和 Release 记录不改变 APP 编译来源。
|
||||
|
||||
## 项目身份与目录
|
||||
## 项目身份
|
||||
|
||||
`/Volumes/备份/大鱼调色` 是包含多个独立工程的父目录。开始工作时进入下表中的当前源码根目录,提交前核对远程与 Bundle ID。
|
||||
- 当前源码:`/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
|
||||
|
||||
| 项目 | 本次大鱼调色 FxPlug4 | 另一个项目大鱼调色盘 |
|
||||
| --- | --- | --- |
|
||||
| 固定产品名 | 大鱼调色 | 大鱼调色盘 |
|
||||
| 源码根目录 | `/Volumes/备份/大鱼调色/大鱼调色` | `/Volumes/备份/大鱼调色/大鱼调色盘` |
|
||||
| Git 仓库 | `https://dayu.media/git/dayu/dayu-color.git` | `https://dayu.media/git/dayu/dayu-colorplate.git` |
|
||||
| 主 Bundle ID | `com.dayu.color` | `com.dayu.colorplate` |
|
||||
| 插件服务 ID | `com.dayu.color.XPC` | `com.dayu.colorplate.fxplug` |
|
||||
| 唯一正式 APP | `/Library/Plug-Ins/FxPlug/大鱼调色.app` | `/Library/Plug-Ins/FxPlug/大鱼调色盘.app` |
|
||||
| 本次交接时安装版本 | 1.1.5(16) | 2.0.0(68) |
|
||||
| 固定构建缓存 | `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color` | `/Users/mac/Library/Caches/CodexBuilds/com.dayu.colorplate` |
|
||||
父目录中的大鱼调色盘、CST、一级调色还原均为独立仓库;本轮仅只读参考 CST,没有改动其他产品。
|
||||
|
||||
“大鱼调色 FxPlug4”是本交接用于辨认工程的名称;产品名称、Bundle ID 和正式安装路径继续保持上表中的固定值。父目录内还有“大鱼CST”“大鱼一级调色还原”,各自属于独立工程。不要在父目录初始化或提交混合仓库,也不要改动“大鱼调色盘”的交接、源代码、用户数据和发行记录。
|
||||
## 最新用户要求与已实现行为
|
||||
|
||||
本项目 Xcode 工程为 `/Volumes/备份/大鱼调色/大鱼调色/大鱼调色.xcodeproj`,方案为 `Wrapper Application`,界面使用 AppKit,内部为独立 XPC 插件。源文件位于源码根下的 `大鱼调色/Plugin/`。本地 `.git` 指向 APFS 上的 Git 元数据,恢复时按 [RECOVERY.md](RECOVERY.md) 处理。
|
||||
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/一级,不包含空间细节和逐画面统计。
|
||||
|
||||
FCP 效果入口是“大鱼调色”分类下的“大鱼调色”,模板位置为:
|
||||
## 关键实现
|
||||
|
||||
```text
|
||||
/Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef
|
||||
```
|
||||
`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 都保留透明度与预乘处理。
|
||||
|
||||
交接开始时工作区干净,分支 `main`,远程 `origin` 为 `https://dayu.media/git/dayu/dayu-color.git`,本地与远端主分支一致。
|
||||
`DYInspectorToken` schema 2 新增 folds 字典;`toggleSection:` 只写字典,`groupEnabled:` 只写启用参数。`DYModel.mm` 定义 3 个 CST 阶段和所有新默认。输入与工作/输出的曲线、色域按稳定数学 ID 保存,不使用菜单位置代替 ID,选择参数不插值。
|
||||
|
||||
| 节点 | 值 |
|
||||
| --- | --- |
|
||||
| 交接前源码头及发布记录标签 | `3e2554988287d1c3ce423280fac87112488bb635`,`v1.1.5-release-published-20261101` |
|
||||
| 当前正式发行标签 | `v1.1.5-lut-encoding-20261101` |
|
||||
| 发行标签完整提交 | `06968514fc5205a83fbf3c5a3dbb1be0f6f3e79b` |
|
||||
| APP 实际编译源码 | `59b058a3c8b9e5387381574da6bbc05af437527c` |
|
||||
| APP 公证 | `b47b6fe8-b7a9-4112-93b9-de85b03ca598`,Accepted |
|
||||
| PKG 公证 | `90a38636-93bb-4693-8db2-16b9a815e409`,Accepted |
|
||||
## 本轮验证
|
||||
|
||||
正式安装包已发布到 [大鱼调色 1.1.5 Release](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.1.5-lut-encoding-20261101)。Release ID 为 `355`,附件 ID 为 `8`,状态为已发布;完整下载已核对字节数和 SHA-256。
|
||||
- `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、唯一登记与宿主路径。
|
||||
|
||||
```text
|
||||
本地正式包:/Volumes/备份/大鱼调色/发行包/大鱼调色-1.1.5.pkg
|
||||
大小:13,752,153 字节
|
||||
SHA-256:bf2a4acc57a3c08176be0f317c90551120bfcfb21a7224a690191884c8a3d071
|
||||
```
|
||||
像素对照是指定 GPU/样本的原生运算检查,宿主记录是实际界面与保存检查;没有宣称所有宿主逐像素等同。未验收 Motion、Intel 和旧系统。
|
||||
|
||||
APP 已完成 Developer ID 签名、公证、票据、Gatekeeper、正式安装及宿主验收。PKG 已完成 Installer 签名、公证、票据及 20 项真实展开验包;包内 APP 与已验收正式安装一致,生成包后未重复执行 PKG 安装。详细记录见 [Delivery.json](verification/Delivery.json)、[Package.json](verification/Package.json) 和 [Release.json](verification/Release.json)。
|
||||
## 后续交付与数据保护
|
||||
|
||||
交接文件提交会产生后续文档节点,不改变上述实际编译来源和发行标签。新功能交付时递增版本与构建号,创建新的标签和 Release,保留已有版本。
|
||||
本版本标签 `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`。各脚本已管理适用锁,外层不要重复获取。
|
||||
|
||||
- 五套主题跨实例记忆;程序图标与 FCP 效果缩略图统一为光谱鱼。
|
||||
- 所有调色分组展开即启用、折叠即停用并隐藏参数;新实例及全部还原仅展开基础调节。折叠保留数值和 LUT 路径,恢复已存工程时按实际启用状态展开。
|
||||
- 支持 17 种内置相机输入转换、自选输入 LUT,以及五层风格 LUT。停用的输入或风格组旁路渲染并停止加载对应文件。
|
||||
- LUT 扫描、校验、复制、解析和缩略图生成在后台逐项执行;导入可取消,失败或取消只回滚本轮新增副本,保留既有库。浏览器只为可见范围创建控件。
|
||||
- 点击外部 LUT 后先在后台解析并准备 GPU 资源,宿主接受后才确认选择;快速切换只应用最后一次请求,已选表独立保留以抵抗预览缓存淘汰。
|
||||
- Cube 支持 UTF-8、UTF-16/32 大小端、有无 BOM,以及 ASCII 指令下旧编码标题与注释。后台转换工作副本,保留原件和导入副本字节;非法编码、尺寸和数字仍严格报错。
|
||||
用户 LUT 在 `~/Movies/大鱼调色LUT/look LUTs`;本轮读取 N12 的 26 项测试选择,无新导入、无删除,验收实例最后全部还原。用户媒体、原有项目、收藏和偏好不进入 Git/包。`tools/create_cst_host_fixture.py` 只生成产品缓存中的合成验收资源;FCPXML 技能校验使用精确 1.12 DTD,通过无警告。
|
||||
|
||||
既有证据包括 179 项编码检查、112 项 LUT 库检查、67 项浏览器状态检查,以及 FCP 12.4 中 16 份混合编码样本的导入、预览、逐项应用和保存重开。N12 的 26 个实际 LUT 曾完成目录导入与渲染验收。入口见 [LUTEncoding.json](verification/LUTEncoding.json)、[HostLUTEncoding.json](verification/HostLUTEncoding.json)、[ExternalLUTActivation.json](verification/ExternalLUTActivation.json)、[HostExternalLUT.json](verification/HostExternalLUT.json)、[LUTResponsiveness.json](verification/LUTResponsiveness.json)。
|
||||
恢复完整步骤及历史节点见 `RECOVERY.md`。当前 AppKit 项目无需引入 SwiftUI 或改变产品固定身份。
|
||||
|
||||
这些记录主要覆盖风格 LUT 库和共用加载链,不能替代此次输入 LUT 浏览器的专项验收。用户最新反馈应独立复现并记录。
|
||||
## 1.2.0 正式 PKG
|
||||
|
||||
## 输入 LUT 浏览器的代码线索
|
||||
|
||||
以下为交接时静态读取源码得到的现状,尚未据此确认宿主中的故障根因。
|
||||
|
||||
| 入口 | 当前行为与排查价值 |
|
||||
| --- | --- |
|
||||
| `大鱼调色/Plugin/DYInspector.mm`,`assetRowForKey:title:inCard:`、`layout` | 输入行也创建 `browse` 网格按钮,但布局对 `key == input` 执行隐藏。风格 LUT 行显示网格按钮。 |
|
||||
| 同文件,`chooseAsset:` | 输入下拉菜单包含 17 种内置相机转换,以及“缩略图浏览库…”和“载入 LUT 文件…”。菜单结束后异步执行待处理命令。 |
|
||||
| 同文件,`performAssetMenuCommand:`、`browseAsset:` | 从输入菜单进入浏览器仍传入输入行隐藏的 `browse` 按钮。优先请求 `FxRemoteWindowAPI`;取不到宿主父视图时,使用该按钮作为 Popover 锚点。应优先复核隐藏锚点和宿主回调是否导致窗口未出现。 |
|
||||
| `大鱼调色/Plugin/DYLUTBrowser.mm`,`showRelativeToView:`、`showInRemoteParent:close:` | 浏览器由宿主远程窗口或锚定 Popover 承载;Popover 展示异常会关闭浏览器。检查实际采用的承载方式、锚点可见性、关闭及重新打开的生命周期。 |
|
||||
| `大鱼调色/Plugin/DYLUTLibrary.mm`,`defaultRootURL` | 现有默认库固定为 `/Users/mac/Movies/大鱼调色LUT/look LUTs`;输入与风格入口共用 `_library`。内置相机转换在菜单中列出,未作为独立浏览库条目接入。 |
|
||||
| `大鱼调色/Plugin/DYLUTBrowser.mm`,偏好常量 | 目录和尺寸偏好使用 `com.dayu.color.lookLUTPreview.*`。若新增独立输入库或输入浏览模式,需审查目录过滤与偏好复用是否会造成空列表或串状态。 |
|
||||
| `大鱼调色/Plugin/DYInspector.mm`,`browseAsset:`、`previewChanged:` | 所有浏览器都接收 `[_renderer lookLUTPreview]`,当前未区分输入与风格用途。 |
|
||||
| `大鱼调色/Plugin/DYRenderer.mm`,`renderSource:destination:uniforms:paths:error:` | 现有预览通过 `dyInputAnalysis` 生成,已应用当前输入 LUT;它适合风格 LUT 候选预览。输入候选若继续套在该帧上,需排查重复输入转换。应设计输入转换前的专用源帧,并保持图像上下方向及自动分析数据语义。 |
|
||||
| 同文件,`textures:uniforms:entry:error:` | 外部路径 `paths[input]` 优先;没有路径时才按 `inputProfile` 加载内置 `.dylut`。清除外部路径会使仍保留的内置档位重新生效,须明确“无 LUT”与“无输入转换”的界面含义。 |
|
||||
| `DYInspector.mm`,`setAssetPath:forKey:completion:`、`commitAssetPath:forKey:error:` | 输入选择写入 `DYAssetState.paths[input]`;异步准备和宿主确认已共用。复核选择、清除、失败回退、内置档位、启用状态和撤销重做能否一致保存。 |
|
||||
|
||||
`DYLUTLibrary.h` 中已有异步加载 API 和不可变 `DYLUTPreparedTable`,读取器支持内置 `.dylut`。内置资源位于 `大鱼调色/Plugin/Resources/InputLUTs/`,清单为 `manifest.json`;相机名称及档位在 `DYModel.mm`,`inputProfile` 宿主参数 ID 为 `2013`。
|
||||
|
||||
下一轮可复用共用浏览器和异步准备能力,按输入用途明确条目、源帧与选择状态。避免为输入入口另写一套同步解析链。
|
||||
|
||||
## 下一轮执行与验收
|
||||
|
||||
1. 核对本项目根目录、远程、分支、未提交改动、正式安装版本和交付锁;保护其他聊天的工作。先在 FCP 独立合成工程中展开“输入 / LUT”,从“输入色彩”下拉菜单打开“缩略图浏览库…”,记录不可用具体表现:未弹出、空列表、无图、不可点击、选择后未生效或宿主卡住。
|
||||
2. 以风格 LUT 浏览器作为同一正式版本的对照,核查隐藏锚点、远程窗口回调和 Popover 后备路径。记录实际宿主路径和错误,确认最小修复范围。
|
||||
3. 明确输入浏览器应显示的内置转换与用户 LUT;保留已有风格库、收藏和偏好。输入预览使用合适的转换前源帧,避免已转换画面再次套用输入 LUT。
|
||||
4. 保持后台逐项加载、可取消、可见范围预览、最后一次选择生效及宿主确认后更新选择。补充有区分度的状态和预览检查,不为纯布局变更重复编写镜像测试。
|
||||
5. 在正式安装的已公证新版中验收:新实例仅基础调节展开;输入展开后可打开、关闭、重复打开浏览器;内置转换和外部 Cube 的缩略图、选择与实际画面一致;输入强度、无转换、失败回退、快速切换、导入取消、撤销重做及正常重开保留正确。选择不同当前输入时,候选预览不重复套用旧输入转换。回归风格五层和原有 LUT 库。
|
||||
6. 更新专项证据,建议新增 `verification/HostInputLUTBrowser.json`,记录版本、源码、复现步骤、实际窗口承载方式、验收项目和结果;该文件目前尚未生成。完成正式构建、签名、公证、唯一安装、宿主验收、PKG、Release 附件下载校验及远程恢复验证。
|
||||
|
||||
本轮只生成交接文档和 README 入口,没有修改功能、重新构建 APP、运行新的宿主验收或重新打包。下一版本号在实施时确认,当前 1.1.5(16)仍为正式基线。
|
||||
|
||||
## 数据保护与交付入口
|
||||
|
||||
用户 LUT 位于 `/Users/mac/Movies/大鱼调色LUT/look LUTs`,真实源样本目录为 `/Volumes/备份/N12精选luts`。先前验收保留原有 4 个与 N12 导入的 26 个 LUT;接手时以当前实际文件为准。用户文件、收藏、预设、宿主资料库和媒体单独保护,不纳入源码、安装包或合成测试清理。测试副本只按本轮来源与摘要识别;正常退出宿主并保留用户改动,需要强制退出时针对当前现场另行取得授权。
|
||||
|
||||
交付使用团队 `B3W25FX5H5` 的有效 Developer ID Application 和 Installer,公证 profile 为 `codex-dayu-notary-B3W25FX5H5`。每轮复核证书有效性,凭据留在系统钥匙串。
|
||||
|
||||
- APP 交付:在本项目根目录运行 `python3 tools/deliver.py`。脚本持有 `/Users/mac/.codex/app-delivery-locks/com.dayu.color.lock`,覆盖最终构建至宿主验收和清理;已有锁时不要重复获取。用户可见验收从唯一正式安装路径启动。
|
||||
- 模型或注册参数改变时:审查并运行 `python3 tools/build_template.py --refresh-model --overwrite`。纯浏览界面修改不自动改模型和模板。
|
||||
- PKG:使用 `/Users/mac/.codex/skills/pkg-forge/SKILL.md`,入口 `python3 Packaging/build_pkg.py --pkg-forge-repo /Users/mac/Documents/dayu-git/repositories/pkg-forge`;可先加 `--prepare-only`。APP 的编译、签名和公证先完成。
|
||||
- Release:使用 `python3 Packaging/publish_release.py --tag <新版本标签> --notes <对应版本说明>`,由 PKG 技能上传器先准备草稿、下载校验后发布。同名附件一致则复用,冲突停止;不覆盖旧附件或移动旧标签。API 凭据来自钥匙串 `dayu-git-api`,不复制令牌到文档、参数或日志。
|
||||
- 源码保存:遵守本机全局 AGENTS,按仓库共享锁提交并推送。可用 `python3 tools/checkpoint.py '<提交说明>' <已审查文件路径...>`;该入口已管理本仓库 Git 锁,不要在外层重复持有同一把锁。正式包由 `.gitignore` 排除,放到版本 Release 附件。
|
||||
|
||||
恢复方法、依赖和历史验证见 [RECOVERY.md](RECOVERY.md);算法真实来源与许可见 [research/ALGORITHM_SOURCES.md](research/ALGORITHM_SOURCES.md),保留现有来源区分和许可证记录。
|
||||
正式包 `../发行包/大鱼调色-1.2.0.pkg`,13,818,397 字节,SHA-256 `9fba4f0c1a313a6da8374b683f7e6b41af70388d7a7a180e26b9e236a9ba64a1`。PKG 公证 `c7b97b0f-57c8-45d3-a4d7-7db8e8694487`,Accepted;Installer 团队 B3W25FX5H5、票据、Gatekeeper 及 20 项展开验包通过。包内 APP 与已验收正式安装一致,未重复运行安装器。
|
||||
在新工单中引用
屏蔽一个用户