¿Qué hace media-use?
El sistema operativo de medios 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 el CLI de heygen (ruta de uso gratuito), luego verifica con node <SKILL_DIR>/scripts/resolve.mjs --doctor. Configuración y proveedores: references/setup-providers.md.
Resolver — el único verbo
node <SKILL_DIR>/scripts/resolve.mjs --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 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 HeyGen, más de 75.000 vectores) |
icon | iconos, símbolos (transparentes) |
logo | marcas oficiales (svgl → simple-icons → avatar de GitHub → favicon; nunca redibujado) |
voice | voz superpuesta por TTS (ruta de uso gratuito HeyGen; Kokoro local opcional) |
grade | candidato de corrección medido; el pulido/estilización general sigue los tratamientos de medios |
lut | archivo .cube proporcionado por el usuario o elegido explícitamente, validado y reutilizable |
Antes de resolver algo nuevo, lista los candidatos reutilizables con --candidates y juzga tú mismo el ajuste — las reglas de reutilización, todas las banderas, la ingesta (--from) y la adopción están en references/resolve.md.
Tratar la retroalimentación visual amplia como intención de medios
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 o 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 creación ordinaria. Un tratamiento puede componer corrección, un preajuste, acabado, efectos de sombreado compatibles, fotogramas clave admitidos y superposiciones opcionales del Registro. Agrega solo ajustes acotados y justificados por la fuente y partes compatibles, nunca efectos solo para hacer que el resultado parezca más sofisticado. Persiste la carga final combinada con hyperframes media-treatment.
Usa un flujo de trabajo progresivo y de una sola escalada. Para video, inspecciona una hoja de contacto 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 ordinarios. 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 ordinarios, 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 viñetas, grano, desenfoque, pixelado, color o efectos de tratamiento compatibles con superposiciones CSS/SVG; eso evita los controles de Studio y la ruta canónica de previsualización/renderizado de sombreado.
Sé proactivo — realiza un pase de oportunidad de medios
El humano generalmente no puede saber qué medio mejoraría la pieza. Tú sí puedes. Cuando construyas o revises una composición, haz un escaneo fundamentado y luego pregunta una vez — no agregues en silencio, ni insistas por cada activo.
Ofrece una oportunidad solo cuando haya una señal concreta presente:
| Señal detectada | Ofrece |
|---|---|
| Texto en pantalla / un guión sin voz superpuesta | Voz superpuesta por TTS (motor de audio) |
Emoji o un <div> estilizado como icono | resolver icons reales |
| Imagen que es un marcador de posición, pequeña o parece ampliada | una image mejor (y/o ampliación — ver references/operations.md) |
| Cortes de escena duros / transiciones sin sonido | sfx de transición |
| Una pieza de más de ~10s sin música de fondo | bgm |
| Metraje que se ve sub/sobreexpuesto o con cast de color | una corrección de gradación (inspecciónalo 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, con el destino previsto nombrado |
| Una entrada/revelación de medios significativa que se siente estática | una animación de tratamiento compatible y segura para la búsqueda; conserva el color a menos que la solicitud también justifique un preajuste |
Reglas que mantienen esto como una ayuda, no un fastidio: 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 solicitud consolidada; respeta "déjalo así"); superficie, nunca mutar en silencio (las 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 de gradación | references/grading.md |
| voz superpuesta / TTS, música, SFX, subtítulos, transcripción (motor de audio) | references/audio.md |
| cortar / recuadrar / 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 (para mantenedores) | references/meta.md |