文件
dayu-color/大鱼调色FxPlug4交接.md
T

18 KiB
原始文件 Blame 文件历史

大鱼调色开发交接

交接日期:2026年11月4日,Asia/Shanghai;本机用户 mac,Mac mini M4。新对话从已交付的 1.8.2(59) 继续开发。色彩管理修正、黑金界面、签名公证、正式安装、PKG和Release均已完成,没有挂起的发布步骤;下一轮具体优化以用户的新需求为准。

先读本文件、README和恢复说明。开发与交付遵循 /Users/mac/.codex/AGENTS.md 及用户最新说明。旧交接已逐字节归档到1.7.3及之前历史,其中旧版本号、检查数量和原始规划不是当前状态。

工程和正式版本

项目 已核验内容
实际工程根目录 /Volumes/备份/大鱼调色/大鱼调色,有两层“大鱼调色”
工程和方案 根目录下 大鱼调色.xcodeproj;Wrapper Application,Release
平台 Apple Silicon,最低macOS14.6;本机Xcode27.1、FxPlug SDK4.3.5、Metal Toolchain
唯一正式APP /Library/Plug-Ins/FxPlug/大鱼调色.app,1.8.2(59)
Bundle ID 外层 com.dayu.color;服务 com.dayu.color.XPC
内部服务 /Library/Plug-Ins/FxPlug/大鱼调色.app/Contents/PlugIns/大鱼调色 XPC Service.pluginkit
固定构建缓存 /Users/mac/Library/Caches/CodexBuilds/com.dayu.color
正式模板 /Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef
远程和分支 https://dayu.media/git/dayu/dayu-color.git,main,保持现有可见性
实际编译源码 da03d16c7efa87a5d230467334ec73f9a3a12e54
发行标签 v1.8.2-blackgold-20261104
标签提交 f4bacfbd75404a69f51127356fc861a44c0c27e9
交接整理前main 504e6d98e3a820cc7a896db0a32cd6dcc5741081,已推送核验;本交接另作后续提交,接手时读取实际HEAD

无LFS或子模块。OCIO2.5.2 / ACES1.3 studio-config v2.2.0及8个锁定依赖源码归档保存在仓库;私钥和认证不进Git。外置卷会产生 ._* 元数据文件,不要混入提交。

用户确定的产品要求

  • 高级色彩管理收进独立“颜色设置”按钮,普通用户默认看不到说明区;收起后不留空白。
  • 默认继续“原有流程”。已保存的nil、v2、v3工程保持各自处理,展开界面不能改写状态或产生调色撤销项。
  • 一级CST的输入、工作曲线/色域、输出必须生效。用户明确反对先将Log素材显示还原为Rec.709,再让后续一级转换失去意义。
  • 黑金为新增默认配色:黑色和深色渐变背景、亮金文字、柔和光晕,保留原来五种主题。
  • 产品名称、Bundle ID和正式路径保持稳定。用户可见验收使用正式安装位置的已公证版本。

1.8.2界面实现

检查器为 AppKit / Objective-C++,不是SwiftUI。采用FxPlug原位展开区域,没有新增浮动设置窗口。

顶部四个按钮为保存预设、载入预设、导出LUT、颜色设置。宽度小于320时排成两行;六枚主题色块占原标题区,窄栏隐藏版本小字以免重叠。

_colorSettingsExpanded 是检查器实例内的临时布尔状态。打开和关闭不写模型、不产生宿主撤销项;新建检查器默认收起。隐藏的 DYManagedColorPanel 不参与布局高度。说明已缩短,完整条件在工具提示中。

主题ID0–4依次为深空灰、冰川蓝、薰衣草紫、翡翠绿、琥珀橙;追加ID5黑金渐变。偏好域 com.dayu.color.preferences、键 themeIndex。没有明确保存偏好或索引非法时使用5;明确保存过的旧选择保留。本机已经通过界面选中黑金。

黑金背景为不透明静态渐变,金色细边与亮金文字。NSShadow模糊半径1.8、alpha0.30;系统增加对比度或减少透明度时去掉光晕。色轮、通道曲线和媒体预览保留真实色相。

