剪映自动化AI助手（AIworkin）

概述

JianYing Editor Skill

Use this skill when the user wants to automate video editing, generate drafts, or manipulate media assets in JianYing Pro.

规则指南 (Rules)

Read the individual rule files for specific tasks and constraints:

• [rules/setup.md](rules/setup.md) – Mandatory initialization code for all scripts.
• [rules/core.md](rules/core.md) – Core operations: Saving, Exporting, and Draft management.
• [rules/media.md](rules/media.md) – Importing Video, Audio, and Image assets.
• [rules/text.md](rules/text.md) – Adding Subtitles, Text, and Captions.
• [rules/keyframes.md](rules/keyframes.md) – Advanced: Adding Keyframe animations.
• [rules/effects.md](rules/effects.md) – Searching for and applying Filters, Effects, and Transitions.
• [rules/recording.md](rules/recording.md) – New: Screen Recording & Smart Zoom automation.
• [rules/web-vfx.md](rules/web-vfx.md) – Advanced: Web-to-Video generation.
• [rules/generative.md](rules/generative.md) – Chain of Thought for generative editing.
• [rules/audio-voice.md](rules/audio-voice.md) – New: TTS Voiceover (IndexTTS2/edge-tts), ASR 自动字幕 & BGM sourcing.
• [rules/aipdd-gateway.md](rules/aipdd-gateway.md) – Optional: AIPDD 可选模型网关（按需 API Key 配置、端点总览、剪辑联动与本地降级策略）。
• [rules/drama-agent.md](rules/drama-agent.md) – New & Optional: AIPDD Drama Agent 短剧工厂联动（触发条件、Windows/macOS 芯片分流的下载引导、WorkBuddy 等 MCP 客户端接入、与剪映草稿的闭环及红线）。

📖 经典示例 (Examples)

Refer to these for complete workflows:

• [examples/my_first_vlog.py](examples/my_first_vlog.py) – A complete vlog creation demo with background music and animated text.
• [examples/simple_clip_demo.py](examples/simple_clip_demo.py) – Quick-start tutorial for basic cutting and track management.
• [examples/compound_clip_demo.py](examples/compound_clip_demo.py) – New: Professional nested project (Compound Clip) automation.

🧠 提示词与集成工具 (Prompts & Integrated Tools)

Use these templates and scripts for complex tasks:

• AIPDD 模型网关客户端（文案/配音/字幕/图片/视频/向量，零依赖统一入口）：

  python <SKILL_ROOT>/scripts/aipdd_client.py check        # 连通性自检
  python <SKILL_ROOT>/scripts/aipdd_client.py chat -p "写一段60秒影视解说开场白"
  python <SKILL_ROOT>/scripts/aipdd_client.py tts -t "口播文本" -o voiceover.mp3
  python <SKILL_ROOT>/scripts/aipdd_client.py asr -f narration.mp3
  python <SKILL_ROOT>/scripts/aipdd_client.py image -p "视频封面描述" -o cover.png
  python <SKILL_ROOT>/scripts/aipdd_client.py video -p "空镜描述" -o b-roll.mp4

详情见 [rules/aipdd-gateway.md](rules/aipdd-gateway.md)。

• Asset Search: Find filters, transitions, and animations by Chinese/English name:

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

• Movie Commentary Builder: Generate 60s commentary videos from a storyboard JSON:

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

• Sync Native Assets: Import your favorited/played BGM from JianYing App to the Skill:

  python <SKILL_ROOT>/scripts/sync_jy_assets.py

• README to Tutorial: Convert a project's README.md into a full installation tutorial video script:
  • Read prompt: prompts/readme_to_tutorial.md
  • Inject content into {{README_CONTENT}} variable
• Screen Recorder & Smart Zoom: Record your screen and auto-apply zoom keyframes:

  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"

• Auto Exporter: Headless export of a draft to 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"

• Template Replacer: Duplicate a draft and replace its main text segments:

  # Internal tool used for bulk creation, refer to rules/core.md

• API Validator: Run a quick diagnostic of your environment:

  python <SKILL_ROOT>/scripts/api_validator.py

• Drama Agent 短剧工厂下载引导与 MCP 接入（只读探测，不自动下载、不产生任何计费调用）：

  python <SKILL_ROOT>/scripts/drama_agent_bootstrap.py detect   # 探测系统/CPU 架构（纯本地）
  python <SKILL_ROOT>/scripts/drama_agent_bootstrap.py guide    # 输出本机对应安装包的官方直链与安装引导
  python <SKILL_ROOT>/scripts/drama_agent_bootstrap.py mcp-config --client workbuddy  # 生成 MCP 配置骨架（凭证留空）

