Communitygithub.com

剪映编辑器 Skill

API de alto nivel (JyWrapper) para automatización de edición de video en JianYing, listo para usar con Python. Soporta grabación de pantalla, importación de material, generación de subtítulos, composición web y exportación de proyectos, completamente adaptado a MacOS (Apple Silicon/Intel) y Windows.

¿Qué es 剪映编辑器 Skill?

Este skill proporciona una API Python (JyWrapper) para automatizar completamente la edición de video en JianYing Pro, permitiendo desde la creación de borradores hasta la exportación final. Es útil para desarrolladores y agentes de IA que necesitan generar videos de forma programática, ahorrando tiempo en tareas repetitivas como la sincronización de subtítulos, la gestión de pistas y la aplicación de efectos. Soporta MacOS (Apple Silicon e Intel) y Windows, con versiones v5.9+ y auto-reparación de proyectos. El skill incluye herramientas CLI para inspeccionar borradores, buscar activos, sincronizar música de la nube y aplicar zoom inteligente en grabaciones de pantalla. Sigue reglas estrictas de desarrollo, como mantener los scripts de usuario fuera del directorio del skill para facilitar la actualización, y utiliza un sistema de rutas de archivos para la inicialización del entorno en diferentes plataformas.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

JianYing Editor Skill - Versión en Español

Utilice este skill cuando el usuario desee automatizar la edición de video, generar borradores o manipular recursos multimedia en JianYing Pro.

Manual de ejecución para agentes: docs/agent-playbook.md SOP de comandos mínimos: docs/minimal-command-sop.md Guía de uso en lenguaje natural: usage.md CLI de inspección de borradores: python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20 python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "NombreDelBorrador" python <SKILL_ROOT>/scripts/draft_inspector.py show --name "NombreDelBorrador" --kind content --json Para solicitudes de edición genéricas, siga siempre la "Plantilla de Edición Rápida" y la "Lista de Verificación de Aceptación" en ese manual.

🚨 Principios de Desarrollo Importantes (CRITICAL DEVELOPER RULES)

  1. Ubicación de scripts: Prohibido crear scripts de edición dentro del directorio del Skill. Todo el código de lógica de edición (archivos .py) debe colocarse en el directorio raíz del proyecto del usuario (o un subdirectorio como scripts/), para mantener la pureza y portabilidad de la biblioteca del Skill.
  2. Versión y Arquitectura:
    • Adaptación multiplataforma: Totalmente compatible con MacOS (detección de rutas/grabación de pantalla) y Windows.
    • Auto-reparación: Compatible con v5.9+ (draft_info.json). Si el borrador está dañado o hay conflictos de versión, inicialice JyProject con overwrite=True para activar la reparación automática.
  3. Selección de música de fondo:
    • Para demostraciones simples use la música predeterminada. En proyectos reales, priorice la búsqueda y recomendación de pistas relevantes en data/cloud_music_library.csv, o filtre por palabra clave según el tema del video (ej. "tecnología", "cálido").
    • Pregunte al usuario: "Encontré algunas pistas de música en la nube que podrían coincidir con el tema, ¿quieres probarlas? (Ej.: Illuminate - con estilo tecnológico)".

📜 Guía de Reglas (Rules)

Lea los archivos de reglas individuales para tareas y restricciones específicas:

🎯 Enrutamiento Rápido del Agente

  • Video en la nube + Música en la nube: rules/media.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
  • Locución inteligente y subtítulos (Script-to-Video): rules/text.md + rules/audio-voice.md -> API central add_narrated_subtitles
  • Narración y alineación de subtítulos: rules/text.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
  • Grabación de pantalla y zoom inteligente: rules/recording.md -> tools/recording/recorder.py
  • Exportación por lotes/exportación sin cabeza: rules/core.md + rules/cli.md -> examples/robust_auto_export.py
  • Generación de comentarios cinematográficos: rules/generative.md -> scripts/movie_commentary_builder.py

📖 Ejemplos Clásicos (Examples)

Consulte estos para flujos de trabajo completos:

🧠 Prompts & Herramientas Integradas (Prompts & Integrated Tools)

