5个核心CLI脚本速览jianying-editor-skill 的机器可读输出契约与剪映自动化命令指南【免费下载链接】jianying-editor-skillSkill for Agent automating JianYing (CapCut Chinese version) video editing.项目地址: https://gitcode.com/gh_mirrors/ji/jianying-editor-skilljianying-editor-skill是一个让 AI 自动接管剪映CapCut 国内版剪辑流程的 Skill 项目用自然语言下达指令它就能完成写文案、配音、字幕、配乐、特效到导出的全链路。除了 Python API 外它还内置了一组CLI 命令行脚本并约定了统一的机器可读输出契约JSON 输出格式方便 AI Agent 和自动化流水线稳定地调用、解析与排错。为什么需要「机器可读输出契约」普通命令行的输出往往是给人看的彩色日志而 AI Agent 和脚本编排需要的是确定性的结构。jianying-editor-skill 为此定义了统一的--json输出契约所有支持该参数的脚本都会输出同构的 JSON 载荷。契约定义见 rules/cli.md 与 docs/api.md核心结构如下{ ok: true, code: ok, reason: , data: {} }字段含义ok布尔值调用是否成功code状态码ok表示成功失败时为具体错误码reason人类可读的失败原因说明data业务数据载荷草稿信息、检索结果等统一契约的三大好处AI 可解析Agent 无需猜输出含义直接读ok字段决定下一步流水线可编排多个脚本串联时JSON 可以直接作为下游输入排错更快速reason字段直接给出失败原因配合退出码定位问题。该契约的实现非常轻量集中在 scripts/utils/cli_protocol.py 中def make_result(ok, code, reason, dataNone): return {ok: bool(ok), code: code, reason: reason, data: data or {}}异常体系同样分层清晰见 scripts/utils/errors.pyUserInputError—— 用户输入/参数非法InfraError—— 运行环境或依赖缺失DataError—— 数据格式或内容非法。退出码约定命令行还遵循固定退出码见 docs/api.md退出码含义0成功1运行时/环境依赖失败2输入非法或前置条件不满足5 个核心 CLI 脚本一览所有脚本统一位于 scripts/ 目录官方速查见 SKILL.md 与 docs/api.md 的 Key scripts 清单。1. draft_inspector.py —— 草稿检查器最常用查看本地剪映草稿的入口工具支持列出草稿、按名称查看摘要、导出完整 JSON。# 列出最近 20 个草稿 python scripts/draft_inspector.py list --limit 20 # 查看某个草稿的摘要 python scripts/draft_inspector.py summary --name 草稿名 # 导出完整工程 JSONcontent 或 meta python scripts/draft_inspector.py show --name 草稿名 --kind content --json实用参数--root覆盖草稿根目录自动探测失败时手动指定--path按草稿绝对路径直接检查--json返回机器可读载荷。草稿目录的跨平台自动探测逻辑在 scripts/utils/formatters.pyWindows / macOS 路径都能自动识别。2. api_validator.py —— 环境诊断一条命令检查 Python 依赖、剪映安装位置、草稿目录是否就绪python scripts/api_validator.py --json新装环境先跑它能快速区分环境问题还是脚本问题。3. asset_search.py —— 素材名称检索剪映自带海量滤镜/转场/动画AI 通过它按中英文名称模糊检索素材库底层数据来自 data/ 目录下的 CSV 素材表如filters.csv、transitions.csv、text_animations.csvpython scripts/asset_search.py 复古 -c filters python scripts/asset_search.py 雾化 -c transitions这样加个复古滤镜这类自然语言需求就能被精确映射到剪映素材库里的真实名称。4. auto_exporter.py —— 无头自动导出剪完草稿后一键导出 MP4无需手动点剪映界面python scripts/auto_exporter.py 草稿名 output.mp4 --res 1080 --fps 60⚠️ 注意自动导出依赖Windows 剪映 5.9 或更低版本且导出过程中不要动鼠标键盘它模拟了键鼠操作。5. build_cloud_music_library.py —— 云端曲库挖掘自动扫描你历史工程中用过的云端音乐建成本地曲库索引让 AI 也能调用剪映曲库里的音乐python scripts/build_cloud_music_library.py同目录还有 sync_jy_assets.py 同步收藏/播放过的 BGM 与文字模板以及 build_cloud_text_styles_library.py 建立云端文字样式库。一个典型的自动化工作流把上面的 CLI 串起来就是完整的生成 → 验证 → 导出闭环api_validator.py --json确认环境就绪用 Python APIJyProject 封装生成草稿核心类定义见 scripts/jy_wrapper.pydraft_inspector.py list --json验证草稿确实生成auto_exporter.py无头导出成片。每一步都是ok / code / reason / data四字段结构任何一步失败Agent 都能凭reason与退出码决定是重试、修参还是求助用户。这套约定也写在 docs/minimal-command-sop.md 的最简执行 SOP 中一次生成脚本 → 单次执行 → 固定检查项验收避免反复试错。延伸阅读资料路径官方文档目录docs/CLI 契约规范rules/cli.mdAPI 参考与退出码docs/api.mdAgent 执行手册docs/agent-playbook.md完整示例集合examples/健壮自动导出示例examples/robust_auto_export.py 小贴士所有SKILL_ROOT前缀都指向本 Skill 的安装目录如.claude/skills/jianying-editor。如果你的剪映草稿目录不在默认位置用--root覆盖或设置JY_PROJECTS_ROOT环境变量即可。掌握这套CLI 工具集 机器可读输出契约你既可以亲自用命令行驱动剪映自动化也可以让 AI Agent 更可靠地替你完成批量剪辑任务 【免费下载链接】jianying-editor-skillSkill for Agent automating JianYing (CapCut Chinese version) video editing.项目地址: https://gitcode.com/gh_mirrors/ji/jianying-editor-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
