剪映 AI 自动化剪辑【云芯智能】

概述

JianYing Editor Skill

用 Python 生成剪映专业版（JianYing Pro）草稿：Skill 负责把时间轴搭好（写出 draft_info.json），渲染与导出仍在剪映里完成。This skill builds JianYing Pro draft projects programmatically. It writes the draft timeline; JianYing itself renders and exports.

0. 环境门禁（Environment Gate）— 每次会话首次调用前必须执行

本 Skill 依赖本机 Python 包、FFmpeg 与剪映桌面端。平台没有"技能激活钩子"，因此门禁由本文件驱动，规则如下：

1. 若本次会话尚未检测，先执行快速检测（约 2 秒）：

   python <SKILL_ROOT>/scripts/doctor.py --quick --json

1. 按 verdict 分支：
   • ready → 直接进入剪辑工作流。
   • blocked（核心依赖缺失）→ 向用户列出 actions，征得同意后执行：

“bash python <SKILL_ROOT>/scripts/bootstrap.py install --core --yes `用户拒绝时，改为输出手动命令 pip install -r scripts/requirements-core.txt`，并在本次仅产出图层方案（降级）。

• degraded（可选项缺失，例如无 FFmpeg / 未装剪映）→ 继续工作，但明确告知哪些能力不可用及降级路径。

1. 需要可选能力时（网页动效 / 自动导出 / AI 解说），先按功能检测再决定：

   python <SKILL_ROOT>/scripts/doctor.py --feature web-animation --json
   python <SKILL_ROOT>/scripts/bootstrap.py install --feature web-animation --yes

1. 边界：绝不自动安装「剪映专业版」；系统级变更（FFmpeg、PATH、全局安装）必须先获得用户确认。

依赖声明见 @scripts/deps.manifest.json，检测器 @scripts/doctor.py，安装器 @scripts/bootstrap.py。

1. 目录与资源约定

官方独立 Skill 结构：SKILL.md + references/ + scripts/ + templates/。

• references/rules/ — 各功能的使用规则（按需读取，不要一次全读）。
• references/docs/ — Agent 工作手册、最小命令 SOP、自然语言用法指南。
• references/examples/ — 完整范例脚本。
• references/prompts/ — 提示词模板。
• references/pyjianying/ — 内嵌 pyJianYingDraft 库的说明与参考代码。
• references/data/ — 特效 / 转场 / 滤镜 / 音乐等检索库（CSV）。
• references/assets/ — 运行期素材（示例视频、标记图等）。注意：原根目录 data/、assets/ 已迁入 references/。
• scripts/ — 可执行脚本（含 vendor/pyJianYingDraft 内嵌库、recording/ 录屏器）。
• templates/ — 输出模板（故事板样例、业务脚本脚手架）。

2. 工作流（标准闭环）

