Communitygithub.com

剪映 (JianYing) KI-Automatisierungsskill

Eine erweiterte API (JyWrapper) für die KI-gestützte Automatisierung von JianYing (剪映). Bietet sofort einsatzbereite Python-Schnittstellen für Bildschirmaufnahmen, Materialimport, Untertitelgenerierung, Web-Animation-Synthese und Projektexport. Vollständig angepasst für macOS (Apple Silicon/Intel) und Windows, unterstützt v5.9+ (draft_info.json)-Architektur, automatische Projektwiederherstellung, intelligente Sprachausgabe mit Untertiteln und Bildschirmaufnahme-Zoom.

Was ist 剪映 (JianYing) KI-Automatisierungsskill?

Dieser Skill ermöglicht Entwicklern und KI-Agenten, den professionellen Videobearbeitungsprozess in JianYing Pro (剪映专业版) vollständig zu automatisieren. Er kapselt die komplexe native API in eine benutzerfreundliche Python-Bibliothek namens JyWrapper, die eine Vielzahl von Funktionen bietet: Bildschirmaufnahme mit intelligentem Zoom, Import von Cloud-Medien und lokalen Assets, automatische Generierung von KI-gestützten Untertiteln und Sprachausgabe (TTS), Web-zu-Video-Animation, sowie robusten Projektexport. Der Skill ist vollständig plattformübergreifend für macOS und Windows optimiert und unterstützt selbstheilende Mechanismen für beschädigte Projektdateien (v5.9+ draft_info.json). Entwickler können entweder vorgefertigte Beispiele und CLI-Werkzeuge nutzen oder mit der Python-API eigene, maßgeschneiderte Videobearbeitungs-Workflows erstellen. Der Skill beinhaltet klare Regeln für die Skriptplatzierung (außerhalb des Skill-Verzeichnisses) und folgt einer strengen Architektur, um die Wartbarkeit und Portabilität zu gewährleisten. Durch die Integration von Cloud-Musikbibliotheken und die Fähigkeit, Videoinhalte durch KI zu analysieren (z. B. für B-Roll-Auswahl), hebt er die Videoproduktion auf ein neues, automatisiertes Niveau.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/jianying-editor-skill

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

JianYing Editor Skill

Verwenden Sie diesen Skill, wenn der Benutzer die Videobearbeitung automatisieren, Projekte erstellen oder Medieninhalte in JianYing Pro bearbeiten möchte.

Agenten-Ausführungsplaybook: docs/agent-playbook.md Minimales Befehl-SOP: docs/minimal-command-sop.md Anleitung zur Verwendung in natürlicher Sprache: usage.md Projektinspektor-CLI: python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20 python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "Projektname" python <SKILL_ROOT>/scripts/draft_inspector.py show --name "Projektname" --kind content --json Befolgen Sie für allgemeine Bearbeitungsanfragen stets die "Schnellbearbeitungs-Laufzeitvorlage" und die "Akzeptanzcheckliste" aus diesem Playbook.

🚨 Wichtige Entwicklungsprinzipien (CRITICAL DEVELOPER RULES)

  1. Skriptspeicherort: Es ist verboten, Bearbeitungsskripte innerhalb des Skill-Verzeichnisses zu erstellen. Der gesamte Logikcode für die Bearbeitung (.py-Skripte) muss im Stammverzeichnis (oder Unterverzeichnis wie scripts/) des aktuellen Benutzerprojekts gespeichert werden, um die Reinheit und Portabilität der Skill-Bibliothek zu gewährleisten.
  2. Version & Architektur:
    • Zwei-Plattform-Anpassung: Vollständige Unterstützung für macOS (Pfadfindung/-erkennung) und Windows.
    • Auto-healing: Unterstützt v5.9+ (draft_info.json). Wenn ein Projekt beschädigt ist oder ein Versionskonflikt vorliegt, kann die Initialisierung von JyProject mit overwrite=True eine automatische Reparatur auslösen.
  3. Musikauswahl:
    • Für einfache Demos die Standardmusik verwenden. Bei echten Projekten bevorzugt in der data/cloud_music_library.csv nach relevanten Titeln suchen und diese empfehlen oder eine Schlüsselwortfilterung basierend auf dem Videothema (z. B. "Technologie", "Herzlich") durchführen.
    • Fragen Sie den Benutzer: "Ich habe einige passende Cloud-Musiktitel gefunden. Möchten Sie sie ausprobieren? (z.B.: Illuminate - Technologie-Feeling)".

📋 Regelwerk (Rules)

Lesen Sie die einzelnen Regeldateien für spezifische Aufgaben und Einschränkungen:

🎯 Agenten-Schnellnavigation

  • Cloud-Video + Cloud-Musik: rules/media.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
  • Intelligente Sprachausgabe & Untertitel (Script-to-Video): rules/text.md + rules/audio-voice.md -> Kern-API add_narrated_subtitles
  • Voiceover & Untertitelausrichtung: rules/text.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
  • Bildschirmaufnahme & intelligenter Zoom: rules/recording.md -> tools/recording/recorder.py
  • Stapel-/Headless-Export: rules/core.md + rules/cli.md -> examples/robust_auto_export.py
  • Filmerklärungsgenerierung: rules/generative.md -> scripts/movie_commentary_builder.py

📖 Klassische Beispiele (Examples)

Für vollständige Arbeitsabläufe siehe:

🧠 Prompts & integrierte Tools (Prompts & Integrated Tools)

