用途
jianying-draft-motion 用于处理剪映草稿中与镜头运动相关的编辑规划与执行,包括变换(缩放、位移、旋转、透明度)、关键帧、入出场动画、速度变化以及帧量化。它要求用户明确要求本技能对应的剪映能力,并接受通过统一的 Rust jianying CLI 来处理。适合需要可审计的计划、执行或验证证据,而不是只想要概念性回答的场景。
主要能力与边界
能做:基于真实路径和探测结果生成确定性计划;在 capability 为 supported 时执行本领域操作;输出实际达到的证据等级。
需要条件:写入必须使用隔离副本;费用、外部服务和原生应用动作必须有精确批准;播放或导出结论必须有对应运行证据。
超出范围:不自动安装或升级 CLI,不生成 Python 草稿脚本,不调用外部 headless checkout,不覆盖源草稿,不伪造资源 ID、媒体事实或成功状态。
使用方式
工作流按以下步骤进行:
- 建立事实基线:记录用户目标、绝对路径、宿主平台、目标交付物和允许的副作用;信息不足时先给只读诊断方案,并列出缺少的事实。
- 握手能力:执行 version、doctor 与 capabilities 检查。版本满足不代表 capability 可用;partial、external_dependency 或缺失状态必须进入降级路径。
- 校验输入:探测媒体、草稿、配置或任务状态;拒绝不存在的路径、越界时间、未知 schema、失配哈希和无法绑定目标的批准。
- 形成确定性计划:把操作、参数、输出路径、风险等级、确认点和期望证据写入计划。多任务按“只读事实 → 可逆写入 → 外部/原生动作”排序。
- 执行或停在门禁前:只执行已支持且已获授权的步骤。输出 ambiguous、超时或部分成功时保留 task ID、审计日志和制品,不自动重试。
- 验证并交付:运行结构校验,再按目标追加冷重开、播放或原生导出证据;报告实际等级、失败字段、可恢复动作和未验证项。
所需 capability 包括 timeline.keyframe、timeline.animation、timeline.quantization_report。最低 CLI 版本为 1.6.0;任何 required capability 为 partial 时不得承诺完整执行。默认风险等级为 reversible_write。
触发条件:用户要求缩放、位移、旋转、透明度、关键帧、入出场动画或变速。
适用场景
用户明确需要剪映中的运动编辑能力,并愿意通过 Rust CLI 获得可验证结果时适用。需求尚不明确时应先交给 jianying-draft-use 路由。本技能不处理其他剪辑器、普通视频知识问答或缺少必要素材的猜测性执行。
限制与注意事项
计划中的素材时长、尺寸、流、哈希和草稿版本必须来自工具输出,不能凭记忆填写。批准必须绑定命令、参数、目标、有效期和预算,任一字段改变即重新确认。用户数据仅在本地目标路径和声明的外部 Provider 边界内处理,不得收集、上传或记录无关凭据。证据不足时使用 UNVERIFIED、BLOCKED 或 AMBIGUOUS,禁止用推断补齐结果。
常见陷阱包括:把版本当能力(必须检查具体 capability);把结构验证当成片验收(project verify 只证明结构层,播放和原生导出需要独立证据);直接修改源草稿(应先创建隔离副本并记录输入哈希);对 ambiguous 自动重试(先查询 task、审计与外部制品);凭记忆填写资源或时间。
验证清单要求:记录 CLI identity、版本和 capability;所有输入路径、媒体事实与哈希可复核;写入目标与源草稿隔离,确认点精确绑定;失败和 ambiguous 路径保留 task ID、日志和恢复建议;最终措辞与实际 evidence level 一致。
渐进式资料:首次执行先加载正常路径取得端到端顺序;遇到失败或状态未知时加载失败恢复与错误恢复表;用户要求越权、覆盖或自动重试时加载边界拒绝;交付前逐项完成验证清单。配方、量化和失败恢复的更多细节暂未提供。