JianYing Draft Schema 是剪映(JianYing)技能体系中的计划构造与校验技能,核心是对 jianying-job/v2 或兼容的计划文档进行结构化设计与验证,依赖统一的 Rust jianying CLI 处理,而不负责绕过 CLI 直接写入草稿协议。
用途与触发条件:当用户明确要求该技能对应的剪映能力,并接受通过统一 Rust jianying CLI 处理,或需要可审计的计划、执行与验证证据时使用。触发场景包括 Job/Plan Schema、领域对象、时间线结构、v1 兼容或版本诊断。需求尚不明确时应先交由 jianying-draft-use 路由;不适用于其他剪辑器、普通视频知识问答或缺少必要素材的猜测性执行。
主要能力:基于真实路径和探测结果生成确定性计划;在 capability 为 supported 时执行本领域操作;输出实际达到的证据等级。所需 capability 为 schema.job_v2 与 schema.plan_v1_compat,最低 CLI 版本 1.6.0,提交前仍需进行 capability 握手。默认风险为 read_only,仅生成计划时不产生草稿副作用。
使用方式:按六步流程进行。第一步建立事实基线,记录用户目标、绝对路径、宿主平台、目标交付物与允许的副作用,信息不足时先给只读诊断方案并列出缺失事实。第二步握手能力,执行 version、doctor 与 capabilities 检查,version 满足不代表 capability 可用,partial、external_dependency 或缺失状态须进入降级路径。第三步校验输入,探测媒体、草稿、配置或任务状态,拒绝不存在的路径、越界时间、未知 schema、失配哈希与无法绑定目标的批准。第四步形成确定性计划,写入操作、参数、输出路径、风险等级、确认点与期望证据,多任务按“只读事实 → 可逆写入 → 外部/原生动作”排序。第五步执行或停在门禁前,仅执行已支持且已获授权的步骤,ambiguous、超时或部分成功时保留 task ID、审计日志与制品,不自动重试。第六步验证并交付,运行结构校验,再按目标追加冷重开、播放或原生导出证据,报告实际等级、失败字段、可恢复动作与未验证项。
核心规则:根 schema 为 jianying-job/v2,operation 为 create/edit/inspect/verify/publish/export/batch;时间使用整数微秒,帧敏感位置同时遵守项目 FrameRate 量化结果;新项目使用 project.type = new,已有草稿使用 existing 且写入时必须提供隔离输出;素材先经 media probe --json,不以设计时长替代实测事实;v1 输入只能放入 compatibility 信封,由 CLI 转换并返回字段级诊断;未知 schema、破坏性版本或缺失 capability 必须结构化失败。计划中的素材时长、尺寸、流、哈希与草稿版本必须来自工具输出;批准须绑定命令、参数、目标、有效期与预算,任一字段改变即重新确认。
适用场景与限制:适用于剪映任务计划的结构设计与校验、时间线结构与版本兼容诊断。超出范围的行为包括自动安装或升级 CLI、生成 Python 草稿脚本、调用外部 headless checkout、覆盖源草稿、伪造资源 ID、媒体事实或成功状态。写入必须使用隔离副本;费用、外部服务与原生应用动作需精确批准;播放或导出结论必须有对应运行证据。结构验证通过不等于草稿结构或真实剪映验证通过,播放与原生导出需独立证据。字段模型、操作选择与验证层级见 references/workflow.md,可执行最小例见 examples/minimal-job.json;首次执行先加载正常路径,遇到失败或状态未知时加载失败恢复与错误恢复表,用户要求越权、覆盖或自动重试时加载边界拒绝。