候选58在FCP实机发现“添加模块”标题漏绘:pullsDown菜单的selectedItem可能为nil。正式59从第一项取标题,并增加实际像素绘制检查。候选58已回滚清理,未制作或发布安装包。后续改共用控件时保留普通按钮、弹出选择器和下拉菜单的差别。

入口 职责
DYInspector.mm 顶部按钮、展开状态、卡片、参数控件和窄栏布局
DYManagedColorPanel.mm 色彩方式、帮助、输入输出字段及有撤销的状态写入
DYTheme.h、DYTheme.mm 六主题、动态颜色、渐变、光晕、共用AppKit控件
DYCompactUIDiagnostics.inc.h 隐藏高度、模型不变、三栏宽、主题、对比度、文字绘制
界面约定 本轮需求及实现选择

色彩管理的当前合同

完整预设格式仍为v7,色彩管理有独立版本。全局方式和一级可见参数各自的责任不要混淆。

状态 界面方式 行为
nil 原有流程(默认) 保留历史链,不自动迁移
v2 mode1–3 1.8兼容,跟随FCP、相机或LUT输入 固定ACEScct/AP1,保护1.8.0已存画面
v3 mode4 一级CST · 延后输出 采用原一级输入、工作域和输出,主输出放在一级层与印片之后

v3严格状态为:

{"version":3,"mode":4,"engine":"Dayu-CST-f32","config":"primary-parameters-v1"}

v3主链:声明的素材编码 → 一级输入CST → 所选工作域一级调色 → 独立一级层 → 印片 → 主输出CST及可选映射 → SDR修饰 → 实际宿主空间。主输入做曲线与色域转换,不先做Rec.709显示映射。工作空间由原一级工作曲线和工作色域选择,可用DWG/DaVinci Intermediate、ACEScct/AP1等现有组合。

新增独立一级默认继承主工作空间,输入和输出相同、额外映射关闭。primaryFollow 为输入/工作/输出三段跟随位,初始7;手动更改某段曲线或色域后该段退出跟随。主工作域变化时,将跟随值写入作者状态,并形成一个宿主撤销组。渲染使用可见参数,不能暗中覆盖。局部CST后按声明的输出域回到主工作域,混合和蒙版在AP1线性中执行。

印片按需要往返ACEScct/AP1再返回用户工作域。新流程CST/BASIS边界和图像传输为float32;线性工作曲线有明确DI适配。新流程Cube为65³,保留一级声明的输入/输出Gamma或Log编码。旧兼容方式有不同导出合同,不要混用。

旧基础、HSL等工具仍作为输出后的SDR修饰,没有全部改成场景域或HDR算法。Log/线性码值输出拒绝活跃的SDR修饰;停用项和强度为零的LUT不能误触发拒绝。FxPlug接收到的是上游FCP像素,无法恢复相机LUT、颜色符合或上游裁切已丢失的信息。显式sRGB编解码桥可以是可逆码值载体,不能单凭出现该公式判定链路错误。

**模板兼容教训:**1.8.1候选56只改模板dataValue,即便defaultVal和原生注册缺省仍为nil,实际FCP也将旧nil实例改成v3。自动启用已回滚,候选56未发布安装包。当前模板与注册缺省均保留原nil,新流程由用户明确选择。不要为了默认启用v3再次直接改模板归档。

入口 用途
DYManagedColor.mm 状态校验、v3默认值和独立层跟随
DYPrimaryRender.inc.h v3工作域、顺序、主输出及SDR接续
DYPrimaryKernels.inc.h v3内核与边界
DYManagedRender.inc.h v2兼容链
DYRenderer.mm 管线分派、Cube与宿主接入
DYPrimaryDiagnostics.inc.h 高光、局部CST、线性域、负值、导出与旧链回归
float_air_boundary.py float32入口出口生成,原入口保留
1.8.1修正设计 当前设计依据与模板问题
三款插件调查 历史只读分析,当时待办不能直接当作当前未完成项

