jianying-editor

Category: Development & Coding | Uploader: luoluoluo22 | Downloads: 0 | Version: v1.0（Latest）

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper)。提供开箱即用的 Python 接口，支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。

Changelog: Source: GitHub https://github.com/luoluoluo22/jianying-editor-skill

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 1.9 KB
- 📄 pull_request_template.md 538 B
📁 assets/
- 📁 artistEffect/
  - 📁 7127669365423508767/
    
    📁 ac476c738e3109c848bfe76f9df8eced/
    
    📁 image/
    
    📄 1.png 23.3 KB
    
    📄 1.png.meta 262 B
    
    📁 material/
    
    📄 effect.material 440 B
    
    📄 shadow.material 493 B
    
    📁 rt/
    
    📄 outputTex.rt 417 B
    
    📁 texture/
    
    📄 lieheng.png 17.5 KB
    
    📄 lieheng.png.meta 262 B
    
    📁 xshader/
    
    📄 depth.frag 200 B
    
    📄 effect.frag 12.5 KB
    
    📄 effect.vert 956 B
    
    📄 effect.xshader 2.8 KB
    
    📄 shadow.xshader 2.8 KB
    
    📄 config.json 109 B
    
    📄 content.json 283 B
    
    📄 effect.prefab 3.4 KB
    
    📄 main.scene 4.3 KB
    
    📄 sticker.config 374 B
  - 📁 7187739440347958589/
    
    📁 266eb863a42498a72c5c67bb8845c24c/
    
    📁 image/
    
    📄 红碎屑.png 8.5 KB
    
    📄 红碎屑.png.meta 262 B
    
    📁 material/
    
    📄 effect.material 440 B
    
    📄 shadow.material 493 B
    
    📁 rt/
    
    📄 outputTex.rt 417 B
    
    📁 texture/
    
    📄 122.texture 318.1 KB
    
    📄 lieheng.png 17.5 KB
    
    📄 lieheng.png.meta 262 B
    
    📁 xshader/
    
    📄 depth.frag 200 B
    
    📄 effect.frag 13.0 KB
    
    📄 effect.vert 956 B
    
    📄 effect.xshader 2.8 KB
    
    📄 shadow.xshader 2.8 KB
    
    📄 config.json 109 B
    
    📄 content.json 304 B
    
    📄 effect.prefab 3.0 KB
    
    📄 main.scene 3.9 KB
    
    📄 sticker.config 374 B
  - 📁 7351316503771368713/
    
    📁 95cd57a11522b49969efe0210afb1044/
    
    📄 1709118789822.png 126.6 KB
    
    📄 config.json 143 B
    
    📄 cover_icon.png 11.8 KB
    
    📄 effectStyle.json 3.5 KB
- 📄 audio.mp3 127.8 KB
- 📄 click_marker.png 754 B
- 📄 cover.png 1.1 MB
- 📄 subtitle.srt 239 B
- 📄 video.mp4 2.9 MB
- 📄 使用思路.jpg 206.6 KB
- 📄 快速上手.png 68.5 KB
- 📄 片段特效_annotation.jpg 12.6 KB
📁 data/
- 📄 cloud_music_library.csv 255.6 KB
- 📄 cloud_sound_effects.csv 2.4 KB
- 📄 cloud_text_styles.csv 438 B
- 📄 cloud_video_assets.csv 86.8 KB
- 📄 filters.csv 32.2 KB
- 📄 jy_cached_audio.csv 263 B
- 📄 text_animations.csv 6.1 KB
- 📄 transitions.csv 18.6 KB
- 📄 tts_speakers.csv 7.7 KB
- 📄 video_intro_animations.csv 7.6 KB
- 📄 video_outro_animations.csv 6.1 KB
- 📄 video_scene_effects.csv 62.3 KB
📁 docs/
- 📁 images/
  - 📁 donate/
    
    📄 alipay.jpg 107.7 KB
    
    📄 wechat.png 135.1 KB
- 📄 agent-playbook.md 2.2 KB
- 📄 api.md 3.1 KB
- 📄 minimal-command-sop.md 1.7 KB
📁 examples/
- 📄 _bootstrap.py 1.9 KB
- 📄 all_elements_regen.py 2.4 KB
- 📄 auto_exposure_align_demo.py 1.5 KB
- 📄 cloud_video_music_tts_demo.py 2.0 KB
- 📄 compound_clip_demo.py 1.9 KB
- 📄 my_first_vlog.py 1.3 KB
- 📄 robust_auto_export.py 19.7 KB
- 📄 simple_clip_demo.py 1.3 KB
- 📄 video_transcribe_and_match.py 6.1 KB
- 📄 web_to_video_intro_demo.py 3.2 KB
📁 prompts/
- 📄 movie_commentary.md 1.2 KB
- 📄 readme_to_tutorial.md 3.0 KB
📁 references/
- 📄 AVAILABLE_ASSETS.md 70.2 KB
- 📄 draft_folder.py 176 B
- 📄 full_feature_showcase.py 7.9 KB
- 📄 jianying_controller.py 190 B
- 📄 README.md 29.6 KB
- 📄 script_file.py 174 B
- 📄 video_analysis_template.py 4.0 KB
📁 rules/
- 📄 audio-voice.md 1.9 KB
- 📄 cli.md 1.3 KB
- 📄 core.md 3.0 KB
- 📄 effects.md 2.0 KB
- 📄 generative.md 1.4 KB
- 📄 keyframes.md 2.2 KB
- 📄 media.md 3.1 KB
- 📄 recording.md 1.7 KB
- 📄 setup.md 1.7 KB
- 📄 text.md 3.7 KB
- 📄 web-vfx.md 2.4 KB
📁 scripts/
- 📁 core/
  - 📄 media_ops.py 8.8 KB
  - 📄 mocking_ops.py 4.7 KB
  - 📄 project_base.py 8.1 KB
  - 📄 text_ops.py 7.4 KB
  - 📄 vfx_ops.py 2.5 KB
