¿Qué hace Sci-Glow Video Skill (发光线描科普视频全流程制片)?
Visión General
Transforma de manera estable un concepto científico desde "una frase" hasta un conjunto completo de entregables listos para publicar: un guion de voz (solo texto), una tabla de verificación de fuentes, un script de subtítulos con sincronización precisa de beats, un máster MP4 a 60fps con desenfoque de movimiento, portadas 4K horizontales y verticales ajustadas al área segura, y textos promocionales para diferentes plataformas.
Filosofía central: Puerta de calidad automática con rehacer (brillo cuantificado + verificación de cero BOM + revisión ciega por sub-agente independiente ≥ 8.5), bajo ningún concepto se renderiza el máster si existen defectos P0/P1 o sobreexposición que cause una pantalla gris.
Dependencias
Este Skill orquesta y potencia las capacidades de niveles inferiores, sin reimplementar sus motores base:
Lead-知识讲解动画(lead-knowledge-animation): Proporciona el runtime Canvas/DOM determinista (motion.js,kit.js) y el andamiaje de bajo nivel (new_film.mjs,beats.py,timeline.py,fonts.py,sfx.py,mix.py,render.mjs,cover.mjs,verify.mjs,qa_video.py,review_pack.py). DeAzenYes/leaderai-media-toolkit.Lead-自媒体口播文案(lead-media-script): Proporciona la sintaxis de gancho de inicio en frío, las estructuras de analogías cotidianas y las guías de redacción para publicaciones en B站/Douyin/视频号/小红书/YouTube. DeAzenYes/leaderai-media-toolkit.uv(uv run): Ejecuta el script CLI auxiliar de biblioteca estándarscripts/sci_glow_cli.py.- Habilidades de búsqueda científica (opcional): Si el host las tiene instaladas (
pubmed-databaseoliterature-search-openalex), se priorizan para verificar artículos y valores reales; si no, se usa la búsqueda web para confirmar fuentes primarias.
Inicio Rápido
# 1. Verificar entorno y 8 pesos de IBM Plex Sans SC (si faltan, descargar con limitación de velocidad)
uv run <skill_dir>/scripts/sci_glow_cli.py preflight --auto-fix-fonts --output work/preflight.json
# 2. Analizar el espectro de clímax de un MP3 de usuario, mostrar top-3 puntos de inicio y parámetros de pre-dipping
uv run <skill_dir>/scripts/sci_glow_cli.py analyze-bgm --bgm "<BGM.mp3>" --target-duration 60 --top-k 3 --output work/bgm_analysis.json
# 3. Inicializar el proyecto con dos directorios y parámetros seguros por defecto (incluye 3:4 1080x1440 y bloom 0.26)
uv run <skill_dir>/scripts/sci_glow_cli.py scaffold-project --workspace "<ruta raíz del proyecto>" --date 20261118 --topic optogenética --ratio 3x4 --output work/scaffold.json
Scripts Utilitarios
Todos los cálculos auxiliares se proporcionan a través de scripts/sci_glow_cli.py, escribiendo uniformemente con --output un JSON UTF-8 sin BOM. Prohibido volcar grandes bloques de logs brutos a la terminal:
| Subcomando | Función Principal | Parámetros Obligatorios Clave |
|---|---|---|
preflight | Verificar Node 18+, FFmpeg, Chrome, Playwright (sugerir npmmirror + evitar descargar navegador duplicado), los dos skills superiores y los 8 pesos de IBM Plex; con --auto-fix-fonts descargar automáticamente los .otf faltantes | --output |
scaffold-project | Crear 口播文案输出/<fecha tema科普>/ y .code/<fecha tema科普动画>/, ejecutar new_film.mjs y parchear para habilitar tamaño 3:4 y bloom: 0.26 | --workspace, --date, --topic, --ratio, --output |
analyze-bgm | Decodificar forma de onda mono a 8kHz con FFmpeg, extraer RMS de banda completa + envolvente de baja frecuencia <180Hz, buscar Drop 1 (tarjeta de título) → Breakdown → Drop final de clímax, generar Top-K de --music-start y --music-dips | --bgm, --target-duration, --top-k, --output |
validate-lines | Validar/eliminar BOM UTF-8, verificar conteo de caracteres en ancho de 1080px (gancho <=12, subtítulo <=15), paréntesis balanceados, sin puntuación final, límite de 5s para ganchos, recalcular y fijar duración total tail | --lines, --target-duration, --ratio, --output (opcional --fix-bom, --apply-tail) |
audit-qa | Llamar al skill superior qa_video.py y según las huellas de oro (mean 17-20, p99 >= 130, bright <= 3.5%, cero zonas muertas, cero frames parpadeantes) dar semáforo verde/rojo y receta de ajuste, además generar prompt de revisión ciega independiente | --video, --film-dir, --round, --output |
Flujo de Trabajo
Cuando se encuentren demandas de producción en paralelo (múltiple opción) o división de trabajo entre dos modelos, cargar al mismo tiempo multi-agent-batch-playbook.md; los parámetros de imagen y maquetación deben cumplir estrictamente visual-and-layout-guardrails.md.
Paso 0: Verificación de entorno y confirmación de música antes de empezar
- Ejecutar
preflight --auto-fix-fonts --output ...; si falta Playwright, guiar para ejecutar:$env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="1"; npm i playwright --registry https://registry.npmmirror.com. - Puerta de música: si el usuario especificó una canción, usar solo esa; si no especificó y no hay canción local correspondiente, preguntar activamente al usuario por la ruta del archivo o cambiar a solo efectos de sonido (no saltarse sin consultar).
Paso 1: Redacción de guion sin barreras y verificación de fuentes primarias (reutilizar Lead-自媒体口播文案)
- Los primeros 3 segundos deben captar la atención con un número concreto o un hecho contraintuitivo; luego dar una analogía cotidiana concreta antes de introducir términos científicos.
- Verificar al menos 2-3 fuentes de revistas primarias (
Nature/Science/NEJM/Cell), prohibido inventar datos. - Generar guion de texto plano
.txty plan de ejecución.mden口播文案输出/<YYYYMMDD tema科普>/.
Paso 2: Alineación de clímax espectral de BGM y fijación de duración de subtítulos
- Ejecutar
analyze-bgm --bgm <ruta> --target-duration <T> --top-k 3 --output work/bgm.jsonpara seleccionar el mejormusic_start_sec, y usar el skill superiorbeats.pypara generarwork/beats.json. - Escribir
work/lines.json: colocar el títuloT.aten Drop 1, el momento de giro/crisisaten Breakdown, el instante de avanceaten Drop final de clímax, y dejar espacio al final para una imagen de cierre. - Ejecutar
validate-lines --lines work/lines.json --target-duration <T> --ratio <ratio> --fix-bom --apply-tail --output work/lines_check.json; solo cuando todo esté verde, ejecutar el skill superiortimeline.py --beats work/beats.json --music-start <start> --film film/.
Paso 3: Diseño del sistema visual e implementación de código determinista (reutilizar Lead-知识讲解动画)
[!IMPORTANT] Los parámetros de codificación y diseño visual deben cumplir visual-and-layout-guardrails.md:
bloom: 0.20–0.28,K.fog: 0.024–0.028,K.hud.cornerdeshabilitado,scenes.jsenvuelto en IIFE, títulos de transición conmode: 'rise', blur: 0y retraso+0.36s.
- Ejecutar primero
scaffold-projectpara crear los dos directorios. - Diseñar una paleta de colores principal que no entre en conflicto, en
film/core.jsescribir 3-5 capas de primitivas de brillo fino para la metáfora científica específica del video (prohibido reutilizar tarjetas generales de cuadros o figuras de palo en caja repetitivas). - Escribir
film/scenes.js,film/index.htmlyfilm/cover.html, ejecutar el skill superiorfonts.py film/para subconjunto de fuentes yverify.mjs film/index.html --tol 24para verificación de cero puntos con diferencia máxima 24.
Paso 4: Mezcla con dipping y verificación del área segura de portadas 4K duales
- Escribir
work/cues.jsonen UTF-8 sin BOM, ejecutarsfx.py --variants 3ymix.py(rellenar--music-starty--music-dipsdados poranalyze-bgm, nivelar a-14.0 LUFS / -1.5 dBFS). - Ejecutar
cover.mjs film/cover.html --out out --name <tema> --guides, ver visualmente las imágenes enwork/封面检查/, asegurando que la información clave de la portada horizontal caiga estrictamente dentro del4:3central (x ∈ [240, 1680]).
Paso 5: Revisión cuantitativa de borrador a 30fps + bucle de revisión ciega por sub-agente independiente
- Renderizar primero el borrador a mitad de resolución:
render.mjs film/index.html --fps 30 --scale 0.5 --out out/draft_r1.mp4(para un solo video usar--workers 8, para múltiples videos concurrentes controlar estrictamente--workers 4). - Ejecutar
audit-qa --video out/draft_r1.mp4 --film-dir film --round 1 --output work/qa_r1.json. Si el brillo o las zonas muertas no cumplen, modificar parámetros según la receta y re-renderizar el borrador directamente. - Ejecutar
review_pack.py out/draft_r1.mp4 --film film/ --out out/review_r1, derivar un sub-agente de revisión ciega de solo lectura research (solo puede leerout/review_r1/, prohibido ver el código fuente) que ejecute una puntuación en 9 dimensiones. - Si existe cualquier P0/P1 o puntuación media
< 8.5, prohibido renderizar el máster a 60fps, modificar uno por uno, autoverificar, y volver a revisar hasta que todo esté verde.
Paso 6: Renderizado directo del máster a 60fps con desenfoque de movimiento y entrega completa
- Una vez que la revisión ciega esté completamente verde, renderizar la versión final solo una vez:
render.mjs film/index.html --fps 60 --blur 2 --audio work/mix.wav --out out/<tema>.mp4. - Ejecutar de nuevo
audit-qayqa_video.py --sheet --ref-sheet, verificar visualmente la hoja de contacto de la pieza terminada y eliminar los borradores temporalesout/draft*.mp4. - Según
Lead-自媒体口播文案ycopy_template.md, completarwork/文案与封面.md, entregar al usuario el conjunto completo de archivos y una lista de momentos de re-grabación de audio que requieran escucha humana.
Limitación de Velocidad
analyze-bgm,validate-lines,scaffold-project,audit-qase ejecutan todos localmente, sin solicitudes de red externa.preflight --auto-fix-fontsal descargar fuentes.otffaltantes desde un CDN, tiene implementado un bloqueo de archivo OS entre procesos + limitador de velocidadtime.monotonic()(1.0 req/s), con 3 reintentos con retroceso exponencial ante 5xx, y lanza excepciónRateLimitErrorante HTTP 429, terminando la solicitud.
Errores Comunes
- BOM UTF-8 de PowerShell que causa fallo en
mix.py: PowerShell 5.1 conSet-Content -Encoding UTF8escribe un encabezadoEF BB BF. Todos los.jsondeben escribirse conencoding='utf-8'de Python, herramientasclio[IO.File]::WriteAllText(sin BOM). - Usar por defecto
bloom: 0.9ymode: 'center'causa imagen borrosa: Un sujeto de líneas brillantes con0.9de bloom causará inevitablementebright > 3.5%, y el títulocentercon desenfoque fijo de 14px arruinará las transiciones de barrido de luz. Se debe reducir a0.20–0.28según visual-and-layout-guardrails.md y usarrise(blur: 0). - Sobrecarga de Workers de Chromium y "autoevaluación" en producción concurrente: Con 3-4 videos en paralelo, se debe limitar
--workers 4; además, nunca permitir que el mismo contexto que escribe el código se autoevalúe y apruebe; la firma debe pasar por el sub-agente de revisión ciega de solo lectura en el directorio aisladoout/review_rN/.