此前调查对象为 /Library/Plug-Ins/FxPlug/BASIS.app、/Library/Plug-Ins/FxPlug/Colour Space Transform.app、/Applications/ColorFinale.app。已交付运行时不依赖这三款APP或研究缓存。继续研究发行二进制时使用reverse-engineer-anything技能;普通大鱼源码开发直接读仓库。

验证结果和边界

1.8.2正式安装版595项原生检查通过,含1.8.1的581项及14项界面检查。FCP12.4实机检查六种主题、10次开关、关闭不留空白、原nil项目仍为原流程、v3保持、添加模块菜单可打开及Escape关闭;冷重开后黑金保留、设置收起。

更新前、操作后和冷重开后三份完整v3预设均为8,590字节、逐字节一致,SHA-256为 1f05b3e350dd5fbc054de155062aff87fdd4d46c6a762ee06650ad5bd3363982。1.8.2没有改渲染算法、模板或预设格式。

1.8.1另有独立高光参考、负值/超白、局部CST、独立层跟随与撤销重做、两代预设、65³ Cube、1080p25四秒100帧ProRes、两个项目XML1.12回读。受控宿主Log样本为带sRGB标签的16-bit PNG码值载体,不代表任意真实相机的上游路由或完整HDR监看链。1.8.2实际FCP为正常栏宽,280/320/400布局由原生假宿主验证;没有切换系统辅助显示选项。

独立远程克隆Release重建通过595项,8个依赖归档的大小和摘要通过;复用已验证静态依赖缓存,没有全依赖冷构建。最终标签独立检出,编译输入与实际编译提交一致。临时恢复目录、生成APP、旧安装备份、提交ZIP和浏览器下载副本均已清理。

证据 文件
正式安装、签名、公证及实际源码 Delivery.json
595项原生结果 InstalledSelfTest.json
当前FCP验收 HostCompactUI1.8.2.json
CST数值与宿主 PrimaryCSTNumerical1.8.1.json、HostPrimaryCST1.8.1.json
独立恢复与清理 CompactUIRecovery1.8.2.json、CompactUICleanup1.8.2.json
安装包及下载 Package.json、Release.json

发布与恢复

发行包 /Volumes/备份/大鱼调色/发行包/大鱼调色-1.8.2.pkg,43,006,067字节,SHA-256为 cbabffc620ad851bd8ecddfaf797c46689722d0f772be409aaa29d0841a2eded。在线Release383,附件27,保留公测标记。草稿和发布后完整下载均已校验。

APP公证 11fcf84b-680e-415e-87d2-bcf4ee8cdb78;PKG公证 26361685-6bdd-4c59-bc2c-4824ea190e05,均Accepted并完成票据验证。PKG通过20项展开验包;APP已独立替换和宿主验收,本轮没有再次运行PKG系统安装脚本。

标签包含本版最终Package.json,发布后的Release.json在后续main。标签内旧Release.json属于上一版历史。实际编译、标签、最终文档提交不同,不移动标签或改写历史来强求SHA一致。

签名团队B3W25FX5H5,Application/Installer身份为zhong luo;当前证书有效至2027年2月2日06:12:15(上海),发布时重新核实身份、私钥与有效期。公证profile为 codex-dayu-notary-B3W25FX5H5,钥匙串 /Users/mac/Library/Keychains/login.keychain-db。不打印或提交凭据,密钥恢复按全局规则。

下一轮开发步骤

