文件
dayu-color/research/MainApp1.6.1.md
T

4.0 KiB
原始文件 Blame 文件历史

主 APP 1.6.1(43)改造

本轮范围:仅主 APP 产品介绍、插件自动检查/提交注册、成功退出。不加入登录、授权、加密、自动更新或后端接口;以本轮用户说明为准,不执行旧交接中的下一阶段账号计划。

界面合同

延续现有 Objective-C/AppKit、Nib 连线和手动内存管理。使用 standard 档原生交互;静态深色渐变、圆角彩色卡片与胶囊按钮呼应用户参考图,不引入常驻动画、模糊或新的渲染依赖。

比较了单列介绍、左右双栏状态+功能、状态+使用指引+双列特色卡三种结构,选择第三种:优先显示注册与宿主入口,接着完整调色、LUT、胶片、蒙版叠层,顶部首先显示可点击的发布地址 https://dayu.media。窗口默认920×850,最小760×620,纵向滚动;介绍可通过按钮/⌘I保留,菜单⌘R重试、⌘W关闭、⌘Q退出。保留可访问的原生按钮、文本、焦点环和状态播报;表面不透明,增强对比度加粗边框。

状态唯一归属 AppDelegate:checking → registering → ready/failed。所有 PluginKit 操作在后台队列;主线程负责状态和窗口。重复检查期间禁用重入。每次打开都提交内嵌组件注册;先验证内嵌组件Bundle ID、当前构建号和FxPlug登记协议1.1,提交精确路径的注册;查询可用时核对实际路径。若系统明确拒绝沙盒查询,则使用成功的pkd注册应答,不将查询受限误报为注册失败。其他查询/提交失败仍不放行。成功默认5秒后退出;查看介绍取消本次倒计时;失败保留窗口和重试。关闭窗口退出,无后台常驻。

运行诊断仅记录本机插件登记和版本,写入应用 Application Support/com.dayu.color/Registration.json;不联网、不含凭据。--show-introduction 是保留介绍的启动方式,仍运行真实注册流程。

参考来源

用户指定仓库 https://dayu.media/git/dayu/fcpx-qwen3-asr.git ,只读参考提交113069c74aff935db2082b5bcd8e1aa47fe1fbf2的ContentView.swift和LicenseViewModel.swift。借鉴深色渐变、卡片配色和操作层级;未复用会员、识别计费、账号或扩展业务代码。

保留范围

主 Bundle ID com.dayu.color,服务com.dayu.color.XPC,唯一正式路径/Library/Plug-Ins/FxPlug/大鱼调色.app。主 APP/内嵌服务版本同步1.6.1(43)。调色/渲染、Uniform、参数、预设、Metal、模板无改动。现有自检及正式安装、宿主、打包/Release证据在verification记录;本文件不预先宣称未执行的验证通过。

首轮正式40版发现沙盒查询-A会返回PKDiscoverAll未授权,虽然-a注册已经成功。41版移除-A/-D,仅查询自身组件,不取消沙盒、不新增权限。注册标记+后的可变空白单独归一化;发布地址按用户补充移到页面最顶部。40版保留为问题定位记录,不作为最终发行包。

41版实测证明系统CLI即使不带-A,查询也请求PKDiscoverAll;沙盒拒绝查询但允许显式注册。最终42版分别记录discoveryVerified、discoveryRestricted、submissionAccepted与confirmationMethod。只有明确的查询权限错误且精确组件验证/注册应答成功时,使用pkd应答判定注册成功;没有给沙盒增加权限,也没有把未知错误一律当成功。交付时由外部PluginKit回读和删除登记后重建的实际结果独立验证。

最终范围更新:用户明确允许关闭沙盒。43版移除外层APP的app-sandbox entitlement,Hardened Runtime、Developer ID、公证等交付要求保持;内嵌服务原本未启用该沙盒。恢复严格的系统登记回读,不再使用42版候选的pkd应答降级。主界面“打开FCP检查”会保留窗口,由用户在宿主确认画面及调节后点击“已确认正常,退出”。该确认写入本机诊断,自动验收不代替用户点击;系统注册成功与宿主用户确认分开。默认启动仍在注册成功5秒后退出。42版中断等待后未安装、不发布;40/41为定位问题的候选,不发布。