docs: establish unified workspace baseline and shared mask contract
这个提交包含在:
1 父节点
b33b9634e2
当前提交
78e53b3889
1 个文件已更改
+25
@@ -0,0 +1,25 @@
|
||||
# 统一调色工作区开发记录
|
||||
|
||||
日期: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 宿主。用户可见验收只运行正式公证安装版。
|
||||
|
||||
程序尚未改版、未宣称交付。后续阶段在本记录补充实现、验证及缺口。
|
||||
在新工单中引用
屏蔽一个用户