60 行
7.2 KiB
Markdown
60 行
7.2 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.2-group-fold-20261031。APP 1.1.2(11)编译源码:cdcb30a6aa1519bfb2f183165fef11cbf278bc7c;标签另含本次宿主验收与恢复记录。Apple公证ID 398b020c-9e1e-4c2b-b637-e8e3af2a8f59,Accepted;正式签名、票据和实际安装状态见 verification/Delivery.json。
|
||
|
||
所有调色分组展开即启用、折叠即停用,关闭时参数不可见;仅基础调节在新实例和全部还原后默认展开。折叠保留数值和 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送公证前及正式安装后均通过82项原生自检,正式结果见 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。
|