Communitygithub.com

剪映编辑器 Skill (JyWrapper)

API avançada de automação de edição de vídeo para JianYing (剪映), fornecendo interface Python pronta para uso com suporte a gravação de tela, importação de materiais, geração de legendas, síntese de efeitos Web e exportação de projetos. Compatível com MacOS (Apple Silicon/Intel) e Windows, com suporte à arquitetura v5.9+ (draft_info.json), autoreparo, dublagem inteligente com legendas e zoom de gravação.

O que é 剪映编辑器 Skill (JyWrapper)?

Este skill fornece uma camada de automação para o JianYing Pro (剪映), permitindo que agentes de IA (como Claude Code, Cursor, Codex) controlem programaticamente a edição de vídeo. Ele usa uma API Python chamada JyWrapper que lida com inicialização de projeto, reparo automático em caso de inconsistências, importação de mídia, geração de legendas com TTS e efeitos avançados como animações Web e zoom inteligente. O skill suporta tanto MacOS (Apple Silicon e Intel) quanto Windows e é compatível com projetos a partir da versão 5.9, que usam `draft_info.json`. Além disso, inclui ferramentas de linha de comando para inspeção de rascunhos, busca de ativos, exportação headless e sincronização de bibliotecas de música em nuvem, acelerando o fluxo de trabalho de edição de vídeo de forma programática.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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)

  1. 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 como scripts/), para manter a biblioteca do Skill limpa e portátil.
  2. 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, inicialize JyProject com overwrite=True para acionar o reparo automático.
  3. 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)".

📜 Guia de Regras (Rules)

Leia os arquivos de regras individuais para tarefas e restrições específicas:

🎯 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 principal add_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:

🧠 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}}
  • 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:
    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"
    
    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.
  • 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.

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 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

Habilidades Relacionadas