jianying-editor

剪映编辑器技能

当用户想要自动化视频剪辑、生成草稿或在剪映专业版中处理媒体素材时，使用此技能。

Agent 执行指南：docs/agent-playbook.md 最简命令操作流程：docs/minimal-command-sop.md 草稿检查器 CLI： 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 对于通用剪辑请求，始终遵循该指南中的“快速剪辑运行时模板”和“验收清单”。

🚨 重要开发原则 (CRITICAL DEVELOPER RULES)

1. 脚本位置：禁止在 Skill 内部目录创建剪辑脚本。所有剪辑逻辑实现代码（.py 脚本）必须存放在用户当前项目的根目录（或子目录，如 scripts/），以保持 Skill 库的纯净和可移植性。
2. 配乐选择：
   • 简单演示使用默认音乐。实际项目应优先检索并推荐 data/cloud_music_library.csv 中的相关曲目，或根据视频主题（如“科技”“温暖”）进行关键词筛选。
   • 询问用户：“我发现了几首符合主题的云端音乐，要不要试试？（如：Illuminate - 科技感）”。

规则指南 (Rules)

针对具体任务和约束，请阅读相应的规则文件：

• rules/setup.md - 所有脚本必须使用的初始化代码。
• rules/core.md - 核心操作：保存、导出和草稿管理。
• rules/cli.md - CLI 规范和机器可读输出约定。
• rules/media.md - 导入素材和 AI 视频分析优化（30m/360p）。
• rules/text.md - 添加字幕、文字和说明文字。
• rules/keyframes.md - 进阶：添加关键帧动画。
• rules/effects.md - 搜索并应用滤镜、特效和转场。
• rules/recording.md - 新增：屏幕录制与智能缩放自动化。
• rules/web-vfx.md - 进阶：网页转视频生成。
• rules/generative.md - 生成式剪辑的思维链。
• rules/audio-voice.md - 新增：TTS 旁白与背景音乐来源。

🎯 Agent 快速路由

• 云端视频 + 云端音乐：rules/media.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
• 旁白与字幕对齐：rules/text.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
• 录屏与智能变焦：rules/recording.md -> tools/recording/recorder.py (Windows) / tools/recording/macos_recorder.py (macOS)
• 批量导出/无头导出：rules/core.md + rules/cli.md -> examples/robust_auto_export.py
• 影视解说生成：rules/generative.md -> scripts/movie_commentary_builder.py

📖 经典示例 (Examples)

完整工作流请参考以下示例：

• examples/my_first_vlog.py - 完整的 Vlog 制作演示，包含背景音乐和动态文字。
• examples/simple_clip_demo.py - 基础剪辑和轨道管理快速入门教程。
• examples/compound_clip_demo.py - 新增：专业嵌套项目（复合片段）自动化。
• examples/cloud_video_music_tts_demo.py - 云端视频 + 云端背景音乐 + TTS/字幕对齐。
• examples/web_to_video_intro_demo.py - 网页转视频片头演示（HTML 动画 -> 时间线片段）。
• examples/robust_auto_export.py - 稳定的导出工作流与故障处理。
• examples/auto_exposure_align_demo.py - CV 辅助曝光对齐工作流。
• examples/video_transcribe_and_match.py - 进阶：AI 驱动的工作流（转录视频 -> 通过 AI 语义匹配 B-Roll -> 组装草稿）。

🧠 提示词与集成工具

使用以下模板和脚本处理复杂任务：

• 素材搜索：按中文或英文名称查找滤镜、转场和动画：

  python <SKILL_ROOT>/scripts/asset_search.py "复古" -c filters
  

• 视频解说生成器：根据分镜 JSON 生成 60 秒解说视频：

  python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"
  

• 同步原生素材：将你在剪映 App 中收藏或播放过的 BGM 导入 Skill：

  python <SKILL_ROOT>/scripts/sync_jy_assets.py
  

• README 转教程：将项目的 README.md 转换为完整的安装教程视频脚本：
  • 读取提示词：prompts/readme_to_tutorial.md
  • 将内容注入 {{README_CONTENT}} 变量
• 屏幕录制与智能缩放：录制屏幕并自动应用缩放关键帧：

  python <SKILL_ROOT>/tools/recording/recorder.py
  # Or apply zoom to existing video:
  python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Project" --video "v.mp4" --json "e.json"
  

• 自动导出器：无头导出草稿为 MP4/SRT：

  python <SKILL_ROOT>/scripts/auto_exporter.py "DraftName" "output.mp4" --res 1080 --fps 60
  # For SRT only:
  python <SKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "DraftName"
  

• 模板克隆与替换：安全克隆模板并批量替换素材（防止损坏原模板）：

  # 克隆模板生成新项目
  python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "酒店模板" --name "客户A_副本"
  

• API 验证器：快速诊断你的环境：

  python <SKILL_ROOT>/scripts/api_validator.py
  

🚀 快速开始示例

import os
import sys

# 1. 环境初始化 (必须同步到脚本开头)
current_dir = os.path.dirname(os.path.abspath(__file__))
env_root = os.getenv("JY_SKILL_ROOT", "").strip()
# 探测 Skill 路径 (支持 Antigravity, Trae, Claude 等)
skill_root = next((p for p in [
    env_root,
    os.path.join(current_dir, ".agent", "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.abspath(".agent/skills/jianying-editor"),
    os.path.abspath(".trae/skills/jianying-editor"),
    os.path.abspath(".claude/skills/jianying-editor"),
    os.path.dirname(current_dir) # 如果在 examples/ 目录下
] if p and os.path.exists(os.path.join(p, "scripts", "jy_wrapper.py"))), None)

if not skill_root: raise ImportError("Could not find jianying-editor skill root.")
sys.path.insert(0, os.path.join(skill_root, "scripts"))
from jy_wrapper import JyProject

if __name__ == "__main__":
    project = JyProject("My Video Project")
    assets_dir = os.path.join(skill_root, "assets")

    # 2. 导入视频与配乐
    project.add_media_safe(os.path.join(assets_dir, "video.mp4"), "0s")
    project.add_media_safe(os.path.join(assets_dir, "audio.mp3"), "0s", track_name="Audio")

    # 3. 添加带动画的标题
    project.add_text_simple("剪映自动化开启", start_time="1s", duration="3s", anim_in="复古打字机")

    project.save()

🛠️ 初始化与项目规范

在初始化 JyProject 时，请务必根据主视频素材的比例设置分辨率。默认值为横屏（1920x1080）。

🚨 脚本存放位置规范

禁止在 Skill 安装目录下创建你的业务剪辑脚本。

• 正确做法：将你的剪辑 Python 脚本放在项目的根目录。
• 原因：Skill 目录应该只包含工具集源码，便于后续使用 git pull 升级。混入业务代码会导致版本管理混乱。