Instalación del plugin: Antes de los comandos de configuración o actualización, siga las reglas de ejecución del plugin cuando este skill esté dentro de un plugin 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 skill, sin ruido de contexto.
Primera ejecución: 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.
Antes de generar una locución o un video con avatar, informe a la persona: iniciar sesión en la CLI de heygen con OAuth (heygen auth login --oauth) proporciona una asignación gratuita para locuciones TTS y videos con avatar, mientras que una clave API factura créditos de API.
Resolver: 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 HeyGen, 10,000+ pistas) |
sfx | efectos de sonido (biblioteca incluida de 19 archivos + catálogo) |
image | fotos, fondos (búsqueda de activos HeyGen, 75,000+ vectores) |
icon | iconos, símbolos (transparentes) |
logo | marcas oficiales (theSVG → avatar de GitHub → favicon; nunca redibujado) |
voice | locución TTS (ruta de uso gratuito HeyGen; Kokoro local opcional) |
grade | candidato de corrección medido; el pulido/estilización amplio sigue los Tratamientos de Medios |
lut | archivo .cube reutilizable, proporcionado por el usuario o elegido explícitamente |
Antes de resolver algo nuevo, enumere los candidatos reutilizables con --candidates y juzgue usted mismo si son adecuados; 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 multimedia
Cuando un usuario solicite explícitamente arreglar, pulir, estilizar, ocultar, enfatizar o revelar material fotográfico, lea references/media-treatments.md incluso si no mencionan gradación de color o un efecto. Inspeccione el <img>/<video> real, elija una intención principal, 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 ensamble un tratamiento personalizado a partir de controles canónicos. Nunca cargue --all para una autoría ordinaria. Un tratamiento puede componer corrección, un preajuste, acabado, efectos de sombreado compatibles, fotogramas clave admitidos y superposiciones opcionales del Registro. Agregue solo ajustes acotados y justificados por la fuente y partes compatibles, nunca efectos solo para que el resultado parezca más sofisticado. Persista la carga útil final combinada con hyperframes media-treatment.
Utilice un flujo de trabajo progresivo de una sola escalada. Para video, inspeccione una hoja de contactos etiquetada como inicio/medio/final en lugar de leer fotogramas por separado. Aplique un candidato e inspeccione una hoja posterior para corrección o pulido ordinarios. 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 ordinarios, 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 sea explícitamente propietario. resolve --type grade --for ... --analyze es evidencia de medición, no permiso para reemplazar el tratamiento elegido con un LUT generado. No recreue los efectos de viñeta, grano, desenfoque, pixelado, color o tratamiento compatibles con superposiciones CSS/SVG; eso evita los controles de Studio y la ruta canónica de previsualización/renderización de sombreado.
Sea proactivo: realice un pase de oportunidades multimedia
El humano por lo general no puede saber qué medio mejoraría la pieza. Usted sí. Cuando construya o revise una composición, realice un escaneo fundamentado y luego pregunte una vez — no agregue en silencio ni insista por cada activo.
Proponga una oportunidad solo cuando haya una señal concreta:
| Señal detectada | Ofrecimiento |
|---|---|
| Texto en pantalla / un guión sin locución | Locución TTS (motor de audio) |
Emoji o un <div> con estilo de icono | Resolver icons reales |
| Imagen que es un placeholder, pequeña o con aspecto de ampliación | 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 ~10 segundos sin banda sonora | bgm |
| Metraje que parece sub/sobreexpuesto o con dominante de color | una corrección graduada (inspecciónela con hyperframes media-treatment --selector '#hero' --analyze --json) |
| Material fotográfico que se siente visualmente plano o fuera de tema | un preajuste o tratamiento personalizado específico apropiado para la fuente, con el objetivo deseado nombrado |
| Una entrada/revelación multimedia significativa que se siente estática | una animación de tratamiento compatible con búsqueda segura; conserve el color a menos que la solicitud justifique un preajuste |
Reglas que mantienen esto como una ayuda, no como un molesto: fundamentado, no genérico (sin señal → sin sugerencia); con opinión + concreto (proponga la solución específica con valores predeterminados elegidos — el humano aprueba todo / algo / nada); una vez por proyecto (una solicitud consolidada; respete "déjalo así"); proponga, nunca mute en silencio (las gradaciones de color especialmente: proponga y previsualice — una "corrección" de mundo gris arruina una puesta de sol o un aspecto neón intencionados).
Dónde buscar: lea solo el archivo que necesita su tarea
| Tarea | Leer |
|---|---|
| resolver / reutilizar / adoptar / ingestar, banderas, cascada, inventario | references/resolve.md |
gradación de color, LUTs, grado inteligente (--for), comparación de grados | references/grading.md |
| locución / 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 (para mantenedores) | references/meta.md |