文件
dayu-color/research/OnlineLUTIntegration-20261111.md
T

8.3 KiB
原始文件 Blame 文件历史

在线 LUT 接入(2026-11-11)

目标:主 APP 使用大鱼站微信登录;购买文章 14421、15792 任意一个或有效会员可访问全部已发布在线 LUT、分类、下载及当前时间线帧在线效果预览。普通本地调色不依赖登录。

参考 FcpxSoundEffectsExtension 的 02c66da4a54dca9954dadb8dab7cc93005468935:通用 /dayu-app/v1/login/session 微信会话、dayu_sfx_materials 表及现有私有素材存储。参考项目仅作只读使用,不复制其签名种子、不改变其权限或发布。

实现约定:

  • 新建产品专用 MU 插件和 /dayu-color/v1/lut/ 接口,复用现有账号、设备绑定与付款记录;所有在线素材操作均在服务器重新检查权限。
  • 微信批准的本产品一次性会话交换随机产品令牌;令牌保存到登录钥匙串,允许正式主 APP 与正式 FxPlug 服务读取。禁止把设备 UUID 或本地布尔值当作在线权限凭证。
  • 只列出已发布 LUT;其他用户的草稿和私有素材不公开。分类、分页、搜索与下载共用现有目录。
  • 浏览器由用户点击“在线预览当前帧”上传当前帧缩略图。只发送 PNG 像素,不发送视频、文件路径或项目名称;服务器内存处理并返回 PNG,禁止保存帧和记录请求正文。已选择帧冻结至下一次点击,避免播放期间连续上传。
  • 在线预览是显示参考;最终应用先下载并校验大小、SHA-256 和有效 Cube,仍走现有本地渲染流程。

生产基线:已验证 192.168.31.21 对应 SMB 共享,根目录可读写。新增的两个后端文件在生产和本地专项工程均不存在。既有网站和鉴权源只读核对,不改写共享登录组件。

LOCAL_PROJECT=/Users/mac/Downloads/dayumedia/dayu-color-beta;NAS_ROOT=/Volumes/dayumedia (存储空间1)/wwwroot/dayu_media。仓库 Backend/wp-content/mu-plugins/dayu-color-online-luts.php 及 Backend/wp-content/mu-plugins/dayu-color-online-luts/renderer.php 分别映射到上述两处根目录下同相对路径。只部署这两个文件,覆盖前按原目录旁路备份并核对基线。

当前状态:接入前基线 5fae1150f4b7b6087f5da8298b5ac3ad8916e529,正式 1.21.8(126)。工程文件已有 Security 引用排序改动保留;本轮采用自动同步的 Shared 源文件,不需改写该工程文件。实现、测试与交付结果持续补充到本记录和开发交接。

实现检查点

已完成专用会话与权限接口、在线目录及内存 PNG 渲染器;主 APP 微信登录/权限卡片、共享钥匙串客户端、浏览器在线分类/分页/帧预览/下载应用及去重导入已接入。首次 Release 配置编译通过,PHP 合约检查通过。尚未部署后端、尚未运行正式新版、尚未公证或发布;下一步补充原生浏览器与导入检查,检查线上接口后进行正式交付。

第二阶段:PHP/GD 权限与渲染合约 36 项、原生 AppKit 在线浏览器与导入合约 36 项通过;原生测试模拟网络应答,未使用用户凭据或上传真实时间线帧。已从现有公开接口盘点 1,233 个发布 LUT 和 17 个分类。准备 1.22.0(127)正式交付,后台部署前检查点包含专用部署脚本及安装说明。

部署与修正:两个新增生产文件已按映射部署并核对内容;线上 6 项未登录/伪造凭据检查通过,本地浏览器 40 项回归通过。127 候选 APP 已获 Apple Accepted 并完成票据验证,安装后的 CLI 检查期间停止交付,未进行用户界面验收或发布。保留 126 恢复 APP;127 的来源、公证和备份见 verification/SupersededOnlineLUTBuild127.json。补齐清除/本地选择时的在线选中状态复位,最终候选改为 1.22.0(128)。交付脚本安装后校验区在键盘中断时也执行回滚。

最终 UI 回归补充了在线比较标题使用 LUT 名称、来源切回本地时恢复打开文件夹按钮,以及清除和本地选择后的选中状态。128 候选在公证等待阶段停止,未安装;公证 ID 与来源见 verification/SupersededOnlineLUTBuild128.json,继续只读查询该提交,不重传相同产物。最终候选更新为 1.22.0(129)。

