企业官网建设流程全解析

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-skill

jianying-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": {} }

统一契约的三大好处：

• 🤖AI 可解析：Agent 无需"猜"输出含义，直接读ok字段决定下一步；
• 🔁流水线可编排：多个脚本串联时，JSON 可以直接作为下游输入；
• 🩹排错更快速：reason字段直接给出失败原因，配合退出码定位问题。

该契约的实现非常轻量，集中在 scripts/utils/cli_protocol.py 中：

def make_result(ok, code, reason="", data=None): return {"ok": bool(ok), "code": code, "reason": reason, "data": data or {}}

异常体系同样分层清晰，见 scripts/utils/errors.py：

• UserInputError—— 用户输入/参数非法；
• InfraError—— 运行环境或依赖缺失；
• DataError—— 数据格式或内容非法。

退出码约定

命令行还遵循固定退出码（见 docs/api.md）：

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 "草稿名" # 导出完整工程 JSON（content 或 meta） python scripts/draft_inspector.py show --name "草稿名" --kind content --json

实用参数：

• --root覆盖草稿根目录（自动探测失败时手动指定）；
• --path按草稿绝对路径直接检查；
• --json返回机器可读载荷。

草稿目录的跨平台自动探测逻辑在 scripts/utils/formatters.py，Windows / 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.csv）：

python 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 串起来，就是完整的"生成 → 验证 → 导出"闭环：

1. api_validator.py --json确认环境就绪；
2. 用 Python API（JyProject 封装）生成草稿，核心类定义见 scripts/jy_wrapper.py；
3. draft_inspector.py list --json验证草稿确实生成；
4. auto_exporter.py无头导出成片。

每一步都是ok / code / reason / data四字段结构，任何一步失败，Agent 都能凭reason与退出码决定是重试、修参还是求助用户。这套约定也写在 docs/minimal-command-sop.md 的最简执行 SOP 中：一次生成脚本 → 单次执行 → 固定检查项验收，避免反复试错。

延伸阅读

💡 小贴士：所有<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