media-use
El sistema operativo multimedia para HyperFrames: resuelve · genera · opera · recuerda — cada tipo de contenido, una sola habilidad, cero ruido contextual.
Primera ejecución: instala e inicia sesión en la CLI heygen (ruta de uso gratuito), luego verifica con npx hyperframes media-use resolve --doctor. Configuración y proveedores: references/setup-providers.md.
Resolver — el único verbo
npx hyperframes media-use resolve --type <tipo> --intent "<descripción>" --project <directorio>
Devuelve una línea: resuelto <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 (transparentes) |
logo | marcas oficiales (theSVG → avatar de GitHub → favicon; nunca redibujadas) |
voice | locución TTS (ruta de uso gratuito de HeyGen; Kokoro local opcional) |
grade | candidato de corrección medido; el pulido/estilizado amplio sigue los tratamientos multimedia |
lut | archivo .cube reutilizable verificado proporcionado por el usuario o elegido explícitamente |
Antes de resolver desde cero, lista candidatos reutilizables con --candidates y evalúa tú mismo si encajan — las reglas de reutilización, todas las banderas, ingestión (--from) y adopción están en references/resolve.md.
Tratar comentarios visuales amplios como intención multimedia
Cuando un usuario pida explícitamente arreglar, pulir, estilizar, oscurecer, enfatizar o revelar contenido fotográfico, lee references/media-treatments.md incluso si no menciona la 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 la creación ordinaria. Un tratamiento puede componer corrección, un preajuste, acabado, efectos shader compatibles, fotogramas clave admitidos y superposiciones opcionales del Registro. Añade solo ajustes acotados justificados por la fuente y partes compatibles, nunca efectos solo para hacer que el resultado luzca 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 inicio/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 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 del 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 compatibles de viñeta, grano, desenfoque, pixelado, color o tratamiento con superposiciones CSS/SVG; eso evita los controles de Studio y la ruta de shader de previsualización/renderizado canónica.
Sé proactivo — ejecuta un pase de oportunidad multimedia
El humano generalmente no puede saber qué contenido mejoraría la pieza. Tú sí puedes. Cuando construyas o revises una composición, haz un escaneo fundamentado y luego pregunta una vez — no añadas en silencio ni insistas por cada activo.
Sugiere una oportunidad solo cuando haya una señal concreta:
| Señal detectada | Oferta |
|---|---|
| Texto en pantalla / un guion sin voz en off | Locución TTS (motor de audio) |
Emoji o un <div> con estilo de icono | Resolver iconos reales (icon) |
| Imagen que es un marcador de posición, pequeña o parece ampliada | una mejor image (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 fondo musical | bgm |
| Metraje que se ve sub/sobre-expuesto o con dominante de color | una gradación correctiva (inspecciónalo con hyperframes media-treatment --selector '#hero' --analyze --json) |
| Contenido fotográfico que se siente visualmente plano o fuera de tema | un preajuste o tratamiento personalizado específico y apropiado para la fuente, con el objetivo nombrado |
| Una entrada/revelación multimedia 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 para que esto sea una ayuda, no 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 sola pregunta consolidada; respeta "déjalo así"); sugerir, nunca mutar en silencio (especialmente gradaciones: propón y previsualiza — una "corrección" neutral arruina una puesta de sol intencional o un aspecto neón).
Dónde buscar — 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 |
| locución / TTS, música, efectos de sonido, subtítulos, transcripción (motor de audio) | references/audio.md |
| cortar / reencuadrar / transformar contenido existente, difusión de error 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 |