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)
- 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 wiescripts/) des aktuellen Benutzerprojekts gespeichert werden, um die Reinheit und Portabilität der Skill-Bibliothek zu gewährleisten. - 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 vonJyProjectmitoverwrite=Trueeine automatische Reparatur auslösen.
- Musikauswahl:
- Für einfache Demos die Standardmusik verwenden. Bei echten Projekten bevorzugt in der
data/cloud_music_library.csvnach 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)".
- Für einfache Demos die Standardmusik verwenden. Bei echten Projekten bevorzugt in der
📋 Regelwerk (Rules)
Lesen Sie die einzelnen Regeldateien für spezifische Aufgaben und Einschränkungen:
- rules/setup.md - Verpflichtender Initialisierungscode für alle Skripte.
- rules/core.md - Kernoperationen: Speichern, Exportieren und Projektverwaltung.
- rules/cli.md - CLI-Spezifikationen und Konventionen für maschinenlesbare Ausgaben.
- rules/media.md - Import von Assets & KI-Videoanalyse-Optimierung (30m/360p).
- rules/text.md - Hinzufügen von Untertiteln, Text und Bildunterschriften.
- rules/keyframes.md - Fortgeschritten: Hinzufügen von Keyframe-Animationen.
- rules/effects.md - Suchen und Anwenden von Filtern, Effekten und Übergängen.
- rules/recording.md - Neu: Bildschirmaufnahme & automatischer intelligenter Zoom.
- rules/web-vfx.md - Fortgeschritten: Web-zu-Video-Generierung.
- rules/generative.md - Gedankengang für generative Bearbeitung.
- rules/audio-voice.md - Neu: TTS-Sprachausgabe & BGM-Bereitstellung.
🎯 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-APIadd_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:
- examples/my_first_vlog.py - Eine komplette Vlog-Erstellungsdemo mit Hintergrundmusik und animiertem Text.
- examples/simple_clip_demo.py - Schnellstart-Tutorial für grundlegende Schnitte und Spurverwaltung.
- examples/compound_clip_demo.py - Neu: Professionelle Automatisierung verschachtelter Projekte (Compound Clip).
- examples/cloud_video_music_tts_demo.py - Cloud-Video + Cloud-BGM + TTS/Untertitel-Ausrichtung.
- examples/web_to_video_intro_demo.py - Web-zu-Video-Intro-Demo (HTML-Animation -> Zeitleisten-Clip).
- examples/robust_auto_export.py - Stabiler Export-Workflow und Fehlerbehandlung.
- examples/auto_exposure_align_demo.py - CV-gestützter Belichtungsabgleich-Workflow.
- examples/video_transcribe_and_match.py - Fortgeschritten: KI-gesteuerter Workflow (Video transkribieren -> B-Roll per KI-Semantik zuordnen -> Projekt zusammenstellen).
🧠 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
- Prompt lesen:
- 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:
Hinweis: Der MP4-Autoexport verwendet die Windows-UI-Automation. Unter macOS erstellen Sie das Projekt und exportieren es manuell aus JianYing.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" - 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.