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

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

@@ -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)。