docs: hand off 1.8.2 color pipeline, black-gold UI and release workflow

这个提交包含在:
mac 于 2026-11-04 11:52:03 +08:00 提交
1 父节点 504e6d98e3
当前提交 fa82014266
2 个文件已更改
+191 -31

没有与搜索条件相匹配的文件

@@ -0,0 +1,51 @@
# 大鱼调色 FxPlug4 交接
2026-11-02 当前正式安装为 **1.7.3(49)**。本机已复现“更多空间”灰色区域并定位到SDK提供的外层contentView原点偏移;新增坐标对齐修正,首次打开无需绿色按钮。411项原生、27项几何、23项浏览库检查及本机FCP12.4热/冷重开和缩放通过,目标MacBook/FCP12.3仍待使用者复测。详见[修复与边界](research/BrowserMoreSpace1.7.3.md)、[RECOVERY.md](RECOVERY.md)及 `verification/Delivery.json` / `Package.json` / `Release.json`。保留1.7.1 Cube文字行兼容及1.7.0更新/公测诊断。以下保留1.6.0交接历史。
## 1.6.0交接历史
后续主 APP 优化入口:[大鱼调色主APP开发交接.md](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色主APP开发交接.md),包含自动更新、登录验证、生产接口只读盘点与待定产品规则;其中自动更新与公测诊断已在1.7.0完成,登录与授权仍未实施。
2026-11-02,最终正式版 **1.6.0(39)**。本次完成Color Finale本机胶片五组、通道混合器及用户补充的全部八种印片;去掉MOEF作者/网站两行、降低模板格式,并追加一级自动映射默认开启和主标题链接。
## 正式身份与恢复
- 唯一APP:`/Library/Plug-Ins/FxPlug/大鱼调色.app`;ID `com.dayu.color` / `com.dayu.color.XPC`,团队B3W25FX5H5。
- 实际编译源码:`e5affd3f097fc96f87f41be8e1a3f131ed01daeb`,APP公证 `5d74c04c-8a30-47e9-822d-4f616dfdee56` Accepted;签名、票据、Gatekeeper及正式进程路径通过。
- 远程:`https://dayu.media/git/dayu/dayu-color.git`,main,最终标签 `v1.6.0-print-looks-20261102`。完整标签SHA及PKG/Release元数据以 `verification/Release.json` 为准;实际编译SHA与文档交付SHA分别记录。
- 模板:`~/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef`,ozml5.11 / Motion5.4.5,SHA `fe6b9ed9a59e1e00de7bcad4526bc98fa2d5fde5cab490fd65ec999835ab2250`。
- Apple Silicon/macOS14.6或更新;FCP12.4已验收,旧FCP未实机覆盖。不依赖ColorFinale安装、REA缓存或父插件;无LFS/子模块。
## 行为与参数
胶片为减色、晕光、辉光、颗粒、暗角、印片六页。印片默认无:Kodak2383、Kodak2393、Kodak2302 BW、Fuji3510、Fuji3513、Fuji3519、Fuji3521、AgfaCP30,独立强度。通道混合器为RGB三输出×三输入,保持亮度/饱和度和混合强度。两工具沿用启停、折叠、复位、蒙版、数量标记、区域跟踪、相邻独立层;旧索引、Uniform前缀、LUT、蜘蛛盘和轨迹保留。
印片追加在五处理后、全胶片混合/原蒙版前;Rec.709线性→AP1/D60→ACEScct→65³原LMT四面体→线性Rec.709。不包含原版任意完整CMS/ODT迁移。旧1296字节前缀保留,追加filmPrint共1312字节;预设v6读v1–v5。纯印片、矩阵和减色可导出Cube;空间/时间效果和蒙版限制保留。原版CI半透明链与产品预乘合同的已测差异详见研究和完整对照报告。
MOEF仅发布自定义检查器与混合,无作者/网站Rig。全局技能检查器对5.11返回未知版本guard,如实保存;项目级真实原生样本字段验证与当前FCP加载/渲染分别通过。
FCP新效果、新加一级层及全部还原的自动映射为开启;主标题链接为“更多插件访问 https://dayu.media”,点击已实际打开网站。原生注册默认维持历史0,新MOEF显式value1/default0;旧独立一级层省略值保持0。FCP沿用模板默认的旧主效果实测会变为开启,三组旧预设仅此0→1,其余277项及全部paths/spider/tools载荷保持。不能宣称更改模板默认后旧主效果完全逐字节不变;新手动关闭后已验证冷重开保持。
## 验收证据
正式395项原生检查、四尺寸136项原版印片对照通过,固定容差0.0001,最大线性RGB绝对差0.000004828。最终Metal与完整八外观验收的36候选相同。36候选逐个选择八种印片、两层不同印片/强度、椭圆蒙版100键跟踪、折叠标记、删除撤销重做及三段300帧ProRes通过;最终39保留全部自定义载荷,并完成新默认、实际链接、手动开关冷重开8668字节一致及新增1080p100帧正式导出。完整用户文件只在本机fcp-qa缓存,不进Git或PKG。
- 最终安装:`verification/Delivery.json` / `InstalledSelfTest.json`。
- 最终汇总:`verification/HostPrintLooks1.6.0.json`。
- 默认/链接/保存:`verification/HostPrimaryDefaults1.6.0.json`。
- 八外观完整宿主操作:`verification/HostPrintLooksBuild36.json`。
- 算法/原版边界:`research/PrintLooks1.6.0.md` / `verification/PrintLooksReference.json`。
- 独立恢复:`verification/PrintLooksRecovery.json`,最终编译节点294文件全字节、full/strict fsck、Release构建395项和模板重建通过。
- 最终安装包/上传/标签恢复/清理:`verification/Package.json`、`Release.json`、`PrintLooksReleaseRecovery.json`、`PrintLooksCleanup.json`。
最终PKG由PKG工坊签名、公证、票据与20项展开验包;不再运行系统安装器,APP已有独立正式安装和宿主验收。包与Release下载校验值以Package/Release报告为准。
## 接续方法
固定缓存 `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color`。更改模型后运行 `python3 tools/build_template.py --refresh-model --overwrite`,再 `python3 tools/verify_template.py`;更新SkillAudit及摘要。Release用Wrapper Application方案,按全局产品锁/仓库锁约定交付;仅正式已公证位置做用户可见测试。证书/私钥需独立恢复。
历史35/37/38候选未发布;36的已验PKG在新需求到达后移除,未上传。37公证等待中停止了本地等待,保留ID查询,未重新上传相同产物。38正式验收发现FCP默认行为,39已记录实际边界。既有历史发行包与标签保留。1.5完整交接归档见 `research/handoffs/DayuColorThrough1.5.0-20261102.md`。
正式PKG `大鱼调色-1.6.0.pkg`,40833847字节,SHA-256 `13821631b5d54f1b9c1934c513a9cc7e92641208e20219839a63e23865f21cca`;PKG公证 `4716e3c7-8199-4dc1-940c-2376dd647e9b` Accepted,签名、票据、Gatekeeper和20项展开验包通过。发行包未再次运行系统安装器。
最终[Release373](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.6.0-print-looks-20261102) / 附件18已发布并回读确认。标签 `v1.6.0-print-looks-20261102` 对应完整SHA `0cc51149a6f21ebe09465b4fd7130451bedd57bb`;草稿正常浏览器下载与发布后完整下载均校验40,833,847字节及SHA-256一致。发行标签296文件逐字节恢复和full/strict fsck通过,与实际编译SHA的程序源码完全一致。恢复clone、独立构建和下载副本清理完成;已知相关位置仅正式39版APP,历史发行包和私人验收数据保留。记录见 `verification/Release.json`、`ReleaseDraftDownload1.6.0.json`、`PrintLooksReleaseRecovery.json`、`PrintLooksCleanup.json`。
+140 -31
查看文件
@@ -1,51 +1,160 @@
# 大鱼调色 FxPlug4 交接
# 大鱼调色开发交接
2026-11-02 当前正式安装为 **1.7.3(49)**。本机已复现“更多空间”灰色区域并定位到SDK提供的外层contentView原点偏移;新增坐标对齐修正,首次打开无需绿色按钮。411项原生、27项几何、23项浏览库检查及本机FCP12.4热/冷重开和缩放通过,目标MacBook/FCP12.3仍待使用者复测。详见[修复与边界](research/BrowserMoreSpace1.7.3.md)、[RECOVERY.md](RECOVERY.md)及 `verification/Delivery.json` / `Package.json` / `Release.json`。保留1.7.1 Cube文字行兼容及1.7.0更新/公测诊断。以下保留1.6.0交接历史。
交接日期:2026年11月4日,Asia/Shanghai;本机用户 mac,Mac mini M4。新对话从已交付的 **1.8.2(59)** 继续开发。色彩管理修正、黑金界面、签名公证、正式安装、PKG和Release均已完成,没有挂起的发布步骤;下一轮具体优化以用户的新需求为准。
## 1.6.0交接历史
先读本文件、[README](/Volumes/备份/大鱼调色/大鱼调色/README.md)和[恢复说明](/Volumes/备份/大鱼调色/大鱼调色/RECOVERY.md)。开发与交付遵循 `/Users/mac/.codex/AGENTS.md` 及用户最新说明。旧交接已逐字节归档到[1.7.3及之前历史](/Volumes/备份/大鱼调色/大鱼调色/research/handoffs/DayuColorThrough1.7.3-20261104.md),其中旧版本号、检查数量和原始规划不是当前状态。
后续主 APP 优化入口:[大鱼调色主APP开发交接.md](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色主APP开发交接.md),包含自动更新、登录验证、生产接口只读盘点与待定产品规则;其中自动更新与公测诊断已在1.7.0完成,登录与授权仍未实施。
## 工程和正式版本
2026-11-02,最终正式版 **1.6.0(39)**。本次完成Color Finale本机胶片五组、通道混合器及用户补充的全部八种印片;去掉MOEF作者/网站两行、降低模板格式,并追加一级自动映射默认开启和主标题链接。
| 项目 | 已核验内容 |
| --- | --- |
| 实际工程根目录 | `/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。外置卷会产生 `._*` 元数据文件,不要混入提交。
- 唯一APP:`/Library/Plug-Ins/FxPlug/大鱼调色.app`;ID `com.dayu.color` / `com.dayu.color.XPC`,团队B3W25FX5H5。
- 实际编译源码:`e5affd3f097fc96f87f41be8e1a3f131ed01daeb`,APP公证 `5d74c04c-8a30-47e9-822d-4f616dfdee56` Accepted;签名、票据、Gatekeeper及正式进程路径通过。
- 远程:`https://dayu.media/git/dayu/dayu-color.git`,main,最终标签 `v1.6.0-print-looks-20261102`。完整标签SHA及PKG/Release元数据以 `verification/Release.json` 为准;实际编译SHA与文档交付SHA分别记录。
- 模板:`~/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef`,ozml5.11 / Motion5.4.5,SHA `fe6b9ed9a59e1e00de7bcad4526bc98fa2d5fde5cab490fd65ec999835ab2250`。
- Apple Silicon/macOS14.6或更新;FCP12.4已验收,旧FCP未实机覆盖。不依赖ColorFinale安装、REA缓存或父插件;无LFS/子模块。
## 用户确定的产品要求
## 行为与参数
- 高级色彩管理收进独立“颜色设置”按钮,普通用户默认看不到说明区;收起后不留空白。
- 默认继续“原有流程”。已保存的nil、v2、v3工程保持各自处理,展开界面不能改写状态或产生调色撤销项。
- 一级CST的输入、工作曲线/色域、输出必须生效。用户明确反对先将Log素材显示还原为Rec.709,再让后续一级转换失去意义。
- 黑金为新增默认配色:黑色和深色渐变背景、亮金文字、柔和光晕,保留原来五种主题。
- 产品名称、Bundle ID和正式路径保持稳定。用户可见验收使用正式安装位置的已公证版本。
胶片为减色、晕光、辉光、颗粒、暗角、印片六页。印片默认无:Kodak2383、Kodak2393、Kodak2302 BW、Fuji3510、Fuji3513、Fuji3519、Fuji3521、AgfaCP30,独立强度。通道混合器为RGB三输出×三输入,保持亮度/饱和度和混合强度。两工具沿用启停、折叠、复位、蒙版、数量标记、区域跟踪、相邻独立层;旧索引、Uniform前缀、LUT、蜘蛛盘和轨迹保留。
## 1.8.2界面实现
印片追加在五处理后、全胶片混合/原蒙版前;Rec.709线性→AP1/D60→ACEScct→65³原LMT四面体→线性Rec.709。不包含原版任意完整CMS/ODT迁移。旧1296字节前缀保留,追加filmPrint共1312字节;预设v6读v1–v5。纯印片、矩阵和减色可导出Cube;空间/时间效果和蒙版限制保留。原版CI半透明链与产品预乘合同的已测差异详见研究和完整对照报告。
检查器为 **AppKit / Objective-C++**,不是SwiftUI。采用FxPlug原位展开区域,没有新增浮动设置窗口。
MOEF仅发布自定义检查器与混合,无作者/网站Rig。全局技能检查器对5.11返回未知版本guard,如实保存;项目级真实原生样本字段验证与当前FCP加载/渲染分别通过。
顶部四个按钮为保存预设、载入预设、导出LUT、颜色设置。宽度小于320时排成两行;六枚主题色块占原标题区,窄栏隐藏版本小字以免重叠。
FCP新效果、新加一级层及全部还原的自动映射为开启;主标题链接为“更多插件访问 https://dayu.media”,点击已实际打开网站。原生注册默认维持历史0,新MOEF显式value1/default0;旧独立一级层省略值保持0。FCP沿用模板默认的旧主效果实测会变为开启,三组旧预设仅此0→1,其余277项及全部paths/spider/tools载荷保持。不能宣称更改模板默认后旧主效果完全逐字节不变;新手动关闭后已验证冷重开保持。
`_colorSettingsExpanded` 是检查器实例内的临时布尔状态。打开和关闭不写模型、不产生宿主撤销项;新建检查器默认收起。隐藏的 `DYManagedColorPanel` 不参与布局高度。说明已缩短,完整条件在工具提示中。
## 验收证据
主题ID0–4依次为深空灰、冰川蓝、薰衣草紫、翡翠绿、琥珀橙;追加ID5黑金渐变。偏好域 `com.dayu.color.preferences`、键 `themeIndex`。没有明确保存偏好或索引非法时使用5;明确保存过的旧选择保留。本机已经通过界面选中黑金。
正式395项原生检查、四尺寸136项原版印片对照通过,固定容差0.0001,最大线性RGB绝对差0.000004828。最终Metal与完整八外观验收的36候选相同。36候选逐个选择八种印片、两层不同印片/强度、椭圆蒙版100键跟踪、折叠标记、删除撤销重做及三段300帧ProRes通过;最终39保留全部自定义载荷,并完成新默认、实际链接、手动开关冷重开8668字节一致及新增1080p100帧正式导出。完整用户文件只在本机fcp-qa缓存,不进Git或PKG。
黑金背景为不透明静态渐变,金色细边与亮金文字。NSShadow模糊半径1.8、alpha0.30;系统增加对比度或减少透明度时去掉光晕。色轮、通道曲线和媒体预览保留真实色相。
- 最终安装:`verification/Delivery.json` / `InstalledSelfTest.json`。
- 最终汇总:`verification/HostPrintLooks1.6.0.json`。
- 默认/链接/保存:`verification/HostPrimaryDefaults1.6.0.json`。
- 八外观完整宿主操作:`verification/HostPrintLooksBuild36.json`。
- 算法/原版边界:`research/PrintLooks1.6.0.md` / `verification/PrintLooksReference.json`。
- 独立恢复:`verification/PrintLooksRecovery.json`,最终编译节点294文件全字节、full/strict fsck、Release构建395项和模板重建通过。
- 最终安装包/上传/标签恢复/清理:`verification/Package.json`、`Release.json`、`PrintLooksReleaseRecovery.json`、`PrintLooksCleanup.json`。
候选58在FCP实机发现“添加模块”标题漏绘:pullsDown菜单的selectedItem可能为nil。正式59从第一项取标题,并增加实际像素绘制检查。候选58已回滚清理,未制作或发布安装包。后续改共用控件时保留普通按钮、弹出选择器和下拉菜单的差别。
最终PKG由PKG工坊签名、公证、票据与20项展开验包;不再运行系统安装器,APP已有独立正式安装和宿主验收。包与Release下载校验值以Package/Release报告为准。
| 入口 | 职责 |
| --- | --- |
| [DYInspector.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYInspector.mm) | 顶部按钮、展开状态、卡片、参数控件和窄栏布局 |
| [DYManagedColorPanel.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYManagedColorPanel.mm) | 色彩方式、帮助、输入输出字段及有撤销的状态写入 |
| [DYTheme.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYTheme.h)、[DYTheme.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYTheme.mm) | 六主题、动态颜色、渐变、光晕、共用AppKit控件 |
| [DYCompactUIDiagnostics.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYCompactUIDiagnostics.inc.h) | 隐藏高度、模型不变、三栏宽、主题、对比度、文字绘制 |
| [界面约定](/Volumes/备份/大鱼调色/大鱼调色/research/ui-blackgold-20261104/brief.md) | 本轮需求及实现选择 |
## 接续方法
## 色彩管理的当前合同
固定缓存 `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color`。更改模型后运行 `python3 tools/build_template.py --refresh-model --overwrite`,再 `python3 tools/verify_template.py`;更新SkillAudit及摘要。Release用Wrapper Application方案,按全局产品锁/仓库锁约定交付;仅正式已公证位置做用户可见测试。证书/私钥需独立恢复。
完整预设格式仍为v7,色彩管理有独立版本。全局方式和一级可见参数各自的责任不要混淆。
历史35/37/38候选未发布;36的已验PKG在新需求到达后移除,未上传。37公证等待中停止了本地等待,保留ID查询,未重新上传相同产物。38正式验收发现FCP默认行为,39已记录实际边界。既有历史发行包与标签保留。1.5完整交接归档见 `research/handoffs/DayuColorThrough1.5.0-20261102.md`。
| 状态 | 界面方式 | 行为 |
| --- | --- | --- |
| nil | 原有流程(默认) | 保留历史链,不自动迁移 |
| v2 mode1–3 | 1.8兼容,跟随FCP、相机或LUT输入 | 固定ACEScct/AP1,保护1.8.0已存画面 |
| v3 mode4 | 一级CST · 延后输出 | 采用原一级输入、工作域和输出,主输出放在一级层与印片之后 |
正式PKG `大鱼调色-1.6.0.pkg`,40833847字节,SHA-256 `13821631b5d54f1b9c1934c513a9cc7e92641208e20219839a63e23865f21cca`;PKG公证 `4716e3c7-8199-4dc1-940c-2376dd647e9b` Accepted,签名、票据、Gatekeeper和20项展开验包通过。发行包未再次运行系统安装器。
v3严格状态为:
最终[Release373](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.6.0-print-looks-20261102) / 附件18已发布并回读确认。标签 `v1.6.0-print-looks-20261102` 对应完整SHA `0cc51149a6f21ebe09465b4fd7130451bedd57bb`;草稿正常浏览器下载与发布后完整下载均校验40,833,847字节及SHA-256一致。发行标签296文件逐字节恢复和full/strict fsck通过,与实际编译SHA的程序源码完全一致。恢复clone、独立构建和下载副本清理完成;已知相关位置仅正式39版APP,历史发行包和私人验收数据保留。记录见 `verification/Release.json`、`ReleaseDraftDownload1.6.0.json`、`PrintLooksReleaseRecovery.json`、`PrintLooksCleanup.json`。
```json
{"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](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYManagedColor.mm) | 状态校验、v3默认值和独立层跟随 |
| [DYPrimaryRender.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYPrimaryRender.inc.h) | v3工作域、顺序、主输出及SDR接续 |
| [DYPrimaryKernels.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYPrimaryKernels.inc.h) | v3内核与边界 |
| [DYManagedRender.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYManagedRender.inc.h) | v2兼容链 |
| [DYRenderer.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYRenderer.mm) | 管线分派、Cube与宿主接入 |
| [DYPrimaryDiagnostics.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYPrimaryDiagnostics.inc.h) | 高光、局部CST、线性域、负值、导出与旧链回归 |
| [float_air_boundary.py](/Volumes/备份/大鱼调色/大鱼调色/tools/float_air_boundary.py) | float32入口出口生成,原入口保留 |
| [1.8.1修正设计](/Volumes/备份/大鱼调色/大鱼调色/research/cms-correction-20261104/design.md) | 当前设计依据与模板问题 |
| [三款插件调查](/Volumes/备份/大鱼调色/大鱼调色/research/cms-audit-20261103/report.md) | 历史只读分析,当时待办不能直接当作当前未完成项 |
此前调查对象为 `/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](/Volumes/备份/大鱼调色/大鱼调色/verification/Delivery.json) |
| 595项原生结果 | [InstalledSelfTest.json](/Volumes/备份/大鱼调色/大鱼调色/verification/InstalledSelfTest.json) |
| 当前FCP验收 | [HostCompactUI1.8.2.json](/Volumes/备份/大鱼调色/大鱼调色/verification/HostCompactUI1.8.2.json) |
| CST数值与宿主 | [PrimaryCSTNumerical1.8.1.json](/Volumes/备份/大鱼调色/大鱼调色/verification/PrimaryCSTNumerical1.8.1.json)、[HostPrimaryCST1.8.1.json](/Volumes/备份/大鱼调色/大鱼调色/verification/HostPrimaryCST1.8.1.json) |
| 独立恢复与清理 | [CompactUIRecovery1.8.2.json](/Volumes/备份/大鱼调色/大鱼调色/verification/CompactUIRecovery1.8.2.json)、[CompactUICleanup1.8.2.json](/Volumes/备份/大鱼调色/大鱼调色/verification/CompactUICleanup1.8.2.json) |
| 安装包及下载 | [Package.json](/Volumes/备份/大鱼调色/大鱼调色/verification/Package.json)、[Release.json](/Volumes/备份/大鱼调色/大鱼调色/verification/Release.json) |
## 发布与恢复
发行包 `/Volumes/备份/大鱼调色/发行包/大鱼调色-1.8.2.pkg`,43,006,067字节,SHA-256为 `cbabffc620ad851bd8ecddfaf797c46689722d0f772be409aaa29d0841a2eded`。[在线Release383](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.8.2-blackgold-20261104),附件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](/Volumes/备份/大鱼调色/大鱼调色/tools/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](/Volumes/备份/大鱼调色/大鱼调色/tools/deliver.py)、[build_pkg.py](/Volumes/备份/大鱼调色/大鱼调色/Packaging/build_pkg.py)、[publish_beta.py](/Volumes/备份/大鱼调色/大鱼调色/Packaging/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](/Volumes/备份/大鱼调色/大鱼调色/tools/create_primary_host_fixture.py)重建。
交付结束时FCP为黑金、颜色设置收起,QA项目为1.8.1_Log高光恢复。此前Motion文稿已恢复打开,未编辑。新对话重新获取当前窗口和进程,不沿用历史UI元素编号、PID或工具会话。
真实相机Log上游路由、HDR/SDR工具域、更广宿主版本及界面细节均可作为后续方向,用户尚未指定优先级。不要把“所有工具已场景化”或“任意HDR链已验证”当作现状。
主APP自动更新与云端公测诊断已在1.7.0实现;登录、授权、业务加密尚未实施,详见[主APP交接](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色主APP开发交接.md)和[后端说明](/Volumes/备份/大鱼调色/大鱼调色/Backend/README.md)。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](/Volumes/备份/大鱼调色/大鱼调色/research/BrowserMoreSpace1.7.3.md)。