- 📁 utils/
  - 📄 cli_protocol.py 427 B
  - 📄 config.py 551 B
  - 📄 constants.py 1.2 KB
  - 📄 env_setup.py 1.3 KB
  - 📄 errors.py 301 B
  - 📄 formatters.py 6.3 KB
  - 📄 logging_utils.py 731 B
  - 📄 media_normalizer.py 2.0 KB
  - 📄 skill_path.py 2.1 KB
- 📁 vendor/
  - 📁 pyJianYingDraft/
    
    📁 assets/
    
    📄 __init__.py 1.1 KB
    
    📄 draft_content_template.json 3.2 KB
    
    📄 draft_meta_info.json 1.3 KB
    
    📁 metadata/
    
    📄 __init__.py 1.3 KB
    
    📄 audio_scene_effect.py 24.3 KB
    
    📄 effect_meta.py 5.5 KB
    
    📄 filter_meta.py 212.8 KB
    
    📄 font_meta.py 109.3 KB
    
    📄 mask_meta.py 922 B
    
    📄 speech_to_song.py 960 B
    
    📄 text_intro.py 20.5 KB
    
    📄 text_loop.py 13.0 KB
    
    📄 text_outro.py 13.7 KB
    
    📄 tone_effect.py 9.0 KB
    
    📄 transition_meta.py 76.4 KB
    
    📄 video_character_effect.py 127.8 KB
    
    📄 video_group_animation.py 17.3 KB
    
    📄 video_intro.py 21.9 KB
    
    📄 video_outro.py 17.5 KB
    
    📄 video_scene_effect.py 583.9 KB
    
    📄 __init__.py 9.3 KB
    
    📄 animation.py 5.1 KB
    
    📄 audio_segment.py 8.5 KB
    
    📄 draft_folder.py 5.9 KB
    
    📄 effect_segment.py 1.2 KB
    
    📄 exceptions.py 679 B
    
    📄 jianying_controller.py 9.9 KB
    
    📄 keyframe.py 3.4 KB
    
    📄 local_materials.py 8.7 KB
    
    📄 script_file.py 37.4 KB
    
    📄 segment.py 10.8 KB
    
    📄 template_mode.py 8.2 KB
    
    📄 text_segment.py 17.9 KB
    
    📄 time_util.py 3.1 KB
    
    📄 track.py 4.4 KB
    
    📄 util.py 2.1 KB
    
    📄 video_segment.py 22.6 KB
  - 📄 README.md 373 B
- 📄 api_validator.py 4.5 KB
- 📄 asset_search.py 6.1 KB
- 📄 auto_exporter.py 3.3 KB
- 📄 build_cloud_music_library.py 6.8 KB
- 📄 build_cloud_text_styles_library.py 4.8 KB
- 📄 cloud_manager.py 10.4 KB
- 📄 draft_inspector.py 6.5 KB
- 📄 jy_wrapper.py 2.5 KB
- 📄 movie_commentary_builder.py 3.5 KB
- 📄 smart_rough_cut.py 5.7 KB
- 📄 smart_zoomer.py 9.2 KB
- 📄 sync_jy_assets.py 5.7 KB
- 📄 universal_tts.py 6.9 KB
- 📄 web_recorder.py 3.9 KB
📁 tests/
- 📄 test_wrapper.py 7.3 KB
📁 tools/
- 📁 recording/
  - 📄 recorder.py 15.2 KB
  - 📄 recorder_config.json 34 B
- 📄 check_repo_hygiene.py 944 B
- 📄 validate_data_schema.py 2.4 KB
📄 .editorconfig 230 B
📄 .gitignore 286 B
📄 .pre-commit-config.yaml 450 B
📄 CHANGELOG.md 743 B
📄 CONTRIBUTING.md 823 B
📄 index.html 30.2 KB
📄 LICENSE 1.0 KB
📄 pyproject.toml 262 B
📄 README.md 9.5 KB
📄 requirements.txt 191 B
📄 SECURITY.md 543 B
📄 SKILL.md 8.0 KB
📄 VERSION 6 B

SKILL.md

---
name: jianying-editor
description: 剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper)。提供开箱即用的 Python 接口，支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。
---

# 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)
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.  **配乐选择**：
    - **简单演示使用默认音乐**。实际项目，应优先检索并推荐 `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`
- 旁白与字幕对齐：`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:
  ```bash
  python <SKILL_ROOT>/scripts/asset_search.py "复古" -c filters
  ```
- **Movie Commentary Builder**: Generate 60s commentary videos from a storyboard JSON:
  ```bash
  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:
  ```bash
  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:
  ```bash
  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:
  ```bash
  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 Clone & Replacer**: 安全克隆模板并批量替换物料 (防止损坏原模板):
  ```bash
  # 克隆模板生成新项目
  python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "酒店模板" --name "客户A_副本"
  ```
- **API Validator**: Run a quick diagnostic of your environment:
  ```bash
  python <SKILL_ROOT>/scripts/api_validator.py
  ```

## 🚀 快速开始示例

```python
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()
```

## 🛠️ 初始化与项目规范 (Initialization & Project Rules)

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

### 🚨 脚本存放位置规范
**禁止在 Skill 安装目录下创建你的业务剪辑脚本**。
- **正确做法**：将你的剪辑 Python 脚本放在项目的根目录。
- **原因**：Skill 目录应该只包含工具集源码，便于后续 `git pull` 升级。业务代码混入会导致版本管理混乱。

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

jianying-editor

Directory Structure

SKILL.md

Report

Notice