SuperAPI AI 工具集

jianying-draft-adjustments

设计与创作

查看项目

更新于 10-27 10:06

技能介绍

剪映调节(JianYing Adjustments)是面向剪映“调节”面板的技能,覆盖曝光、亮度、对比度、饱和度、色温、色调、锐化、暗角和颗粒等参数。由于当前发布的 CLI 没有把这些参数全部提升为稳定的草稿原子命令,该技能默认先做能力计划与参数回读。

用途

  • 修正曝光、白平衡、对比度、饱和度或细节。
  • 统一多镜头颜色,或进行局部/全局调节。
  • 读取、比较、重置和恢复调节参数。

能力边界

  • 能做:调节参数计划、能力探测、绝对值写入请求、读回、前后比较和恢复。
  • 需要条件:必须精确匹配剪映版本、语义控件并支持 readback;画面结论需要通过播放验证。
  • 不该用:不以滤镜替代调节、不猜测滑杆刻度、不在只有相对拖动能力时自动执行。

使用方式

可直接提出需求,例如“把室内片段色温调暖但保护肤色”“读取当前曝光参数”“重置这个镜头的锐化和暗角”。首次使用时加载功能动线;多镜头统一曝光或白平衡时加载曝光匹配流程,把分析建议、人工例外、绝对参数和 readback 分开保存。

运行契约

  • 触发条件:用户提出调节面板、曝光、色温、对比度、饱和度、锐化、暗角或颗粒操作。
  • 所需 capability:runtime.control_catalog、runtime.controls、runtime.profile、project.edit_isolated。
  • 最低 CLI 版本:1.6.19;runtime.controls 或具体参数未 supported 时只能输出计划和版本绑定 Adapter 请求。
  • 默认风险:external_native_execution。
  • 输入事实:目标片段/范围、编辑器精确版本、原参数读回、参考画面、允许参数、保护肤色/品牌色规则。
  • 确认点:首次调用 GUI Adapter、全片调节、重置已有调节和原生播放分别确认。
  • 成功证据:playback;参数写入回执仍需前后画面证据。
  • 禁止行为:不得用滤镜命令冒充调节,不得猜测滑杆数值、复用其他版本控件映射或在无法回读时连续累加参数。

工作流

  1. 探测控件:runtime controls list/get 查找精确版本的调节语义动作和状态回读合同。
  2. 保存基线:保存应用前参数与画面证据;缺少语义 ID 或 readback 时停止。
  3. 批准执行:按功能动线生成一次性、绝对值参数请求并获得批准。
  4. 验证:Adapter 执行后重新读回参数,比较前后代理/原生画面。
  5. 恢复:验证失败或状态不明时恢复快照,不重复增量操作。

规则

  • 只接受绝对参数目标和可回读状态。
  • 版本、build、语义 ID 任一变化都重新 Canary。
  • 先保存原参数和画面基线,再写入。
  • 滤镜、调节和 LUT 不可互相冒充。
  • 分析 Provider 只能提出建议;没有绝对参数、版本绑定语义 ID 和 readback 时不得批量写入。

注意事项

  • 相对拖动不可幂等:无绝对值和回读时保持阻断。
  • 版本升级映射漂移:每个版本重新验证控件。
  • 曝光修正损坏肤色:同时检查亮部、阴影和人物肤色。
  • 批量复制覆盖例外镜头:先列出排除片段。
  • 超时后重复调节:先读回当前值,避免叠加。

安全与数据

调节默认只处理本地草稿和代理帧,不上传视频;远程评估需对精确代理、Provider 和费用另行批准。最小 Job 见 examples/minimal-job.json。