剪映草稿 Harness 是面向插件和智能体宿主的运行契约。所有执行都通过统一的 Rust CLI handler 完成,CLI、MCP 和宿主 adapter 必须返回同一任务与错误语义。
用途与适用场景 当用户明确要求该技能对应的剪映能力,并接受通过统一 Rust jianying CLI 处理时使用;当用户需要可审计的计划、执行或验证证据,而不是概念性回答时使用。需求尚不明确时先交给 jianying-draft-use 路由。该技能不用于其他剪辑器、普通视频知识问答或缺少必要素材的猜测性执行。
主要能力 可基于真实路径和探测结果生成确定性计划;在 capability 为 supported 时执行本领域操作;输出实际达到的证据等级。触发条件为用户需要持久任务、审批、配置、MCP、宿主集成、取消/重试或审计能力。所需 capability 包括 job.lifecycle、approvals、config、mcp.serve、mcp.job_lifecycle;最低 CLI 版本 1.6.0,运行前需校验实际 manifest。默认风险为 high_risk_write,只读 list/show/audit 可降为 read_only。
使用方式 流程分为六步:建立事实基线,记录目标、绝对路径、宿主平台、交付物和允许的副作用;握手能力,执行 version、doctor 与 capabilities 检查;校验输入,探测媒体、草稿、配置或任务状态;形成确定性计划,写明操作、参数、输出路径、风险等级、确认点和期望证据;执行或停在门禁前,只执行已支持且已获授权的步骤;验证并交付,先做结构校验,再按目标追加冷重开、播放或原生导出证据。运行中完成 version/schema/capability 握手,编译确定性的 jianying-job/v2 并保存输入摘要和素材哈希,对风险操作创建精确批准,使用 jianying job run --json、job batch 或 job serve 并记录 CLI task ID,通过 job show、job audit、job cancel、job retry 管理生命周期。MCP 使用官方协议实现的 stdio、Streamable HTTP 或 SSE;远程监听必须验证 token、Host 和 Origin,并通过 jianying_job_list/show/cancel/retry/audit 管理持久业务任务。最小 Job 示例见 examples/minimal-job.json,生命周期、审批与 transport 门禁见 references/workflow.md。
限制与注意事项 写入必须使用隔离副本;费用、外部服务和原生应用动作必须有精确批准;播放或导出结论必须有对应运行证据。不自动安装或升级 CLI,不生成 Python 草稿脚本,不调用外部 headless checkout,不覆盖源草稿,不伪造资源 ID、媒体事实或成功状态。批准必须绑定命令、参数、目标、有效期和预算,任一字段改变即重新确认。用户数据仅在本地目标路径和声明的外部 Provider 边界内处理。证据不足时使用 UNVERIFIED、BLOCKED 或 AMBIGUOUS。常见问题包括把版本当能力、把结构验证当成片验收、直接修改源草稿、对 ambiguous 自动重试、凭记忆填写资源或时间。