From b33b9634e247f402807307933960732f5471ae61 Mon Sep 17 00:00:00 2001 From: mac Date: Thu, 5 Nov 2026 02:33:13 +0800 Subject: [PATCH] docs: refresh canvas control handoff for accepted 1.11.0 --- 自定控件开发交接.md | 249 ++++++++++++++++++++++++-------------------- 1 file changed, 137 insertions(+), 112 deletions(-) diff --git a/自定控件开发交接.md b/自定控件开发交接.md index a443179..5ad306d 100644 --- a/自定控件开发交接.md +++ b/自定控件开发交接.md @@ -2,164 +2,189 @@ 更新日期:2026-11-05,Asia/Shanghai。 -## 本轮 1.11.0(73)交付状态 +继续优化控件应以已经交付并由用户验收的 **1.11.0(73)** 为基础。曲线直方图、HSL、蜘蛛盘的半透明画布编辑,四张折叠卡的主面板,人脸肤色保护及区域预览、镜头畸变修复均已完成。本轮原目标已经结束,下一轮根据用户指定的工具或交互继续优化。 -本轮已实现曲线直方图、HSL八色三轴、蜘蛛网格的半透明画布编辑;主检查器默认只显示一级、蜘蛛、基础、HSL四张折叠卡,其它模块由添加菜单或画布入口显示。已有非默认调色和蒙版自动保留为可见模块。全部还原也恢复四卡折叠布局。 +本次更新交接文档,不修改程序、版本或正式安装。已将旧版交接中“蜘蛛盘/HSL尚未移入画布”“当前版本为1.10.0”等过时说明合并为当前状态;历史过程保留在 Git 和研究记录中。 -肤色保护增加默认开启的人脸限定和“显示肤色保护区域”,使用当前帧 Vision revision3/76点、人脸轮廓、额头及五官排除,并与原色选及用户蒙版相乘;灰度显示实际保护权重。无脸与失败帧为空,不沿用上一镜头。基础与UUID独立层均支持。参考FCP-BeautyGirl的思路与MIT许可见research/FCPBeautyGirl-MIT.txt。 +## 工程和正式版本 -新增“镜头畸变修复”工具,支持正反径向校正、缩放与光学中心,接入独立层、蒙版、预设和撤销。其采样由本项目独立编写,尚无目标GPU逐像素等价证明。人脸选区和镜头修复不能导出到静态Cube,完整预设可保存。 - -APP正式编译SHA `49d35cb49ab93f5ab6ca3411eaea80f7219be346`,Apple公证 `348c6e9b-f5d9-4661-bc7f-f192fa770ecf` Accepted,票据/Gatekeeper/唯一位置安装及724项正式安装自检通过。用户已实鼠确认画布/肤色/畸变“三项均正常”,详见verification/HostCanvasTools1.11.0.json。交付脚本已完成,Delivery为 **verified**;旧版恢复APP已清理,交付锁已释放。PKG容器签名、公证Accepted、票据及20项展开验包通过,保存在上级发行包目录,见verification/Package.json。Release最终发布及下载核验见verification/Release.json。 - -最终版本标签 `v1.11.0-canvas-spatial-20261105` 对应提交 `5f8fb13fceb0c4d4ead447b8b5694ce269e95749`。Release 388、附件32已发布(保留原有公测标志),草稿与发布后附件分别完整下载校验一致;远端独立检出555文件与版本标签逐字节一致,程序及模板与实际编译源码一致,full/strict fsck通过。记录见verification/CanvasFinalRecovery1.11.0.json;临时下载、恢复clone及公证提交副本已清理,历史发行包保留。正式唯一安装和本轮有界扫描见verification/CanvasCleanup1.11.0.json。 - -FCP 12.4已成功导入三个验收项目,无导入错误;实际主检查器四张折叠卡与图像已观察到,服务进程使用正式安装路径。事件“大鱼调色_1.11.0_73_画布与空间工具”。工具 `tools/create_canvas_host_fixture.py` 可重建FCPXML、两项测试预设与网格;真人fixture随源码保存于tools/fixtures,仅用于验收。静态DTD/素材检查通过不等于鼠标功能验收。 - -新增代码入口:DYFaceRender.inc.h(Vision与镜头渲染),DYCanvasToolsDiagnostics.inc.h(新增29项回归),DYToolGPU.h(人脸覆盖元数据),DYGrade.metal及tools/build_masked_kernel.py(实际肤色选区输出)。旧Uniform完整1312字节前缀不变,仅追加32字节;旧参数ID和预设v7不变。蜘蛛写入使用DYViewerParameterBridge的beginSpider/changeSpider,必须保持冲突检查和一次撤销。 - -AddressSanitizer完整724项无内存错误,插桩下唯一旧性能阈值失败;正常Release全部通过。修复旧渲染C++引用捕获向异步通知泄漏self栈地址的问题,通知必须通过独立Objective-C方法调度,避免恢复旧写法。 - -源码和阶段记录已持续推送;实际编译SHA从远端独立恢复549个文件逐字节一致、full/strict fsck及模板合同验证通过。最新明细见research/CanvasTools-20261105.md及verification/CanvasSourceRecovery1.11.0.json。旧1.10.0 Release387草稿不属于本轮新发行,保持原状。 - -## 以下为1.10.0基线交接 - -更新日期:2026-11-04,Asia/Shanghai。下一阶段继续完善「大鱼调色」的画布自定控件与画布外辅助工作区。当前正式版本为 **1.10.0(72)**,曲线拖点与一次撤销、LUT 预览、示波器随播放头更新已由用户实鼠确认。后续可以在这个版本上继续开发。 - -当前十四个工具都有画布入口,专用图形编辑已覆盖曲线和颜色分级;其它工具主要通过通用参数面板调整。下一阶段的具体控件样式和功能范围尚未确定,下文将现有能力、实现约定与建议顺序分别说明。本次交接只新增文档,不修改插件功能、版本或线上文章。 - -## 工程与版本基线 - -| 项目 | 当前记录 | +| 项目 | 交接基线 | | --- | --- | -| 工程根目录 | `/Volumes/备份/大鱼调色/大鱼调色`,不是上一级同名目录 | -| 工程与方案 | `大鱼调色.xcodeproj`,`Wrapper Application`,Release | -| 技术 | AppKit、Objective-C++、FxPlug 4、Metal;现有工程不以 SwiftUI 实现控件 | -| 仓库 | ,分支 `main`;保持已有仓库可见性 | -| 交接前 main | `302b75710b24c52e7c535faa1a5cf92790359272`;交接文档另作后续提交 | -| 正式 APP 实际编译源码 | `80dec904bedf5f704b29d16325fa95d639f3a250`;后续提交为文档、验证和发布记录 | -| 版本标签 | `v1.10.0-canvas-workspace-20261104` → `c0e6f3be0afc310125d2d045a96655db7524f24b`,已推送并独立恢复核验 | -| 唯一正式安装 | `/Library/Plug-Ins/FxPlug/大鱼调色.app`,1.10.0(72) | -| 产品身份 | 主 Bundle ID `com.dayu.color`;内嵌服务 `com.dayu.color.XPC` | -| 固定构建缓存 | `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color`,其中 `DerivedData` 用于 Release 构建 | -| 产品交付锁 | `/Users/mac/.codex/app-delivery-locks/com.dayu.color.lock`;本次交接读取时未占用 | -| 构建与宿主基线 | Xcode 27.1、FxPlug SDK 4.3.5;Apple Silicon、macOS 14.6+;已验收宿主 FCP 12.4 | +| 实际工程根目录 | `/Volumes/备份/大鱼调色/大鱼调色`,不是上一级同名目录 | +| 工程与方案 | 根目录 `大鱼调色.xcodeproj`;`Wrapper Application`;Release | +| 技术 | AppKit、Objective-C++、FxPlug 4、Metal;控件沿用现有实现 | +| 交接前 main | `1144a89214f87c27228db01946b52d431b413c22`;本交接文档另作后续提交 | +| APP 实际编译源码 | `49d35cb49ab93f5ab6ca3411eaea80f7219be346`;其后提交为验收、辅助项目与交付记录 | +| 发布标签及提交 | `v1.11.0-canvas-spatial-20261105` → `5f8fb13fceb0c4d4ead447b8b5694ce269e95749` | +| 源码远程 | `https://dayu.media/git/dayu/dayu-color.git`,分支 `main`;保持现有可见性 | +| 唯一正式 APP | `/Library/Plug-Ins/FxPlug/大鱼调色.app`,1.11.0(73) | +| 产品身份 | 外层 `com.dayu.color`;服务 `com.dayu.color.XPC` | +| FCP 模板 | `/Users/mac/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef` | +| 固定构建缓存 | `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color`;Release 使用其中的 `DerivedData` | +| 产品交付锁 | `/Users/mac/.codex/app-delivery-locks/com.dayu.color.lock`;本次交接核对时未占用 | +| 开发与验收环境 | 交付记录为 Xcode 27.1、FxPlug SDK 4.3.5、Apple Silicon、macOS 14.6+;实际宿主验收为 FCP 12.4 | -接手时先盘点工作区、分支、远程引用和产品锁,再修改明确属于本任务的文件。保留完整 Git 历史和既有标签;不要在源码提交中保存密码、令牌或签名私钥。 +下一会话先核对工作区、分支、远端引用与交付锁,保护其它会话尚未提交的改动。当前正式版本不再等待宿主验收,也没有仍需输入 `complete` 的交付进程。凭据与签名私钥不属于源码恢复内容。 -## 用户已经明确的交互方向 +## 当前控件能力 -- 画布侧边使用纵向工具排列,工具入口需要直接可见。 -- 曲线等图形控件可以叠在画面上,调整应直接作用于画布里的控件。 -- 工具面板能够拖动位置;可同时打开多个不同工具,保留现有检查器作为参数入口。 -- 画布外需要独立组件承载示波器、LUT 预览等,可参考 Color Finale 的内外分工。 -- 保留现有浅色、深色两种模式。界面主题、面板位置等显示状态与调色数据分开。 -- mFilmLook 和 Color Finale 作为交互参考;产品中的控件由本项目独立实现。 - -此前“只有一个基础调色”“整个面板不能拖动”对应 69 及更早阶段。70 已加入面板移动与十四工具切换,用户确认正常;随后根据新要求发展为 72 的纵向工具条和独立工作区。继续开发应以 72 为起点。历史过程见[屏幕控件研究](/Volumes/备份/大鱼调色/大鱼调色/research/mFilmLookOSC-20261104.md)与[工作区实现说明](/Volumes/备份/大鱼调色/大鱼调色/research/ViewerWorkspace-20261104.md)。 - -## 当前控件的实际能力 - -| 区域 | 已有能力 | 继续开发时需要知道的边界 | +| 区域 | 已实现 | 优化时保留的边界 | | --- | --- | --- | -| 纵向工具条 | 一级、蜘蛛、基础、肤色、LUT、HSL、曲线、分级、原色、色阶、黑白、平衡、通道、胶片;小画布分页;工作区入口和收起面板 | 工具条锚定图像可见区域左侧;同一工具按钮再次点击会关闭并移除其面板 | -| 浮动面板 | 标题点击折叠、拖动移动、关闭、置顶;同类图层选择;参数分页 | 每个工具类型最多一个浮动面板;同类独立层通过图层菜单切换。位置只存在于当前面板对象,未实现关闭重建或重启后恢复布局 | -| 曲线 | RGB/红/绿/蓝切换,选点、加点、拖点、删除点,图形和参数页切换 | 使用已有有限参数槽,不是无限点曲线;固定端点另行绘制 | -| 颜色分级 | 阴影、中间调、高光、全局四个色轮;图形和参数页切换 | 画布色轮直接修改色相与饱和度,其它分级参数继续使用参数页 | -| 通用参数 | 已公开参数的滑杆、开关、循环选项、单项复位和数值显示 | 当前画布数值显示不是完整文本输入框;选项主要通过点击循环。并未自动覆盖检查器里的资产选择、蜘蛛网格等全部自定义操作 | -| 画布外工作区 | FxRemoteWindow 宿主窗口,亮度波形、RGB 分列、直方图,风格1 LUT 浏览与真实帧预览 | LUT 页目标为当前 manager 对应的 `look0`,即风格1;不是任意 LUT 槽或任意浮动面板图层选择器 | +| 主检查器 | 新实例默认显示一级、蜘蛛、基础、HSL 四张折叠卡;其它工具由添加模块或画布工具条进入;全部还原恢复四卡折叠 | 旧工程有效调色、蒙版和实际 LUT 选择会自动显示,不能因简化界面而丢失 | +| 纵向画布工具条 | 15种工具入口,小画布分页,工作区入口和收起全部面板 | 工具条锚定实际图像可交互区域;同一工具再次点击会关闭并移除面板 | +| 浮动面板 | 半透明背景、标题点击折叠、标题拖动移动、关闭、点击置顶、同类图层切换、参数分页 | 每个工具类型最多一个面板;同类多个图层通过图层目录选择,尚无同类型多面板 | +| 曲线 | RGB/红/绿/蓝通道,加点、选点、拖点、删除选中点;同区直方图叠层;可切参数页 | 点位使用既有有限槽位;直方图为渲染分析参考,不是每一独立曲线层的即时输入 | +| HSL | 八色、色相/饱和度/明亮度三轴,画布内纵向拖动颜色点 | 自定义色选及其它精确参数仍在参数页和检查器 | +| 蜘蛛盘 | 画布网格拖点、同列自由点联动、固定点、还原选中点、全盘复位、6/12/24网格规格切换 | 自定义网格资产有专用写入桥;不能当作普通 float 参数写入 | +| 颜色分级 | 阴影、中间调、高光、全局四个色轮,直接调色相和饱和度 | 其它分级参数仍使用参数页 | +| 通用参数页 | 已公开参数的滑杆、开关、循环选项、数值显示、单项复位 | 画布中的数值显示尚不是可编辑文本框;并非所有资产选择与检查器自定义操作都在画布提供 | +| 肤色保护 | 默认开启人脸限定;实际保护区域以灰度权重显示;支持基础层及UUID独立层 | 当前帧无脸或识别失败时为空;关闭人脸限定可恢复全图颜色筛选 | +| 镜头畸变修复 | 正负径向强度、缩放、光学中心;接入独立层、蒙版、完整预设及撤销 | 独立反向径向实现,未证明与目标插件逐像素等价;不是新增局部液化工具 | +| 画布外工作区 | FxRemoteWindow 窗口;亮度波形、RGB分列、直方图、风格1 LUT浏览及真实帧预览 | LUT操作目标为绑定实例的 `look0`;不是任意LUT槽选择器 | -十四工具类型顺序来自 `DYToolTypes()`:`primary, spider, base, skin, look, hsl, curve, grading, primaries, levels, blackwhite, balance, mixer, film`。工具条名称与类型顺序需要同步维护。 +工具类型顺序来自 `DYToolTypes()`:`primary, spider, base, skin, look, hsl, curve, grading, primaries, levels, blackwhite, balance, mixer, film, lens`。前14项顺序保持不变,`lens` 在末尾;工具名称数组与类型目录需同步维护。 + +画布面板背景当前 alpha 为0.66;系统开启“降低透明度”时改为实色。面板位置采用视口归一化坐标,但只存于当前面板对象;关闭重建、插件重建或重启后不恢复布局。 ## 代码入口 -下表文件均在本工程内。多数 `*.inc.h` 是在 `.mm` 中展开的实现片段,不能当作独立编译单元重复加入目标。 +下列文件都属于当前工程。`*.inc.h` 多为在 `.mm` 中展开的实现片段,不作为独立编译单元重复加入目标。 -| 要完善的部分 | 文件 | 主要入口 | +| 要优化的部分 | 源码入口 | 主要方法或职责 | | --- | --- | --- | -| FxPlug 画布坐标、绘制、命中及输入路由 | [DYToolOSC.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYToolOSC.inc.h) | `DYToolOSC`,`drawOSC`、`partAtPoint:`、鼠标回调;同时保留原蒙版与钢笔路由 | -| 纵向工具条、面板开关、置顶与捕获 | [DYViewerControls.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerControls.inc.h) | `prepareWithSize:scale:atTime:`、`activateTool:`、`event:point:atTime:` | -| 浮动面板布局、图层目录、滑杆和标题拖动 | [DYViewerParameterPanel.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerParameterPanel.inc.h) | `prepareWithSize:`、`clickArea:`、`movePanelToPointer:`、`finishCapture` | -| 曲线与四个色轮的图形交互 | [DYViewerGraphics.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerGraphics.inc.h) | `curveSlots`、`layoutGraphicAt:`、`drawGraphic:`、`beginGraphicAt:`、`updateGraphicAt:` | -| 快照、主队列写回、撤销与冲突保护 | [DYViewerParameterBridge.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerParameterBridge.inc.h) | `publishUniforms:`、`snapshotAtTime:`、`beginParameters:`、`changeValues:`、`endGesture`、`invalidate` | -| 插件发布快照及采集最终输出 | [DYPlugIn.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYPlugIn.mm) | `pluginState:atTime:` 发布 uniforms/工具文档;成功渲染后调用 `captureScopeTile:atTime:` | -| OSC 与插件实例绑定 | [DYToolHostMethods.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYToolHostMethods.inc.h) | `initializeToolHost`、`tearDownToolHost`、`scheduleToolCanvasRegistration`、`viewerParameterBridge` | -| 检查器、工作区按钮及现有原生图形控件 | [DYInspector.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYInspector.mm) | `openWorkspace:`;`DYCurvePanel`、`DYColorWheel`、`DYWheelPanel`;原图形手势接口 | -| 蜘蛛盘的现有原生实现 | [DYSpiderDisc.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYSpiderDisc.inc.h) | `DYSpiderPanel`;网格状态另见 `DYSpiderState.h` 与 `SpiderCore/` | -| 画布外窗口和 LUT 应用 | [DYColorWorkspace.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYColorWorkspace.mm) | `showRelativeToView:`、`layoutWorkspace`、`pageChanged:`、`selectionContextAtTime:`、`selectLUT:`、`commitLUT:expected:error:`、`close` | -| 示波器采样与异步统计 | [DYScopeCapture.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYScopeCapture.inc.h) | `setScopeEnabled:`、`captureScopeTile:atTime:`、`processPendingScopeSamples`;统计和 GPU 采样见 `DYScopeMath.hpp`、`DYScopeSample.mm` | -| 参数定义与独立图层 | [DYModel.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYModel.mm)、[DYToolState.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYToolState.mm) | `DYDescriptors()`、`DYSections()`、`DYToolTypes()`、`DYToolDisplayOrder()`、`DYToolManager` | -| 深浅模式与控件表面绘制 | [DYTheme.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYTheme.mm) | `DYThemeColor`、`DYDrawThemeSurface`、`DYDrawSoftControl`;尽量复用现有主题能力 | +| 宿主画布坐标和鼠标路由 | [DYToolOSC.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYToolOSC.inc.h) | `DYToolOSC`、`drawOSC`、`partAtPoint:`;保留蒙版和钢笔路由 | +| 工具条和多面板管理 | [DYViewerControls.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerControls.inc.h) | `prepareWithSize:scale:atTime:`、`activateTool:`、`event:point:atTime:`;置顶与捕获 | +| 面板布局和通用交互 | [DYViewerParameterPanel.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerParameterPanel.inc.h) | `prepareWithSize:scale:atTime:`、`clickArea:`、`movePanelToPointer:`、`finishCapture` | +| 曲线 HSL 蜘蛛 色轮图形 | [DYViewerGraphics.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerGraphics.inc.h) | `layoutGraphicAt:`、`drawGraphic:`、`beginGraphicAt:`、`updateGraphicAt:`、`spiderAction:` | +| 写回 撤销 冲突保护 | [DYViewerParameterBridge.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerParameterBridge.inc.h) | `snapshotAtTime:`、`beginParameters:`、`changeValues:`、`beginSpider:`、`changeSpider:`、`endGesture` | +| 插件快照和渲染后采集 | [DYPlugIn.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYPlugIn.mm) | `pluginState:atTime:` 发布参数与资产;成功渲染后发布直方图并采集示波器 | +| 实例绑定和生命周期 | [DYToolHostMethods.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYToolHostMethods.inc.h) | `initializeToolHost`、`tearDownToolHost`、`scheduleToolCanvasRegistration`、`viewerParameterBridge` | +| 检查器布局和原生图形 | [DYInspector.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYInspector.mm) | 四卡折叠、有效参数自动显示、`resetAll:`;`DYCurvePanel`与色轮 | +| 模块添加和画布入口联动 | [DYToolInspector.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYToolInspector.inc.h) | `revealViewerTool:`、`visible:`;已删除类型的恢复与中性替代 | +| 参数和工具文档 | [DYModel.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYModel.mm)、[DYToolState.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYToolState.mm) | `DYDescriptors()`、`DYSections()`、`DYToolTypes()`、`DYToolDisplayOrder()`、`DYToolManager` | +| 原生蜘蛛盘和网格数学 | [DYSpiderDisc.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYSpiderDisc.inc.h)、[DYSpiderMesh.hpp](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/SpiderCore/DYSpiderMesh.hpp) | `DYSpiderPanel`、`dy::moveMesh`;状态格式见 `DYSpiderState.h` | +| 肤色人脸和畸变渲染 | [DYFaceRender.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYFaceRender.inc.h)、[DYToolRender.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYToolRender.inc.h) | 当前帧人脸检测、几何覆盖、镜头采样和独立层接入 | +| GPU选区和Uniform | [DYGrade.metal](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYGrade.metal)、[DYToolGPU.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYToolGPU.h)、[DYUniforms.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYUniforms.h) | 肤色权重输出、人脸覆盖元数据、CPU/GPU布局 | +| 画布外工作区 | [DYColorWorkspace.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYColorWorkspace.mm) | `showRelativeToView:`、`layoutWorkspace`、`selectionContextAtTime:`、LUT提交与关闭 | +| 示波器采集和统计 | [DYScopeCapture.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYScopeCapture.inc.h)、[DYScopeMath.hpp](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYScopeMath.hpp) | 小幅GPU读回,后台统计,最新帧合并 | +| 主题和表面 | [DYTheme.mm](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYTheme.mm) | 复用 `DYThemeColor`、`DYDrawThemeSurface`、`DYDrawSoftControl` | -画布侧基本链路为:宿主 OSC 输入 → `DYToolOSC` → `DYViewerControls` → 对应 `DYViewerParameterPanel`/图形方法 → `DYViewerParameterBridge` → 主队列宿主 action → 原参数或稳定 UUID 对应的 `DYToolManager`。渲染状态再通过快照回到面板。外部工作区通过绑定 manager 的通知打开,由检查器管理生命周期。 +画布基本链路:宿主OSC → `DYToolOSC` → `DYViewerControls` → 面板及图形 → `DYViewerParameterBridge` → 主队列宿主action → 原参数或UUID对应的 `DYToolManager` → 渲染快照返回面板。 -## 新控件必须保留的交互约定 +## 交互和数据约定 -**坐标与命中。** 布局以真实 OBJECT→CANVAS 图像矩形和画布的交集为准。绘制、命中、拖动应共用几何数据;控件在宿主黑边能画出来不代表能接收鼠标。工具条绘制与命中优先,面板逆序命中,按下面板后置顶。原有蒙版和钢笔仍从同一 OSC 根路由。 +**坐标与命中。** 使用真实 OBJECT→CANVAS 图像矩形与画布的交集。绘制、命中、拖动共用几何;工具条先命中,面板逆序命中,按下面板后置顶。原蒙版、钢笔和新增控件共享OSC根路由。不能只看“画得出来”来判定宿主可交互。 -**捕获与释放。** 按下记录目标、时间、起点和原值;超过 `2 × scale` 的位移后进入拖动。滑杆或图形捕获后,移出轨道继续处理,松开补算最终位置并结束手势。普通按钮在原命中区释放才触发;拖标题后松开不能再折叠面板。`mouseExited` 清悬停,不直接中止仍捕获的拖动。 +**捕获与释放。** 按下时记录节点、时间、起点和原值;超过 `2 × scale` 位移进入拖动。图形或滑杆捕获后允许移出轨道继续拖动,松开补算最终位置并结束手势。普通按钮在原命中区释放才触发;拖标题后松开不能再次折叠。`mouseExited` 仅清理悬停。 -**线程与快照。** OSC 回调读取当前帧的不可变快照,不同步等待主队列,也不直接改宿主模型。`snapshotAtTime:` 只返回同一时间的快照;缺帧时保留原 UUID 选择并暂缓编辑。主队列写入前复核当前时间、目标节点、原值和关联开关;发现外部修改或目标消失时结束手势,保留最新外部设置。 +**同帧快照。** OSC只读取当前帧快照,不同步等待主队列,不直接写宿主模型。缺帧时保留UUID选择并暂缓编辑。主队列写入前复核时间、节点、原值和关联开关;遇外部修改或目标消失结束手势并保留外部结果。 -**多字段写入与撤销。** 曲线 X/Y、色轮 H/S 通过 `beginParameters:` 和完整 `changeValues:` 成组提交,放在同一次宿主 action 内;一次手势只打开一个撤销组。不要拆成两个单字段手势。宿主拒绝写入时尝试还原受影响字段并结束该组;宿主 API 没有 `abortAction`。单击开关、复位和删除点也需完整收尾。空闲面板不能结束另一面板的共享写入手势。 +**一次手势一次撤销。** 曲线X/Y、色轮H/S通过 `beginParameters:` 与完整 `changeValues:` 成组提交。蜘蛛盘通过 `beginSpider:` 与 `changeSpider:` 提交自定义资产。一次手势共享一个撤销组,松开及失败均收尾;空闲面板不能关闭另一面板的写入组。宿主API无 `abortAction`,失败要按现有逻辑尝试恢复并结束action。 -**参数与显示状态。** 面板移动、开合、置顶、分页、通道切换只改变显示状态,不写调色参数、不制造撤销项。基础层使用 `base:`;独立层使用真实 UUID,不能按面板下标或当前列表序号写参数。保留参数 ID、uniform 布局、预设 v7、CMS nil/v2/v3 的既有兼容约定;本轮图形扩展优先连接现有数据。 +**图层目标。** 基础层使用 `base:`,独立层使用真实UUID,不能按面板或列表序号定位。蜘蛛基础层来自 `DYAssetState.spiderMesh`,独立层来自层文档的 `spider`;桥接器在 `DYToolManager` 提交action后回读实际保存结果,并检查外部网格和拓扑冲突。 -**生命周期。** 播放头变化、插件或面板销毁、manager 失效时必须结束捕获并关闭撤销组。异步操作使用序号/会话校验,关闭窗口后不得继续提交。项目使用手动内存管理,新增 retain/release 和异步 block 时沿用现有生命周期处理。 +**显示状态。** 面板位置、开合、置顶、分页、图形页、颜色轴及通道选择属于显示状态,不写调色参数,不制造调色撤销。若增加布局持久化,应明确采用用户偏好或实例界面状态,避免写入调色Uniform、网格资产或LUT内容。 -## 曲线和色轮的参数映射 +**兼容与生命周期。** 保留既有参数ID、完整预设v7、CMS nil/v2/v3语义及工具顺序。Uniform原1312字节前缀保持,1.11.0只追加32字节,总计1344;CPU/GPU两侧同步修改并保留断言。播放头变化、面板销毁、manager失效时关闭捕获和撤销组;异步提交校验会话。工程采用手动内存管理,注意retain/release和block的生命周期。 -曲线显示输出值为 `output = x + curveY × 0.01`;拖点写回 `curveY = (output - x) × 100`。`curveY` 保存的是相对对角线偏移,不能直接填绝对输出值。RGB 主曲线为4个基础槽加4个额外槽,单色通道为2个基础槽加4个额外槽;`x < 0` 表示未启用槽,删除点写 `x = -1, y = 0`。绘制使用与现有编辑器一致的单调 Hermite 插值和固定首尾端点。 +## 四类图形的参数映射 -色轮使用 `grade{i}_0` 表示角度制色相、`grade{i}_1` 表示0–100饱和度,`i = 0..3` 分别为阴影、中间调、高光、全局。画布坐标 Y 轴与色轮数学坐标方向相反,新增圆盘控件时需要同时核对绘制和输入变换。 +- 曲线:`output = x + curveY × 0.01`,写回 `curveY = (output - x) × 100`。RGB为4个基础槽加4个额外槽,单色通道为2个基础槽加4个额外槽;`x < 0`表示未启用,删除写 `x=-1, y=0`。固定端点及单调Hermite插值沿用已有实现。 +- HSL:`hsl{axis}_{color}`,axis为0色相、1饱和度、2明亮度,color为0至7。当前画布按所在颜色列选目标,将垂直位置映射至-100至100;不要将绘制坐标误当成参数相对增量。 +- 色轮:`grade{i}_0`为角度制色相,`grade{i}_1`为0至100饱和度;i为0至3,依次阴影、中间调、高光、全局。注意画布Y轴与数学Y轴方向相反。 +- 蜘蛛盘:拖动以按下时冻结的网格为起点,归一化位移经 `dy::moveMesh` 计算;固定、还原和重采样也经过同一桥接器,不直接改渲染缓存。 -蜘蛛网格属于自定义资产/图层数据,不能直接套用当前 float 描述符桥接。若将蜘蛛盘搬入画布,应先明确基础层 `DYAssetState.spiderMesh` 与独立层 `spider` 数据的目标路由,再扩展安全写入通道、冲突检测和一次撤销。 +## 直方图和空间工具的边界 -## 外部工作区的约定 +曲线直方图来自320×180分析缓存、256档、最多约2Hz,成功渲染更新后才发布至同时间快照,播放头不匹配时不展示上一帧。它沿用现有分析采样阶段,不等同于每个独立曲线层的输入;具体采样阶段随原流程/CMS设置而异,见README中曲线直方图说明。 -工作区由 FxRemoteWindow 托管并绑定当前插件实例;`DYColorWorkspaceRequested` 通知的 object 是对应 manager。LUT 异步准备完成后检查播放头、原风格1选择、全局颜色管理及目标图层是否仍有效,且在 `DYToolManager` 结束 action 后回读真实保存结果。关闭窗口要取消准备并关闭示波器采样。 +外部工作区示波器另用 `DYScopeCapture` 采集当前效果的处理输出,不含后续效果和宿主显示转换。已知ICC时转扩展sRGB,未知空间显示宿主RGB原值参考;保留分块标注,不能把它作为精确HDR/IRE测量。不要用 `_renderer histogram` 代替该输出采样。GPU读回在宿主纹理仍有效时完成,CPU统计放后台;保留根视图、面板裁剪和顶栏越界重绘回归。 -工作区示波器采样**当前效果的处理输出**,不含后续其它效果或宿主显示转换。320×180 采样在已知 ICC 配置下转扩展 sRGB;空间未知时明确显示宿主 RGB 原值参考。波形、RGB 分列、直方图属于显示参考,不替代 HDR/IRE 精密测量。宿主仅提供分块时须保留分块标注。 +人脸限定使用当前帧Vision revision3/76点,支持轮廓和额头区域并排除眼、眉、唇,与原肤色筛选及用户蒙版相乘。输入长边最多960像素;MTLTexture转CIImage时按 `TOP_LEFT` 翻转归一化,两种原点输出一致已经回归。仅复用完全相同的像素,不复用上一镜头人脸;检测失败时为空。肤色区域预览读取真实皮肤阶段的保护权重,不另画一张近似脸框。 -`DYScopeCapture.inc.h` 与原 `_renderer histogram` 分开:后者属于较早的分析/曲线参考缓存,不能直接拿来充当最终输出示波器。宿主输出纹理可能在 render 返回后被复用,因此小幅 GPU 读回在其所有权仍有效时完成;CPU 颜色转换和统计放在后台队列,待处理帧合并为最新帧。 +人脸选区、镜头几何及调试预览属于空间处理,静态Cube无法保存;活跃时按现有逻辑拒绝不适用的Cube导出,完整预设继续保存。畸变修复为独立反向径向采样,保留透明度、边界、像素宽高比和光学中心原点处理。 -71 曾出现绘图区越界覆盖工作区顶栏,72 已加入根视图、面板裁剪和顶栏位图回归。修改工作区布局时保留这些检查,特别核对窗口缩放和大片 dirty rect 重绘。 +`DYRenderer.mm` 的 `notifyPreviewChanged` 独立方法用于安排主队列预览通知。此前C++引用捕获中的异步block泄漏self栈地址已修复,不要恢复旧写法。完整ASAN运行无内存错误;插桩下旧主队列响应阈值失败,正常Release通过,未放宽阈值。 -## 建议的后续开发顺序 +## 后续优化候选 -以下是接手建议,具体工具及样式以用户下一次要求为准。 +具体优先级由用户下一次需求决定,以下均为尚未实施的候选,不作为已有缺陷或新增功能承诺。 -1. 先确定要完善的一个工具,检查其在原检查器里的现有实现与数据结构。蜘蛛盘、HSL 等尚无专用画布图形,可作为后续候选;不要把十四个入口当作十四套图形控件均已完成。 -2. 在现有画布框架内实现该工具的布局、绘制和命中。保留通用参数页作为精确参数入口;若新增数值输入、菜单、键盘或修饰键操作,补齐焦点、宿主快捷键和钢笔工具之间的路由约定。 -3. 连接真实参数或自定义资产,覆盖基础层与独立 UUID 层,验证一次撤销/重做和检查器同步。需要修改多项数据时成组提交。 -4. 再完善多面板布局、面板位置恢复或同类多图层同时显示。这些会改变当前“一类型一面板”的行为,需独立设计;纯显示布局不要进入调色预设和撤销历史。 -5. 逐项检查浅深两种模式、窄画布、不同缩放、面板重叠与外窗按钮可读性。现有三项功能验收不能覆盖所有新增交互或后续视觉修改。 +| 候选 | 涉及范围 | 应先明确的交互 | +| --- | --- | --- | +| 面板位置和开合恢复 | `DYViewerControls`、`DYViewerParameterPanel`及界面状态存储 | 是关闭重开恢复,还是重启恢复;是否按插件实例独立保存;缩放或分辨率变化后的回位 | +| 曲线和HSL操作手感 | `DYViewerGraphics`、参数桥 | 选点命中半径、拖动灵敏度、细调修饰键、选中态及数值反馈;保留现有参数语义 | +| 画布精确数值输入 | 面板、OSC、宿主焦点路由 | 单击/双击进入、确认/取消、超范围处理,以及FCP快捷键和钢笔工具冲突 | +| 蜘蛛盘编辑反馈 | 网格图形和专用资产桥 | 选中/固定状态、同列联动提示、网格密度和窄画布可读性 | +| 工具条和多面板布局 | 工具条分页、面板层次及边界约束 | 15工具可发现性、重叠时选择、遮挡画面程度;同类多面板需另行设计 | +| 外部工作区 | `DYColorWorkspace`、`DYScopeCapture` | LUT目标图层/槽位扩展或示波器布局,保留异步取消和真实目标冲突检测 | -## 验证与正式交付 +推荐每次先完成一个工具或一组明确交互,连接真实参数和UUID层,再做窄画布、主题和宿主验证。已有曲线、HSL、蜘蛛盘均可在画布编辑,后续应在当前实现上优化。 -已通过的基线包括:正式安装版695项原生检查;用户实鼠的曲线拖点与一次撤销、风格1 LUT 真实预览、移动播放头后示波器更新。用户原话为“三项都正常”,见[宿主验收](/Volumes/备份/大鱼调色/大鱼调色/verification/HostWorkspace1.10.0.json)。原生检查使用真实 Metal/IOSurface 和模拟 FxPlug 宿主选择器,不能代替真实 FCP 文档操作。 +## 验证入口和宿主项目 -新增图形控件的原生回归主要放在 [DYViewerControlsDiagnostics.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerControlsDiagnostics.inc.h);参数批量写入和冲突保护放在 [DYViewerParameterDiagnostics.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYViewerParameterDiagnostics.inc.h);外窗、LUT 提交与越界重绘见 [DYWorkspaceDiagnostics.inc.h](/Volumes/备份/大鱼调色/大鱼调色/大鱼调色/Plugin/DYWorkspaceDiagnostics.inc.h)。这些检查由 `DYDiagnostics.mm` 集成,测试辅助协议见对应 Probe 文件。 +正式安装版原生检查为 **724项通过**,包含真实Metal/IOSurface和模拟宿主回调。用户于2026-11-05实鼠确认“三项均正常”:画布曲线含直方图、HSL、蜘蛛盘拖动和一次撤销;人脸肤色区域;畸变网格调整。记录见 [HostCanvasTools1.11.0.json](/Volumes/备份/大鱼调色/大鱼调色/verification/HostCanvasTools1.11.0.json) 与 [CanvasAcceptance1.11.0.json](/Volumes/备份/大鱼调色/大鱼调色/verification/CanvasAcceptance1.11.0.json)。这次验收为FCP 12.4,不扩写为Motion也逐项实测。 -需要重跑正式安装自检时,入口为: +| 修改范围 | 原生回归入口 | +| --- | --- | +| 新三工具、真实人脸、畸变GPU/CPU对照 | `大鱼调色/Plugin/DYCanvasToolsDiagnostics.inc.h`,1.11.0新增29项 | +| 工具条、布局、图形捕获 | `大鱼调色/Plugin/DYViewerControlsDiagnostics.inc.h` | +| 参数组写入、UUID、时间和外部冲突 | `大鱼调色/Plugin/DYViewerParameterDiagnostics.inc.h` | +| 四卡折叠、移除和重新添加 | `大鱼调色/Plugin/DYCompactUIDiagnostics.inc.h`、`DYToolDeletionDiagnostics.inc.h`、`DYToolInsertionDiagnostics.inc.h` | +| 外窗、LUT异步提交、越界重绘 | `大鱼调色/Plugin/DYWorkspaceDiagnostics.inc.h` | + +上述回归由 `DYDiagnostics.mm` 集成。重跑正式安装自检需提供版本化真人fixture,避免被误判为人脸功能失败: ```sh -'/Library/Plug-Ins/FxPlug/大鱼调色.app/Contents/PlugIns/大鱼调色 XPC Service.pluginkit/Contents/MacOS/大鱼调色 XPC Service' --self-test +cd '/Volumes/备份/大鱼调色/大鱼调色' +DY_DIAGNOSTIC_FACE_FIXTURE='/Volumes/备份/大鱼调色/大鱼调色/tools/fixtures/astronaut.png' \ + '/Library/Plug-Ins/FxPlug/大鱼调色.app/Contents/PlugIns/大鱼调色 XPC Service.pluginkit/Contents/MacOS/大鱼调色 XPC Service' --self-test ``` -功能改动后的交付流程沿用 [tools/deliver.py](/Volumes/备份/大鱼调色/大鱼调色/tools/deliver.py):先保存并正常退出宿主,Release 构建、正式签名、公证 Accepted、票据验证,再替换唯一正式位置并运行正式安装自检,最后进入宿主验收。脚本会在正式安装后等待 `complete` 或 `leave`;只有真实验收通过才输入 `complete`,否则保留诊断和恢复状态。最终还需核验 PluginKit/实际宿主进程路径并清理本任务生成的多余 APP、提交 ZIP 和旧版恢复副本,不能仅凭脚本退出宣称交付完成。 +宿主验收库在 `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/fcp-qa/大鱼调色_验收.fcpbundle`;事件为“大鱼调色_1.11.0_73_画布与空间工具”,含画布曲线/HSL/蜘蛛盘、人脸肤色保护、镜头畸变修复三个项目。辅助资料可重建: -新增控件至少实测:拖动与释放位置、移出控件继续捕获、一次撤销及重做、独立层目标、切换片段/播放头、拖动期间外部改值、面板开合与位置变化、工程重开、深浅模式和缩放。已有缺陷对应的回归按改动范围运行,不为纯文档修改重复构建或验收插件。 +```sh +python3 '/Volumes/备份/大鱼调色/大鱼调色/tools/create_canvas_host_fixture.py' +``` -代码修改分阶段用 [tools/checkpoint.py](/Volumes/备份/大鱼调色/大鱼调色/tools/checkpoint.py) 对明确文件提交、推送并核验远程;脚本自带仓库锁,不要套同一把锁造成死锁。完整恢复、签名与打包约定见[恢复说明](/Volumes/备份/大鱼调色/大鱼调色/RECOVERY.md)。 +输出位于 `/Users/mac/Library/Caches/CodexBuilds/com.dayu.color/fcp-qa/canvas-1.11.0/`,含验收FCPXML、网格、肤色区域预览及畸变预设。该脚本当前固定1.11.0命名;新增版本需按实际版本调整,不要把旧验收记录当作新版本通过。通过FCP“文件→导入→XML”导入,不直接修改fcpbundle数据库。 -## 已完成的发布与遗留事项 +新增或修改交互至少核对:基础层和两个同类独立UUID层;按下、拖动、轨道外捕获及释放;一次撤销/重做;检查器同步;播放头和片段切换;拖动期间外部改值或删层;面板重叠、关闭、重建;深浅主题、降低透明度、小画布及不同缩放;保存重开。按变更补充必要检查,避免复制实现的无效测试。 -- 正式 APP 和 PKG 均已签名、公证、粘附票据并验证。PKG 位于 `/Volumes/备份/大鱼调色/发行包/大鱼调色-1.10.0.pkg`,43,090,565字节,SHA-256 `ee70461c9b2d2e0ddd78cbcb3371c3b1b36b7f0e5fc69bfccc7ac0f1a3e468d8`。PKG 通过20项展开验包,本轮未重复运行系统安装脚本。详情见 [Package.json](/Volumes/备份/大鱼调色/大鱼调色/verification/Package.json)。 -- [资源文章15792](https://dayu.media/15792/)已更新为“1.10.0 紧急 UI 更新”,使用新封面和用户提供的深色、浅色两张原始截图,主下载同步新版。50元、有效会员免费及其他商业设置保留。文章图片、SEO及安装包完整下载已验证,见 [Article1.10.0.json](/Volumes/备份/大鱼调色/大鱼调色/verification/Article1.10.0.json)。发布素材在 `/Volumes/备份/大鱼调色/大鱼调色/Publishing/1.10.0/`。 -- **Git Release387/附件31仍为草稿,未发布。** 安装包已上传,但草稿下载需要已登录浏览器;上一会话的电脑操作工具因当前浏览器页面 URL 访问限制终止。尚未取得该 Release 附件的完整下载证明,不可把网站文章的包下载证明替代它。后续恢复正常访问后,复用既有草稿与附件,完整下载核对上述大小和哈希,再由 `Packaging/publish_beta.py --verified-download` 完成发布与发布后再次下载核验。不要重复上传、删除旧附件或移动现有标签。当前记录见 [Release.json](/Volumes/备份/大鱼调色/大鱼调色/verification/Release.json) 与 [CMSReleaseDraft.json](/Volumes/备份/大鱼调色/大鱼调色/verification/CMSReleaseDraft.json)。 -- 任务生成的70/71旧安装恢复APP、缓存生成APP、公证ZIP、验证下载副本和源码恢复 checkout 已按记录清理。源码、用户工程/QA媒体及历史发行包保留,见 [清理记录](/Volumes/备份/大鱼调色/大鱼调色/verification/WorkspacePendingCleanup1.10.0.json)。未修改 NAS 后端源码或网站自动更新清单。 +上一轮自动点击未能可靠触发原生OSC,最终三项结果来自用户实鼠确认。电脑自动化遇此限制时保留事实并请用户完成相应步骤,不以绘制截图或模拟宿主通过替代实鼠验收。对宿主发送退出后不要马上再次取该APP状态,以免工具重新启动它;先确认保存并正常退出,避免强杀用户工程。 + +## 构建和交付 + +功能改动继续沿用 [tools/deliver.py](/Volumes/备份/大鱼调色/大鱼调色/tools/deliver.py)。正常保存并退出FCP/Motion后运行;脚本取得产品锁,显式禁用ASAN,清理专用构建目录并Release构建,逐层Developer ID签名,原生检查,Apple公证Accepted,粘附及验证票据,替换唯一正式安装,核对PluginKit。用户可见验收运行正式安装路径的已公证版本。 + +脚本在正式安装后等待 `complete` 或 `leave`。仅在真实宿主验收通过后输入 `complete`,以清理旧版恢复APP并将Delivery记为verified;有问题时保留诊断和可恢复状态。脚本会重写Delivery记录,额外宿主证据在完成后补齐。 + +修改参数描述、模板默认值或注册信息时同步 `template/sources/RegisteredParameters.json`、原生模板和模板校验;入口为 `tools/build_template.py --refresh-model --overwrite`。单纯控件文档修改不重建插件。正式PKG通过 [Packaging/build_pkg.py](/Volumes/备份/大鱼调色/大鱼调色/Packaging/build_pkg.py) 与PKG工坊技能生成;构建器要求正式APP交付已验证。不要覆盖已发布的同名版本包,也不移动既有标签。 + +新版本Release沿用 [Packaging/publish_beta.py](/Volumes/备份/大鱼调色/大鱼调色/Packaging/publish_beta.py):先有已推送标签、匹配的Package报告和最终发布说明,创建草稿并上传,经完整下载核对大小及SHA-256后发布,发布后再次完整下载核验。草稿API下载404时使用已登录浏览器下载,再传 `--verified-download`;必须是真实远端下载文件,不能复制本地原包冒充。保留现有公测标志和仓库可见性。 + +源码阶段提交使用 [tools/checkpoint.py](/Volumes/备份/大鱼调色/大鱼调色/tools/checkpoint.py),只传本任务审查过的文件。脚本自带Git仓库锁,不嵌套同一把锁;当前实现按main核验远端,切到其它工作分支时先适配。最终按 [RECOVERY.md](/Volumes/备份/大鱼调色/大鱼调色/RECOVERY.md) 完成源码推送、版本标签、远端独立恢复与本产品生成副本清理。额度重置由用户手动操作。 + +## 发布和恢复记录 + +1.11.0 APP公证 `348c6e9b-f5d9-4661-bc7f-f192fa770ecf` Accepted;PKG公证 `ffbdb4fb-f573-411e-99fc-166c4a829121` Accepted。签名、票据、Gatekeeper、唯一位置安装及PluginKit发现通过。原生724项与20项展开验包通过,PKG本轮未重复执行安装脚本,APP由交付流程独立正式安装。 + +正式包为 `/Volumes/备份/大鱼调色/发行包/大鱼调色-1.11.0.pkg`,43,128,845字节,SHA-256 `2dd5166902ebdaae50dd897057459cbe7e5ea611dbdeb571bd688e843c59768e`。[Release388](https://dayu.media/git/dayu/dayu-color/releases/tag/v1.11.0-canvas-spatial-20261105)及附件32已经发布,草稿与发布后完整下载均校验一致。记录见 `verification/Package.json`、`Release.json`。 + +远端独立检出发布标签的555个跟踪文件逐字节一致,程序与模板和实际编译49d35cb一致,full/strict fsck通过,无LFS及子模块。恢复到正式发布源码可克隆上述仓库,再执行 `git switch --detach 5f8fb13fceb0c4d4ead447b8b5694ce269e95749`;继续开发使用盘点后的最新main。详见 `verification/CanvasFinalRecovery1.11.0.json`。 + +旧版恢复APP、编译产生的松散APP、公证提交ZIP、临时验证下载及恢复clone均已清理;源码、QA媒体/用户库、历史安装包保留。扫描仅覆盖交付记录中的明确目录,见 `verification/CanvasCleanup1.11.0.json`。不按旧记录中的进程PID或临时下载路径继续操作。 + +旧1.10.0 Release387/附件31保持原草稿,不属于本轮未完成事项,不影响1.11.0已完成交付。网站文章15792此前停留在1.10.0,本轮未更新文章、网站下载或NAS后端;如要上架1.11.0,按新的发布需求另行处理。 + +## 参考资料 + +- [本轮实现研究](/Volumes/备份/大鱼调色/大鱼调色/research/CanvasTools-20261105.md):功能范围、研究证据、算法与验证。 +- [画布工作区实现](/Volumes/备份/大鱼调色/大鱼调色/research/ViewerWorkspace-20261104.md):前一轮框架和工作区。 +- [原始屏幕控件研究](/Volumes/备份/大鱼调色/大鱼调色/research/mFilmLookOSC-20261104.md):交互参考和历史阶段。 +- 演示素材 `/Volumes/备份/6524bdcd3a33f6bd0128a340b9c7fadc_raw.mp4`;只读研究,不上传用户视频到源码仓库。 +- 人脸算法参考 [FCP-BeautyGirl](https://github.com/dayumeida/FCP-BeautyGirl),研究提交 `42fecaa3b55471fea928339127d53484663d4057`;许可保留在 `research/FCPBeautyGirl-MIT.txt`。测试真人 `tools/fixtures/astronaut.png` 的公共领域来源见同目录README,不随APP交付。 ## 给下一会话的接续说明 -继续完善大鱼调色的画布自定控件。先读取本文件,再读取工作区研究与对应源码。基于 main 和已验收的正式1.10.0(72),保留纵向工具条、多个可拖动面板、画布内曲线/色轮及画布外示波器/LUT工作区。按用户指定工具继续补齐交互,保留参数、独立图层UUID、一次手势一次撤销和主队列安全写入。已有三项实鼠验收通过,不用退回69或70阶段。新功能仍按正式Release签名、公证、唯一安装、宿主验收、源码推送和安装包Release规则交付。上一版Release草稿的下载核验阻塞另有记录,不要宣称已发布。 +> 继续优化大鱼调色的画布自定控件。先读取 `/Volumes/备份/大鱼调色/大鱼调色/自定控件开发交接.md`,盘点最新main、工作区和交付锁,以已验收的正式1.11.0(73)为基础。曲线含直方图、HSL、蜘蛛盘已在半透明画布面板中可编辑,主检查器默认四卡折叠,人脸肤色区域和畸变修复均已完成。按我随后指定的控件问题或交互目标继续改进,保留UUID图层、同帧快照、主队列写回、一次手势一次撤销、原蒙版钢笔路由及兼容格式。文档中的候选优化尚未实施,不自动扩成全部任务。功能修改继续按Release签名公证、唯一正式安装、实际宿主验收、源码推送、PKG和Release下载校验交付;额度重置由我手动处理。