Use estas plantillas y scripts para tareas complejas:

  • Búsqueda de recursos: Encuentre filtros, transiciones y animaciones por nombre en chino/inglés:
    python <SKILL_ROOT>/scripts/asset_search.py "retro" -c filters
    
  • Constructor de comentarios cinematográficos: Genere videos de comentarios de 60 segundos a partir de un storyboard JSON:
    python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"
    
  • Sincronizar recursos nativos: Importe su música de fondo y estilos favoritos/reproducidos desde la aplicación JianYing al Skill:
    python <SKILL_ROOT>/scripts/sync_jy_assets.py
    # Indexar materiales en la nube desde sus borradores existentes
    python <SKILL_ROOT>/scripts/build_cloud_music_library.py
    python <SKILL_ROOT>/scripts/build_cloud_text_styles_library.py
    
  • README a Tutorial: Convierta el README.md de un proyecto en un guion completo de video tutorial de instalación:
    • Leer prompt: prompts/readme_to_tutorial.md
    • Inyectar contenido en la variable {{README_CONTENT}}
  • Grabador de pantalla y Zoom inteligente: Grabe su pantalla y aplique automáticamente fotogramas clave de zoom:
    python <SKILL_ROOT>/tools/recording/recorder.py
    # Captura de vista previa web (alto rendimiento)
    python <SKILL_ROOT>/scripts/web_recorder.py --url "http://localhost:3000" --duration 5
    # O aplicar zoom a un video existente:
    python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Proyecto" --video "v.mp4" --json "e.json"
    
  • Inspeccionador de borradores: Examine la estructura y metadatos del borrador (compatible con v5.9+):
    python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20
    python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "NombreDelBorrador"
    
  • Exportador automático: Exportación sin cabeza de un borrador a MP4/SRT:
    python <SKILL_ROOT>/scripts/auto_exporter.py "NombreDelBorrador" "output.mp4" --res 1080 --fps 60
    # Solo para SRT:
    python <SKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "NombreDelBorrador"
    
    Nota: La exportación automática a MP4 usa Automatización de UI en Windows. En macOS, genere el borrador y expórtelo manualmente desde JianYing.
  • Clonar plantilla y reemplazar: Clone plantillas de forma segura y reemplace materiales por lotes (evita dañar la plantilla original):
    # Clonar plantilla para generar un nuevo proyecto
    python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "PlantillaHotel" --name "ClienteA_Copia"
    
  • Validador de API: Ejecute un diagnóstico rápido de su entorno:
    python <SKILL_ROOT>/scripts/api_validator.py
    

🚀 Ejemplo de inicio rápido

import os
import sys

# 1. Inicialización del entorno (debe sincronizarse al inicio del script, compatible con Win/Mac)
current_dir = os.path.dirname(os.path.abspath(__file__))
env_root = os.getenv("JY_SKILL_ROOT", "").strip()
# Detectar la ruta del Skill (compatible con 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("No se pudo encontrar la raíz del skill jianying-editor.")
sys.path.insert(0, os.path.join(skill_root, "scripts"))
from jy_wrapper import JyProject

if __name__ == "__main__":
    # 2. Inicializar proyecto (compatible con v5.9+ y auto-reparación)
    project = JyProject("Nuevo Video IA", overwrite=True)
    assets_dir = os.path.join(skill_root, "assets")

    # 3. Locución inteligente y subtítulos (One-click Script-to-Video)
    project.add_narrated_subtitles(
        text="Bienvenido al Skill de automatización de JianYing. Esta es una versión avanzada completamente adaptada a MacOS.",
        speaker="zh_female_xiaopengyou"
    )

    # 4. Importar material adicional
    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. Añadir título con animación
    project.add_text_simple("Automatización JianYing activada", start_time="1s", duration="3s", anim_in="Máquina de escribir retro")

    project.save()

🛠️ Inicialización y Reglas del Proyecto (Initialization & Project Rules)

Al inicializar JyProject, asegúrese de establecer la resolución según la relación de aspecto del material de video principal. El valor predeterminado es horizontal (1920x1080).

🚨 Regla de ubicación de scripts

Prohibido crear sus scripts de edición de negocio en el directorio de instalación del Skill.

  • Correcto: Coloque sus scripts Python de edición en el directorio raíz del proyecto.
  • Motivo: El directorio del Skill solo debe contener el código fuente de las herramientas, para facilitar futuras actualizaciones con git pull. Mezclar código de negocio causa desorden en la gestión de versiones.

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

Skills relacionados