用途
本技能面向剪映(JianYing)相关操作的统一 Rust 命令行工具 jianying,用于在正式执行剪辑、草稿或运行时操作之前,对当前环境进行只读诊断。它帮助确认 CLI 本身、媒体工具链、草稿根目录、配置 profile 以及原生运行时是否具备所需能力,并以可审计的方式输出事实与证据等级。
主要能力
- 握手检查:执行
jianying --version、jianying doctor --json、jianying capabilities --json,记录实际调用的二进制路径、版本和 SHA-256。 - 运行时发现与状态:执行
jianying runtime discover --json、jianying runtime status --json,识别未知 Runtime Profile。 - 配置校验:执行
jianying config validate --json。 - 输入事实核查:探测 CLI 绝对路径与哈希、宿主平台、ffmpeg/ffprobe、草稿根、配置 profile、剪映进程和 Runtime Profile。
- 分类报告:将缺失工具、缺失草稿根、
drafts_without_editor、运行中的编辑器和未知 Runtime Profile 分开报告。 - 能力降级路径:当 capability 不是
supported(如partial、external_dependency或缺失)时,输出所需最低能力与恢复建议,不自动选择替代引擎。
使用方式
该技能在用户明确要求安装前检查、环境诊断、版本/capability 握手或 Runtime Profile 排障时触发。所需 capability 为 doctor、runtime.discovery、runtime.status;最低 CLI 版本为 1.6.0,且版本满足仍需逐项检查具体 capability。默认风险等级为 read_only。
典型诊断命令序列:
jianying --version
jianying doctor --json
jianying capabilities --json
jianying runtime discover --json
jianying runtime status --json
jianying config validate --json
流程上先建立事实基线,再握手能力、校验输入、形成确定性计划,随后执行或停在门禁前,最后验证并交付。字段解释与排障顺序可参考 references/workflow.md,只读 Job 示例见 examples/minimal-job.json。
适用场景
- 首次使用前的环境就绪检查。
- CLI 版本与 capability 握手确认。
- 媒体工具、草稿根或配置 profile 缺失的排障。
- Runtime Profile 状态不明或未知时的诊断。
限制与边界
- 不自动安装或升级 CLI,不生成 Python 草稿脚本,不调用外部 headless checkout,不覆盖源草稿,不伪造资源 ID、媒体事实或成功状态。
- 安装、升级、修改配置、启动/停止剪映等动作须分别确认具体动作与目标;批准需绑定命令、参数、目标、有效期和预算,任一字段改变即重新确认。
doctor通过不证明真实剪映兼容或原生导出能力;成功证据等级为 structural,播放与原生导出需独立证据。- 遇到 ambiguous、超时或部分成功时保留 task ID、审计日志与制品,不自动重试。
- 证据不足时使用 UNVERIFIED、BLOCKED 或 AMBIGUOUS,禁止用推断补齐结果。
- 费用、外部服务与原生应用动作需精确批准。
- 不适用于其他剪辑器、普通视频知识问答或缺少必要素材的猜测性执行;需求不明确时应先经
jianying-draft-use路由。 - 安装与修复所需操作的具体内容,资料仅说明需引用当前平台官方来源,未提供具体步骤。