剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper)，提供开箱即用的 Python 接口，支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows，支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

JianYing Editor Skill Use this skill when the user wants to automate video editing, generate drafts, or manipulate media assets in JianYing Pro. Agent execution playbook: [docs/agent playbook.md](docs/agent playbook.md) Minimal command SOP: [docs/minimal command sop.md](docs/minimal command sop.md) Natural language usage guide: [usage.md](usage.md) Draft inspector 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 For generic editing requests, always follow the "Quick Edit Runtime Template" and "Acceptance Checklist" in that playbook. 🚨 重要开发原则 (CRITICAL DEVELOPER RULES) 1. 脚本位置：禁止在 Skill 内部目录创建剪辑脚本。所有的剪辑逻辑实现代码（ .py 脚本）必须存放在用户当前项目的根目录（或子目录，如 scripts/ ），以保持 Skill 库的纯净和可移植性。 2. 版本与架构：双平台适配：已全面支持 MacOS (路径探测/录屏) 与 Windows。 Auto healing ：支持 v5.9+ ( draft info.json )。若草稿损坏或版本冲突，使用 overwrite=True 初始化 JyProject 可触发自动修复。 3. 配乐选择：简单演示使用默认音乐。实际项目，应优先检索并推荐 data/cloud music library.csv 中的相关曲目，或根据视频主题（如“科技”、“温暖”）进行关键词过滤。询问用户：“我发现了几首符合主题的云端音乐，要不要试试？（如： Illuminate 科技感）”。规则指南 (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/cli.md](rules/cli.md) CLI contracts and machine readable output conventions. [rules/media.md](rules/media.md) Importing assets & AI Video Analysis Optimization (30m/360p) . [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 & BGM sourcing. 🎯 Agent Quick Routing 云端视频 + 云端音乐： rules/media.md + rules/audio voice.md examples/cloud video music tts demo.py 智能配音与字幕 (Script to Video)： rules/text.md + rules/audio voice.md 核心 API add narrated subtitles 旁白与字幕对齐： rules/text.md + rules/audio voice.md examples/cloud video music tts demo.py 录屏与智能变焦： rules/recording.md tools/recording/recorder.py 批量导出/无头导出： rules/core.md + rules/cli.md examples/robust auto export.py 影视解说生成： rules/generative.md scripts/movie commentary builder.py 📖 经典示例 (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. [examples/cloud video music tts demo.py](examples/cloud video music tts demo.py) Cloud video + cloud BGM + TTS/subtitle alignment. [examples/web to video intro demo.py](examples/web to video intro demo.py) Web to Video intro demo (HTML animation timeline clip). [examples/robust auto export.py](examples/robust auto export.py) Stable export workflow and failure handling. [examples/auto exposure align demo.py](examples/auto exposure align demo.py) CV assisted exposure alignment workflow. [examples/video transcribe and match.py](examples/video transcribe and match.py) Advanced : AI driven workflow (Transcribe Video Match B Roll via AI semantics Assemble Draft). 🧠 提示词与集成工具 (Prompts & Integrated Tools) Use these templates and scripts for complex tasks: Asset Search : Find filters, transitions, and animations by Chinese/English name: Movie Commentary Builder : Generate 60s commentary videos from a storyboard JSON: Sync Native Assets : Import your favorited/played BGM/Styles from JianYing App to the Skill: 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: Draft Inspector : Examine draft structure and metadata (v5.9+ support): Auto Exporter : Headless export of a draft to MP4/SRT: Note: MP4 auto export uses Windows UI Automation. On macOS, generate the draft and export it manually from JianYing. Template Clone & Replacer : 安全克隆模板并批量替换物料 (防止损坏原模板): API Validator : Run a quick diagnostic of your environment: 🚀 快速开始示例 🛠️ 初始化与项目规范 (Initialization & Project Rules) 在初始化 JyProject 时，请务必根据主视频素材的比例设置分辨率。默认值为横屏 (1920x1080) 。 🚨 脚本存放位置规范禁止在 Skill 安装目录下创建你的业务剪辑脚本。正确做法：将你的剪辑 Python 脚本放在项目的根目录。原因：Skill 目录应该只包含工具集源码，便于后续 git pull 升级。业务代码混入会导致版本管理混乱。

jianying-editor