release: record signed 1.8.3 package and updated neon histogram handoff

这个提交包含在:
mac 于 2026-11-04 12:28:23 +08:00 提交
1 父节点 c55f3343ea
当前提交 a06a3a3914
5 个文件已更改
+208 -156

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

+6 -1
查看文件
@@ -8,4 +8,9 @@
色彩管理、调色数学和模板默认保持不变。系统要求 Apple Silicon、macOS14.6 或更新。唯一正式位置 /Library/Plug-Ins/FxPlug/大鱼调色.app。
验证结果与发行摘要在本版正式验收后补齐。
605项正式原生检查与FCP12.4实机通过;真实视频与色块分布、四通道/显隐、冷重开与8,590字节原预设一致验证完成。APP与PKG均已正式签名、公证Accepted、粘附票据;PKG通过20项展开验包。本轮APP独立正式安装验收,未重复执行PKG安装脚本。
安装包:大鱼调色-1.8.3.pkg
字节数:43010609
SHA-256:518f54c12a6680c32be5cb4bd7d01b8a4c49e3d492a0d9d75ac5e46e3345da53
实际编译源码:3fd015224037df944b428684c43ec8ec7accea85
+10
查看文件
@@ -1,3 +1,13 @@
# 1.8.3(62)多色渐变与曲线直方图
仓库 https://dayu.media/git/dayu/dayu-color.git,main。编译源码3fd015224037df944b428684c43ec8ec7accea85;发行标签v1.8.3-neon-histogram-20261104。正式位置、身份、依赖及恢复步骤沿用下文;当前详细交接见大鱼调色FxPlug4交接.md。标签/附件最终完整SHA见verification/Release.json,包校验见Package.json。
最终主题ID6为分模块饱和双色渐变,无统一紫底或深蓝灰底;候选60/61未发布包。605项正式原生检查、FCP真实视频直方图与冷重开、原8,590字节预设逐字节一致通过。APP公证706a58bb-2fa4-4b1e-b392-de60d93aef49为Accepted。独立远程源码与版本标签恢复范围见NeonRecovery1.8.3.json;本轮未宣称独立重编全部依赖。
直方图为320×180分析缓存、256档、最多2Hz,非最终输出/HDR示波器或每层即时输入;来源和显示范围见检查框工具提示。源码/模板数学和CMS默认保持。APP独立正式替换并验收,PKG按展开验包记录,本轮未重复执行安装脚本。网站与自动更新清单未修改。
---
# 1.8.2(59)黑金界面与高级颜色设置
仓库 https://dayu.media/git/dayu/dayu-color.git,main。实际编译源码 da03d16c7efa87a5d230467334ec73f9a3a12e54;发行标签 v1.8.2-blackgold-20261104。标签包括最终 Package.json;发布后的 Release.json 和最后恢复/清理核验保存在后续 main,标签中的旧 Release.json 属于上版历史。本版安装包以本版 Release 页面和后续 main 的发布记录为准。
@@ -0,0 +1,160 @@
# 大鱼调色开发交接
交接日期:2026年11月4日,Asia/Shanghai;本机用户 mac,Mac mini M4。新对话从已交付的 **1.8.2(59)** 继续开发。色彩管理修正、黑金界面、签名公证、正式安装、PKG和Release均已完成,没有挂起的发布步骤;下一轮具体优化以用户的新需求为准。
先读本文件、[README](/Volumes/备份/大鱼调色/大鱼调色/README.md)和[恢复说明](/Volumes/备份/大鱼调色/大鱼调色/RECOVERY.md)。开发与交付遵循 `/Users/mac/.codex/AGENTS.md` 及用户最新说明。旧交接已逐字节归档到[1.7.3及之前历史](/Volumes/备份/大鱼调色/大鱼调色/research/handoffs/DayuColorThrough1.7.3-20261104.md),其中旧版本号、检查数量和原始规划不是当前状态。
## 工程和正式版本
| 项目 | 已核验内容 |
| --- | --- |
| 实际工程根目录 | `/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](/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) | 本轮需求及实现选择 |
## 色彩管理的当前合同
完整预设格式仍为v7,色彩管理有独立版本。全局方式和一级可见参数各自的责任不要混淆。
| 状态 | 界面方式 | 行为 |
| --- | --- | --- |
| nil | 原有流程(默认) | 保留历史链,不自动迁移 |
| v2 mode1–3 | 1.8兼容,跟随FCP、相机或LUT输入 | 固定ACEScct/AP1,保护1.8.0已存画面 |
| v3 mode4 | 一级CST · 延后输出 | 采用原一级输入、工作域和输出,主输出放在一级层与印片之后 |
v3严格状态为:
```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)。
+14 -14
查看文件
@@ -1,7 +1,7 @@
{
"package": "/Volumes/备份/大鱼调色/发行包/大鱼调色-1.8.2.pkg",
"sha256": "cbabffc620ad851bd8ecddfaf797c46689722d0f772be409aaa29d0841a2eded",
"bytes": 43006067,
"package": "/Volumes/备份/大鱼调色/发行包/大鱼调色-1.8.3.pkg",
"sha256": "518f54c12a6680c32be5cb4bd7d01b8a4c49e3d492a0d9d75ac5e46e3345da53",
"bytes": 43010609,
"testUnsigned": false,
"installationExecuted": false,
"checks": [
@@ -31,27 +31,27 @@
"source": "/Library/Plug-Ins/FxPlug/大鱼调色.app",
"payload": "Library/Plug-Ins/FxPlug/大鱼调色.app",
"bundleID": "com.dayu.color",
"version": "1.8.2",
"build": "59"
"version": "1.8.3",
"build": "62"
},
{
"source": "/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/pkg-inputs/大鱼调色",
"payload": "Library/Application Support/PKGForge/Payload/com.dayu.color.installer.20452a40-e96f-4a01-9191-82412995e286/89DECFA7-D24D-462F-912E-9503BB73B5E6/大鱼调色"
"payload": "Library/Application Support/PKGForge/Payload/com.dayu.color.installer.0f5903c7-b19d-4375-99d2-56e68fb2bd7e/CC1BE24D-1F08-475E-A494-5A27FFA6BA2C/大鱼调色"
}
],
"signature": "Package \"大鱼调色-1.8.2.pkg\":\n Status: signed by a developer certificate issued by Apple for distribution\n Notarization: trusted by the Apple notary service\n Signed with a trusted timestamp on: 2026-11-04 02:55:41 +0000\n Certificate Chain:\n 1. Developer ID Installer: zhong luo (B3W25FX5H5)\n Expires: 2027-02-01 22:12:15 +0000\n SHA256 Fingerprint:\n C0 19 01 3C 67 88 8F 34 65 56 C5 91 3C E5 B6 12 4C 5D A6 DA F9 D8 \n DA 00 37 52 DF F0 F3 E6 00 B4\n ------------------------------------------------------------------------\n 2. Developer ID Certification Authority\n Expires: 2027-02-01 22:12:15 +0000\n SHA256 Fingerprint:\n 7A FC 9D 01 A6 2F 03 A2 DE 96 37 93 6D 4A FE 68 09 0D 2D E1 8D 03 \n F2 9C 88 CF B0 B1 BA 63 58 7F\n ------------------------------------------------------------------------\n 3. Apple Root CA\n Expires: 2035-02-09 21:40:36 +0000\n SHA256 Fingerprint:\n B0 B1 73 0E CB C7 FF 45 05 14 2C 49 F1 29 5E 6E DA 6B CA ED 7E 2C \n 68 C5 BE 91 B5 A1 10 01 F0 24",
"gatekeeper": "/Volumes/备份/大鱼调色/发行包/大鱼调色-1.8.2.pkg: accepted\nsource=Notarized Developer ID",
"signature": "Package \"大鱼调色-1.8.3.pkg\":\n Status: signed by a developer certificate issued by Apple for distribution\n Notarization: trusted by the Apple notary service\n Signed with a trusted timestamp on: 2026-11-04 04:27:21 +0000\n Certificate Chain:\n 1. Developer ID Installer: zhong luo (B3W25FX5H5)\n Expires: 2027-02-01 22:12:15 +0000\n SHA256 Fingerprint:\n C0 19 01 3C 67 88 8F 34 65 56 C5 91 3C E5 B6 12 4C 5D A6 DA F9 D8 \n DA 00 37 52 DF F0 F3 E6 00 B4\n ------------------------------------------------------------------------\n 2. Developer ID Certification Authority\n Expires: 2027-02-01 22:12:15 +0000\n SHA256 Fingerprint:\n 7A FC 9D 01 A6 2F 03 A2 DE 96 37 93 6D 4A FE 68 09 0D 2D E1 8D 03 \n F2 9C 88 CF B0 B1 BA 63 58 7F\n ------------------------------------------------------------------------\n 3. Apple Root CA\n Expires: 2035-02-09 21:40:36 +0000\n SHA256 Fingerprint:\n B0 B1 73 0E CB C7 FF 45 05 14 2C 49 F1 29 5E 6E DA 6B CA ED 7E 2C \n 68 C5 BE 91 B5 A1 10 01 F0 24",
"gatekeeper": "/Volumes/备份/大鱼调色/发行包/大鱼调色-1.8.3.pkg: accepted\nsource=Notarized Developer ID",
"pass": true,
"scope": "Expanded package structural and payload verification only; no installer scripts executed and no host quit or registration performed.",
"notarization": {
"id": "26361685-6bdd-4c59-bc2c-4824ea190e05",
"id": "5666e466-7ec5-49fb-beac-f7fc5b4e080c",
"name": "大鱼调色-1.8.3.pkg",
"status": "Accepted",
"createdDate": "2026-11-04T02:55:43.274Z",
"name": "大鱼调色-1.8.2.pkg",
"createdDate": "2026-11-04T04:27:23.407Z",
"message": "Successfully received submission info"
},
"appCompiledSource": "da03d16c7efa87a5d230467334ec73f9a3a12e54",
"appBuild": "59",
"appCompiledSource": "3fd015224037df944b428684c43ec8ec7accea85",
"appBuild": "62",
"packageBuilderRemote": "https://dayu.media/git/dayu/pkg-forge.git",
"packageBuilderCommit": "eb53707c0e67d8ddeab8c1270bb079f1050cfafe",
"templateSHA256": {
@@ -59,6 +59,6 @@
"large.png": "ab12611e8801cff86332ccc505a4cffa0c1120541c2efb9bb9908be2c9fe631a",
"small.png": "41fec3138aee904fc39d6982e6fde809243ffec55298dbfe966f4f48d89caf8a"
},
"installedAppHostAcceptance": "verification/HostCompactUI1.8.2.json",
"installedAppHostAcceptance": "verification/HostNeon1.8.3.json",
"installScope": "本轮仅生成并验包,未再次执行系统安装;正式 APP 已有独立宿主验收。"
}
+18 -141
查看文件
@@ -1,160 +1,37 @@
# 大鱼调色开发交接
交接日期:2026年11月4日,Asia/Shanghai;本机用户 mac,Mac mini M4。新对话从已交付的 **1.8.2(59)** 继续开发。色彩管理修正、黑金界面、签名公证、正式安装、PKG和Release均已完成,没有挂起的发布步骤;下一轮具体优化以用户的新需求为准。
2026年11月4日,Asia/Shanghai。本轮正式版本 **1.8.3(62)**,在1.8.2基础上新增炫彩主题与曲线直方图。此前完整CMS、黑金及发布流程交接已逐字节归档到 research/handoffs/DayuColorThrough1.8.2-20261104.md;其旧版本号与黑金默认要求属于历史,用户本轮视觉反馈优先。
先读本文件、[README](/Volumes/备份/大鱼调色/大鱼调色/README.md)和[恢复说明](/Volumes/备份/大鱼调色/大鱼调色/RECOVERY.md)。开发与交付遵循 `/Users/mac/.codex/AGENTS.md` 及用户最新说明。旧交接已逐字节归档到[1.7.3及之前历史](/Volumes/备份/大鱼调色/大鱼调色/research/handoffs/DayuColorThrough1.7.3-20261104.md),其中旧版本号、检查数量和原始规划不是当前状态。
实际工程 /Volumes/备份/大鱼调色/大鱼调色;Xcode工程“大鱼调色.xcodeproj”,Wrapper Application / Release;检查器为Objective-C++/AppKit。平台Apple Silicon/macOS14.6+,本机Xcode27.1、FxPlug4.3.5。唯一正式安装 /Library/Plug-Ins/FxPlug/大鱼调色.app,主ID com.dayu.color,内部 com.dayu.color.XPC。固定缓存 /Users/mac/Library/Caches/CodexBuilds/com.dayu.color。
## 工程和正式版本
源码远程 https://dayu.media/git/dayu/dayu-color.git,main;实际编译源码 **3fd015224037df944b428684c43ec8ec7accea85**。版本标签 v1.8.3-neon-histogram-20261104;完整标签提交及PKG/Release摘要见最终 verification/Package.json、Release.json、NeonRecovery1.8.3.json。标签包含Package.json,后续发布回读另作main提交,不移动已有标签。无LFS/子模块。
| 项目 | 已核验内容 |
| --- | --- |
| 实际工程根目录 | `/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。外置卷会产生 `._*` 元数据文件,不要混入提交。
用户否决了候选60“大片紫色”,又否决候选61“深蓝灰与青色主题近似”。最终62使用分模块双色渐变表面:一级紫红、蜘蛛盘青蓝、基础珊瑚玫红、肤色橙红、HSL绿青、曲线青蓝等。卡片、标题与图标都跟随模块色相;背景为有色相的紫/蓝/青渐变,不再使用深蓝灰方案。白色正文,洋红到青色的重点按钮与滑杆。不要在后续调整中自动恢复全紫或统一蓝灰。
## 用户确定的产品要求
主题追加ID6“霓虹炫彩”;旧0–5不改编号,未保存偏好默认6,明确旧选择保留。本机已在正式FCP切到6,冷重开保持。偏好域com.dayu.color.preferences/themeIndex;主题不写入工程或预设。大面积表面均为不透明静态渐变,无持续动画,炫彩文字不发光。
- 高级色彩管理收进独立“颜色设置”按钮,普通用户默认看不到说明区;收起后不留空白。
- 默认继续“原有流程”。已保存的nil、v2、v3工程保持各自处理,展开界面不能改写状态或产生调色撤销项。
- 一级CST的输入、工作曲线/色域、输出必须生效。用户明确反对先将Log素材显示还原为Rec.709,再让后续一级转换失去意义。
- 黑金为新增默认配色:黑色和深色渐变背景、亮金文字、柔和光晕,保留原来五种主题。
- 产品名称、Bundle ID和正式路径保持稳定。用户可见验收使用正式安装位置的已公证版本。
## 直方图实现与边界
## 1.8.2界面实现
DYHistogram.h统计既有320×180浮点分析缓存,在渲染工作线程生成不可变256档亮度/R/G/B快照,主线程只绘制。透明、NaN、无穷像素不计;范围外归端点;各通道共用峰值并作平方根高度。RGB页叠加4通道,单色页只绘对应通道,直方图默认开启、可显隐;新建检查器重置显示开关,不写参数/撤销/预设。
检查器为 **AppKit / Objective-C++**,不是SwiftUI。采用FxPlug原位展开区域,没有新增浮动设置窗口。
原流程分析源为一级CST/输入LUT后;新CMS为显示输出转换后、SDR修饰前。**不是最终输出示波器,不保证每个局部曲线层的即时输入。** 显示编码亮度是Rec.709系数加权码值,并非场景线性亮度/HDR测量。最多每0.5秒更新,依赖宿主渲染;无缓存显示“等待画面”。工具提示列明来源/采样范围。没有改变GPU数学、Uniform、参数ID、CMS、模板或预设格式。
顶部四个按钮为保存预设、载入预设、导出LUT、颜色设置。宽度小于320时排成两行;六枚主题色块占原标题区,窄栏隐藏版本小字以免重叠。
关键文件:DYTheme.mm、DYInspector.mm、DYHistogram.h、DYRenderer.h/mm、DYManagedRender.inc.h、DYCompactUIDiagnostics.inc.h。独立层共用renderer且各自观察其通知,缓存按renderer隔离,失效时清空旧直方图。勿新增定时器、全分辨率读取或UI线程像素统计。
`_colorSettingsExpanded` 是检查器实例内的临时布尔状态。打开和关闭不写模型、不产生宿主撤销项;新建检查器默认收起。隐藏的 `DYManagedColorPanel` 不参与布局高度。说明已缩短,完整条件在工具提示中。
## 正式验证
主题ID0–4依次为深空灰、冰川蓝、薰衣草紫、翡翠绿、琥珀橙;追加ID5黑金渐变。偏好域 `com.dayu.color.preferences`、键 `themeIndex`。没有明确保存偏好或索引非法时使用5;明确保存过的旧选择保留。本机已经通过界面选中黑金。
605项正式原生检查通过;FCP12.4实看最终多色表面、RGB/红/绿/蓝及显隐、色块与真实运动视频的分布更新;最终冷重开主题保持、颜色设置收起、直方图拿到57,600有效采样。完整原预设8,590字节在恢复测试点及最终冷重开后逐字节一致,SHA-256 1f05b3e350dd5fbc054de155062aff87fdd4d46c6a762ee06650ad5bd3363982。
黑金背景为不透明静态渐变,金色细边与亮金文字。NSShadow模糊半径1.8、alpha0.30;系统增加对比度或减少透明度时去掉光晕。色轮、通道曲线和媒体预览保留真实色相。
候选60期间在图表中心添加的masterX0=0.5点在61冷重开后仍保留,最终通过原生载入预设恢复;不能把该主动交互产生的参数差异算作主题修改。拖动/删除没有单独完整验收,不宣称全手势覆盖。无VoiceOver、辅助显示选项矩阵或Instruments全性能采样。SwiftUI扫描器无Swift文件,记录不适用。详细证据见 HostNeon1.8.3.json及 research/ui-neon-20261104/validation.md。
候选58在FCP实机发现“添加模块”标题漏绘:pullsDown菜单的selectedItem可能为nil。正式59从第一项取标题,并增加实际像素绘制检查。候选58已回滚清理,未制作或发布安装包。后续改共用控件时保留普通按钮、弹出选择器和下拉菜单的差别。
APP公证706a58bb-2fa4-4b1e-b392-de60d93aef49,Accepted;正式安装签名/票据/Gatekeeper和实际FCP服务路径通过。发行包由PKG工坊制作并展开验包;本轮APP直接正式安装验收,没有再次执行PKG系统安装脚本。PKG与Release完成状态以相应最终报告为准。未更改NAS后端、网站文章或自动更新清单。
| 入口 | 职责 |
| --- | --- |
| [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) | 本轮需求及实现选择 |
## 继续开发与交付
## 色彩管理的当前合同
保护nil/v2/v3色彩流程、预设v7及模板默认,不因UI改动修改CMS。高级“颜色设置”仍默认收起,开关不改模型。详细数学与恢复依赖按上述历史完整交接和RECOVERY.md。
完整预设格式仍为v7,色彩管理有独立版本。全局方式和一级可见参数各自的责任不要混淆。
tools/checkpoint.py对明确文件提交/推送并核验main,自带仓库锁。tools/deliver.py取得产品锁,保持HEAD直到Delivery.json写入实际编译SHA;正式安装验收通过才输入complete。Packaging/build_pkg.py与Packaging/publish_beta.py复用PKG工坊,最终版本包不进入Git。草稿附件404先确认已上传,使用正常已登录浏览器完整下载后传--verified-download,不重复POST、不提前发布。
| 状态 | 界面方式 | 行为 |
| --- | --- | --- |
| nil | 原有流程(默认) | 保留历史链,不自动迁移 |
| v2 mode1–3 | 1.8兼容,跟随FCP、相机或LUT输入 | 固定ACEScct/AP1,保护1.8.0已存画面 |
| v3 mode4 | 一级CST · 延后输出 | 采用原一级输入、工作域和输出,主输出放在一级层与印片之后 |
v3严格状态为:
```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)。
源代码、历史发行包、私人QA媒体与预设保留。只清理本任务识别的生成APP、旧安装备份、提交ZIP、恢复clone与下载副本;不能扩大为整盘清理。密钥/证书不在Git,发布时重新验证,身份与锁按本机全局约定。