1. 环境门禁（见 §0）。
2. 读规则：按任务读取对应 references/rules/*.md；通用编辑先读 @references/docs/agent-playbook.md 的 "Quick Edit Runtime Template" 与 "Acceptance Checklist"。
3. 写脚本到用户项目根目录（不要写进 Skill 目录），以 @templates/business-script-scaffold.py 为起点。
4. 执行并保存草稿，用 draft_inspector 复核结构。
5. 交付：告知草稿名与所在目录；需要导出时按 §4 处理（自动导出仅 Windows + 剪映 ≤5.9）。

3. 规则索引（References）

• @references/rules/setup.md — 所有脚本必需的初始化代码。
• @references/rules/core.md — 保存、导出、草稿管理。
• @references/rules/cli.md — CLI 契约与机器可读输出约定。
• @references/rules/media.md — 素材导入与 AI 视频分析优化（30m/360p）。
• @references/rules/text.md — 字幕、文本与花字。
• @references/rules/audio-voice.md — TTS 配音与 BGM 寻源。
• @references/rules/effects.md — 滤镜、特效、转场的检索与应用。
• @references/rules/keyframes.md — 进阶：关键帧动画。
• @references/rules/recording.md — 录屏与智能变焦。
• @references/rules/web-vfx.md — 网页动效转视频。
• @references/rules/generative.md — 生成式剪辑的思维链。

4. 常用工具与命令

• 素材检索：python <SKILL_ROOT>/scripts/asset_search.py "复古" -c filters（分类：filters / transitions / text_animations / video_scene_effects …，库在 references/data/）。
• 草稿检查：

  python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20
  python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "DraftName"
  python <SKILL_ROOT>/scripts/draft_inspector.py show --name "DraftName" --kind content --json

• 影视解说：python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"（故事板格式见 @templates/storyboard.example.json）。
• 录屏与智能变焦：

  python <SKILL_ROOT>/scripts/recording/recorder.py
  python <SKILL_ROOT>/scripts/web_recorder.py --url "http://localhost:3000" --duration 5
  python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Project" --video "v.mp4" --json "e.json"

• 自动导出（仅 Windows，剪映 ≤5.9）：python <SKILL_ROOT>/scripts/auto_exporter.py "DraftName" "out.mp4" --res 1080 --fps 60；macOS 请在剪映内手动导出。
• 模板克隆：python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "酒店模板" --name "客户A_副本"。
• 环境自检：python <SKILL_ROOT>/scripts/api_validator.py（检查 ffprobe 与草稿生成链路）。

5. 快速开始（Quick Start）

import os, sys
current_dir = os.path.dirname(os.path.abspath(__file__))
env_root = os.getenv("JY_SKILL_ROOT", "").strip()
skill_root = next((p for p in [
    env_root,
    os.path.join(current_dir, ".agents", "skills", "jianying-editor"),
    os.path.join(current_dir, ".trae", "skills", "jianying-editor"),
    os.path.join(current_dir, ".claude", "skills", "jianying-editor"),
    os.path.join(current_dir, "skills", "jianying-editor"),
    os.path.dirname(current_dir),
] if p and os.path.exists(os.path.join(p, "scripts", "jy_wrapper.py"))), None)
if not skill_root:
    raise ImportError("Could not find the jianying-editor skill root.")
sys.path.insert(0, os.path.join(skill_root, "scripts"))

from jy_wrapper import JyProject

project = JyProject("New AI Video", overwrite=True)          # overwrite=True 触发草稿自修复 (v5.9+)
project.add_narrated_subtitles(text="欢迎使用剪映自动化 Skill。", speaker="zh_female_xiaopengyou")
assets_dir = os.path.join(skill_root, "references", "assets")  # 素材已迁入 references/
project.add_media_safe(os.path.join(assets_dir, "video.mp4"), "0s")
project.add_text_simple("剪映自动化开启", start_time="1s", duration="3s", anim_in="复古打字机")
project.save()

6. 开发规范（CRITICAL）

1. 禁止在 Skill 目录内创建业务剪辑脚本：所有 .py 放到用户项目根目录，保持 Skill 可 git pull 升级。
2. 分辨率：初始化工程时按主素材比例设置，默认横屏 1920×1080。
3. 草稿修复：草稿损坏或版本冲突时，用 overwrite=True 重建（Auto-healing，适配 draft_info.json）。
4. 配乐选择：优先从 references/data/cloud_music_library.csv 按主题关键词检索并推荐，而非直接默认音乐。

7. 能力边界与降级

云端能力合规声明（重要）：本 Skill 源码不内置任何剪映/字节内部标识（device_id / iid / app_key / app_id）。云端能力（SAMI 配音、云端素材 API 解析）为显式启用制，凭据按以下顺序解析：环境变量 JY_DEVICE_ID、JY_IID、JY_SAMI_APP_KEY、JY_SAMI_APP_ID → 用户本机剪映安装数据。总开关 JY_CLOUD_ENABLED：auto（默认，能解析到凭据才启用）/ on / off（企业推荐，硬关闭全部云端调用）。凭据缺失时不报错，按上表降级。运行 scripts/doctor.py 可查看当前云端合规状态。

8. 许可与致谢

本技能包基于上游开源项目 jianying-editor-skill（MIT）封装，内嵌库 pyJianYingDraft（Apache-2.0，作者 GuanYixuan）。出处、作者与完整协议见 @references/ACKNOWLEDGEMENTS.md 与 @references/THIRD_PARTY_NOTICES.md，分发时请一并保留。