# LumiGrade 主题和 LUT 浏览库补充分析 目标仍为已安装 LumiGrade 3.0(56),arm64 分析切片 SHA256 `c04e911e449e888eb0d8c10f7bcf2b6bc2c4153b9ba86c1952ddf210c96c5e97`。本记录基于 Ghidra 12.1.4 的静态反编译、原文件资源清单和 Swift 符号;静态布局常量不表示已经观测到窗口在宿主实际弹出。完整的 35 条新增 Evidence 位于 `ThemeLUT-analysis.json`。`ThemePalette.json` 是从原双精度常量逐值解码的颜色数据,不是截图估色。 ## 主题 - `ThemePreference.selectedIndex`(`0x100059374`,`ev_a8688461143765f6d38667a24dc736bcfcce133f76c6c1003b3e2d86ee6bfc67`)读取 `NSUserDefaults.standard`,合法整数为 0–4;缺失、错误类型、越界均回到 1。`refreshFromDisk` 为真时先 `synchronize`。 - `ThemePreference.select`(`0x1000594c4`,`ev_5dcc78a25578273dc8d179c57dc0afd79cf31d176d3cd88f806ab3a060f387df`)仅写合法索引,写后 `synchronize`,并向普通和分布式通知中心发布同一通知。因此原版主题是跨实例、跨进程的全局偏好,不是逐滤镜的可动画调色参数。 - 原偏好键 `LumiGrade.globalThemeIndex`(`ev_2dea9886c635b29b0e21643ccb31c1264ffd35280494e35f03405af8202bb692`),通知 `LumiGradeGlobalThemeDidChange`(`ev_fd94a34bf03cae7ae8a372d5c9b5b60a322d1e238115dac8e7996f8baa3b6ae5`)。复刻应使用产品自己的命名空间,不改原厂偏好。 - 依 `family(for:)`(`0x100059cec`)的比较常量和界面观测,五个色块顺序为灰、蓝、紫、绿、橙;这五个中文名称是说明性名称,不主张它们是原版 tooltip 文案。色块 RGB 分别为 `(0.30,0.33,0.38)`、`(0.28,0.72,1)`、`(0.58,0.52,1)`、`(0.30,0.86,0.52)`、`(1,0.61,0.28)`,默认蓝。 - `chromeAccent`(`0x10005b1bc`,`ev_e814744aa17fdd27bbd3b46f60561201c4bdebf068a430b2007006b5c51ee7f2`)另将灰转为 `(0.72,0.77,0.84)`、蓝转为 `(0.22,0.67,1)`,其余三个保持对应主题色。不能直接把灰色块的暗灰当文字和工具图标 tint。 - `palette`(`0x10005a028`,`ev_0a2bea4354863fd7685a919ca6dae83ba5cf582f12cd0592edb24f0816eee35a`)生成每主题 17 色,使用 `colorWithCalibratedRed:green:blue:alpha:`。数组按原 Palette 存储顺序保留。消费者确认的槽含义如下。 | 槽 | 实际用途 | 消费函数 | | --- | --- | --- | | 1 | 整体面板底色 | InspectorView.applyAccent,`0x10001c9a4` | | 3 | section 内容底色 | SectionView.applyAccent,`0x100022d98` | | 6、7 | section 标题胶囊渐变 | SectionTitleButton.applyAccent,`0x100049e6c` | | 8、9 | 普通滑条轨道渐变 | SliderCell.drawTrackBackground,`0x100041fa8` | | 10、11 | 普通滑条活动段渐变 | SliderCell.drawBar,`0x10006c9c0` | | 14 | Logo 和 section 标题文字 | InspectorView / SectionTitleButton.applyAccent | | 15 | 参数行、输入和 LUT 标签 | InspectorView.applyAccent | | 16 | 版本文字 | InspectorView.applyAccent | Section 描边使用 chrome accent 的 alpha 0.38;可见性、展开和其他工具按钮常用 alpha 0.92。普通滑条高度 5、圆角 2.5、黑色描边 alpha 0.28 / 线宽 0.6。其余槽在本次有完整颜色值,但不额外猜测语义。 ## LUT 库发现与入口 - `userLookLUTFolderURL`(`0x100070058`,`ev_9a37e0a0dcdc73db9e2c58ceb5d34dfbbe0629d4b59cc2c082f68ac7d69c5c56`)使用用户 Movies 目录,回退 `~/Movies`,再拼接 `梁哥调色LUT/look LUTs`。复刻使用自己的目录,不修改原厂库。 - `lookLUTFolders`(`0x1000822b4`,`ev_abc8f7799dfd67b519733d2de59c75c013b02dd07b59f009a770fa6ab41c76b0`)另加入插件 bundleForClass 和 mainBundle 的 `Resources/LUTs/Look`,再加入用户目录。 - `discoverLookLUTOptions`(`0x100070bc8`)读取目录内容,跳过隐藏内容(options=4),文件扩展名小写比较 `cube`。顶层目录分别递归枚举;顶层文件进入「未分类」,以路径去重,再排序。此次安装包里的 17 个 `.cube` 全部为输入相机配置;清单中没有 `LUTs/Look` 内置风格文件。未在此调查中读取用户 LUT 文件内容。 - `lookLUTMenuGroups`(`0x100090360`,`ev_db2b7ee3dceb2a58706ee4515113437a34f4199bcc0508ab053933fa590529ad`)排除第 0 个「无」选项,以已有 group title 分组,无 group 时归「未分类」,保留 selection index 给点击回写。 - `openLookLUTFolder`(`0x100066c10`,`ev_82b900e1fdd53b69048bcf894b4fba6bff9f958acdbc26c4e7b7bc58320eab67`)创建用户目录并调用 `NSWorkspace.openURL`;右侧文件夹图标用于在 Finder 打开文件夹,未显示选择根目录的 open panel。 ## 浏览器布局、选择和缩略图 - `showLookLUTPreviewBrowser`(`0x10001ee8c`,`ev_7e6daea432f64c3380b5399e539dcf6abaafc0fe4ad7efe3d507121a1d722813`)以 **760×560** 展示 `LookLUTBrowserView`;可按宿主选择原生 host presentation 或 anchored `NSPopover`。Popover behavior=1,锚在入口按钮。 - `build`(`0x10004f9fc`,`ev_70bccecb4b8d036ad6303ee9fa6b2c34dd9768db7a0a5f9428db4a4d81c4329d`)浏览器底色固定 Calibrated RGB `(0.035,0.08,0.12)`;整体内边距 12、纵间距 10;左目录宽 150,顶部左标题宽 145,右网格容器宽 560,最小高 240;左右列间距 12。顶部同时显示库标题、当前目录及文件数和缩略图大小滑杆。标题 14 semibold;文件数 10 medium。 - initializer(`0x100066534`,`ev_98b1bcc280692122ab576ba2cf0062846372dfee4db01a703307f2c4ac5d8e3d`)创建 size slider:默认 **96**、最小 **70**、最大 **255**,宽 150。读取 `LumiGrade.lookLUTPreview.thumbnailSize`(无有效正数时为 96)及 `LumiGrade.lookLUTPreview.selectedFolder`。该偏好同样应在复刻中使用独立键。 - `thumbnailClicked`(`0x100052784`,`ev_cc54cc6744ddd7a436ee769e86209c3306f4576995f7033b108ea225d803bd6f`)单击即设置所选 index、更新 tile 选择边框并调用 onSelect;该函数没有关闭浏览器。未发现必须双击才应用的路径。 - Tile initializer(`0x100066338`)设置宽度为缩略图大小,高度为 `size×9/16+24`。图像为 16:9,下方额外 24 像素放名称。 - `sizeChanged`(`0x100052814`,`ev_083dcc84539e4a5e2e388f33f77929bc857b3ef6651054aab08593f6fcd1c52a`)保存偏好,取消旧 work item,**0.22 秒 debounce** 后重建。 - `reloadThumbnails`(`0x100051238`)按当前尺寸重新分行,每行 spacing 10;后台 previewQueue 逐项生成,generationID 与弱引用用于抛弃旧代、已关闭视图或过期 tile 的结果。UI 更新回主线程。 - `currentLookLUTPreviewItem`(`0x10007f148`)缓存键为 `frameVersion|Int(size)|LUT path`,超过 600 项清空缓存;用 currentPreviewFrame 或 fallbackPreviewFrame,对每个候选施加对应 LUT。 - `currentPreviewFrame`(`0x10007f4f4`,`ev_7f13d031b53f51bd16e7cea9755f085d590d702c7dc993a31040568a17b4d9b9`)在缩略图 LUT 前先处理当前输入 LUT 及其强度,并按源帧版本缓存结果。`capturePreviewFrameIfNeeded`(`0x1000833ec`)捕获节流 **0.35 秒**;输入路径/强度变化立即递增版本并失效 processedPreviewFrame。 - `thumbnailImage`(`0x100091a04`,`ev_47a86ed56280777069e755d726b84701244573dceed4b182f9ec8de02d12fc40`)宽 `max(64,Int(size))`,高 `max(40,Int(width×9/16))`;先转 RGBA8,以每通道 `/255` 经 CubeLUT.sample,然后 clamp/量化回显示字节。此浏览器缩略图并非整套基础调色和五层 LUT 合成后的画面。 ## 证据边界 地址对应本次 arm64 切片,不能当作其他版本地址。Ghidra 对 Swift 参数和 SIMD 值有类型恢复误差,本文仅将直接常量、可见 API、字段读写及可验证的堆栈偏移用作实现规格。颜色槽用途按原存储偏移与具体消费者对应;布局常量仍需正式宿主进行视觉核对。浏览器没有从此静态清单中推断出网络商店、账号收藏、搜索框或动态商业 LUT 下载功能。已关闭本次 REA 原生会话;可复用的完整 session snapshot 保存在本机产品缓存 `research/ThemeLUT-snapshot.json`。