Pipeline de Shorts (neutro em relação ao tópico)
Uma lista de edição (<short>/edl.json) mais uma narração resulta em um vídeo finalizado: clipes em movimento em uma "janela" de foto temática, legendas de palavras, uma placa de gancho, um círculo de herói, uma capa, uma lista de cues de efeitos sonoros e, em seguida, uma mixagem de som a -14 LUFS.
Tudo que é específico para um canal (tópico, idiomas, público, regras de conteúdo, aparência, voz, créditos, cronograma) fica no CHANNEL.md do projeto. Leia-o primeiro e siga-o em vez dos padrões abaixo. Se estiver faltando ou tiver seções vazias, pergunte ao proprietário (ou copie engine/templates/CHANNEL.md e preencha-o com ele) antes de produzir qualquer coisa.
Habilidades relacionadas: shorts-script-voice (tópico, roteiro, voz) e shorts-packaging (arquivos finais, textos de upload).
Antes de tudo
- Scripts do kit (
setup.sh,shorts-init.sh,doctor.sh,install-codex.sh) ficam na pastascripts/do kit: a pasta do plugin, ou$SHORTS_HOME/kit/scripts/(setup.sheinstall-codex.shmantêm uma cópia lá). - Trabalhe a partir de uma pasta de projeto que contenha
_pipeline/,_tools/,_fonts/,CHANNEL.md(crie uma comscripts/shorts-init.sh <dir>). Todos os comandos abaixo são executados a partir da raiz dessa pasta. - Execute
scripts/doctor.sh <dir-do-projeto>uma vez por máquina. Ele verifica todas as dependências (programas do sistema, pacotes Python, modelos, espaço em disco) e deve terminar com "All good." Caso contrário:scripts/install-system-deps.shpara ffmpeg/Python/curl,scripts/setup.shpara o resto. A lista completa está emDEPENDENCIES.mddo kit. SHORTS_HOME(padrão~/.shorts-studio) contém o ambiente virtual Python e os modelos de voz. Exporte-o se colocá-lo em outro lugar.- Leia
_pipeline/README.md(referência do mecanismo) ereferences/edl-notes.mdantes de escrever uma lista de edição.
O fluxo de trabalho (cada etapa tem sua própria verificação)
| # | Etapa | Comando / saída | Verificar |
|---|---|---|---|
| 1 | Tópico + roteiro | habilidade shorts-script-voice | uma alegação, fontes atribuídas, proprietário OK quando o perfil solicitar |
| 2 | Voz | $SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, depois _tools/words.py <short>/vo | leia vo/words.json: cada palavra correta |
| 3 | Material | _tools/grab.py <topic> '<url>' <start> <end> --tag NAME (registra _footage/SOURCES.md), ou suas próprias gravações | folha de contato de cada clipe; política do CHANNEL.md |
| 4 | Lista de edição | copie references/edl-template.json, altere o conteúdo | build.py <edl> --words mostra tokens de legenda |
| 5 | Renderizar | python3 _pipeline/build.py <short>/edl.json --theme <theme> (3-10 min; 4K60 é lento) | sem erro; o arquivo é mais recente que o edl |
| 6 | Capa | ... build.py <edl> --cover | "violações de zona segura: nenhuma", legível com 180 px de largura |
| 7 | Verificar | python3 _pipeline/check.py <short>/<name>-<theme>-silent.mp4 <short>/edl.json | imprime ALL CHECKS PASS; você olhou cada folha de contato |
| 8 | Som | $SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <name> --strict | -14,0 +/-0,5 LUFS, pico verdadeiro <= -1,0 dBTP, erros de palavras próximos de 0 |
| 9 | Empacotar | habilidade shorts-packaging | arquivo + capa + bloco de upload em ready/ |
Folhas de contato de um clipe de origem: ffmpeg -ss <t> -i <file> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png (escreva PNG: a saída JPEG de algumas fontes falha com "non full-range YUV"). Limites de cena: ffmpeg -i <file> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*".
Temas: case-file (papel de dossiê), panel-heist (página de quadrinhos), vice-dusk (dusk neon), classic; o perfil escolhe um.
Como um bom short se parece (padrões; o perfil substitui)
- 18-45 s, um argumento do gancho ao desfecho, um corte a cada 1,5-3 s, cada tomada se move, a placa de gancho está ligada desde o quadro 0 (
hook.y1170 mantém-a longe da etiqueta de exposição), um momento de herói com um círculo vermelho em algo que o quadro realmente mostra. - A imagem segue as palavras. As legendas são frases de 2-3 palavras (
break_before); nomes permanecem em um grupo. - A última tomada corta de volta para o primeiro quadro (o vídeo faz loop).
- Todo texto legível permanece na zona segura do telefone: y 300-1580, x 130-950 (x <= 860 para y 1000-1600). check.py aplica isso.
- Janela de foto alta
"aspect": "3:4"(900x1200) em clipes de 1080p ou mais; fontes em 720p ou letterbox não conseguem preenchê-la.
Lições aprendidas a duras penas (detalhes em references/lessons.md)
- O EDL é mais recente que o render? O render está desatualizado. Reconstrua antes de julgar o check.py.
- Stills congelados (quadros consecutivos mal diferem por > 0,3 s) falham no check.py. Telas estáticas, cores planas e assuntos parados precisam de movimento em velocidade constante:
"move_ease": "linear", um intervalo de zoom de 0,15-0,4 e um pan de 150+ px de origem.floatsozinho não é suficiente (a senoide desacelera até zero em suas curvas). - Limites de zoom: fontes 4K <= 1,00, 1080p <= 1,25, 720p <= 1,0 (check.py imprime o limite por clipe).
- Sobreposições do criador (marca d'água, facecam, terço inferior, legendas, banners estilizados) nunca atingem a imagem: corte com a substituição de imagem
sourcesde nível superior, mova o corte ou escolha outros quadros. Olhe cada quadro de corte. - Honestidade: rótulos, círculos e legendas dizem apenas o que o quadro mostra; atribua fatos à sua fonte na narração.
- Capa: um corte full-bleed de um quadro de origem; a placa fica em
tab_y(330) e esconde o topo da imagem. Para um assunto próximo ao topo, definatab_yem cerca de 1090 estamp_yem cerca de 410. - Um render por vez (um render 4K60 usa todos os núcleos); nunca inicie um segundo render da mesma pasta.
Delegando uma edição a um subagente
Dê ao agente o BRIEF.md (criado por shorts-init a partir de references/editor-brief.md) mais o roteiro, os arquivos de voz e a lista de clipes. A sessão principal escreve o roteiro e a voz, revisa cada quadro ela mesma e faz a mixagem de som: o relatório de um agente é uma alegação, não uma prova. Verifique os horários dos arquivos (mp4 silencioso mais recente que o edl, log de verificação mais recente que o mp4) antes de aceitar.