21 KiB
大鱼调色开发交接
更新于 2026-11-06(Asia/Shanghai)。这是新对话的接手入口。历史设计和实现细节按需查阅专项交接,复现和交付证据以对应版本的报告为准。
当前基线
| 项目 | 已核对状态 |
|---|---|
| 工程与源码 | /Volumes/备份/大鱼调色/大鱼调色,大鱼调色.xcodeproj,Wrapper Application / Release。远程为 https://dayu.media/git/dayu/dayu-color.git,分支 main。1.15.0(96)实际编译节点为 a2a6e57c13977ea2fc313f91b4d765ea86498f10。 |
| 本机正式安装 | 1.15.0(96),/Library/Plug-Ins/FxPlug/大鱼调色.app。公证、票据、Gatekeeper、唯一 PluginKit 路径及 898 项正式原生自检通过。交付 · 宿主验收 |
| Git Release | 1.15.0(96) 已签名公证并验包,正式包位于 /Volumes/备份/大鱼调色/发行包/大鱼调色-1.15.0.pkg。标签 v1.15.0-modular-leveling-20261106 指向 b85165b6e2586ff86cab8fbf13ee8474fb3356a0。Release 397/附件 41,草稿和正式链接均已完整下载校验。发布页 · 发布回读 · 安装包 |
| 站点及自动更新 | 原文章 15792 的主下载已切换至 1.14.4(95),正文顶部显示验签修复和重新下载安装提醒。站内附件 15865 已完整下载,内容与正式包逐字节一致。主 APP 公测通道上次回读为 1.12.0(79)。原文章 · 文章核验 · 更新通道核验 |
| 本机开发与验收 | AppKit / Objective-C++ / FxPlug 4 / Metal,Apple Silicon,macOS 14.6+。交付记录使用 Xcode 27.1、FxPlug SDK 4.3.5 和 FCP 12.4。构建缓存为 /Users/mac/Library/Caches/CodexBuilds/com.dayu.color,验收素材库位于其中的 fcp-qa/大鱼调色_验收.fcpbundle。产品交付锁为 /Users/mac/.codex/app-delivery-locks/com.dayu.color.lock,接手时重新检查。 |
1.15.0 深色默认、独立效果与水平校正
- 新用户默认深色,保存过的浅色选择会被读取。独立效果使用既有的 FxPlug 和工具文档,分别预置并展开一级调色、HSL 混色。整合版保持原路径、滤镜 UUID 和发布项。独立
.moef只发布自定义检查器,模板无版权或网址发布项。三个效果随同一 PKG 安装。 - 「水平校正」支持水平或垂直、两点或拖线。按实际画面宽高比计算旋转及覆盖四角的最小放大倍率。校正应用于完整效果输出,屏幕蒙版和图章位置按同一变换映射。校正状态随效果和完整预设保存,Cube 导出会提示改用完整预设。
- FCP 12.4 独立验收库确认两个独立效果的初始模块、控制面板和继续添加模块,整合版原四组及混合仍可见。载入 −8° 校正预设后,合成网格拉平、画面覆盖四角,冷重开继续生效。两点、拖线、撤销、重置和 Esc 由 898 项正式原生自检中的 OSC 回调覆盖。自动实窗鼠标未进入 FCP 的 OSC,手动实机画线仍待复核。验收范围
- 接手续测时可打开缓存中的独立资源库
fcp-qa/level-1.15.0/未命名.fcpbundle,选中 HSL 或一级调色片段,从画面右下角校正图标手动画线,复测保存与撤销。
1.14.4 安装权限和启动验签
- 94 版分发后,多名用户反馈“安装完整性验证失败”。用户提供的修复记录指出有四个不可读资源及一份放在
/Applications的重复 App。94 正式 PKG 的 BOM 恰有四个root:wheel、0700文件,分别为外层 App 的Basis_balanceWheel.png和内置模板的large.png、small.png、大鱼调色.moef。在原签名副本上模拟读权限丢失可复现严格验签的Permission denied,修正为0644后通过,不需要重签。PKG 自身的载荷与脚本均指向固定 FxPlug 路径并禁用重定位。未获取受影响设备的诊断或确认重复副本来源。 - 94 包中主 App 和插件服务的 Apple Developer ID 证书链均完整。单独使用系统信任根、排除用户钥匙串和联网,两条链均通过。开发机本轮复核的 94 App 是由交付脚本复制、当前用户持有的正式安装,能读取这些文件,未覆盖安装器改为
root后的权限场景。 - 95 版启动和注册检查两个可执行文件、Apple Developer ID 团队、签名标识、位置关系和版本一致性。全资源和嵌套框架扫描保留给下载更新包,签名改动、重签、缺失及混装对照检查通过。交付脚本将上述四个资源设为
0644,打包前检查实际 App,公证后检查最终 BOM。未发布的原始 95 候选经新权限门槛确认失败后重制,历史 94 包保留。第三方机器的新版安装结果仍需回访。 - 原文 15792 已绑定附件 15865「大鱼调色-1.14.4.pkg」,在正文顶部提示验签修复并请遇到报错的用户重装。原标题和 SEO 继续描述 1.14.3 的跟踪更新,安装段已指向 1.14.4。正式下载目标取回 45,381,319 字节,与本地正式包逐字节一致,下载副本的公证票据验证通过。封面、分类、价格和会员规则回读一致。站点验收
1.14.3 站点文章
- 在原文 15792 就地发布 1.14.3(94),更新版本介绍、安装说明、SEO、特色图片与站内主包。正文展示用户提交的 2046×1570 原图。1672×941 封面注明「不加密 · 不限制安装数量」。文章的历史界面图片、普通用户 50 元和鱼粉会员 0 元均经前台核验。
- 文章主包下载名为「大鱼调色-1.14.3.pkg」,完整下载与公证发行包的字节数及 SHA-256 一致。发布输入与两张图片保存在 1.14.3 发布目录,前后台和附件验证见 站点验收。下次更新从文章 15792 的当前内容和资源字段回读开始。
1.14.3 图章稳定与逐帧跟踪预览
DYToolState.mm在连续分析段写入前,使用最多五帧的对称窗口平滑图章两侧坐标和对数缩放,起点与最后可信帧保持原值。Metal 跟踪渲染支持连续的亚像素取样,相对缩放经过 1 倍时连续过渡。取样跨出画面边缘时在最后一个像素内过渡。旧图章重新执行双向跟踪即可应用轨迹平滑。- 仿制图章和普通蒙版共用控制面板右侧的进度和同步预览。预览采用同一分析帧的画面与轮廓,图章显示青色取样和黄色覆盖,普通蒙版显示黄色轮廓。进度统计双向分析时的唯一帧数,进度条直接按比例绘制。自动分析期间时间线播放头停在起始位置,单帧跟踪仍按宿主时间映射移动播放头。
- 在上次 257 帧 4K 轨迹离线回放中,取样中心二阶帧差 RMS 从 2.71 降到 0.95 像素,覆盖中心从 2.43 降到 0.92 像素。独立实拍副本中,图章和矩形蒙版均完成 190 帧跟踪,保存回读为连续 25 fps。94 版重跑验证了画面、轮廓和进度,51% 时条形填充与数值一致。验收覆盖本机 Final Cut Pro 12.4 与原生自检。实拍验收
- 接续实拍反馈时,先在原问题片段重新跟踪旧图章,记录方向、首个异常时间码和取样区。若需复测,可使用本机验收库的独立副本。
1.14.0 图章取样与覆盖跟踪
- 用户在 1.13.4 的实拍工程中确认图章可落位、拖动,随后要求取样点和覆盖目标都参与跟踪并识别缩放。1.13.4 实鼠确认
- 两个区域各自使用同一宿主源帧运行 OpenCV 分析。写入的每个轨迹键同时记录两点的位置与缩放。任一侧跟丢时,提交本次最后一段两侧均可信的连续轨迹。普通蒙版沿用原分析。旧图章单点轨迹仍按位移求值,可重新跟踪以获得双点数据。
- 覆盖圈随覆盖区域缩放。渲染按取样区域和覆盖区域的相对缩放映射当前帧的源像素,两侧缩放相同时保留整数像素平移。调大或调小覆盖范围仍可独立操作。清除轨迹时将当前帧的图章外观保留为静态值。
- 89 版在 FCP 12.4 实拍素材上完成正向和双向跟踪。双向导出得到 257 个连续双点键,并发现片尾一个原有自动键与最后的新键只差 6.33 毫秒。90 版按半帧识别同帧自动键,在分析范围边缘替换旧键,同时保留手工编辑和分析范围之外的轨迹。90 版在同一 4K 源帧上生成 257 个连续双点键,无旧键残留。最终帧横纵缩放分别约为取样 1.387 / 1.689 倍,覆盖 1.169 / 1.203 倍。两边各有独立的中心轨迹。1.14.0 实拍与原生核验
1.13.1 等像素复制与取样十字拖动
- 选中图章后可拖动青色取样十字。拖动时更新标记,松手后换取样位置并形成一次撤销。Esc 取消,旧图章可直接编辑。源点调整适用于图章的全部帧,目标位置轨迹保持原样。
- Metal 按整数像素偏移直接复制当前帧中的原像素,羽化只混合覆盖边缘。改变椭圆宽高只修改覆盖范围。画布和工作区移除图章旋转控件。跟踪继续用现有分析器求解运动,图章只应用中心位移。旧项目的轨迹键保留,历史缩放与旋转分量在图章求值时忽略。普通蒙版仍使用原有变换。
- 入口为
DYToolOSC.inc.h、DYToolCanvasEditing.inc.h、DYToolHostMethods.inc.h、DYToolState.mm和DYGrade.metal。画布写回继续校验时间、图章 ID 和外部修改冲突。原生检查覆盖一次撤销、Esc 取消、拖动和调尺寸时保持跟踪键,以及实际 Metal 输出的等像素复制。
1.13.0 历史交付 · 画布响应与仿制图章
- 旧版工具栏重绘会清零并上传整张 CPU 位图。无蒙版、未进入图章取样时,新版只绘制工具栏和已打开面板所需的区域,并沿用宿主提供的透明画布。4K、2 倍缩放的空闲工具栏位图为 1000×134,约占 3840×2160 的 1.6%。蒙版与图章绘制仍可能使用整画布。
- 工具文档复制改用内存深拷贝,已验证的不可变文档副本共享内容。每帧快照直接从选中的关键帧生成,不再绕一次序列化往返,也只为胶片层读取颗粒参数。M4 合成测试用四条各含 2400 个键的轨迹,40 次复制平均耗时从 18.018 ms 降到 10.949 ms。上述是局部测量,第三方反馈缺少触发动作、素材和工程,尚无法对同一场景前后复测。
- 点击画布右下角仿制图章,点选取样中心,再拖出椭圆覆盖区。Esc 取消未保存操作。选中图章可直接在画布启动正向、反向或双向跟踪,也可在工作区选择图章,调整几何、强度和羽化、清除轨迹、旁路或删除。
- 图章用现有共享蒙版文档和跟踪轨迹保存,使用独立标识,每次创建为一组撤销。取样位置和原取样尺寸固定,目标跟踪位移、缩放和旋转。Metal 从每帧同一源画面采样,在调色前处理预乘 RGBA,重叠图章按创建顺序合成。完整预设保留图章,启用图章时拒绝导出无法表达空间修改的 Cube。
- 关键路径为
DYToolOSC.inc.h、DYViewerControls.inc.h、DYToolHostMethods.inc.h、DYToolState.mm、DYManagedRender.inc.h和DYGrade.metal。下一次排查卡顿时,先区分空闲画布、曲线拖动、工作区示波器和有蒙版的 4K 播放,再抓取对应场景的运行时间。
1.12.1 历史交付
- 检视器以紧凑高度打开,顶部按钮固定在参数滚动区外。80 版在接入宿主后强改视图高度,造成顶部裁切。81 版由 FCP 管理已挂载视图的空间,超出可用高度的模块在参数区内滚动。
- 画布工具栏与曲线默认在右下。曲线顶部手柄可移动面板。松手后保留最终点位,等宿主写回后接续正式参数;保留时间和图层校验及一次手势一次撤销。
- 画布与检视器的曲线直方图取样自当前效果的输出。画布按显示帧匹配,检视器接收效果输出更新。曲线直方图与工作区四宫格示波器各有显示用途,继续沿用各自的取样和色彩说明。
- 画布新增白平衡吸管,复用基础调整的求解和参数写入;畸变修复使用枕形网格图标。独立图层被宿主拒绝写入时增加本机诊断
dayu_tool_save_rejected。
接手时的代码入口
下表中的文件位于 大鱼调色/Plugin/。
| 范围 | 入口 |
|---|---|
| 检视器高度、滚动和曲线刷新 | DYInspector.mm 的 layout、curveOutputChanged: |
| 画布工具、曲线拖动和写回 | DYViewerControls.inc.h、DYViewerParameterPanel.inc.h、DYViewerParameterBridge.inc.h |
| 效果输出取样与直方图 | DYScopeCapture.inc.h、DYScopeSample.mm、DYHistogram.h |
| 画布白平衡与宿主写入诊断 | DYPlugIn.mm、DYColorTables.h、DYToolState.mm |
| 工作区、共享蒙版与跟踪 | DYColorWorkspace.mm、DYToolState.mm、DYToolOSC.inc.h。共享蒙版以工具文档 schema 3 为编辑源,渲染展开副本只用于渲染。工作区与跟踪专项交接 |
验收与待跟进
-
86 版安装完整性加固。
Shared/DYCodeIntegrity.m固定 Apple Developer ID Application、团队和签名标识,验证正在运行的代码及磁盘上的外层 APP、插件服务与签名资源。外层注册前拒绝改包并撤销此副本登记。XPC 在进入 FxPrincipal 前独立校验。更新器验签失败后取消本次运行的更新任务,停用检查、下载、安装,恢复须安装原包并重开。 -
分发与边界。 原始 PKG 允许原样转发,无机器码或账号授权。用户选择保留后端自动更新策略,由新版本在本地拒绝改包。对方若保留签名内件,只在外部加装控制,内件验签仍可通过。缺少倒卖样本,实际改法待确认。拒绝路径、旧包校验、原版更新及宿主画面均有独立记录。完整性测试
-
85 版历史防护评估。 1.13.1(85)的正式 APP
com.dayu.color与 FxPlug 服务com.dayu.color.XPC都由B3W25FX5H5的 Developer ID Application 签名。该版的外层AppDelegate.m在调用pluginkit -a前只检查组件元数据。插件Plugin/main.m直接进入FxPrincipal,效果清单为静态登记。 -
验签实测。 用临时 Security.framework 探针对正式安装与独立副本执行静态签名校验,要求 Apple 签发的 Developer ID Application、指定 Team ID 和各自的签名标识。正式 APP 与服务均通过,错误标识、服务掉签、服务临时重签、Metal 资源被改及外层 APP 临时重签均被拒绝。仅重签外层时,原版内层服务单独校验仍通过。临时副本已清理。本轮未运行改包,也未获得倒卖样本,无法确认对方实际改动。
-
85 版像素复制与十字。 正式安装的 864 项原生检查通过,实际 Metal 输出验证扩大覆盖只增加复制面积,重合像素逐值相同。FCP 12.4 独立项目副本读入 83 版图章,画布和工作区都只提供中心与尺寸控制,导出后原图章和 99 个轨迹键逐项一致。实窗自动拖动未产生宿主写入,十字拖动、一次撤销和 Esc 取消由正式安装版的原生回调覆盖。工作区“画面编辑”按钮仍沿用通用蒙版提示文字。验收证据
-
83 版图章与跟踪。 安装后的 858 项原生检查通过。FCP 12.4 独立验收项目副本中已看到图标、取样十字、目标区及实际贴图。工作区触发真实正向跟踪,冷重开后导出的预设保留 99 个轨迹键,目标几何变化,取样坐标和尺寸一致。宿主测试通过载入验收预设创建图章。画布点击及拖选由原生 FxPlug 回调测试覆盖,自动鼠标输入没有进入实窗的 OSC 回调。验收证据
-
正式 81 版通过 844 项原生检查。FCP 12.4 冷重开后,检视器顶部完整显示,曲线读到 57,600 个输出样本,原调色参数成功读回。同帧输出变更和检视器直方图刷新已通过原生检查。用户手动确认的是 80 版的画布曲线和实时直方图。宿主验收
-
画布白平衡待实机复核。 已验证取样入口分发、播放头改变后的写入保护、白平衡求解、色温和色调写入及一次撤销。下一次实机验收补做系统取样界面的点选和取消,核对取样后色温与色调的实际变化。宿主验收范围
-
第三方 FCP 保存告警待反馈。 本机内置 APFS 验收库未复现,退出重开读回正常。收到报错前的操作、时间、FCP 和插件版本、素材库位置后,再区分卷写入故障、素材库异常与特定插件写入触发;先保护原库与备份,复现在独立验收库进行。保存告警排查
-
站点文章、自动更新通道和 Git Release 分别交付。接手通道更新时,以实时清单、正式包和对应的生产回滚记录为准。更新部署说明
继续工作
- 核对
git status --short --branch、远端引用、正式安装版本与交付锁。先在独立 FCP 验收库重现用户本轮指定的问题,保留原工程和既有参数语义。 - 代码变更按 RECOVERY.md 恢复和验收。常用入口为
tools/checkpoint.py、tools/deliver.py与Packaging/build_pkg.py;交付脚本等待宿主验收时,通过后才输入complete。 - 按 AGENTS.md 在结束前更新本文并提交、推送、回读。
可复制到新对话:
在
/Volumes/备份/大鱼调色/大鱼调色继续优化大鱼调色。先读项目AGENTS.md和开发交接.md,以核实后的正式安装和验收记录为基线,按我接下来指定的内容修改。完成后更新交接文档。
任务记录
| 日期 | 任务 | 结果与接续 |
|---|---|---|
| 2026-11-05 | 检视器、画布控件与保存告警排查 | 81 版正式安装并发布。80 版的画布反馈已复核,81 版修复检视器裁切与直方图刷新。剩余实机取样和第三方告警见上。 |
| 2026-11-05 | 建立每次任务的交接流程 | 新建本入口及项目规则,为历史专项交接加指引。回读核对了正式安装 81、远程版本标签、站点文章及公测通道 79。本轮成果为项目文档。 |
| 2026-11-05 | 画布响应与仿制图章 | 83 版正式安装,补齐图章渲染、现有跟踪复用及工作区编辑。性能局部测量、FCP 实帧和冷重开证据见本页,反馈场景待复现。 |
| 2026-11-05 | 仿制图章等像素复制与取样十字拖动 | 加入源点拖动和撤销,复制改为整数像素平移,目标跟踪保留中心位移。 |
| 2026-11-05 | 二次打包与重签防护评估 | 已核对注册和 XPC 启动入口,并用正式 85 版和改动副本验证候选验签规则。下一步可接入双入口校验并在正式安装版上复测 FCP。 |
| 2026-11-05 | 防二次加密和重签 | 1.13.2(86)正式安装。注册、服务启动和更新入口加入验签,FCP 和安装包通过验收。公测 Release 393 已发布并完整下载核对,站点及自动更新策略沿用原配置。 |
| 2026-11-05 | 更新 1.13.2 站点文章 | 在原文章 15792 更新正文、SEO 和主下载包,加入验签、原包转发规则、仿制图章与故障排查说明。原售价、会员权益、封面和历史图片均已回读,主包完整下载校验通过。公测自动更新通道回读为 1.12.0。 |
| 2026-11-06 | 仿制图章松手消失和拖动回弹 | FCP 在同一次手势给出相差约 32 毫秒的绘制时间与参数写入时间。88 版将图章文档写入与几何时间分开,用户实拍确认可拖动。本机正式安装和 88 安装包已验收;接续实现取样与覆盖区域独立跟踪及缩放后再发 Release。 |
| 2026-11-06 | 图章跳动闪烁与逐帧跟踪预览 | 1.14.3(94)正式安装和发布。图章与矩形蒙版实拍双向跟踪、轨迹回读、进度和取样连续性通过验收。 |
| 2026-11-06 | 1.14.3 更新到站点文章 | 原文已发布新版本,绑定界面原图、新封面和 94 版主下载包。前台 SEO、原图与封面、商业字段和完整下载均已核验。 |
| 2026-11-06 | 复核分发后的完整性失败 | 核实 94 包四个资源的落盘权限并复现严格验签失败。95 版修正权限、缩小启动检查范围并加入打包权限检查。现场证书链和宿主核验见上。 |
| 2026-11-06 | 更新文章 15792 的正式包 | 原文章下载替换为 95 版,发布修复和重装提醒。前台和站内下载完整校验通过。 |
| 2026-11-06 | 深色默认、独立效果与水平校正 | 1.15.0(96)已正式安装并发布,安装包完整下载校验通过。两款独立效果可添加模块。实窗手动画线待复核。 |