media-use
O sistema operacional de mídia para HyperFrames: resolva · gere · opere · lembre — todos os tipos de mídia, um único skill, zero ruído de contexto.
Primeira execução: instale e faça login no CLI heygen (caminho de uso gratuito) e, em seguida, verifique com node <SKILL_DIR>/scripts/resolve.mjs --doctor. Configuração e provedores: references/setup-providers.md.
Resolve — o verbo único
node <SKILL_DIR>/scripts/resolve.mjs --type <tipo> --intent "<descrição>" --project <diretório>
Retorna uma linha: resolved <id> → <caminho> (<tipo>, <metadados>). Todo o ruído de pesquisa permanece no disco.
| Tipo | Intenção de uma linha |
|---|---|
bgm | música de fundo (catálogo HeyGen, 10k+ faixas) |
sfx | efeitos sonoros (biblioteca com 19 arquivos + catálogo) |
image | fotos, fundos (pesquisa de ativos HeyGen, 75k+ vetores) |
icon | ícones, símbolos (transparentes) |
logo | marcas oficiais (svgl → simple-icons → avatar 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 geral segue os Tratamentos de Mídia |
lut | arquivo .cube reutilizável validado, fornecido pelo usuário ou explicitamente escolhido |
Antes de resolver um novo item, liste candidatos reutilizáveis com --candidates e julgue a adequação você mesmo — regras de reutilização, todas as flags, importação (--from) e adoção estão em references/resolve.md.
Trate 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 nomeie correção de cor ou um efeito. Inspecione a <img>/<video> real, escolha uma intenção primária e, em seguida, use persistência e verificação determinísticas. Use uma receita correspondente como semente testada opcional, 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, um preset, 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 e escalonado. Para vídeo, inspecione uma folha de contato rotulada do início/meio/fim, em vez de ler quadros separadamente. Aplique um candidato e inspecione uma folha posterior 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, particular ou crítico para a marca.
Para correção ou polimento comuns, persista o JSON de preset/ajuste do tratamento final. Não gere um LUT .cube apenas para codificar exposição, sombras, contraste ou aquecimento. Use um LUT apenas quando o usuário fornecer um ou o tratamento selecionado possuir um explicitamente. 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 vinheta, granulação, desfoque, pixelização, cor ou efeitos de tratamento suportados com sobreposições CSS/SVG; isso ignora os controles do Studio e o caminho canônico de pré-visualização/renderização de shader.
Seja proativo — faça uma passagem de oportunidade de mídia
O humano geralmente não consegue identificar qual mídia elevaria o projeto. Você consegue. Ao construir ou revisar uma composição, faça uma varredura fundamentada e pergunte uma vez — não adicione silenciosamente e não incomode por ativo.
Ofereça uma oportunidade apenas quando um sinal concreto estiver presente:
| Sinal detectado | Ofereça |
|---|---|
| Texto na tela / um roteiro sem narração | Narração TTS (mecanismo de áudio) |
Emoji ou uma <div> estilizada como ícone | resolva icons reais |
| Imagem que é um placeholder, pequena ou com aparência de upscaled | uma image melhor (e/ou upscale — veja references/operations.md) |
| Cortes de cena abruptos / 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 de cor (inspecione com hyperframes media-treatment --selector '#hero' --analyze --json) |
| Mídia fotográfica que parece visualmente plana ou fora do assunto | um preset específico apropriado à fonte ou tratamento personalizado, com o alvo pretendido nomeado |
| Uma entrada/revelação de mídia significativa que parece estática | uma animação de tratamento compatível com seek; preserve a cor, a menos que a solicitação também justifique um preset |
Regras que mantêm isso como uma ajuda, não um 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 / algum / nada); uma vez por projeto (um pedido consolidado; respeite "deixe assim"); superfície, nunca mude silenciosamente (correções de cor especialmente: proponha e pré-visualize — uma "correção" de mundo cinza arruína um pôr do sol intencional ou um visual neon).
Onde consultar — leia apenas o arquivo que sua tarefa precisa
| Tarefa | Leia |
|---|---|
| resolver / reutilizar / adotar / importar, flags, cascata, inventário | references/resolve.md |
correção de cor, LUTs, gradação inteligente (--for), grade-compare | references/grading.md |
| narração / TTS, música, SFX, legendas, transcrição (mecanismo de áudio) | references/audio.md |
| cortar / reenquadrar / transformar mídia existente, difusão de erro exata, HEVC | references/operations.md |
| tratamentos criativos conscientes da fonte, efeitos em tempo real, sobreposições, 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 (voltado para mantenedores) | references/meta.md |