JianYing Editor Skill
Use este skill quando o usuário quiser automatizar a edição de vídeo, gerar rascunhos ou manipular recursos de mídia no JianYing Pro.
Playbook de execução do agente: docs/agent-playbook.md
SOP de comandos mínimos: docs/minimal-command-sop.md
Guia de uso em linguagem natural: usage.md
CLI do inspetor de rascunhos:
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
Para solicitações genéricas de edição, siga sempre o "Quick Edit Runtime Template" e a "Acceptance Checklist" desse playbook.
🚨 Princípios de Desenvolvimento Importantes (REGRAS CRÍTICAS PARA DESENVOLVEDORES)
- Localização dos Scripts: É proibido criar scripts de edição dentro do diretório do Skill. Todo código de lógica de edição (scripts
.py) deve ser armazenado no diretório raiz do projeto do usuário (ou subdiretórios comoscripts/), para manter a biblioteca do Skill limpa e portátil. - Versão e Arquitetura:
- Adaptação para ambas plataformas: Suporte completo a MacOS (detecção de caminho/gravação de tela) e Windows.
- Auto-reparo: Suporta v5.9+ (
draft_info.json). Se o rascunho estiver corrompido ou houver conflito de versão, inicializeJyProjectcomoverwrite=Truepara acionar o reparo automático.
- Seleção de Música de Fundo:
- Demonstrações simples usam a música padrão. Em projetos reais, priorize a busca e recomendação de faixas relevantes em
data/cloud_music_library.csv, ou filtre por palavras-chave baseadas no tema do vídeo (ex.: "tecnologia", "aconchegante"). - Pergunte ao usuário: "Encontrei algumas músicas da nuvem que combinam com o tema. Quer testar alguma? (Ex.:
Illuminate- estilo tecnológico)".
- Demonstrações simples usam a música padrão. Em projetos reais, priorize a busca e recomendação de faixas relevantes em
📜 Guia de Regras (Rules)
Leia os arquivos de regras individuais para tarefas e restrições específicas:
- rules/setup.md - Código de inicialização obrigatório para todos os scripts.
- rules/core.md - Operações principais: Salvar, Exportar e gerenciamento de rascunhos.
- rules/cli.md - Contratos de CLI e convenções de saída legível por máquina.
- rules/media.md - Importação de ativos e Otimização de Análise de Vídeo com IA (30m/360p).
- rules/text.md - Adicionar Legendas, Texto e Legendas.
- rules/keyframes.md - Avançado: Adicionar animações com Keyframes.
- rules/effects.md - Pesquisar e aplicar Filtros, Efeitos e Transições.
- rules/recording.md - Novo: Automação de Gravação de Tela e Zoom Inteligente.
- rules/web-vfx.md - Avançado: Geração de vídeo a partir da Web.
- rules/generative.md - Cadeia de pensamento para edição generativa.
- rules/audio-voice.md - Novo: Narração TTS e busca de BGM.
🎯 Roteamento Rápido do Agente
- Vídeo na nuvem + música na nuvem:
rules/media.md+rules/audio-voice.md->examples/cloud_video_music_tts_demo.py - Dublagem Inteligente e Legendas (Script-to-Video):
rules/text.md+rules/audio-voice.md-> API principaladd_narrated_subtitles - Narração e alinhamento de legendas:
rules/text.md+rules/audio-voice.md->examples/cloud_video_music_tts_demo.py - Gravação de tela e zoom inteligente:
rules/recording.md->tools/recording/recorder.py - Exportação em lote/sem interface:
rules/core.md+rules/cli.md->examples/robust_auto_export.py - Geração de comentários de filme:
rules/generative.md->scripts/movie_commentary_builder.py
📖 Exemplos Clássicos (Examples)
Consulte estes para workflows completos:
- examples/my_first_vlog.py - Demonstração completa de criação de vlog com música de fundo e texto animado.
- examples/simple_clip_demo.py - Tutorial rápido para corte básico e gerenciamento de faixas.
- examples/compound_clip_demo.py - Novo: Automação profissional de projetos aninhados (Clip Composto).
- examples/cloud_video_music_tts_demo.py - Vídeo na nuvem + BGM na nuvem + alinhamento TTS/legendas.
- examples/web_to_video_intro_demo.py - Demonstração de introdução Web-to-Video (animação HTML -> clipe na linha do tempo).
- examples/robust_auto_export.py - Workflow de exportação estável e tratamento de falhas.
- examples/auto_exposure_align_demo.py - Workflow de alinhamento de exposição assistido por visão computacional.
- examples/video_transcribe_and_match.py - Avançado: Workflow orientado por IA (Transcrever Vídeo -> Combinar B-Roll via semântica de IA -> Montar Rascunho).
🧠 Prompts e Ferramentas Integradas (Prompts & Integrated Tools)
Use estes modelos e scripts para tarefas complexas:
- Busca de Ativos: Encontre filtros, transições e animações pelo nome em chinês/inglês:
python <SKILL_ROOT>/scripts/asset_search.py "retrô" -c filters - Construtor de Comentários de Filme: Gere vídeos de comentários de 60s a partir de um JSON de storyboard:
python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json" - Sincronizar Ativos Nativos: Importe BGM/Estilos favoritos/executados do aplicativo JianYing para o Skill:
python <SKILL_ROOT>/scripts/sync_jy_assets.py # Indexar materiais da nuvem a partir de seus rascunhos existentes python <SKILL_ROOT>/scripts/build_cloud_music_library.py python <SKILL_ROOT>/scripts/build_cloud_text_styles_library.py - README para Tutorial: Converta o README.md de um projeto em um script de vídeo tutorial completo de instalação:
- Leia o prompt:
prompts/readme_to_tutorial.md - Injete o conteúdo na variável
{{README_CONTENT}}
- Leia o prompt:
- Gravador de Tela e Zoom Inteligente: Grave sua tela e aplique automaticamente keyframes de zoom:
python <SKILL_ROOT>/tools/recording/recorder.py # Captura de pré-visualização Web (alto desempenho) python <SKILL_ROOT>/scripts/web_recorder.py --url "http://localhost:3000" --duration 5 # Ou aplique zoom a um vídeo existente: python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Projeto" --video "v.mp4" --json "e.json" - Inspetor de Rascunhos: Examine a estrutura e metadados do rascunho (suporte v5.9+):
python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20 python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "DraftName" - Exportador Automático: Exportação sem interface de um rascunho para MP4/SRT:
Nota: A exportação automática para MP4 usa Automação de Interface do Windows. No macOS, gere o rascunho e exporte manualmente pelo JianYing.python <SKILL_ROOT>/scripts/auto_exporter.py "DraftName" "output.mp4" --res 1080 --fps 60 # Para apenas SRT: python <SKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "DraftName" - Clonar e Substituir Modelo: Clone modelos com segurança e substitua materiais em lote (evita danificar o modelo original):
# Clonar modelo para gerar novo projeto python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "Modelo Hotel" --name "ClienteA_Copia" - Validador de API: Execute um diagnóstico rápido do seu ambiente:
python <SKILL_ROOT>/scripts/api_validator.py
🚀 Exemplo de Início Rápido
import os
import sys
# 1. Inicialização do ambiente (deve ser sincronizada ao início do script, suporta Win/Mac)
current_dir = os.path.dirname(os.path.abspath(__file__))
env_root = os.getenv("JY_SKILL_ROOT", "").strip()
# Detectar caminho do Skill (suporta Antigravity, Trae, Claude, etc.)
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("Não foi possível encontrar a raiz do skill jianying-editor.")
sys.path.insert(0, os.path.join(skill_root, "scripts"))
from jy_wrapper import JyProject
if __name__ == "__main__":
# 2. Inicializar projeto (suporta v5.9+ e auto-reparo)
project = JyProject("Novo Vídeo com IA", overwrite=True)
assets_dir = os.path.join(skill_root, "assets")
# 3. Dublagem inteligente e legendas (One-click Script-to-Video)
project.add_narrated_subtitles(
text="Bem-vindo ao Skill de automação do JianYing. Esta é uma versão avançada totalmente adaptada ao MacOS.",
speaker="zh_female_xiaopengyou"
)
# 4. Importar materiais adicionais
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. Adicionar título com animação
project.add_text_simple("Automação JianYing Ativada", start_time="1s", duration="3s", anim_in="Máquina de escrever retrô")
project.save()
🛠️ Inicialização e Regras do Projeto (Initialization & Project Rules)
Ao inicializar JyProject, defina a resolução com base na proporção do vídeo principal. O padrão é paisagem (1920x1080).
🚨 Regra de Localização dos Scripts
É proibido criar seus scripts de edição de negócio dentro do diretório de instalação do Skill.
- Correto: Coloque seus scripts Python de edição no diretório raiz do projeto.
- Motivo: O diretório do Skill deve conter apenas o código-fonte das ferramentas, facilitando futuras atualizações via
git pull. Misturar código de negócio leva a uma gestão de versões confusa.