O que media-use faz?
O sistema operacional de mídia para HyperFrames: resolva · gere · opere · lembre — todo tipo de mídia, um skill, zero ruído de contexto.
Primeira execução: instale e faça login no CLI do heygen (o caminho de uso gratuito) e, em seguida, verifique com node <SKILL_DIR>/scripts/resolve.mjs --doctor. Configuração e provedores: references/setup-providers.md.
Resolver — o único verbo
node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>
Retorna uma linha: resolved <id> → <path> (<type>, <metadata>). Todo o ruído da pesquisa fica no disco.
| Tipo | Intenção em uma linha |
|---|---|
bgm | música de fundo (catálogo HeyGen, 10 mil+ faixas) |
sfx | efeitos sonoros (biblioteca de 19 arquivos incluída + catálogo) |
image | fotos, fundos (pesquisa de ativos HeyGen, 75 mil+ vetores) |
icon | ícones, símbolos (transparentes) |
logo | marcas oficiais (svgl → simple-icons → avatar do GitHub → favicon; nunca redesenhado) |
voice | narração TTS (caminho de uso gratuito HeyGen; Kokoro local opcional) |
grade | candidato de correção medido; polimento/estilização amplo segue Tratamentos de Mídia |
lut | arquivo .cube reutilizável validado, fornecido pelo usuário ou explicitamente escolhido |
Antes de resolver algo novo, liste candidatos reutilizáveis com --candidates e julgue você mesmo o ajuste — regras de reutilização, todas as flags, ingestão (--from) e adoção estão em references/resolve.md.
Tratar feedback visual amplo como intenção de mídia
Quando um usuário pedir explicitamente para corrigir, polir, estilizar, obscurecer, enfatizar ou revelar mídia fotográfica, leia references/media-treatments.md mesmo que ele não mencione correção de cor ou efeito. Inspecione o <img>/<video> real, escolha uma intenção primária e use persistência e verificação determinísticas. Use uma receita correspondente como semente opcional testada, ou inspecione hyperframes media-treatment --capabilities --json, então solicite uma família/efeito relevante com --capability <id> e monte um tratamento personalizado a partir de controles canônicos. Nunca carregue --all para criação comum. Um tratamento pode compor correção, predefinição, finalização, efeitos de shader compatíveis, keyframes suportados e sobreposições opcionais do Registry. Adicione apenas ajustes limitados justificados pela fonte e partes compatíveis, nunca efeitos apenas para tornar o resultado mais sofisticado. Persista o payload final combinado com hyperframes media-treatment.
Use um fluxo de trabalho progressivo único. Para vídeo, inspecione uma folha de contato rotulada de início/meio/fim, em vez de ler quadros separadamente. Aplique um candidato e inspecione uma folha de "depois" para correção ou polimento comuns. Escale para quadros individuais ou evidências de rascunho em movimento apenas quando o resultado for ambíguo, temporal, estilizado, baseado em LUT, sensível a HDR/LOG, privado ou crítico para a marca.
Para correção ou polimento comuns, persista o JSON de predefinição/ajuste do tratamento final. Não gere um LUT .cube apenas para codificar exposição, sombras, contraste ou aquecimento. Use um LUT somente quando o usuário fornecer um ou o tratamento selecionado explicitamente possuir um. resolve --type grade --for ... --analyze é evidência de medição, não permissão para substituir o tratamento escolhido por um LUT gerado. Não recrie efeitos de vinheta, granulação, desfoque, pixelização, cor ou tratamento suportados com sobreposições CSS/SVG; isso ignora os controles do Studio e o caminho canônico de visualização/renderização do shader.
Seja proativo — execute uma passagem de oportunidade de mídia
O humano geralmente não consegue identificar qual mídia melhoraria a peça. Você consegue. Ao construir ou revisar uma composição, faça uma varredura fundamentada e depois pergunte uma vez — não adicione silenciosamente e não importune por ativo.
Apresente uma oportunidade apenas quando um sinal concreto estiver presente:
| Sinal detectado | Oferta |
|---|---|
| Texto na tela / um roteiro sem narração | Narração TTS (mecanismo de áudio) |
Emoji ou um <div> estilizado como ícone | Resolver icons reais |
| Imagem que é placeholder, pequena ou com aparência de upscale | Uma image melhor (e/ou upscale — veja references/operations.md) |
| Cortes de cena bruscos / transições sem som | sfx de transição |
| Uma peça com mais de ~10s sem música de fundo | bgm |
| Filmagem que parece sub/sobre-exposta ou com dominante de cor | Uma correção corretiva (inspecione com hyperframes media-treatment --selector '#hero' --analyze --json) |
| Mídia fotográfica que parece visualmente plana ou fora do assunto | Uma predefinição específica adequada à fonte ou tratamento personalizado, com o destino pretendido nomeado |
| Uma entrada/revelação de mídia significativa que parece estática | Uma animação de tratamento suportada e segura para busca; preserve a cor, a menos que o pedido também justifique uma predefinição |
Regras que mantêm isso como ajuda, não como incômodo: fundamentado, não genérico (sem sinal → sem sugestão); opinativo + concreto (proponha a correção específica com padrões escolhidos — o humano aprova tudo / alguns / nenhum); uma vez por projeto (um pedido consolidado; respeite "deixe assim"); superfície, nunca mude silenciosamente (correções de cor especialmente: proponha e visualize — uma "correção" de mundo cinza arruína um pôr do sol intencional ou um visual neon).
Onde olhar — leia apenas o arquivo que sua tarefa precisa
| Tarefa | Leia |
|---|---|
| resolver / reutilizar / adotar / ingerir, flags, cascata, inventário | references/resolve.md |
correção de cor, LUTs, grade inteligente (--for), grade-compare | references/grading.md |
| narração / TTS, música, SFX, legendas, transcrição (mecanismo de áudio) | references/audio.md |
| cortar / reformular / transformar mídia existente, difusão de erro exata, HEVC | references/operations.md |
| tratamentos criativos com consciência de fonte, efeitos em tempo real, overlays, revelações | references/media-treatments.md |
instalação + autenticação, tabela de provedores, escadas de RAM, --local-only, --provider | references/setup-providers.md |
| preferências lembradas + receitas congeladas (memória do usuário) | references/memory.md |
| matriz de propriedade, estatísticas de uso, telemetria, privacidade (para mantenedores) | references/meta.md |