fix: align tracker preprocessing and shared object lifecycle with native evidence

这个提交包含在:
mac 于 2026-11-05 03:49:21 +08:00 提交
1 父节点 9ba6eeb00a
当前提交 a0a97dfd88
14 个文件已更改
+312 -47

没有与搜索条件相匹配的文件

@@ -63,3 +63,41 @@
## 本轮独立实现结果
`dy::OpenCVTracker`现使用独立编译的官方4.5.1库,12项已知运动检查通过(`verification/TrackingOpenCV-20261105.json`):300点、旋转及双轴缩放、框外路径12帧亚像素、周期重选静止、换景、平坦区、运动多数子集、实例隔离、坏帧几何保留、非有限输入及完整4K。中心误差约0.0033px(旋转/缩放)、0.0148px(12帧路径)、0.00011px(4K平移);这些是生成素材结果,不是实拍或原版轨迹对照。只依赖系统zlib/Accelerate/libc++/System,插件运行不需要研究目标或另一APP。宿主接入、共享mask作者同步、正式版本实际跟踪仍由主任务验收。
## 宿主分析预处理补查
2026-11-05追加只读复核,原版三个目标文件SHA保持不变;新增证据均在前述研究缓存的`preprocessing-*-evidence.json`和相应snapshot。GradeKit完整SHA为`e868a8c6df64bf03b7c24af5657c5ac7a2259a1943dfe06e01dbb7881df018a3`,RenderingEngine为`32dca93459347e5ad363cb145d0ccf84b933b2045eee2c9535676a01744b84e3`。
原版`ColorFinalePlugIn::properties:error:`(`0x1000becfc`,`ev_1fdabe00a34ba3c60c1cd544b314a75511f21bfb7e450d3980c7d6a0980e88ee`)返回常量字典。直接读取键和值表,`DesiredProcessingColorInfo`对应NSNumber的整数**2**(`ev_13298ab75f991c7f21dc02b00a61b6b2f7b62c6a5e8c7ffd47a02569c49f2dc1`、`ev_4f886e67dd650bc33b4132e6a46e22baecabcd931e35bb2283ac2f186dd02590`、`ev_46bdde28003eb68ebdb1bfbd992d6eec44a8b5bc3ade2b993aad26ed5401e422`)。本机FxTypes.h545–546核对:0是RGB_LINEAR,2是RGB_GAMMA_VIDEO,SDK注明视频gamma2.2。该请求是否被宿主实际满足仍须核对输入元数据与样本,不能把“请求”描述成所有宿主的无条件事实。
分析入口将`session.colorSpace`和`effectTime`传给`FTFrameTile::frameTileWithImageTile:colorSpace:time:`(GradeKit `0xf890`,`ev_3faba8c4ae9d636bf447ed8eddb17124b49426d25fec7f262c82c93c0c1ab95f`)。它从原宿主IOSurface建立MTLtexture,另建带colorspace标签的CIImage,并保留原texture。跟踪请求`createIOSurfaceWithPixelFormat:maxSize:`(GradeKit `0x12020`,`ev_f9b1157f3f16bec67e2570a8b1e9e8ca367a26fd831c8e924a7dbcb3d434ca08`)优先使用该texture,而非CIImage。
RenderingEngine的`createIOSurfaceFromTexture:pixelFormat:maxSize:`(`0x2a420`,`ev_f37cd808dbf1b11c30f25ae22f67d022dbde5e072e3326b1bc8abcf138c2add5`)按纹理width/height同比缩小,目标RGBA8Unorm(70)。同尺寸同格式可直接返回IOSurface;否则block(`0x2a5b0`,`ev_7466d368af6a009a4f28814ba01d601931d3b3cccb6a295e5bd55ca22ea6d1ee`)只执行**MPSImageLanczosScale**并同步目标纹理,没有显式gamma、ICC、除alpha或pixelAspect拉伸。CI fallback的`colorSpaceForImage:`(`0x29a78`,`ev_39b020d8dd4f7dfa909daf0d20302ddf15269d4573f922acf2626ef7368e0487`)明确返回nil,不能据此把fallback当成自动sRGB转换。
最后核对`+[MTLTextureDescriptor(FTAdditions) ftDescriptorWithIOSurface:usage:]`(RenderingEngine `0x327c4`,`ev_e16998f018851a67426e6422c9e1d12ad5c069274886e710916e639d900be02d`):BGRA→80/BGRA8Unorm,RGBA→70/RGBA8Unorm,RGhA→115/RGBA16Float,RGfA→125/RGBA32Float,均非`_sRGB`格式;没有隐藏在纹理格式中的sRGB采样解码。该事实与宿主请求gamma2.2一起解释其直接缩放和量化行为。
因此不能仅看“原版复制texture不加gamma”就移除大鱼的编码:两产品当前宿主颜色请求不同。最接近已观察合同的分析专用流程是:大鱼linear源→匹配视频gamma2.2的浮点编码纹理→Lanczos缩至最大3840×2160并写RGBA8Unorm→OpenCV整数灰度;普通sRGB分段编码与gamma2.2不等同。先灰度再量化、先量化linear再加gamma、盒式低通缩小都会产生可测差异。对于预乘alpha,原版MPS处理原通道并且gray不再除alpha;若大鱼输入为linear预乘,要模拟宿主gamma请求需先按透明度语义编码并重新预乘,再缩小和量化。真实宿主的颜色请求满足情况、alpha和非方形像素仍应分别验证,不把该生产接入建议作为已完成原版像素对照。
## 原版轨迹的只读导出与比较
保存预设动作明确把`adjustments`及`trackerScene`交给预设管理器(`0x10007870c`,`ev_4568bc43f27bc4fb953e837112e86117d24b300422b0e447920baa582e3e9c1c`)。旧式“导出预设”将每个版本的scene安全归档、zlib压缩为`versions[].masks`,并保存解压归档的base64 SHA-256为`masks_hash`(`0x10000a954`,`ev_1380fa47e7316a68abb78d03436a18b03ea01497592c5c648fc9ee163383e9f6`)。保存面板限定property-list,默认`<identifier>.plist`(`0x1000401a8`,`ev_ab4b0981c4f5bcda698c320d99e85e2ea6d3a10611f0f7217803c6d19bdbb8bb`)。
可操作步骤:在独立QA工程按同一素材、同一时间范围、同一形状进行CF分析;完成后在工作区保存一个新的测试预设(底部菜单的保存预设入口);顶栏打开LUT/预设浏览器,进入Presets并选择该新预设;右键菜单若显示“导出预设 / Export Preset”,填写名称和唯一identifier后保存`.plist`。不要选“导出LUT”,Cube不含空间轨迹。
**本机版本的UI限制必须保留:**`menuNeedsUpdate:`(`0x1000406d8`,`ev_f60df616ccf1a15265170f8aa8c032e41921aae990a67e3805ebb87a24a957c3`)仅在`NSUserDefaults`布尔项`FTPresetsViewControllerEEDK`开启时添加该旧式plist导出菜单。公开“Export as Look (.cflook)… ”只把activeVersion.fxAdjustments传入FTLook,未把trackerScene传入(`0x10003dbb4`,`ev_92e9387d55a56a0ae47fd15746d213dcf1fe2c52707f4d63747afa27b397dfc4`),不能当作已证明的轨迹出口。不要声称普通右键始终能看到plist导出。若需要临时启用该原生菜单,先核对实际进程defaults域、记录原值,并在导出后恢复;这次只读研究没有更改该偏好或原版数据。
本机原生数据存在`~/Library/Application Support/ColorFinale/DataStorage.db`,只读SQLite schema可见`ft_objects`及`ft_objectversions.content`等;当前该库未取到可验证的内容记录。旧`PresetStore.xcdata`是另一代CoreData schema,不能擅自当成本版最新轨迹库。若走数据库对照,应只读连接并backup到一致快照、明确选择本轮唯一测试预设、保留WAL一致性;尚未验证blob封装,不给出猜测解码或直接编辑生产库的方案。
`tools/tracking/read_colorfinale_preset.py`使用Python标准库`plistlib/zlib/struct`解析导出的plist或raw masks archive,绝不加载或实例化CF类。输出按真实标识和有理时间排列的position/rotation/scale轨迹,验证`masks_hash`;坐标原点保持原作者值,不擅自翻转。原生编码字段已观察:
| 对象 | coding keys / 数据 |
| --- | --- |
| FTTrackerScene | identifier、nodes、aspectRatio、duration |
| FTTrackerNode | identifier、name、enabled、inverted、blendMode |
| FTTrackerShape | position、rotation、scale,以及opacity、feather、borderColor |
| FTAnimatedParameter | type、value、keyFrames |
| FTKeyFrame新版 | data,72字节;0:uint32版本1,8:uint64类型,16:int64时间值,24:int32 timescale,32:int64 epoch,40:uint64向量维数,48/56/64:double X/Y/Z |
字段证据:`ev_b91139dc6d6123d6b949555f5e25059f26a2b9b3deac92f49010b6d819219eef`(形状)、`ev_e3a6b0c53238e5a4ea8cdc1b3df70d3fd48c0ff7fbfbc0448ccdabb9cbf50b70`(scene)、`ev_f61f19c55bb089aa86668ace5ed0be32fb9ab34fb98e55d4d6d31bcf4b5208d9`(动画属性)、`ev_1b938e7df2989293beab1198e28439946d3e50178fc61447682ced4367c09862`及`ev_3ceed133be177301388c33727d65297a5e9ec0e0f403e2ff839acb87025eb1f3`(72字节写入和读取)。CIVector的CICount/CI_0/CI_1字段另以系统CoreImage自行归档作oracle,未执行原程序。
示例:`python3 tools/tracking/read_colorfinale_preset.py <本轮导出.plist> --output <缓存目录>/colorfinale-tracks.json`。`--self-test`的有理时间、CIVector及压缩UID图形样本通过;尚无真实CF导出fixture,不能把合成解析检查说成原版真实轨迹提取完成。旧式FTKeyFrame的未知time编码会明确拒绝,不伪造时间;真实fixture到位后再扩展解析。对照应逐CMTime比较中心/角度/双轴尺寸、报告首次失跟和最大/均方误差,并检查实际视频覆盖,不能只看“有效帧数量”就宣布一致。
+5 -1
查看文件
@@ -26,6 +26,10 @@
已实现横排15种工具、真实UUID层表与右侧单工具编辑、四通道曲线并排、四页工作区、LUT目标切换与取消过期载入、共享蒙版schema3和6种蒙版编辑;左画布矩形/椭圆/钢笔常驻,透明曲线/畸变/肤色/LUT入口及底部控制面板;矩形和椭圆直接拖框,旧右侧蒙版按钮栏已移除。共享对象可先画后关联,或关联选中模块后再加其它模块,独立解除关联不会删除对象。
OpenCV4.5.1由官方锁定源码静态构建并随包保留全部许可,宿主工具蒙版跟踪已接入;分析上限3840×2160,灰度使用.299/.587/.114并量化8bit。已有12项生成运动参考,尚无原版同视频完整轨迹对照。775项阶段原生回归通过,最终版追加曲线手势时间/外部冲突保护检查。
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检视器。签名、公证及宿主验收尚待完成。