最终接入回归:44 项原生在线浏览器检查全部通过。比较区使用真实远程可见状态的隐藏视图验证,并明确检查 LUT 名称、清除状态、本地选中状态与打开文件夹按钮恢复;不显示未公证测试 APP。程序源码候选已冻结,接下来只进行正式签名、公证、安装、宿主与发行验收。

129 候选已通过 Apple Accepted、票据/Gatekeeper、正式安装 1,028 项检查及 FCP 基本宿主验收:1080p/25p 合成项目、本地 LUT 缩略图、新来源菜单、未登录提示及片段播放正常,见 verification/HostOnlineLUTBuild129.json。微信会话创建成功,用户未确认;结束本次待确认登录并正常退出主 APP 与宿主,未发起用户帧上传。最终 130 补齐与本地一致的同帧应用前快照保护,以及在线按钮的无障碍名称;46 项原生检查通过。授权后的在线实测仍待用户微信确认。

最终正式安装 1.22.0(130)

编译提交 0631e8b6c3aa6ef1cbcdb919d1267d9beeea7632,APP 公证 f5eb451e-5e1f-492e-99f8-289442229f3d Accepted。正式路径的 1,028 项自检、签名、票据、Gatekeeper、17 模板和 PluginKit 路径核对通过。FCP 12.4 使用新插件服务进程 98402,在独立 1080p/25p 合成项目中验证本地预览、在线来源、未登录提示、辅助功能标签及 2:01→3:24 播放;正常退出。主 APP 130 已启动。用户尚未批准微信登录,真实授权目录/下载和云端预览留待扫码后验收;没有上传用户时间线帧。详见 宿主报告。已知替换备份在最终验收后清理,正在制作正式 PKG 和 Release。

保存最终安装检查点时误以 --help 调用无参数保护的 checkpoint.py,产生 b98d92f 并包含工程既有 Security 引用排序差异;随后以新提交将工程文件恢复到本轮基线,同时把该差异原样保留为工作区未提交状态。脚本增加必填消息/路径和帮助保护,避免空路径触发全仓暂存。没有改写历史或实际编译输入。

硬件 UUID 账号恢复(用户补充)

用户反馈微信 OAuth 未确认,并说明现有后端按 macOS 硬件 UUID 免登录。已验证客户端 gethostuuid 与 IOPlatformUUID 一致;不生成随机设备号、不保存原始 UUID 到报告。既有 app_device_login 对本机识别成功。新增客户端启动恢复:通过该既有接口获取短期 JWT,仅在内存中交给 /dayu-color/v1/lut/device,服务端复用共享 rest_check_access 校验 JWT,并核对统一设备表的当前账号,兑换产品专用在线 LUT 会话。所有后续操作仍复核购买/会员权益和绑定。退出后停止自动恢复,点击刷新可重新识别。未绑定机器继续微信登录。43 项后端合约覆盖伪造 JWT、UUID 单独请求、绑定变更及退出。130 APP 和 PKG 验证完成但不发行,最终改为构建 131。

UUID 恢复的生产接口实测通过:识别本机已有绑定,复用共享 JWT 校验兑换产品会话,读取 17 分类/1,233 项,首项 885,038 字节下载的摘要和声明大小一致;16×9 合成色卡通过生产预览返回相同尺寸 PNG。测试会话均已退出,报告不含 UUID 原文、用户名和令牌。恢复和下载 · 合成帧云端预览。这些尚不替代正式 131 主 APP 自动登录和 FCP 内取帧验收。

正式 131 完整链路验收

APP 公证 1e57ee70-d099-4942-91fd-29a2d5f47a44 Accepted,实际编译提交 d979f8958caf36cc7b97ea838960c69f7fbb4d91。正式安装主 APP 自动硬件登录、退出保持和刷新恢复通过;FCP 共享钥匙串后列出 1,233 项/17 分类。现场修正 PHP 临时数组遍历未将 SQL 字符串编号/大小转换到返回数组的问题,新增合约使总数44项。部署后网格与服务器当前帧预览实际显示,下载653号 01冰- 并应用到宿主,右侧原图/云端效果划像正常,播放通过后正常退出。只上传合成色卡,不含用户素材。新机首次微信 OAuth 和 Motion 未验收。详见最终宿主报告。