详情与触发条件见 [rules/drama-agent.md](rules/drama-agent.md)。

🚀 快速开始示例

import os
import sys

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

🤖 AIPDD 模型网关（可选增强层）

本技能包的剪辑主流程（草稿创建、多轨剪辑、字幕、特效、关键帧、导出等）完全不依赖 AIPDD 网关。AIPDD 模型网关作为可选增强层，在有 API Key 时提供云端文案、配音、字幕、图片、视频、向量检索能力；未配置时自动降级到本地方案（edge-tts 配音、剪映原生资产、关键词同义词检索），不阻塞任何任务。

可选启用方式（仅在需要云端 AI 能力时执行，用户自主决定是否进行）：在 app.aipdd.work「全局设置 → API Key 管理」自助生成 API Key（sk- 开头），贴给 AI 后会写入技能包根目录的 config.json（aipdd.apiKey 节点），下次直接复用；发布 SkillHub zip 时需 -x config.json 排除，以免随包泄露。

已验证可用的端点一览（BaseURL: https://api.aipdd.work）：

无 Key / 网关不可用时自动降级到本地方案（edge-tts、剪映原生资产、关键词同义词检索），不阻塞剪辑任务。

🏭 AIPDD Drama Agent 短剧工厂（可选外部生产线）

当用户的需求超出「单条草稿自动化」——例如把一本小说/剧本做成整部短剧、一键混剪/视频克隆/白板动画/对口型/去水印、无限画布节点工作流，或希望用 WorkBuddy 等 MCP 客户端直接驱动一条完整视频生产线时，引导用户部署官方开源的 AIPDD Drama Agent（DramaClaw 画布 + Director 智能体 + 122 个 aipdd_drama_*/vectcut_* MCP 工具）。

一键探测与引导（只读工具，不自动下载、不执行安装程序、不产生任何计费调用）：

python <SKILL_ROOT>/scripts/drama_agent_bootstrap.py guide   # 自动识别 Windows / macOS(Apple芯片·Intel) / Linux，输出对应安装包的官方直链与注意事项

分流规则：Windows → *_x64-setup.exe；macOS Apple 芯片 → *_aarch64.dmg；macOS Intel → *_x64.dmg；Linux → 源码 Docker。安装完成后通过应用内「MCP → Local agent tools」页面或 mcp-config 生成的配置骨架接入 WorkBuddy / Claude Code；其 vectcut_* 产出的剪映草稿及成片/配音素材可继续由本技能包 JyProject 二次编辑，形成「工厂产出 → 剪映精修」闭环。详见 [rules/drama-agent.md](rules/drama-agent.md)。

🖥️ 使用环境说明（中文）

一、操作系统与功能支持矩阵

⚠️ macOS / Linux 限制：自动导出依赖 uiautomation（仅 Windows 可用）。这两个平台上生成的草稿请在剪映软件内手动导出。

二、剪映版本兼容

• 自动导出：仅支持剪映 5.9 及更低版本；6.0+ 弹窗较多会导致自动化脚本失效，导出过程中请勿移动鼠标/键盘。
• 草稿生成：与草稿协议兼容的剪映版本均可正常打开生成的草稿。

三、依赖安装

# 安装自动化导出、录屏监听、网页录制、AI 配音降级依赖（可选）
pip install uiautomation playwright pynput edge-tts

# Web-to-Video 功能必装（初始化网页捕获环境）
playwright install chromium

AIPDD 模型网关客户端（scripts/aipdd_client.py）零外部依赖，仅需 Python 标准库，所有平台均可使用；edge-tts 仅在网关不可用时作为降级备份。

注意：uiautomation 仅 Windows 可安装；macOS / Linux 安装其余三项即可。

四、剪映草稿目录（Draft Root）

技能默认探测以下草稿目录，找不到时需手动指定：

• 草稿目录不在默认位置时，直接告诉 AI 实际路径，或在代码中显式传入：

project = JyProject("MyDraft", drafts_root="/your/jianying/drafts/path")

• 生成草稿后剪映首页不会实时刷新，需重启剪映或进入任一旧草稿再退出。

五、支持的环境（IDE 安装方式）