138 行
21 KiB
Markdown
138 行
21 KiB
Markdown
# 大鱼调色恢复说明
|
||
|
||
远程:https://dayu.media/git/dayu/dayu-color.git,分支main。
|
||
初始化基线:10987dd6bcc6986ea321eff75b37d4e8b48e966d;后续节点见git log。
|
||
产品主ID:com.dayu.color,XPC:com.dayu.color.XPC;唯一正式位置:/Library/Plug-Ins/FxPlug/大鱼调色.app。
|
||
|
||
当前交付标签:v1.1.5-lut-encoding-20261101。APP 1.1.5(16)编译源码:59b058a3c8b9e5387381574da6bbc05af437527c;标签另含最终宿主验收与恢复记录。Apple 公证 ID b47b6fe8-b7a9-4112-93b9-de85b03ca598,Accepted;正式签名、票据、Gatekeeper 与宿主重开均通过,见 verification/Delivery.json 和 verification/HostLUTEncoding.json。
|
||
|
||
外部LUT版本 v1.1.4-external-lut-20261101 保留,编译源码497eef29fe8eaa5fb7025aa045b6dfa46a9acc14,原公证ID d9d9b05a-58b5-4a7a-aac2-6433b87d901d。
|
||
|
||
后台加载版本 v1.1.3-async-lut-20261101 保留,编译源码6452e793f974234b5ffffdfad5dc3ddeee64d53c,原公证ID d47784c7-7cad-4837-93ab-9bce5d8c19da。
|
||
|
||
分组折叠版本 v1.1.2-group-fold-20261031 保留,编译源码 cdcb30a6aa1519bfb2f183165fef11cbf278bc7c,原公证 ID 398b020c-9e1e-4c2b-b637-e8e3af2a8f59。
|
||
|
||
所有调色分组展开即启用、折叠即停用,关闭时参数不可见;仅基础调节在新实例和全部还原后默认展开。折叠保留数值和 LUT 路径;打开已保存实例时按其实际启用状态展开。基础调节同时控制原光影与颜色两个子组。风格 LUT 总组停用时全部五层均旁路,关闭的输入或风格 LUT 不加载文件。肤色保护的百分比字段按0–100范围显示和保存。
|
||
|
||
FCP12.4正式安装版本的11组标题/眼睛联动、隐藏参数、黑白红45与肤色65%跨折叠及保存重开保留、全部还原后只展开基础调节的验收见 verification/HostGroupFolding.json。仅在独立合成验收项目中改值,最后恢复默认;用户媒体和其他产品未作改动。
|
||
|
||
图标交付标签 v1.1.1-brand-icons-20261031 保留,编译源码 bd02c7a368348fdea6357889a09fba298872487a,原公证ID 352e85a7-f603-4e93-8c1a-43f6c107bea1。正式程序关于窗口的新图标、FCP12.4效果浏览器缩略图与安装资源校验见 verification/BrandAssets.json;本次沿用相同品牌资源。
|
||
|
||
主题/LUT交付标签 v1.1.0-theme-lut-20261031 保留,编译源码 c8d92077e5a017fa4b1a7ee7b24be2386b29294d,宿主验收见 verification/HostThemeLUT.json。
|
||
|
||
历史交付 v1.0.0-build2-20261031 保留;其编译源码 ce7e0a3371693c84c97267af12ca0f078b0db981,原生调色链及初次 FCP 导出验收见 verification/Host.json。
|
||
|
||
本次编译节点的远端独立克隆116个已提交文件比对、strict/full fsck、从源码与本机SDK重建原生模型注册信息及FCP模板逐字节一致,见 verification/GroupFoldingRecovery.json。当前模板 SHA256:ebf8b7aa7a6781b9ce611375a838d89997656b0fc01077b2a7e5b1b2a2c373e1。
|
||
|
||
图标版本的远端独立克隆113文件比对、strict/full fsck和三种导出资源逐字节重建见 verification/BrandRecovery.json。主题/LUT源码的完整 XPC Release 重建和73项原生自检见 verification/ThemeLUTRecovery.json;当前Release送公证前及正式安装后均通过92项原生自检,正式结果见 verification/InstalledSelfTest.json。重建 Metal SHA256:9d89ed3197cf987a37ad7320911d23b8510b5461ffca2bd16397c8b963e02132。构建只使用仓库内的源码与资源。
|
||
|
||
## 恢复和构建
|
||
|
||
1. 登录大鱼站获取Git令牌,通过系统凭据管理登录;克隆上述仓库。
|
||
2. git switch --detach <完整提交SHA> 恢复任一已保存节点;发布节点见版本标签与verification/Delivery.json。
|
||
3. 依赖:Xcode27.1 / macOS SDK27,Metal Toolchain,FxPlug SDK4.3.5(/Library/Developer/SDKs/FxPlug.sdk),FxPlug及PluginManager运行框架(/Library/Developer/Frameworks)。最低系统14.6,当前验证Apple M4。
|
||
4. Xcode打开大鱼调色.xcodeproj,Wrapper Application方案,Release。构建脚本由版本化LLVM文本重建Metal库;不读取外部应用或网络源。17相机输入、Camera Raw数学表均已入Git,无LFS、无子模块。
|
||
5. 更改模型后运行 python3 tools/build_template.py --refresh-model --overwrite,更新FCP原生壳的注册参数与归档。
|
||
6. 正式交付运行 python3 tools/deliver.py;脚本持有产品锁,Release、逐层Developer ID签名、自检通过后送Apple Accepted、staple/validate、Gatekeeper、原子替换、正式版自检、清理副本、PluginKit唯一登记。等待宿主验收后输入complete才记通过。
|
||
7. 固定缓存:/Users/mac/Library/Caches/CodexBuilds/com.dayu.color。正式XPC支持 --self-test 输出原生模型/IOSurface/颜色/LUT集成JSON。请从正式安装路径运行。
|
||
|
||
## 证书和数据
|
||
|
||
Developer ID团队B3W25FX5H5,公证profile codex-dayu-notary-B3W25FX5H5。证书私钥及钥匙串需独立恢复,不在Git。
|
||
|
||
资产预设保存调色数字和用户所选LUT绝对路径;用户自选LUT本身、用户媒体和宿主资料库不属于代码备份。跨机器恢复预设时需同时搬移用户LUT并重新选择。运行与构建使用本工程的参数、资源及用户选择的文件。
|
||
|
||
Color Finale 移植研究、当前算法来源及历史记录入口见 research/ALGORITHM_SOURCES.md。GPU/数学/原生集成与实际宿主验证分别记录,单项算法通过不代表所有宿主/GPU/素材完全等同。
|
||
|
||
此工作区在exFAT外置卷,Git元数据位于本机APFS /Users/mac/Library/Application Support/DayuGitMetadata/dayu-color.git,工作区.git为指向文件。远端克隆在新机器会生成正常独立.git;无需复制此本机指向。
|
||
|
||
## 主题与 LUT 库
|
||
|
||
五套主题通过独立 com.dayu.color.preferences 域保存,并同步其他实例。浏览器目录和缩略图大小使用本产品的独立偏好键。用户库为 ~/Movies/大鱼调色LUT/look LUTs;导入会保留源文件,重名时创建带数字后缀的新副本。用户 LUT、收藏和偏好属于本机用户资料,源码仓库不包含这些内容;换机时单独搬移并按需要重选预设中的绝对路径。
|
||
|
||
缩略图捕获输入转换后的源帧,显示层按 FxPlug 的原点单独转换为顶部优先。原分析帧字节序、调色核心和 Metal 数学库未变。当前宿主验收采用原生锚定 Popover;支持 FxRemoteWindow 的宿主也可使用其窗口接口。
|
||
|
||
运行 python3 tools/create_lut_host_fixture.py 可重建合成验收图、独立 XML 与四个测试 LUT,输出只在产品缓存。随后从浏览器导入测试目录并在 FCP 验证,不自动写入用户库。
|
||
|
||
## 品牌资源
|
||
|
||
程序图标与插件缩略图由内置图像生成工具分别生成,采用同一光谱鱼标志。原始 PNG 和完整提示词见 design/ASSETS.json。程序 ICNS 含16至1024像素的标准图标表示;FCP预览为640×360与240×135。恢复后运行 python3 tools/build_brand_assets.py 可使用macOS自带sips/iconutil重建三项资源,不需要联网生成,使用仓库内已保存的资源。大图原始PNG、ICNS及两种FCP缩略图均保存在普通Git对象中,无LFS或子模块。
|
||
|
||
## 仓库说明整理(2026-10-31)
|
||
|
||
当前主分支增加了来自同系列“大鱼调色盘”工程的 Color Finale 移植研究快照,来源提交4458dc0c0ae7f51046b8cfa4b19626e80f7cf6ca与逐文件摘要见 research/color-finale/SOURCES.json。当前算法链、相关研究和MIT查表来源分别在 research/ALGORITHM_SOURCES.md 说明。整理前完整资料保存在提交29dc4d385c1459cd330d8a9083ec9756787afef3,现有历史和发行标签不改写。
|
||
|
||
该次整理仅涉及说明、源码注释和验证工具的输入方式,当时正式程序为1.1.2(11);实际功能代码、GPU内核、模型、资源、签名与已公证安装未变。GPU对照工具改为显式传入第三个参数指定对照库,使用方法见 tools/kernels/README.md。
|
||
|
||
## LUT 后台加载优化(2026-11-01)
|
||
|
||
扫描、逐项校验、复制、LUT 解析和缩略图生成均在后台;主线程只读短锁快照并更新界面。导入可取消,失败或取消回滚本次文件并保留原有库;预览只为可见项创建视图。独立选择队列使当前选中的 LUT 不必等待缩略图,连续选择以最后一次为准。菜单退出后再打开文件选择框,避免在远程检查器中嵌套菜单与文件框。
|
||
|
||
verification/LUTResponsiveness.json 记录同一组 24 个 65³ 合成 LUT(197,731,344 字节)导入:旧实现主线程最大空档 10,018.8 毫秒,新实现 6.251 毫秒,耗时从 10.019 秒降为 7.399 秒。3,025 条目/3,000 文件夹仅创建 45 个缩略图视图和 15 个文件夹视图,56 项后台检查及 92 项库检查通过。此数据来自本机 Apple M4、APFS 与真实主运行循环心跳,网络卷和旧机器尚未测量。
|
||
|
||
正式 14 版在 FCP12.4 独立合成项目中完成 8.2 MB 单文件载入、24 文件目录导入、192 文件校验期间搜索和取消、渐进缩略图、滚动与快速选择,正常退出重开保留最后一次 LUT。单文件旧问题与各版本的实际验收分别见 verification/HostLUTLoading.json。13 版等待状态按用户明确授权强制退出一次;14 版后续正常退出与重开均通过。
|
||
|
||
验收后仅核对合成文件 SHA256 再清理本次 72 个导入副本,原有 4 个 LUT 保留。浏览器恢复原目录、空搜索与160大小,验收项目全部还原后仅基础调节展开、LUT 路径清空。正式安装、启动与宿主检查通过后清理旧12/13候选备份;已检查的构建、工程和标准安装目录只有正式外层 APP。用户资料库与源媒体未用于测试。
|
||
|
||
远端编译源码 6452e793f974234b5ffffdfad5dc3ddeee64d53c 独立恢复129个已提交文件逐字节一致、strict/full fsck、从恢复源码重建92项库检查通过,见 verification/AsyncLUTRecovery.json。Release 送公证前与正式安装后82项 Metal/IOSurface原生集成检查通过。无需读取外部目标程序,模型 ABI、模板及 Metal 数学库未变。
|
||
|
||
运行 python3 tools/create_async_lut_host_fixture.py --cancel-pack 可在产品缓存重建24个65³导入样本和192个硬链接取消样本,不自动写入用户库;运行 tools/verify_lut_responsiveness.mm 构建出的独立检查器可重测响应。完整 VoiceOver、旧系统、Intel、网络卷未作验收;SwiftUI 专用审查对现有 AppKit 实现不适用。
|
||
|
||
## 外部 LUT 与旧编码目录修复(2026-11-01)
|
||
|
||
1.1.4(15)先在后台解码并上传 GPU,宿主写入成功后才确认缩略图选择。不可变表独立于缩略图缓存保留;测试中删除已选65³源文件、再加载14个其他表淘汰缓存,仍可输出逐像素一致的画面。预览采用 utility 优先级,当前选择采用 user-initiated 优先级;GPU 设备0和真实 registry ID复用相同设备资源。恢复旧工程时未准备的路径仍可能在渲染工作线程首次加载,不能把此结果解释为任何恢复场景都不读文件。
|
||
|
||
实际 N12精选luts 包含26个真实Cube、91,960,032字节,维度16/17/32/33/64。“青橙色.cube”和“青橙色2.cube”含非UTF-8描述性TITLE,旧版因此将整批导入中止。修复只放宽标题/注释编码,尺寸、DOMAIN和数字尾部继续校验;原文件和导入副本逐字节一致。文件系统另有AppleDouble元数据,Foundation枚举未把它们作为本次LUT输入,它们不是此次故障原因。
|
||
|
||
真实目录隔离导入26/26、全部缩略图通过,主循环最大空档6.275毫秒;真实原目录及正式安装后用户库副本分别通过171项Metal/IOSurface检查。合成库回归112项通过;浏览器与宿主确认状态、取消、快速切换等67项通过,24个65³文件导入7.681秒,主循环最大空档6.696毫秒。量化数据是本机运行循环测试,不能当作所有机器和存储的性能承诺。结果见verification/ExternalLUTActivation.json。
|
||
|
||
正式安装的FCP12.4中已看到N12目录完整26项,全部导入副本核对一致;实际应用青橙色两份及64³文件、搜索、连续切换、清除、正常退出重开均通过。验收开始时目录已在用户操作后导入,未重复导入。原有4个LUT保留,N12的26个导入副本保留;恢复验收前用户选中的“复古-大白鲨”、空搜索及N12目录,不改第一段其他插件效果。未捕获先前未指定文件的卡死现场,因此仅就这些实际文件和已检查路径报告通过。
|
||
|
||
源码497eef29fe8eaa5fb7025aa045b6dfa46a9acc14从远端独立恢复133个已提交文件、strict/full fsck、恢复源码重编译112项库检查通过,见verification/ExternalLUTRecovery.json。LUT文件未进入Git或PKG,新机器须另行搬移用户库。
|
||
|
||
真实目录复测可用tools/verify_external_lut_folder.mm与DYLUTLibrary.mm,链接Foundation、AppKit和zlib构建;调用参数为源目录及报告JSON。该工具只读源文件并使用独立临时库,完成后清理。正式XPC的--self-test可选环境变量DY_DIAGNOSTIC_LUT_FOLDER指向实际LUT目录,逐文件准备和渲染;正常插件运行不读取这个诊断变量。
|
||
|
||
## Cube 文本编码兼容(2026-11-01)
|
||
|
||
1.1.5(16)支持 UTF-8 BOM/无BOM、UTF-16 LE/BE 与 UTF-32 LE/BE 的有无BOM文件。无BOM时只根据可识别的Cube起始内容判断字节序,不任意删除NUL字节。宽字符解码在后台进行,每约16KB检查取消;合法字符转换为工作副本,导入仍逐字节复制原文件。中文、日文与非BMP标题已覆盖。ASCII兼容的GB18030、Big5、Shift JIS、Windows-1252、MacRoman和ISO-8859-1标题/注释不要求UTF-8;无需为了显示标题而猜测这些编码。
|
||
|
||
LF、CRLF、CR、Unicode横向空白和宽字符文本中的Unicode换行已覆盖。截断单元、非法UTF-16代理对、UTF-32越界/代理值、宽字符NUL和非法数值不会通过有损转换绕过校验;维度2–128与单文件256MB限制保持。未增加其他LUT文件格式或承诺所有历史字符集。模型、GPU数学和二进制dylut未变。
|
||
|
||
独立编码回归报告179项通过,混合编码40文件异步导入含54,925,360字节UTF-32 65³样本,主循环最大空档6.283毫秒;核心库112项、浏览器67项通过。ASCII快速路径保留普通LUT速度:24个65³合成文件导入7.526秒,主循环最大空档6.3毫秒。N12原26个实际LUT导入与缩略图回归通过。正式APP自检92项通过,16份33³编码样本的实际Metal渲染检查141项通过。详见verification/LUTEncoding.json。
|
||
|
||
FCP12.4通过原生文件夹选择框导入全部16个UTF-8/16/32与旧编码样本,缩略图和逐项应用全部通过;UTF-32 BE无BOM路径保存、正常退出重开仍生效。验收后恢复用户原“复古-大白鲨”、N12目录和空搜索,仅按清单摘要删除16个测试导入副本;原有30个LUT逐字节不变,N12的26项保留。详情见verification/HostLUTEncoding.json。本轮未强制退出宿主或改动第一片段的其他插件。
|
||
|
||
源码59b058a3c8b9e5387381574da6bbc05af437527c已从远端独立恢复138文件、strict/full fsck,恢复源码重建112项库及179项编码回归通过,见verification/LUTEncodingRecovery.json。tools/create_lut_encoding_fixture.py在固定产品缓存重建16个合成宿主样本,不自动导入用户库;tools/verify_lut_encoding.mm与DYLUTLibrary.mm链接Foundation、AppKit和zlib可重测编码/取消/字节保留。正式XPC的DY_DIAGNOSTIC_LUT_FOLDER诊断方式同前。
|
||
|
||
## 正式 PKG(2026-11-01)
|
||
|
||
当前安装包:上级发行包/大鱼调色-1.1.5.pkg,13,752,153字节,SHA256 bf2a4acc57a3c08176be0f317c90551120bfcfb21a7224a690191884c8a3d071。Apple公证ID 90a38636-93bb-4693-8db2-16b9a815e409,Accepted;Installer团队B3W25FX5H5、可信时间戳、票据、Gatekeeper和20项真实展开验包通过。包内APP与1.1.5(16)正式安装逐字节一致,宿主验收为verification/HostLUTEncoding.json。源码技能采用191da9dc0abfda83fcc5939f6fc90e4c9019f4d9,发行标签v1.1.5-lut-encoding-20261101同时包含应用和PKG记录。
|
||
|
||
APP编译源码59b058a3c8b9e5387381574da6bbc05af437527c;恢复后先完成APP正式交付,再运行Packaging/build_pkg.py。没有再次执行本PKG的系统安装。当前包不含用户LUT、测试LUT、媒体或偏好;本轮生成的APP、旧版备份、解包/打包暂存和公证ZIP均已核对清理。历史包保留。
|
||
|
||
### 历史 1.1.4 安装包
|
||
|
||
安装包:上级发行包/大鱼调色-1.1.4.pkg,13,750,251字节,SHA256 b078fc5a86763edeab07002eb00dd13355d28a5c61bb4bed487eb93c0a8b316d。Apple公证ID 1b7bbefe-956c-45bd-8a68-cd6720a9c00d,Accepted;Installer团队B3W25FX5H5、可信时间戳、票据、Gatekeeper和20项真实展开验包通过。包内APP与1.1.4(15)正式安装逐字节一致,宿主验收为verification/HostExternalLUT.json。源码技能采用191da9dc0abfda83fcc5939f6fc90e4c9019f4d9,发行标签v1.1.4-external-lut-20261101同时包含应用和PKG记录。
|
||
|
||
APP编译源码497eef29fe8eaa5fb7025aa045b6dfa46a9acc14;恢复后先完成APP正式交付,再运行Packaging/build_pkg.py。没有再次执行本PKG的系统安装,不能将结构验包描述为安装脚本已经实际运行。原1.1.3安装包与历史标签保留;当前包不含N12 LUT、用户媒体或偏好。旧版14备份由管理员所有,已在系统管理员授权后清理;本轮生成的APP、解包/打包暂存和公证ZIP均已核对清理。
|
||
|
||
### 历史 1.1.3 安装包
|
||
|
||
安装包:上级发行包/大鱼调色-1.1.3.pkg,13,742,355字节,SHA256 2538d513debe9357b4cb78cc7de96783390b41133ad6d1bacf99ed42b18d470c。Apple 公证 ID 70a315dc-5741-45f2-95fa-875454447177,Accepted;Developer ID Installer团队B3W25FX5H5、可信时间戳、票据与Gatekeeper install通过。发行记录标签 v1.1.3-pkg-20261101。
|
||
|
||
打包脚本 Packaging/build_pkg.py,编写节点2bb062c82fcd7eddcba742f7324c662c079bf13c;复用 https://dayu.media/git/dayu/pkg-forge.git 的6d4266efbf85d13582a5d9d97f492273872128f4节点内 skills/pkg-forge 技能。恢复该源码并准备已公证正式APP及本机独立签名凭据后运行:
|
||
python3 Packaging/build_pkg.py --pkg-forge-repo /实际/PKG工坊源码目录 --output-dir /新的发行目录
|
||
新机器需先按前述编译源码6452e793f974234b5ffffdfad5dc3ddeee64d53c恢复、正式签名公证并安装APP;打包不会替APP重签。默认输出已有同版本包时停止,不覆盖历史包。
|
||
|
||
包内完整APP固定至/Library/Plug-Ins/FxPlug/大鱼调色.app;模板分类文件夹及3个必要文件单独安装至登录用户的Motion Templates效果目录,预览锁恢复命令已核对。四种FCP/Motion must-close、root授权、桌面与Bundle ID前置检查、用户GUI注册worker、逐插件真实验证调用、连续验证、修复、成功/失败均显示目录、禁止relocation、欢迎与结束页均通过实际展开检查。包内APP与正式APP全部文件/符号链接一致,APP独立签名票据和Gatekeeper通过。
|
||
|
||
系统安装器介绍页、说明页及光谱鱼角标已预览;没有执行安装动作,不宣称本PKG实际安装流程/注册或旧系统已验收。已有正式APP的FCP保存重开等验收仍见HostLUTLoading.json。包、用户媒体和凭据不进入源码Git;重建的签名时间戳、随机组件ID与公证票据会使PKG摘要不同。完整验包结果见verification/Package.json。
|
||
|
||
打包技能清理修正:当前推荐技能标签skill-pkg-forge-20261101-r2,节点191da9dc0abfda83fcc5939f6fc90e4c9019f4d9。最初生成正式包所用6d4266e保留为真实来源;修正版只增加唯一组件ID关联的暂存清理,不改原PackageBuilder或正式包内容。旧版打包器因保护预览留下的两份载荷及本次探针副本已按任务ID核实清理;修正版真实测试完成后无本任务APP暂存,源预览锁保留。补充交付记录标签v1.1.3-pkg-20261101-r2;初次PKG标签保留。
|
||
|
||
## Release 附件发布(2026-11-01)
|
||
|
||
全局AGENTS规则负责源码/标签推送及正式发行包Release保存;pkg-forge技能提供上传入口。产品入口Packaging/publish_release.py只接受已签名公证、验包通过且与所选版本标签中记录一致的安装包;版本说明在Packaging/Release-1.1.5.md。新Release先草稿,完整下载附件核对大小/SHA-256后再发布;同名一致附件复用,冲突停止,不移动原版本标签。记录在verification/Release.json,发布成功前不能把源码推送或本地包存在描述为附件已经上传。
|
||
|
||
最初浏览器Git凭据的POST Release请求被会员网关按设计拒绝403,回读未创建Release。用户已明确授权独立API发布凭据,read:user与write:repository范围已在系统钥匙串单独保存;现有Git凭据与网关规则未修改。当前等待用户在macOS系统窗口允许Python读取dayu-git-api项。完成系统确认后以同一命令恢复发布,先核对服务器状态;不重复创建凭据,不请求令牌发到聊天,不绕过系统授权。当前PKG及其签名公证记录保持不变。
|