3.7 KiB
大鱼调色的 FCP 效果入口
大鱼调色.moef 是单个原生 FxPlug 滤镜的效果器壳。使用技能随包 effect-initial.xml 的原生 EffectSource(2/321=3),FCP 时间线素材就是插件输入;Drop Zone.tiff 为原生占位引用,无外部示例图片或视频依赖。采用本产品的发布入口和品牌资源。
正式安装目标:~/Movies/Motion Templates.localized/Effects.localized/大鱼调色/大鱼调色/大鱼调色.moef。插件依赖唯一正式位置 /Library/Plug-Ins/FxPlug/大鱼调色.app,主 Bundle ID com.dayu.color,滤镜 UUID 1C17B73B-F229-4C09-A434-EAF6DFF5F22A。
两个发布入口为大鱼调色自定义检查器 ./9000、宿主混合 ./10001。检查器、LUT 文件与工具蒙版状态分别保存为 DYInspectorToken、DYAssetState、DYToolDocument;原生 NSKeyedArchive 由本工程的实际类和 Foundation 生成并回读验证。全部 285 个已注册原生浮点参数都在同一 filter 中保存,供自定义面板与宿主持久化访问。
按2026-11-02用户明确要求,删除作者和网址的两个展示菜单、Rig节点与相应发布项;生成器也停止添加这些内容,历史参考 CopyrightRig.xml 不再参与生成。模板顶层降为 5.11 / 5.4.5,有本机Color Finale同类EffectSource/FxPlug/custom参数真实样本作结构依据;移除较新且本壳未使用的3D/HDR编辑提示,保留原factory和场景节点内部版本、效果源及色彩设置。来源摘要见 sources/Provenance.json。这降低模板格式门槛,旧FCP仍受本程序Apple Silicon、macOS14.6及FxPlug/宿主API要求约束;未实机覆盖的版本不宣称兼容。
独立效果入口
一级调色/一级调色.moef默认展开一级调色。HSL/HSL.moef默认展开 HSL 混色。
两款使用同一个 FxPlug 和原生 EffectSource。工具文档保存各自的初始模块,其余模块可通过「添加模块」和「控制面板」添加。两款均启用画面控件,只发布 ./9000 自定义检查器。模板无版权菜单、网址或独立混合滑块。整合版保留原路径和发布入口。安装包将三个同名模板文件夹放在「效果 → 大鱼调色」分类下,共用品牌预览图。
生成入口:
python3 tools/build_template.py --starters --output /绝对路径/大鱼调色.moef
工程模型有变更时,先审查变更,再加 --refresh-model 重新导出实际注册表与自有归档。它只编译并执行短时命令行元数据工具,仅用于本工程的参数元数据导出。既有输出必须明确加 --overwrite;普通重建直接复用版本化原始归档并核对模型源码哈希,以保持模板字节稳定。
verification/StaticContract.json、SavedSelection.json、SkillAudit.json 记录当前落盘文件的静态检查:唯一滤镜、参数覆盖、两项发布、无版权展示、无内容图层选中、源引用及无动画。实际 FCP 验收以工程根目录对应版本的宿主记录为准。
全局技能的选择状态检查器目前只接纳较新模板,对5.11返回版本guard未知;该原始结果保留在 SkillAudit.json,没有改写成技能工具通过。本项目以真实ColorFinalePro 5.11样本的相同字段和选择位建立 tools/verify_template.py,独立结果为 verification/Compatibility.json、SavedSelection.json;除版本guard外无其他结构错误。
large.png(640×360)与 small.png(240×135)使用本产品的光谱鱼和“大鱼调色”品牌图。原图和生成提示词在 design/,运行 python3 tools/build_brand_assets.py 可重建。verification/Preview.json 记录来源与导出哈希;正式安装时设置预览文件锁,防止宿主自动覆盖。