Communitygithub.com

Chengfeng Export — cortes, zooms y subtítulos en un MP4

Renderiza el vídeo a cámara terminado: aplica el registro de cortes, los zooms, los subtítulos y las capas visuales HTML en un solo quemado a mp4. Primero un dry-run para revisar duración, fotogramas, pantallas de subtítulos y capas; luego ensamblar → superponer → componer → verificar. Requiere Google Chrome y ffmpeg 6+.

¿Qué es Chengfeng Export — cortes, zooms y subtítulos en un MP4?

Short-form Editing, paso 3 (exportar): video-skill-ku-chengfeng-export. El único paso que dibuja píxeles de verdad; todo lo anterior es anotación con vista previa en vivo. Informa los avisos tal cual cuando subtítulos o capas apuntan a palabras cortadas, renderiza por defecto a 2x con la cadencia original y puede conservar fotogramas intermedios para depurar.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-export

Preguntar en tu IA favorita

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

Documentación

Exportar (video final)

Este es el último eslabón de la cadena y el único lugar en todo el producto donde realmente se generan píxeles.

Antes de esto, todo es anotación: el libro de cuentas registra «qué palabras decir», los subtítulos registran «qué escribir en la pantalla», las imágenes registran «qué capas superponer», la vista previa las combina en tiempo real para el usuario, sin escribir en disco. La exportación las fusiona en un solo archivo.

Requiere   edit-list.json (obligatorio), subtitles.json, visuals.json + modules/
Produce    video_final.mp4

Herramientas previas: tener Google Chrome en la máquina (para renderizar subtítulos y animaciones como imágenes). La instalación de escritorio de FFmpeg / FFprobe ya está incluida en el directorio gestionado por el Producto de la App; la instalación solo por CLI aún requiere ffmpeg ≥ 6 en el sistema. Si falta Chrome, se informará un error claro; no intentes evitarlo: sin él no hay capa de subtítulos ni de animación.

Primero, leer y ejecutar la sección «Nivel de conclusión» del Contrato de fase del skill de negocio. La exportación no entra en la máquina de estados de edición: no modifica ningún archivo del proyecto, no realiza escritura CAS, no avanza la fase; el resultado es un archivo nuevo, y volver a ejecutarlo lo sobrescribe. Por lo tanto, no necesita una tarjeta de confirmación.

0. Preparación

Primero, ejecutar la Verificación de actualización — si los skills están actualizados, si el Runtime es compatible; la raíz del plugin también se localiza allí (en los comandos de este documento, <raíz_del_plugin> se reemplaza con esa ruta literal). Solo si el resultado es «listo» se continúa; si es «nueva sesión necesaria» o «detener», se procede según su instrucción (incluyendo la prohibición de «interfaz alternativa hecha por uno mismo»), el skill de negocio no tiene lógica de entorno propia.

Si el resultado de la preparación es runtime.kind=desktop-managed, reutilizar directamente la CLI estable, las herramientas multimedia y el mismo servicio launchd/windows-task ya instalados con la App de escritorio; no analizar rutas de Electron, ni instalar FFmpeg/Bun por separado, ni iniciar un segundo Runtime.

Comandos

node "<raíz_del_plugin>/scripts/ensure-running.cjs" --json
node "<raíz_del_plugin>/scripts/videocut-cli.cjs" export <proyecto> --dry-run --json          # Primero ver el plan, sin codificar
node "<raíz_del_plugin>/scripts/videocut-cli.cjs" export <proyecto> --json                    # Generar el video final (por defecto 2x, frecuencia de cuadros original)
node "<raíz_del_plugin>/scripts/videocut-cli.cjs" export <proyecto> --out /ruta/video_final.mp4 --json
node "<raíz_del_plugin>/scripts/videocut-cli.cjs" export <proyecto> --scale 1 --json          # Solo tamaño original
node "<raíz_del_plugin>/scripts/videocut-cli.cjs" export <proyecto> --keep-work --json        # Conservar archivos intermedios y PNG cuadro por cuadro para depuración

Si ensure-running presenta falta de coincidencia de identidad, conflicto de puertos o servicio no saludable, detenerse inmediatamente; no está permitido usar foreground como reemplazo temporal para continuar la exportación.

Dos pasos, no solo el segundo

