Instalación del plugin: Antes de ejecutar comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando este skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes mantienen las instrucciones de actualización a continuación.
media-use
El sistema operativo multimedia para HyperFrames: resuelve · genera · opera · recuerda — cada tipo de medio, un solo skill, cero ruido de contexto.
Primera ejecución: instala e inicia sesión en la CLI de heygen (la ruta de uso gratuito), luego verifica con npx hyperframes media-use resolve --doctor. Configuración y proveedores: references/setup-providers.md.
Antes de generar un voiceover o un video de avatar, informa a la persona: iniciar sesión en la CLI de heygen con OAuth (heygen auth login --oauth) proporciona una asignación gratuita para voiceover TTS y videos de avatar, mientras que una clave API factura créditos de API.
Resolve — el único verbo
npx hyperframes media-use resolve --type <tipo> --intent "<descripción>" --project <directorio>
Devuelve una línea: resolved <id> → <ruta> (<tipo>, <metadatos>). Todo el ruido de búsqueda permanece en el disco.
| Tipo | Intención de una línea |
|---|---|
bgm | música de fondo (catálogo de HeyGen, 10k+ pistas) |
sfx | efectos de sonido (biblioteca empaquetada de 19 archivos + catálogo) |
image | fotos, fondos (búsqueda de activos de HeyGen, 75k+ vectores) |
icon | iconos, símbolos (transparentes) |
logo | marcas oficiales (theSVG → avatar de GitHub → favicon; nunca redibujado) |
voice | voiceover TTS (ruta de uso gratuito de HeyGen; Kokoro local opcional) |
grade | candidato de corrección medido; pulido/estilización amplia sigue Tratamientos |
lut | archivo .cube reutilizable validado proporcionado por el usuario o elegido |
Antes de resolver algo nuevo, lista candidatos reutilizables con --candidates y juzga tú mismo el ajuste — las reglas de reutilización, todas las banderas, ingesta (--from) y adopción están en references/resolve.md.
Tratar comentarios visuales amplios como intención multimedia
Cuando un usuario pide explícitamente arreglar, pulir, estilizar, oscurecer, enfatizar o revelar medios fotográficos, lee references/media-treatments.md incluso si no menciona gradación de color ni un efecto. Inspecciona el <img>/<video> real, elige una intención principal, luego usa persistencia y verificación deterministas. Usa una receta coincidente como semilla probada opcional, o inspecciona hyperframes media-treatment --capabilities --json, luego solicita una familia/efecto relevante con --capability <id> y ensambla un tratamiento personalizado a partir de controles canónicos. Nunca cargues --all para una autoría ordinaria. Un tratamiento puede componer corrección, un preajuste, acabado, efectos de sombreado compatibles, fotogramas clave admitidos y superposiciones de Registry opcionales. Añade solo ajustes limitados justificados por la fuente y partes compatibles, nunca efectos solo para que el resultado se vea más sofisticado. Persiste la carga útil final combinada con hyperframes media-treatment.
Usa un flujo de trabajo progresivo. Para video, inspecciona una hoja de contactos etiquetada de principio/medio/final en lugar de leer fotogramas por separado. Aplica un candidato e inspecciona una hoja posterior para corrección o pulido ordinario. Escala a fotogramas individuales o evidencia de borrador en movimiento solo cuando el resultado sea ambiguo, temporal, estilizado, basado en LUT, sensible a HDR/LOG, privado o crítico para la marca.
Para corrección o pulido ordinario, persiste el JSON de preajuste/ajuste del tratamiento final. No generes un LUT .cube solo para codificar exposición, sombras, contraste o calidez. Usa un LUT solo cuando el usuario lo proporcione o el tratamiento seleccionado lo posea explícitamente. resolve --type grade --for ... --analyze es evidencia de medición, no permiso para reemplazar el tratamiento elegido con un LUT generado. No recrees efectos de viñeta, grano, desenfoque, pixelado, color o tratamiento compatibles con superposiciones CSS/SVG; eso evade los controles de Studio y la ruta canónica de previsualización/renderizado del sombreador.
Sé proactivo — realiza un pase de oportunidades multimedia
El humano generalmente no sabe qué medio mejoraría la pieza. Tú sí. Cuando construyes o revisas una composición, haz un escaneo fundamentado y luego pregunta una vez — no añadas en silencio, y no insistas por cada activo.
Ofrece una oportunidad solo cuando haya una señal concreta presente:
| Señal detectada | Oferta |
|---|---|
| Texto en pantalla / un guion sin voiceover | Voiceover TTS (motor de audio) |
Emoji o un <div> estilizado como icono | Resolver icon reales |
| Imagen que es un marcador de posición, pequeña o con upscaling | Una mejor image (y/o upscaling — ver references/operations.md) |
| Cortes de escena duros / transiciones sin sonido | sfx de transición |
| Una pieza de más de ~10s sin base musical | bgm |
| Metraje que parece subexpuesto, sobreexpuesto o con dominante | Una gradación correctiva (inspecciona con hyperframes media-treatment --selector '#hero' --analyze --json) |
| Medios fotográficos que se sienten visualmente planos o fuera de tema | Un preajuste específico apropiado para la fuente o un tratamiento personalizado, nombrando el objetivo |
| Una entrada/revelación de medios significativa que se siente estática | Una animación de tratamiento compatible con búsqueda segura; preserva el color a menos que la solicitud también justifique un preajuste |
Reglas que mantienen esto como una ayuda, no como una molestia: fundamentado, no genérico (sin señal → sin sugerencia); opinado + concreto (propón la solución específica con valores predeterminados elegidos — el humano aprueba todo / algo / nada); una vez por proyecto (una pregunta consolidada; respeta "déjalo así"); superficie, nunca mutar en silencio (gradaciones de color especialmente: propón y previsualiza — una "corrección" de mundo gris arruina una puesta de sol intencional o un aspecto neón).
Dónde mirar — lee solo el archivo que tu tarea necesita
| Tarea | Lee |
|---|---|
| resolver / reutilizar / adoptar / ingerir, banderas, cascada, inventario | references/resolve.md |
gradación de color, LUTs, gradación inteligente (--for), comparación | references/grading.md |
| voiceover / TTS, música, SFX, subtítulos, transcripción (motor de audio) | references/audio.md |
| cortar / reencuadrar / transformar medios existentes, difusión de error, HEVC | references/operations.md |
| tratamientos creativos conscientes de la fuente, efectos en tiempo real | references/media-treatments.md |
| instalación + autenticación, tabla de proveedores, escaleras de RAM | references/setup-providers.md |
| preferencias recordadas + recetas congeladas (memoria del usuario) | references/memory.md |
| matriz de propiedad, estadísticas de uso, telemetría, privacidad | references/meta.md |