接手先核对工作区、分支、远程、正式版本和用户新需求。交接整理前工作区干净、main已推送。本轮只更新文档,不重编APP。若收到新截图或问题,在当前实现上定位,避免照旧交接重做已完成的CMS或自动更新。

  1. 读取全局及新增项目规则,保护其他对话的修改,先保存本任务基线。
  2. 使用checkpoint.py提交明确审查过的路径,参数为提交说明和路径;脚本持有仓库锁、推送并核验main,不在外层重复持有同一锁。
  3. UI修改验证正常/窄栏、主题、展示不改参数和撤销。渲染修改按问题补数值与宿主验证,保护nil/v2/v3。更改模型才按需要刷新模板,不能借刷新自动启用v3。
  4. 新发布更新外层与内部Info.plist版本和构建,当前为1.8.2(59)。正常保存退出FCP/Motion,不能强杀有未保存工作的宿主。
  5. 在工程根目录以保持输入会话的终端运行 python3 tools/deliver.py。它完成Release、签名、自检、公证、票据、正式替换和发现路径核验。保持HEAD固定直到Delivery.json记录实际sourceCommit。
  6. 显示FORMAL_INSTALLED后,在正式位置验收。全部通过才向原会话输入 complete;leave仅保留待验收状态。complete会重写Delivery.json,之后补本版hostVerification路径;失败保留诊断并按可恢复流程处理旧版。
  7. python3 Packaging/build_pkg.py使用PKG工坊制作签名公证包和展开验包。要求Delivery.json为verified,拒绝覆盖已有同版发行包;验包不等于执行系统安装脚本。
  8. 提交推送记录并创建新的不可变版本标签;python3 Packaging/publish_beta.py --tag <新标签> --notes <本版说明文件>创建草稿、上传及下载校验。脚本自带仓库锁。
  9. 遇到draft-download-required,先确认附件已存在,别重复POST。用已登录Edge打开API返回的真实附件URL;本机下载目录为 /Volumes/备份。用独立副本传 --verified-download,通过后发布并再次完整下载校验,记录真实URL、附件ID和摘要。
  10. 独立验证远程源码/标签恢复,清理本任务生成的APP、提交ZIP、旧安装备份和验证副本;保留正式包、源码、历史发行包与私人QA资料。提交推送最终记录并核验远端引用。

完整路径入口:deliver.py、build_pkg.py、publish_beta.py。这些命令均在上述工程根目录执行,不能将构建缓存当源码。

产品锁为 /Users/mac/.codex/app-delivery-locks/com.dayu.color.lock;Git锁在 /Users/mac/.codex/git-backup-locks,以不含凭据的小写完整HTTPS仓库地址SHA-256命名。先核对owner.json进程,不能删除仍在工作的锁。

正式服务可执行文件加 --self-test 可做无界面检查: /Library/Plug-Ins/FxPlug/大鱼调色.app/Contents/PlugIns/大鱼调色 XPC Service.pluginkit/Contents/MacOS/大鱼调色 XPC Service。构建目录只做编译与原生无界面检查,用户可见功能验收使用正式已公证位置。Xcode会登记生成内部服务,独立恢复构建在宿主关闭时执行,随后解除生成副本登记,避免宿主误载。

本机验收资料与后续范围

私人资料位于 /Users/mac/Library/Caches/CodexBuilds/com.dayu.color/fcp-qa,不进Git或PKG。资源库为该目录下 大鱼调色_验收.fcpbundle;本轮项目为1.8.1_Log高光恢复和1.8.1_工作空间与独立层。项目名称不保证当前参数值,比较应以实际完整预设为准。

三份一致预设为该目录的ui58-before.json、ui59-after.json、ui59-cold-reopened.json。较早Cube、ProRes和XML的范围见1.8.1记录。缓存不是远程恢复资源,合成素材可由原生诊断和create_primary_host_fixture.py重建。

交付结束时FCP为黑金、颜色设置收起,QA项目为1.8.1_Log高光恢复。此前Motion文稿已恢复打开,未编辑。新对话重新获取当前窗口和进程,不沿用历史UI元素编号、PID或工具会话。

真实相机Log上游路由、HDR/SDR工具域、更广宿主版本及界面细节均可作为后续方向,用户尚未指定优先级。不要把“所有工具已场景化”或“任意HDR链已验证”当作现状。

主APP自动更新与云端公测诊断已在1.7.0实现;登录、授权、业务加密尚未实施,详见主APP交接和后端说明。1.8.0至1.8.2没有同步网站文章或自动更新清单,源码Release发布不等于网站已上新版。

以后涉及后台,按全局规则先核对NAS生产共享 /Volumes/dayumedia (存储空间1)/wwwroot/dayu_media 与本地专项副本的映射、基线和旁路备份;不要把工程内Backend或下载目录当生产源。若优化LUT浏览器,保留1.7.3的FxPlug宿主contentView原点适配,历史记录见BrowserMoreSpace1.7.3.md。