Verwenden Sie diese Vorlagen und Skripte für komplexe Aufgaben:

  • Asset-Suche: Filtern, Übergänge und Animationen nach chinesischem/englischem Namen finden:
    python <SKILL_ROOT>/scripts/asset_search.py "Vintage" -c filters
    
  • Filmerklärungs-Generator: 60-Sekunden-Erklärungsvideos aus einem Storyboard-JSON erstellen:
    python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"
    
  • Native Assets synchronisieren: Ihre favorisierten/abgespielten BGMs/Styles aus der JianYing-App in den Skill importieren:
    python <SKILL_ROOT>/scripts/sync_jy_assets.py
    # Cloud-Materialien aus Ihren vorhandenen Projekten indizieren
    python <SKILL_ROOT>/scripts/build_cloud_music_library.py
    python <SKILL_ROOT>/scripts/build_cloud_text_styles_library.py
    
  • README in Tutorial: Eine README.md eines Projekts in ein vollständiges Installations-Tutorial-Video-Skript konvertieren:
    • Prompt lesen: prompts/readme_to_tutorial.md
    • Inhalt in die Variable {{README_CONTENT}} einfügen
  • Bildschirmrekorder & intelligenter Zoom: Bildschirm aufnehmen und automatisch Zoom-Keyframes anwenden:
    python <SKILL_ROOT>/tools/recording/recorder.py
    # Web-Vorschau-Aufnahme (hohe Leistung)
    python <SKILL_ROOT>/scripts/web_recorder.py --url "http://localhost:3000" --duration 5
    # Oder Zoom auf vorhandenes Video anwenden:
    python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Projekt" --video "v.mp4" --json "e.json"
    
  • Projektinspektor: Projektstruktur und Metadaten untersuchen (v5.9+ Unterstützung):
    python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20
    python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "Projektname"
    
  • Auto-Exporter: Headless-Export eines Projekts in MP4/SRT:
    python <SKILL_ROOT>/scripts/auto_exporter.py "Projektname" "output.mp4" --res 1080 --fps 60
    # Nur für SRT:
    python <SKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "Projektname"
    
    Hinweis: Der MP4-Autoexport verwendet die Windows-UI-Automation. Unter macOS erstellen Sie das Projekt und exportieren es manuell aus JianYing.
  • Vorlagenklon & -ersetzung: Vorlage sicher klonen und Materialien stapelweise ersetzen (um Beschädigung der Originalvorlage zu verhindern):
    # Vorlage klonen und neues Projekt erstellen
    python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "Hotelvorlage" --name "KundeA_Kopie"
    
  • API-Validator: Führen Sie eine schnelle Diagnose Ihrer Umgebung durch:
    python <SKILL_ROOT>/scripts/api_validator.py
    

🚀 Schnellstartbeispiel

import os
import sys

# 1. Umgebungsinitialisierung (muss am Skriptanfang synchronisiert werden, unterstützt Win/Mac)
current_dir = os.path.dirname(os.path.abspath(__file__))
env_root = os.getenv("JY_SKILL_ROOT", "").strip()
# Skill-Pfad erkennen (unterstützt Antigravity, Trae, Claude usw.)
skill_root = next((p for p in [
    env_root,
    os.path.join(current_dir, ".agents", "skills", "jianying-editor"),
    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(".agents/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.abspath("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 jianying-editor skill root.")
sys.path.insert(0, os.path.join(skill_root, "scripts"))
from jy_wrapper import JyProject

if __name__ == "__main__":
    # 2. Projekt initialisieren (unterstützt v5.9+ und Selbstreparatur)
    project = JyProject("Neues KI-Video", overwrite=True)
    assets_dir = os.path.join(skill_root, "assets")

    # 3. Intelligente Sprachausgabe & Untertitel (One-click Script-to-Video)
    project.add_narrated_subtitles(
        text="Willkommen beim JianYing Automatisierungs-Skill. Dies ist eine erweiterte Version, die vollständig an macOS angepasst ist.",
        speaker="zh_female_xiaopengyou"
    )

    # 4. Zusätzliches Material importieren
    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")

    # 5. Animierten Titel hinzufügen
    project.add_text_simple("JianYing Automatisierung starten", start_time="1s", duration="3s", anim_in="Vintage-Schreibmaschine")

    project.save()

🛠️ Initialisierung & Projektregeln (Initialization & Project Rules)

Stellen Sie bei der Initialisierung von JyProject die Auflösung basierend auf dem Seitenverhältnis des Hauptvideomaterials ein. Der Standardwert ist Querformat (1920x1080).

🚨 Speicherort für Skripte

Es ist verboten, Ihre Geschäfts-Bearbeitungsskripte im Skill-Installationsverzeichnis zu erstellen.

  • Richtiges Vorgehen: Legen Sie Ihre Python-Bearbeitungsskripte im Stammverzeichnis Ihres Projekts ab.
  • Grund: Das Skill-Verzeichnis sollte nur den Quellcode des Werkzeugsatzes enthalten, um spätere git pull-Updates zu erleichtern. Das Vermischen von Geschäftslogik führt zu Versionsverwaltungschaos.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

2789927464king-jpg/video-skill-ku

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

给剪好的口播配画面:在录屏上盖 HTML 层(圈重点标注 / 小黑整屏动画 / 推近),层绑字幕屏、由播放器逐帧驱动、直接在预览里看。用户说做分镜、配画面、加动画、圈重点、B-roll、做 storyboard 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

Verwandte Skills