文件
dayu-color/research/CanvasTools-20261105.md

5.8 KiB

画布工具与修复任务

日期:2026-11-05。基线 main 5224e404f54067eca11b9b749095d87fa980c535,远程已核验,工作区干净。唯一正式产品 com.dayu.color,安装 /Library/Plug-Ins/FxPlug/大鱼调色.app。

用户验收范围:

  • 曲线、HSL、蜘蛛盘为可移动半透明画布图形;曲线同区叠加直方图,保留精确参数页。
  • 主检查器初始只展示一级、基础、蜘蛛、HSL 四张折叠卡。其它工具通过添加模块或画布工具条进入,已有工程的有效调色必须保留。
  • 肤色保护增加区域显示;实时识别人脸,并将颜色筛选限制在人脸皮肤范围,无脸不得保护同色背景。参考用户指定 MIT 仓库 FCP-BeautyGirl,保留来源说明。
  • 参考 mFilmLook 的变形/镜头畸变修复功能,接入真实渲染、模块、预设和撤销。

布局沿用 AppKit/Metal OSC 与原参数桥。图形、命中共用几何,基础层及 UUID 层均支持,一次拖动一次撤销,时间/节点/外部冲突时停止写入。半透明在降低透明度时使用实色。

演示 /Volumes/备份/6524bdcd3a33f6bd0128a340b9c7fadc_raw.mp4:4096×2584,120fps,45.65秒;只读抽帧存构建缓存,不把用户视频上传到源码仓库。

交付必须完成 Release、Developer ID、Apple Accepted、票据、唯一安装及正式路径自检、宿主功能验收、PKG 与 Release 下载校验、远端独立恢复。额度重置由用户手动操作。

最终状态:1.11.0(73)已正式交付,724项原生检查、20项验包、用户三项实鼠验收、Release发布前后完整下载校验及远端独立恢复均通过。下文保留各阶段研究记录。

实现检查点

HSL八色三轴图形、蜘蛛网格拖动/固定/复位/分辨率、半透明绘制与降低透明度替代、曲线直方图已连接原参数。蜘蛛自定义资产扩展了主队列冲突保护。主面板按显示状态隐藏未使用的附加模块,保存过的有效参数自动显示;画布工具入口可以恢复已删除类型。

FCP-BeautyGirl 参考提交 42fecaa3b55471fea928339127d53484663d4057,MIT 许可证见同目录 FCPBeautyGirl-MIT.txt。参考 Vision revision 3、76点、皮肤支持区与五官排除的思路;未引入美颜、瘦脸或目标二进制。

mFilmLook 3.1.4 arm64 SHA-256 b1cee1dffd3b490afa0c22db646404b018a0aaadf70d9a6827e95cb178c74357。REA Ghidra 12.1.4 观察到 Lens Distortion、ParamLensDistortionEnable/Strength、RenderDistortionKernel,证据 ev_77ca21689086d3b977243f1b81b3833a89b9e48aa5cd3e38594572abad5296a2、ev_5c4653c5bdd4316ec067c530085235c5c37733b2490065ed6d5ea855611057a7。本项目独立编写反向径向采样,不宣称已证明目标GPU逐像素等价。

Uniform 仅在原1312字节之后追加32字节,旧参数ID与完整前缀不变;新增独立镜头模块、肤色范围预览及默认人脸限定。当前编译/验证中,未安装。

第二阶段验证

原生回归已扩展至719项,新增真实 OSC 图形手势、UUID网格资产、外部拓扑冲突、畸变GPU与独立CPU采样对照、NASA公共领域真人及同色背景检查。原695项按新15工具和四卡折叠布局更新展示预期,旧点颜色/Cube参照显式排除新空间人脸选区。

AddressSanitizer 发现旧 renderLegacy 的 C++ 引用捕获向异步通知泄漏栈 self 地址;改为独立 Objective-C 通知方法后完整内存检查运行结束,无该内存错误。先前未检测到问题的旧正式版695项仍通过,原栈布局偶然掩盖缺陷。

肤色预览改为在原生皮肤阶段读取同一个色选算法、同一预HSL参考、同一用户蒙版与人脸覆盖,白色代表保护权重。初次真人测试识别人脸但MTLTexture→CIImage上下相反,已按TOP_LEFT归一化修正,正在重跑;未通过前不交付。

曲线直方图由成功渲染的分析更新发布到同时间快照,播放头不匹配时不展示旧帧。人脸只缓存完全相同的标准化像素;无脸或输入失败时为空,不延续上一镜头。新增空间处理的Cube导出会明确拒绝,完整预设继续保存。

候选验证记录 1.11.0(73)

724项原生回归通过;真实人脸中心归一化坐标约(0.437,0.244),双人检测2张脸。上下原点输出最大误差0;同色背景差异0,人脸保护生效。独立层、零强度用户蒙版和无脸清空均通过。新的完整724项AddressSanitizer运行未报告内存错误;唯一失败为启用插桩后的旧主队列响应阈值(约226ms),无插桩Release该项通过,未放宽阈值。

最终交付脚本显式关闭ASAN并清理专用构建后重编译,正式安装自检自动提供版本化真人fixture。FCP已通过正常退出保存现有验收库;不修改库数据库。准备正式构建和宿主验收,尚未交付新版。

最终交付

用户实鼠回复“三项均正常”:画布曲线含直方图、HSL及蜘蛛盘的拖动与一次撤销;人脸肤色保护区域;镜头畸变网格响应。正式安装1.11.0(73)的APP公证Accepted、票据、Gatekeeper及唯一PluginKit路径通过,原生724项通过。此验收来自真实FCP用户操作,自动化输入限制保留在宿主记录中。

正式编译SHA 49d35cb49ab93f5ab6ca3411eaea80f7219be346;最终版本标签 v1.11.0-canvas-spatial-20261105 → 5f8fb13fceb0c4d4ead447b8b5694ce269e95749。程序与模板未在编译后改动。Release388/附件32完成草稿下载校验后发布,发布后再次完整下载校验,43,128,845字节、SHA-256 2dd5166902ebdaae50dd897057459cbe7e5ea611dbdeb571bd688e843c59768e。远端独立恢复555跟踪文件一致,fsck通过,临时生成副本已清理。详见verification/Delivery.json、HostCanvasTools1.11.0.json、Package.json、Release.json、CanvasFinalRecovery1.11.0.json及CanvasCleanup1.11.0.json。