docs: hand off dayu-color input LUT browser work with explicit project identity
这个提交包含在:
1 父节点
3e25549882
当前提交
76537da0a6
2 个文件已更改
+115
没有与搜索条件相匹配的文件
@@ -7,6 +7,7 @@
|
||||
- [分析与范围](research/ANALYSIS.md)
|
||||
- [Color Finale 移植研究与算法来源](research/ALGORITHM_SOURCES.md)
|
||||
- [恢复、依赖与正式交付](RECOVERY.md)
|
||||
- [大鱼调色 FxPlug4 交接与输入 LUT 浏览器待办](大鱼调色FxPlug4交接.md)
|
||||
- [GPU 数学来源与验证](tools/kernels/README.md)
|
||||
- [正式安装记录](verification/Delivery.json)
|
||||
- [LUT 后台加载的 FCP 验收](verification/HostLUTLoading.json)
|
||||
|
||||
+114
@@ -0,0 +1,114 @@
|
||||
# 大鱼调色 FxPlug4 输入 LUT 浏览器交接
|
||||
|
||||
更新时间:2026-11-01,Asia/Shanghai。
|
||||
|
||||
本次接手对象为 **大鱼调色**,主 Bundle ID 为 `com.dayu.color`,源码仓库为 `dayu/dayu-color`。当前正式安装及 Release 为 **1.1.5(16)**。下一项工作是用户反馈的“输入 LUT 的缩略图浏览器不可用”;该问题尚未修复,须先在正式安装版本的 Final Cut Pro 中复现,再完成优化和正式交付。
|
||||
|
||||
## 项目身份与目录
|
||||
|
||||
`/Volumes/备份/大鱼调色` 是包含多个独立工程的父目录。开始工作时进入下表中的当前源码根目录,提交前核对远程与 Bundle ID。
|
||||
|
||||
| 项目 | 本次大鱼调色 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` |
|
||||
|
||||
“大鱼调色 FxPlug4”是本交接用于辨认工程的名称;产品名称、Bundle ID 和正式安装路径继续保持上表中的固定值。父目录内还有“大鱼CST”“大鱼一级调色还原”,各自属于独立工程。不要在父目录初始化或提交混合仓库,也不要改动“大鱼调色盘”的交接、源代码、用户数据和发行记录。
|
||||
|
||||
本项目 Xcode 工程为 `/Volumes/备份/大鱼调色/大鱼调色/大鱼调色.xcodeproj`,方案为 `Wrapper Application`,界面使用 AppKit,内部为独立 XPC 插件。源文件位于源码根下的 `大鱼调色/Plugin/`。本地 `.git` 指向 APFS 上的 Git 元数据,恢复时按 [RECOVERY.md](RECOVERY.md) 处理。
|
||||
|
||||
FCP 效果入口是“大鱼调色”分类下的“大鱼调色”,模板位置为:
|
||||
|
||||
```text
|
||||
/Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef
|
||||
```
|
||||
|
||||
## 当前源码与正式发行
|
||||
|
||||
交接开始时工作区干净,分支 `main`,远程 `origin` 为 `https://dayu.media/git/dayu/dayu-color.git`,本地与远端主分支一致。
|
||||
|
||||
| 节点 | 值 |
|
||||
| --- | --- |
|
||||
| 交接前源码头及发布记录标签 | `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。
|
||||
|
||||
```text
|
||||
本地正式包:/Volumes/备份/大鱼调色/发行包/大鱼调色-1.1.5.pkg
|
||||
大小:13,752,153 字节
|
||||
SHA-256:bf2a4acc57a3c08176be0f317c90551120bfcfb21a7224a690191884c8a3d071
|
||||
```
|
||||
|
||||
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,保留已有版本。
|
||||
|
||||
## 已完成且需要保持的行为
|
||||
|
||||
- 五套主题跨实例记忆;程序图标与 FCP 效果缩略图统一为光谱鱼。
|
||||
- 所有调色分组展开即启用、折叠即停用并隐藏参数;新实例及全部还原仅展开基础调节。折叠保留数值和 LUT 路径,恢复已存工程时按实际启用状态展开。
|
||||
- 支持 17 种内置相机输入转换、自选输入 LUT,以及五层风格 LUT。停用的输入或风格组旁路渲染并停止加载对应文件。
|
||||
- LUT 扫描、校验、复制、解析和缩略图生成在后台逐项执行;导入可取消,失败或取消只回滚本轮新增副本,保留既有库。浏览器只为可见范围创建控件。
|
||||
- 点击外部 LUT 后先在后台解析并准备 GPU 资源,宿主接受后才确认选择;快速切换只应用最后一次请求,已选表独立保留以抵抗预览缓存淘汰。
|
||||
- Cube 支持 UTF-8、UTF-16/32 大小端、有无 BOM,以及 ASCII 指令下旧编码标题与注释。后台转换工作副本,保留原件和导入副本字节;非法编码、尺寸和数字仍严格报错。
|
||||
|
||||
既有证据包括 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)。
|
||||
|
||||
这些记录主要覆盖风格 LUT 库和共用加载链,不能替代此次输入 LUT 浏览器的专项验收。用户最新反馈应独立复现并记录。
|
||||
|
||||
## 输入 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),保留现有来源区分和许可证记录。
|
||||
在新工单中引用
屏蔽一个用户