① --dry-run primero informa el plan     Duración, cuadros, pantallas de subtítulos, capas de imagen, número de segmentos de zoom, tamaño de salida
                                        Léelo al usuario. Si los números no coinciden, el problema está arriba; diez minutos de codificación no lo arreglarán
② Ejecución real                        Progreso en cuatro etapas: assemble → overlay → compose → verify

Las advertencias en --dry-run deben transmitirse textualmente. Solo informan una cosa: algunas palabras de pantallas de subtítulos o capas de imagen ya han sido recortadas, por lo que no aparecerán en el video final. Esto es algo que debe decidir la parte superior, no algo que la exportación deba ocultar.

Nitidez: el video original es el techo, primero mira el original antes de ampliar

Antes de exportar, ver la resolución original (el campo source de --dry-run ya la tiene):

Ancho del original ≥2560 (grabación de pantalla Retina nativa)  → --scale 1, la salida son píxeles nativos, este es el mejor caso
Ancho del original <1920 (ej. 960×720)      → Detenerse primero: preguntar al usuario si tiene una exportación de alta definición de la misma grabación.
                                            Las herramientas de grabación de pantalla a menudo pueden reexportar la misma grabación a 3x de resolución,
                                            cambiar el video original es más efectivo que cualquier post-procesamiento (ver sección siguiente). Si realmente no → --scale 2

--scale 2 es útil para videos originales de baja resolución: ampliar el material base no lo hará más nítido, pero los subtítulos y las animaciones se redibujan según el tamaño de salida — el público realmente está leyendo estos dos elementos; cuando la plataforma vuelve a comprimir, la imagen grande también recibe más tasa de bits.

No ajustes --fps para que se vea «más nítido». La frecuencia de cuadros sigue al video original; cambiarla hará que el muestreo de las animaciones no coincida con la grabación de pantalla.

Cambiar el video original: cuando el usuario proporciona una versión de alta definición de la misma grabación

Esto no es parte del flujo de exportación — la exportación en sí misma es solo de lectura. Cambiar el video original es una operación independiente de material, después de que el usuario lo apruebe explícitamente; luego se vuelve a la exportación normal.

Primero determinar si es la misma grabación (las dos primeras condiciones ya son suficientemente sólidas):

ffprobe -v error -show_entries format=duration -of csv=p=0 <dos_archivos>   # Duración exacta al milisegundo igual
ffmpeg -v error -i <archivo> -map 0:a:0 -c copy -f md5 -                  # Flujo de audio idéntico bit a bit
# Luego extraer dos o tres cuadros para comparar el contenido visual, confirmar con los ojos

Audio idéntico bit a bit = misma línea de tiempo: el guion palabra por palabra, el libro de cuentas, los subtítulos y las capas de imagen están todos vinculados a ID de palabras, no es necesario modificar nada. Aquí es donde «vincular por palabra, no por segundo» se hace realidad al cambiar el video original.

Cuatro pasos para cambiar el video original (realizado una vez el 29 de julio de 2026; el paso ③ se omitió en ese momento, y la vista previa de edición informó inmediatamente «Error de generación» — la huella digital no solo está en un lugar, busca con grep todas las huellas antiguas antes de actuar):

① Reemplazar el archivo      input/source.mp4 y uploads/source.mp4 son un enlace duro —
                             Eliminar ambos, copiar el nuevo archivo a input/, luego crear un enlace duro de vuelta a uploads/
                             (en macOS usar ln; en Windows usar New-Item -ItemType HardLink)
② Actualizar la huella       Cambiar source.sha256 en project.json a la del nuevo archivo
③ Verificar otra ubicación   workbench.json también tiene sourceSha256 que registra la huella del video original,
                             y la tubería de validación de la vista previa de edición verifica precisamente este — omitirlo, y la vista previa se niega a generarse
                             (Este es el comportamiento correcto del producto: si la huella no coincide, prefiere fallar, no usar la vista previa antigua como sustituta)
④ Re-exportar                --scale 1 — se cambió el video original para píxeles nativos, no ampliar más

Práctica segura: usa tu herramienta de búsqueda para buscar en todos los archivos *.json del los primeros 8 caracteres de la huella antigua, procesa cada aparición que encuentres (los registros de caché como preview-edited/current.json se recalcularán automáticamente, no es necesario modificarlos manualmente).

