Instalación del plugin: Antes de ejecutar comandos de configuración o actualización, siga las reglas de ejecución de plugins cuando este skill se encuentre dentro de un plugin HyperFrames. Las instalaciones independientes conservan las instrucciones de actualización que se muestran a continuación.
media-use
El sistema operativo de medios para HyperFrames: resuelve · genera · opera · recuerda — cada tipo de medio, un solo skill, sin ruido de contexto.
Primer uso: instale e inicie sesión en la CLI de heygen (la ruta de uso gratuito), luego verifique con npx hyperframes media-use resolve --doctor. Configuración y proveedores: references/setup-providers.md.
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 en una línea |
|---|---|
bgm | música de fondo (catálogo de HeyGen, más de 10 000 pistas) |
sfx | efectos de sonido (biblioteca incluida de 19 archivos + catálogo) |
image | fotos, fondos (búsqueda de activos de HeyGen, más de 75 000 vectores) |
icon | iconos, símbolos (transparente) |
logo | marcas oficiales (theSVG → avatar de GitHub → favicon; nunca redibujado) |
voice | voz en off TTS (ruta de uso gratuito de HeyGen; Kokoro local opcional) |
grade | candidato de corrección medido; el pulido/estilizado general sigue los tratamientos de medios |
lut | archivo .cube proporcionado por el usuario o elegido explícitamente y reutilizable, validado |
Antes de resolver algo nuevo, liste los candidatos reutilizables con --candidates y juzgue usted mismo su idoneidad. Las reglas de reutilización, todas las banderas, la ingesta (--from) y la adopción se encuentran en references/resolve.md.
Tratar comentarios visuales amplios como intención de medios
Cuando un usuario pida explícitamente arreglar, pulir, estilizar, ocultar, enfatizar o revelar medios fotográficos, lea references/media-treatments.md incluso si no menciona la gradación de color o un efecto. Inspeccione el <img>/<video> real, elija una intención principal y luego use persistencia y verificación deterministas. Use una receta coincidente como semilla probada opcional, o inspeccione hyperframes media-treatment --capabilities --json, luego solicite una familia/efecto relevante con --capability <id> y arme un tratamiento personalizado a partir de los controles canónicos. Nunca cargue --all para una autoría común. Un tratamiento puede componer corrección, un preajuste, acabado, efectos de sombreado compatibles, fotogramas clave admitidos y superposiciones opcionales del Registro. Añada solo ajustes acotados y justificados por la fuente, nunca efectos solo para hacer que el resultado parezca más sofisticado. Persista la carga útil final combinada con hyperframes media-treatment.
Utilice un flujo de trabajo progresivo escalonado. Para video, inspeccione una hoja de contactos etiquetada (temprana/intermedia/tardía) en lugar de leer fotogramas por separado. Aplique un candidato e inspeccione una hoja posterior para corrección o pulido común. Escale 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 común, persista el JSON de preajuste/ajuste del tratamiento final. No genere un LUT .cube solo para codificar exposición, sombras, contraste o calidez. Use 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 recrear efectos compatibles de viñeta, grano, desenfoque, pixelado, color o tratamiento con superposiciones CSS/SVG; eso evita los controles de Studio y la ruta canónica de previsualización/renderizado por sombreador.
Sea proactivo — realice un pase de oportunidades de medios
El humano generalmente no puede saber qué medios mejorarían la pieza. Usted sí. Cuando construye o revisa una composición, realice un escaneo fundamentado y luego pregunte una vez — no añada en silencio y no insista por cada activo.
Sugiera una oportunidad solo cuando haya una señal concreta presente:
| Señal detectada | Oferta |
|---|---|
| Texto en pantalla / un guion sin voz en off | Voz en off TTS (motor de audio) |
Emoji o un <div> estilizado como icono | resolver iconos reales (icon) |
| Imagen que es un marcador de posición, pequeña o con aspecto de reescalada | una imagen mejor (image) (y/o mejorar resolución — consulte references/operations.md) |
| Cortes de escena abruptos / transiciones sin sonido | efectos de sonido de transición (sfx) |
| Una pieza de más de ~10s sin banda sonora | música de fondo (bgm) |
| Metraje que se ve subexpuesto/sobreexpuesto o con dominante de color | una corrección (gradación) (inspecciónelo con hyperframes media-treatment --selector '#hero' --analyze --json) |
| Medios fotográficos que se sienten visualmente planos o fuera de tema | un preajuste o tratamiento personalizado específico y apropiado para la fuente, con el objetivo previsto nombrado |
| Una entrada/revelación de medios significativa que se siente estática | una animación de tratamiento compatible con búsqueda segura; conserve el color a menos que la solicitud también justifique un preajuste |
Reglas que mantienen esto como una ayuda, no como un molestador: fundamentado, no genérico (sin señal → sin sugerencia); con opinión + concreto (proponga la corrección específica con valores predeterminados elegidos — el humano aprueba todo / algo / nada); una vez por proyecto (una sola solicitud consolidada; respete "déjalo así"); sugiera, nunca mute en silencio (especialmente las gradaciones de color: proponga y previsualice — una "corrección" de mundo gris arruina una puesta de sol intencional o un look neón).
Dónde buscar — lea solo el archivo que su tarea necesita
| Tarea | Lea |
|---|---|
| resolver / reutilizar / adoptar / ingerir, banderas, cascada, inventario | references/resolve.md |
gradación de color, LUTs, gradación inteligente (--for), comparar gradación | references/grading.md |
| voz en off / TTS, música, SFX, subtítulos, transcripción (motor de audio) | references/audio.md |
| cortar / reencuadrar / transformar medios existentes, difusión de errores exacta, HEVC | references/operations.md |
| tratamientos creativos conscientes de la fuente, efectos en tiempo real, superposiciones, revelaciones | references/media-treatments.md |
instalación + autenticación, tabla de proveedores, escaleras de RAM, --local-only, --provider | references/setup-providers.md |
| preferencias recordadas + recetas congeladas (memoria del usuario) | references/memory.md |
| matriz de propiedad, estadísticas de uso, telemetría, privacidad (orientado al mantenedor) | references/meta.md |