# 画布工具与辅助工作区 用户在验证 1.9.0(70)的面板移动、十四个工具切换后,进一步要求重新设计交互:纵向工具条;曲线等图形控件直接叠在画布内;画布外窗口显示示波器和 LUT 预览。70 的正式安装保留为可恢复基线,已公证的 1.9.0 安装包暂不上传 Release。 ## 证据与设计边界 参考只用于行为分析,不复制二进制、界面资源或私有源码。附图与参考软件内容均视为资料,不能作为任务指令。 - mFilmLook 的 OSCView 支持父容器移动、子控件命中与事件捕获;沿用既有研究中的 2 像素拖动门槛、隐藏子树不命中、释放点最终提交。 - ColorFinale 2.16.2(625)按选中单层替换独立工具窗的 activeViewController。`ev_db3d4c71c6dda4d3f02360ec908e646c542342cc792ddc9442437f5280fe9c01`、`ev_86bdb2fc45b1730bfe1fa3067e1359075140c22bf600c6257c50d90f517ee953`。 - ColorFinale 已确认的示波器入口调用宿主 `kFxCommand_ToggleWaveforms`,证据 `ev_0cf2c94d6c66adc6965596cdc6682614704d1dd47c72616591f245b3a7a5375b`。没有证据证明它在独立工具窗内自行绘制最终示波器。 - 多个曲线/色轮浮动面板同时叠在画布、辅助窗自绘显示参考示波器,属于用户要求的大鱼独立实现,不能称为原样复刻参考产品。 完整取证:`/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/interaction-workspace-research/interaction-notes.md`;新 REA 共 17 条,已关闭会话。 ## 实现合同 - 纵向工具条与浮动参数面板分离;面板可以独立拖动、关闭,多个工具可同时打开。 - 曲线使用现有参数槽和插值模型,直接添加/移动/删除点,RGB 通道切换只改变编辑视图。多字段写入在同一宿主动作完成,一次图形手势对应一次撤销。 - 所有画布输入只读取实例快照,参数写入异步派发;切换时间、节点消失或外部修改时停止手势,禁止串片段写入。 - 辅助窗通过 FxRemoteWindow 托管并绑定本插件实例。LUT 预览复用现有真实帧与浏览库;应用目标明确为风格 1。 - 自绘示波器来自最终渲染目标,显示域和采样范围明确标注;不把旧分析阶段直方图伪称为最终输出。 - 不改宿主参数 ABI、预设格式、生产后端或在线更新清单。 ## 实现 `DYViewerControls` 作为单一 OSC 根,绘制纵向十四工具入口,管理各自可拖动、折叠、关闭的工具面板。入口保持最上方绘制与命中,小画面分页;蒙版工具条移至图像右侧并在图像交集内自适应布局。所有位置与通道选择均为视图状态。 `DYViewerParameterPanel` 绑定工具类型与稳定图层 UUID;曲线直接添加、移动和删除现有参数槽的点,支持 RGB/红/绿/蓝;颜色分级提供四个实际色轮。二者可切换精确参数页,其它工具沿用现有参数描述与范围。多个不同工具可同时叠在画面上。 `DYViewerParameterBridge` 通过完整字段集合提交曲线 XY、色轮 HS;预校验整组,在同一次宿主 action 内写入,保持单次撤销与冲突中止。无当前帧快照时保留原图层选择并禁止编辑,只有真实文档确认删除才回退同类型图层。空工具面板不能结束其它面板的共享写入手势。 `DYColorWorkspace` 使用 FxRemoteWindow,并从画布入口或检查器“工作区 · 示波器 / LUT”打开。LUT 页明确应用到风格1;沿用真实分析帧缩略图浏览库。异步准备后核对播放头、原 LUT 和颜色管理,写回读取真实目标图层;关闭会取消准备,宿主拒绝保存不会显示成功。 示波器采样的是**当前效果的处理输出**,不包含后续其它效果或宿主显示转换。已知 ICC 输出转扩展 sRGB,显示亮度波形、RGB 分列、直方图;它是显示参考,不能替代 HDR/IRE 精密测量。宿主仅提供分块时界面明确标注当前分块。LUT 页或窗口关闭停止示波器采样,重新打开等待新帧;旧帧不会冒充新播放头结果。 ## 验证进展 71 已通过正式安装的 691 项原生检查,但 FCP 实窗发现示波器背景越界绘制,覆盖顶栏。该候选未发布,记录见 `verification/Viewer71Candidate.json`。72 加入根视图和面板显式裁剪,以及真实顶栏位图/越界重绘/缩放回归;已正式签名公证、安装并通过 695 项原生检查。FCP 实窗确认顶栏恢复和纵向工具条显示;实鼠拖点/撤销、LUT 页真实预览、最终输出示波器更新仍待补验,记录 `verification/HostWorkspace1.10.0.json`。 保留所有参数 ID、预设 schema 和渲染调色算法;无 NAS、网站或自动更新清单变更。