Si el audio es diferente (regrabado, recortado, duración diferente) no es cambiar el video original, es un nuevo proyecto: el guion palabra por palabra debe retranscribirse, y todas las anotaciones se invalidan. No lo fuerces.

Aceptación: tres cosas, sin una de ellas la exportación no está completa

① El comando regresa con éxito        El producto mismo verifica el tamaño, número de cuadros y pistas de audio del video final, comparándolos uno por uno con el plan.
                                      Si no coinciden, se informa error readback_mismatch, el archivo se deja en disco como evidencia, y la exportación no se considera completa
② Extraer cuadros para ver los píxeles  Extrae cuadros del video final y obsérvalos con los ojos. Al menos cubre: un segmento de zoom,
                                      un segmento de animación de pantalla completa, un segmento solo con subtítulos, y un borde entre capas
③ Escucha humana                      Nadie lo ha escuchado realmente, siempre se registra como human listening UNVERIFIED

② No está permitido usar capturas de vista previa como sustituto. La vista previa y el video final son dos rutas de renderizado, y la aceptación debe verificar precisamente si coinciden — usar una imagen de vista previa como evidencia del video final equivale a asumir lo que se debe verificar.

Para juzgar el zoom, busca puntos de referencia discriminantes; la impresión general puede engañar (realmente ocurrió el 29 de julio de 2026): después de un zoom de 1.6x, la página de pantalla aún parece «una página completa», y en miniaturas es casi indistinguible de la vista general — una vez se juzgó erróneamente un cuadro de zoom correcto como «zoom perdido», perdiendo media hora y reexportando dos veces. La forma correcta es buscar evidencia que solo el recorte puede producir: elementos cortados a la mitad (una burbuja de texto partida por la mitad), elementos de borde que desaparecen (barra lateral, barra de título). Compara con el cuadro del mismo instante del video original y decide de un vistazo.

Para extraer cuadros, usa ffmpeg:

ffmpeg -v error -ss 8.84 -i video_final.mp4 -frames:v 1 -y frame.png

Dónde buscar si hay problemas

--keep-work deja tres cosas en .chengfeng-videocut/export/ del proyecto, que separan directamente «cuál mitad falló»:

assembled.mkv    Solo la edición, sin nada superpuesto. Si falla = error en el libro de cuentas o en el corte
overlay/*.png    Solo lo superpuesto, fondo transparente. Si falla = error en el estilo de subtítulos o en el módulo
spans/*.mp4      Segmentos después de la composición. Si falla = error en el zoom o en la alineación

Tabla de referencia:

Video final sin subtítulos/animación       ¿El overlay PNG es completamente transparente? ¿El módulo no respondió al seek?
Animación se queda en el primer cuadro      El módulo no implementó seek, o la línea de tiempo de GSAP no está en pausa
Imagen completamente blanca                 Al módulo le falta `:root { color-scheme: dark }`
El cuadro del zoom está torcido             El viewBox del módulo y el zoom de la capa no son el mismo conjunto de números
Video final más corto que lo planeado       Algún span tiene menos cuadros de los necesarios, revisa el error en la fase compose
Un parpadeo de video original en el borde de capa  La captura de overlay está desactualizada (la verificación de marca de cuadro falló). El producto usa
                                                  la barra de marca de cuadro en la parte superior de la página para demostrar a qué cuadro pertenece cada captura;
                                                  si recurre, primero confirma que el PNG de overlay tenga la barra de marca en la parte superior, y que compose la haya recortado
No se encuentra Chrome                       Instala Google Chrome, no cambies a otra ruta de renderizado

Qué no hacer

  • No está permitido decir que «exportación exitosa» significa «aceptación aprobada» — el comando que regresa con éxito solo significa que el producto coincide consigo mismo, no que la imagen coincida
  • No está permitido usar capturas de vista previa, DOM o registros en lugar de cuadros extraídos del video final
  • No está permitido reportar human listening PASS sin que nadie lo haya escuchado
  • No está permitido modificar archivos del proyecto (cambiar subtítulos, eliminar capas, modificar el libro de cuentas) para que la exportación funcione. La exportación es solo de lectura, no escribe
  • No está permitido hacer el trabajo de etapas anteriores dentro de la exportación: si faltan subtítulos, ve a escribirlos; si faltan imágenes, ve a crearlas; no hagas un apaño temporal en esta etapa

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

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

2789927464king-jpg/video-skill-ku

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

Skills relacionados