# 统一调色工作区开发记录 日期: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坐标归属错误。窄条最小720×300,最大由宿主上限决定;分栏比例保存于产品偏好,实际摆放由宿主与用户拖移管理。此处不是原生嵌入FCP检视器。签名、公证及宿主验收尚待完成。