SuperAPI AI 工具集

jianying-draft-media

设计与创作

查看项目

更新于 10-27 10:06

技能介绍

JianYing Media 用于剪映“素材”面板及素材轨道相关操作,核心原则是先取得真实媒体事实,再决定本地导入、子草稿导入、官方素材下载或替换路径。

用途与适用场景:导入视频、图片、素材文件或另一个草稿/轨道;检索并下载剪映官方素材;替换、重链、删除已有素材;分析场景切点、重复拍摄、素材流或资源权益。用户提出素材导入、子草稿、素材库、替换、重链、删除或素材分析时触发。

主要能力:本地视频/图片导入;整草稿或指定轨道导入;替换、重链、删除与素材事实检查。其中整体追加草稿使用 project concat,单轨导入使用 template inspect + template import-track,二者不可混用。遇到 WebM、透明 Web VFX、异常尺寸/帧率或兼容性未知素材时,先加载媒体预检合同,形成可对账的派生媒体关系,再决定是否导入。标准化由受控 Provider 创建派生媒体,技能不静默转码,Provider 也不能直接修改草稿。

使用方式:先加载“功能动线”并选择唯一动作 ID,可用自然语言表达需求,如“把 /素材/开场.mp4 加到 0 秒”“把子草稿 B 接到主草稿末尾”“从官方素材找可商用的 9:16 科技园航拍”。运行流程为:一、运行 doctor、capabilities,并用 media probe 或 project inspect 读取事实;二、选择唯一匹配的语义动作;三、先快照/隔离输出,固定 argv 写入,官方素材先登记权益与下载收据;四、运行 project verify、project diff 验证;五、失败时局部删除或恢复快照。

运行契约与限制:所需 capability 包括 media.probe、media.add、project.edit_isolated、project.verify、template.import_track、media.replace、media.relink、media.official_resource、media.official_resource_apply 等,project concat 以发布命令目录的 supported 状态为准;最低 CLI 版本 1.6.19;默认风险为 reversible_write。官方素材下载需要权益与用途证据,写入需在隔离副本上进行,完成结论需冷重开验证。下载官方资源、写入已有草稿、合并子草稿、删除片段和调用原生应用分别需要确认。媒体时长、尺寸、流和哈希只来自探测结果,语义动作必须绑定绝对路径、目标范围和固定 argv。不得伪造资源 ID、跳过探测、覆盖源草稿、把坐标当动作 ID,或用 Rust 源码代替发布二进制能力证明。不把素材面板可见、下载图标消失或 GUI 提示当作加入草稿成功;下载收据不等于已加入草稿;应用超时后重试前先检查草稿和任务状态,避免重复片段;同名资源使用稳定资源 ID 和哈希判断,不按标题猜测。

不适用范围:不处理字幕排版、数字人生成或未建模的界面入口,这些请求应改由对应分类技能处理或保持阻断。

安全与数据:只读取用户授权路径,不上传本地素材,除非用户对精确文件、Provider、用途和有效期另行批准;凭据不进入技能、命令参数或日志。最小隔离编辑合同见 examples/minimal-job.json。