9.8 KiB
统一调色工作区开发记录
日期:2026-11-05(Asia/Shanghai)。基线 main b33b963,工作区干净,已核对远端 main;正式基线 1.11.0(73)。
用户实测后的新版交互合同(2026-11-05)
- 画布左栏恢复有轮廓/按压反馈的图标按钮,复用现有工具符号,不再用纯文字工具名。保留小按钮尺寸和透明编辑图形,避免大面积遮挡。
- 钢笔闭合后的画布必须保留真实闭合曲线,不能短暂或持续退回新建蒙版的默认矩形;覆盖共享对象、写回前即时预览、写回后与一次撤销。
- 取消工作区调整/蒙版/LUT/示波器独立标签。左侧选模块,中央直接编辑;选LUT直接显示旧缩略图浏览器;点击图层蒙版符号进入该图层的蒙版编辑/跟踪及共享关联。
- 右侧永久显示亮度波形、RGB分列、直方图、矢量图四宫格,切模块/LUT/蒙版时保持采样和显示。仍为效果最终输出的显示参考,不扩大为精确HDR测量。
- 窄条内容优先横向,消除上下滚动条;蜘蛛盘用左侧盘面、右侧紧凑控制。大量标量控件按可用高度分列,空间不足用横向延展,保持操作可达。曲线随实际高度适配,不在底部裁切。
- 视觉以用户提供的ColorFinale色轮截图为依据:中性深灰平面、单行紧凑工具条、薄分隔线、明确蓝色选中态、图形与参数横排。工作区去掉大标题、过大圆角按钮和发光边框;保留原检查器的既有主题语义。
结构比较:继续四标签不满足常驻示波器和图层入口;把示波器移到独立窗会分离审核视线;选择单窗三列“图层/当前编辑/四宫格示波器”,分隔线和窗口尺寸可调整。所有调色与共享蒙版继续只有宿主文档一个权威源,新增显示状态不制造参数撤销。原生窗口坐标仍交给宿主,不恢复本机代理frame定位。
当前1.12.0(74)的787项和早前四页设计属于前一候选证据,不能当作以上改动已完成。新候选需重新执行Release、公证、正式安装、视觉/交互验收和发行包交付。
体验合同
采用 standard 原生生产工具界面,保留 AppKit / Objective-C++ / FxPlug。目标是审片时尽量露出画面,横向工具栏添加模块,左侧真实图层列表,右侧只显示选中模块的调整或蒙版/跟踪;LUT 继续复用现有缩略图、文件夹和异步载入逻辑。
比较三种结构:继续画布浮卡会遮挡审片;把全部参数放入检查器受窄宽限制;采用宿主远程外窗和可拖动左右分隔线,默认横向窄条是本轮选择。FxRemoteWindow v2/v3 允许内容最小/最大尺寸,但未提供将远程窗强制嵌入 FCP 检视器下方或设置其屏幕坐标的公开方法;实际摆放能力需宿主实测,不能将可调整大小宣称为已获得宿主停靠能力。
状态所有权:宿主 float / DYToolDocument 是调色、图层和蒙版唯一数据源;工作区选择、页面与分隔线为界面状态,不写调色撤销。基础工具沿旧处理链兼容;新增层真实 UUID,不能以列表索引写回。编辑必须复用已有 action / undo / 回读和异步冲突校验。
画布左栏只保留曲线、镜头畸变、肤色范围、LUT,并常驻蒙版入口;底部为“控制面板”。曲线只保留曲线与直方图及必要通道选择,畸变直接操作图形;LUT 进入工作区浏览。
用户追加:蒙版是可复用对象,可先画后勾选一个或多个模块,也可选模块后画,再把其它模块加入对象。形状和跟踪属于同一对象,不能以复制多份蒙版伪装同步。入口在画布左侧。
有限状态:工具调整 / 蒙版编辑 / LUT 浏览 / 示波器;选中图层消失时安全退回存活选择;切页、关窗及目标变更取消过期异步任务。已有降透明度/主题/键盘和可访问标签保持;无需添加装饰动画。
研究与验证边界
逆向研究保持原版只读,只保存接口合同、参数事实和证据索引;原版反编译源码、二进制和图标不纳入产品仓库。现有独立跟踪实现与原版配置差异需逐项验证,未建立相同输入对照前不宣称完整等价。
验证覆盖工作区真实 UUID、添加/删除/选层、双向检查器同步、共享蒙版关联与取消关联、同一跟踪轨迹、LUT 旧浏览逻辑及过期回调、窄条/缩放/分隔线、OSC 命中/捕获/undo、正式 FCP 宿主。用户可见验收只运行正式公证安装版。
正式候选 1.12.0(74)
已实现横排15种工具、真实UUID层表与右侧单工具编辑、四通道曲线并排、四页工作区、LUT目标切换与取消过期载入、共享蒙版schema3和6种蒙版编辑;左画布矩形/椭圆/钢笔常驻,透明曲线/畸变/肤色/LUT入口及底部控制面板;矩形和椭圆直接拖框,旧右侧蒙版按钮栏已移除。共享对象可先画后关联,或关联选中模块后再加其它模块,独立解除关联不会删除对象。
OpenCV4.5.1由官方锁定源码静态构建并随包保留全部许可,宿主工具蒙版跟踪已接入。原版请求Gamma2.2、大鱼请求linear;分析专用路径按linear→Gamma2.2→MPS Lanczos→RGBA8→OpenCV整数Gray8执行,上限3840×2160且保持原像素网格。普通调色渲染不执行全帧跟踪读回,分析结束释放4K GPU工作纹理。已有12项生成运动参考和784项集成检查通过,尚无原版同视频完整轨迹对照,alpha/非方形像素/宿主颜色请求满足情况分别保留验收边界。
共享蒙版在画布、工作区、主检查器与跟踪内部统一为全局对象身份;切换同一对象的模块入口或删除某一关联模块,不丢弃进行中的轨迹。LUT目标重绑关闭旧浏览器时抑制“返回调整”回调,保持新目标浏览页。分栏初始化不会写入用户偏好;图标工具条、普通文字标题与约21%默认图层栏已完成原生离屏视觉检查。
中间候选9ba6eeb的公证8fa0d3d6-a7a9-4a6c-84f2-3b0490ef1eaf已Accepted,但未安装、未发布;最终候选在此之后修正视觉布局和分析预处理,必须重新构建、公证,不能复用该票据。
复核1.7.2/1.7.3远程窗口记录后,不在FCP远程窗口调用本机frame恢复/自动定位,避免ViewBridge坐标归属错误。分栏比例保存于产品偏好,实际摆放由宿主与用户拖移管理。此处不是原生嵌入FCP检视器。
正式公证候选a0a97df安装后,在FCP12.4实际打开控制面板,已观察到横排添加“曲线2”、右侧四通道/直方图、矩形对象依次勾选曲线2/蜘蛛盘/HSL,三个模块下出现同一蒙版引用,关闭工作区后普通检查器也显示新增曲线和各自蒙版数量。尚未把这些操作扩写为画布实鼠或跟踪通过。
该宿主检查同时发现初始窗口过大和旁路图标被左栏边缘裁切。修正后默认向宿主请求720×300至1440×360窄条,可明确切换扩大(最大2400×1200,受宿主80%限制)或收为窄条,不修改代理窗口frame。原生最低宽度回归确认旧滚动容器实际可视宽度151而单元格174,且圆角按钮对齐矩形超出行边界;改用自有分栏缩放委托、实际clip view宽度、overlay滚动条、无额外insets及按真实cell布局的无边按钮,保留几何断言防止复发。787项原生检查通过。
最终编译源码226b7e1e93dfd5fa2ee2f002fdc828077a2f7f46已完成Release、逐层正式签名、公证b666b44e-83d3-4edd-88e7-f0c5cf83f8ce Accepted、票据、Gatekeeper、唯一正式安装、PluginKit及正式安装787项检查。再次进入FCP实测时系统报告Mac锁屏,不能自动解锁;已请求用户手动解锁,未绕过锁屏。最终候选宿主验收、PKG和Release尚未完成;旧恢复APP保留。详情在verification/HostUnifiedWorkspace1.12.0.json。
远端独立恢复已验证577个编译节点文件逐字节相同、full/strict fsck、8个色彩依赖源包及官方OpenCV源包锁。后续发行标签仍需单独核验。新增同素材ColorFinale参考项目的XML只引用本机原生效果路径,不复制商业模板或代码;严格DTD/媒体验证通过,尚未导入宿主。
2026-11-05 主检视器空白的现场记录
用户实测截图显示 FCP 自定义视图空白。系统日志在 09:43:55 记录 Unable to create custom view,FxPlugErrorDomain=16;本机 SDK FxTypes.h 将 16 定义为 kFxError_PluginNotFound。现场未发现本次 1.12.0 正式服务的对应崩溃报告,不能把既有 1.10.0 的诊断崩溃当成本次证据。后台完整 APP 编译会执行 RegisterWithLaunchServices,临时构建副本进入 PluginKit,可能干扰宿主插件重连;已移除构建副本登记。用户测试期间只编译 XPC 目标并核验不会执行 LaunchServices 登记,最终完整构建必须宿主正常退出后进行。参数回调改为每个待处理主队列批次只发一次模型更新,避免一个事务数百次视图刷新;需要正式版重复切换与重开验证,暂不宣称空白故障根因已完全解决。
四宫格第四项采用显示参考 RGB 的 BT.709 色差坐标,计算来源为 ITU-R BT.709-6 第 3.3 节。保持现有显示参考采样边界,不把它标为精密 HDR/IRE 测量。
用户已确认空白出现在切换片段或重新打开检视器后,已正常退出FCP。XPC单目标构建和812项原生离屏检查已通过,PluginKit维持唯一正式路径。正式75候选将包含后台远程回调与会话过期检查,再执行签名后完整原生自检与宿主重复切换;保留SDK reply返回前同步接入子视图的已验证尺寸合同,不以无现场证据的异步替换破坏旧几何修复。