Crie Shorts cinéticos com voz
Tudo é renderizado com o pipeline incluído em pipeline/ ao lado deste arquivo
(o "Diretório base para este skill" mostrado quando o skill carrega).
0. Configuração (uma vez por projeto)
Se o projeto não tem uma pasta video_gen/ com kinetic_build.py, crie-a:
mkdir -p video_gen && cp <diretório do skill>/pipeline/* video_gen/
cd video_gen
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt # desenho (Python 3.11+)
python3.12 -m venv .venv-tts && .venv-tts/bin/pip install -r requirements-tts.txt # voz Kokoro
ffmpeg deve estar no PATH. voice.py executa o worker TTS em .venv-tts ao lado dele.
Execute todos os comandos a partir de video_gen/.
1. Leia as regras
DESIGN.md- o estilo visual cinético. Regras rígidas: caixas empilham em uma coluna de largura total, nunca lado a lado; sem barras de destaque nas bordas das caixas; texto grande; cada elemento aparece na palavra falada correspondente; cabeçalhos cabem em uma linha (cerca de 30 caracteres); sem legendas incorporadas.PARTS.md- o formato dopart.md, regras de narração e como dividir um guia. Não leiaengine_short.py,templates.pyouskin.pya menos que esteja depurando-os.
2. Nova série: divida primeiro, obtenha aprovação
- Analise o guia de origem e proponha uma lista de partes (um conceito por parte, cerca de 90-125 s cada). Pare para aprovação do usuário. Nunca corte conteúdo para atingir um tamanho; adicione exemplos e o "porquê" em vez disso.
- Escreva cada
<série>/pNN_<slug>/part.md, mais<série>/README.mdcom a análise e uma tabela de partes. - Adicione a pasta da série a
SERIESembuild_part.py(kicker + footer). Opcionalmente adicione uma marca de logotipo aMARKSemkinetic.py. - Lint da narração:
.venv/bin/python build_part.py <dir da parte> --linte corrija todo problema. Narração: sem recapitulação, sem boas-vindas, vá direto ao tópico; sem símbolos ou código; soletre siglas para a voz; frases com no máximo 45 palavras.
3. Cenas
Cada parte recebe um scenes.py definindo SCENES. Dois estilos (veja examples/):
- Blocos de estágio declarativos (preferido, rápido):
SCENES = K.part(palavra, tag, chips, [[blocos...], ...])usandoTrack, Pipe, Rows, Code, Lanes, Bars, Ring, Fan, Chips, Big, Note. Uma dica (cue) é um prefixo de palavra (buscado após a dica anterior do bloco),(palavra, batida)ou um número de batida. Exemplo:examples/p03_*. - Classes
Sceneescritas à mão para uma metáfora que os blocos não conseguem mostrar. Exemplo:examples/p01_*. Liste as palavras-dica na ordem falada, ou as dicas retornarão como MISSING (ausentes).
4. Verifique, depois renderize
.venv/bin/python kinetic_build.py <dir da parte> --stills /tmp/pNN.png # folha de contato + relatório de dicas
.venv/bin/python kinetic_build.py <dir da parte> --out <série>/output # <slug>_voiced.mp4 final
.venv/bin/python cue_scan.py <série>/p*_* # verificação de sincronia somente texto
Corrija toda dica MISSING e overflow antes da renderização final. Para uma série completa, renderize as duas
primeiras partes e obtenha o OK do usuário sobre a aparência, depois execute o restante 3 de cada vez em segundo plano
(xargs -P 3).
5. Relatório
Uma tabela: link do MP4, tópico, duração, silêncio mais longo (alvo abaixo de 1 s). Marque as partes renderizadas no README da série. Diga claramente o que não foi verificado (quadros não visualizados, áudio não ouvido).
Nunca
- Coloque caixas lado a lado, barras de destaque nas bordas, texto pequeno ou legendas incorporadas.
- Proponha calibração de voz por vídeo; a sincronia é baseada em tempo de palavra e genérica.
- Edite
engine_short.pydiretamente;build_part.pyo modifica em memória.