# 统一调色工作区开发记录 日期:2026-11-05(Asia/Shanghai)。基线 main `b33b963`,工作区干净,已核对远端 main;正式基线 1.11.0(73)。 ## 体验合同 采用 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/媒体验证通过,尚未导入宿主。