Release film: o que mudou, mostrado mudando
Um promo vende o produto; um release film mostra o delta de um release para pessoas que já conhecem o produto em sua maior parte. Mesmo motor, trabalho diferente: o estado anterior importa, cada afirmação é limitada por uma tag, e o filme é um episódio de uma série.
Este skill estende site-promo-film, no diretório irmão ../site-promo-film/.
Leia seu SKILL.md primeiro: direção, o visual, proibições, regras de construção, armadilhas de canvas, stills
antes da renderização, renderizar e verificar — tudo se aplica sem alterações. Este arquivo carrega apenas o que um
release adiciona.
| Arquivo | O que é |
|---|---|
template/release.html | O motor mais uma demonstração de release de 16 s: cartão de versão → o aplicativo como era → um novo controle chega na barra de ferramentas e é clicado (a lista reordena, as linhas se movem) → um atalho no teclado abre uma nova superfície (uma pílula que se abre em um painel) → o restante do changelog → o caminho de atualização clicado em um menu de vidro → de volta ao cartão de versão. Layouts wide e quadrado a partir de um único arquivo; cada mudança em destaque pode ter sua própria luz. |
../site-promo-film/template/film.js | O palco (jitter de subpixel por subframe: nada dá passos ou brilha em movimentos lentos), FILM.draw para ícones e símbolos, a linha do tempo para um filme longo, efeitos. O template o carrega; documentado em seu topo e em site-promo-film §5. |
../site-promo-film/template/parts.js | Partes vetoriais: janelas, um navegador, um terminal, dispositivos, teclas, um interruptor, um anel. |
../site-promo-film/template/fx.js | O visual — fundo, luz, granulação, vidro, ondulações de clique — compartilhado com o template de promo, que o documenta (seu §4). |
../site-promo-film/scripts/render.mjs, contact.mjs, beats.mjs | O renderizador, a folha de contato e a batida de uma trilha sonora (site-promo-film §7, The beat), usados como estão: PAGE=release.html node render.mjs …. |
../site-promo-film/scripts/clickcheck.mjs | Cada clique é visto (§3b): a câmera parada e o cursor em repouso em cada um dos CLICKS da página. node clickcheck.mjs release.html, saia com 1 se um clique ninguém vir. |
../site-promo-film/scripts/deliver.mjs | Os filmes finalizados e suas capas em uma pasta própria, depois a pasta de trabalho para a Lixeira assim que seu kit estiver seguro (site-promo-film §8). |
Copie o template (ou o kit do produto, §5), film.js, parts.js, fx.js (e type.js com as
fontes que ele define, para títulos em um estilo type.js) e os quatro scripts
para a pasta de trabalho src/, ~/Downloads/<produto>-<versão>-whats-new-work/src/ (~/Downloads é a raiz de trabalho a menos que as configurações digam o contrário: site-promo-film, seção Studio), e
npm i playwright-core lá. A demonstração renderiza em 69 s a 16 subframes em 8 workers, 171 s em um
visual pontilhado (night); medido em wide.
Invocado com ? ou help, ou com nada enquanto nada na conversa nomeia um release: o
modo guiado, ../site-promo-film/guide.md. Ele pergunta qual versão e percorre o briefing; nada é
renderizado nele. O Studio (site-promo-film, Studio) escreve um briefing de release também: kind: release, a
versão em release.tag; ele responde às perguntas do §1.
0 — Há um filme neste release?
Só é perguntado depois que o usuário pediu um filme: um comando de release não o levanta, e nada aqui é proposto por iniciativa própria. Renderizações seguem os padrões térmicos site-promo-film §7.
- Construa a lista a partir da tag, nunca da memória:
git log --oneline <tag-anterior>..<ref>, os PRs mesclados, as notas de release do rascunho. Um filme feito do "que eu acho que está nele" mostra um recurso que escapou, ou um do release anterior. - Ele se qualifica quando algo que uma pessoa vê ou faz de forma diferente é entregue: uma nova superfície, um novo controle, um redesign, um novo atalho. Correções, velocidade e internos não; diga isso em uma linha e pare. Um filme de um release sem nada para mostrar é um cartão de título com um número nele.
- Destaque no máximo três mudanças. O restante vai na rolagem do changelog, verbatim das notas, ou em lugar nenhum. Cinco mudanças em destaque significam três segundos cada, o que é um slideshow.
1 — Pergunte, então aguarde
Olhe primeiro: os filmes anteriores do produto (seu kit, §5), as instruções do projeto sobre onde as mídias de release vão, e seu modo de demonstração ou fixtures. Um ativo que nem o kit nem a fonte na tag contêm (o mestre do ícone, um logotipo como vetor) é pedido na mesma mensagem, nunca inventado (site-promo-film §1). Então pergunte em uma mensagem, cada um com um padrão:
- Release e ref a filmar (padrão: a tag;
mainquando ainda não está taggeada, então verifique novamente na tag). - Mudanças em destaque (padrão: minha escolha a partir do log, uma linha cada sobre por que mostra bem).
- Duração (padrão: ~6–8 s por mudança em destaque mais ~3 s de cartão de versão, 15–30 s; dobre quando houver cliques para ver, §3b). Um filme de 30 s ou mais que vai para o YouTube ganha capítulos (§6); um mais curto não pode: o YouTube quer três, o primeiro em 0:00, cada um com pelo menos 10 s.
- Formatos: um mestre 16:9 (padrão), e um corte quadrado como segundo layout.
- Visual (padrão: o do kit; para um primeiro filme, uma folha de looks de um quadro real, como em site-promo-film §4).
- Para onde vai (padrão:
<produto>-<versão>-whats-new/, entregue como site-promo-film §8 diz, contendo apenas os filmes finalizados e capas, enquanto sua pasta-workfica na raiz de trabalho (~/Downloadspor padrão); o próprio local do projeto para mídias de release quando suas instruções nomearem um). - Música: nenhuma por padrão. Clipes de release são reproduzidos automaticamente sem som, então o texto carrega tudo.
Em seguida, um storyboard na grade de batidas quando o produto tem um kit (o estilo está resolvido, apenas o conteúdo é uma escolha), três quando este é seu primeiro filme. Aguarde uma aprovação.
2 — Fonte: o aplicativo, na ref
- Leia o código na ref, não na árvore de trabalho:
git show <ref>:<caminho>. O código fornece as strings, símbolos, espaçamento e cores; as capturas de tela scriptadas do projeto (modo de demonstração, fixtures) fornecem proporções. Nunca uma captura com dados reais. - O estado anterior vem da fonte da tag anterior. Recriado de memória, ele está errado exatamente no detalhe que o release mudou.
- Cada string na tela existe na ref:
git grep -nF -- '<string>' <ref>deve encontrar, para texto de UI, itens de menu e o atalho em uma tecla (grep a ligação, não os docs). Filme no idioma fonte. - Os títulos são as linhas de benefício das notas de release, algumas palavras: não títulos de PR, e nada que o release não faça. São afirmações públicas.
- Uma mudança que é enviada desligada por padrão precisa de seu interruptor na tela. Caso contrário, o filme anuncia algo que o visualizador não pode encontrar.
3 — Padrões de storyboard
- Abra e feche no cartão de versão: ícone, nome, "O que há de novo em X.Y", a versão na cor de destaque. É o quadro 0 e o último quadro, cerca de 1.5 s de cada lado do ponto de loop.
- Mudança no lugar. Mostre a superfície como era por uma batida, então deixe a mudança acontecer nela: o controle chega na barra de ferramentas, a lista reordena, o painel ganha uma seção. Sem rótulos de antes/depois e sem tela dividida: a transição é a explicação. Aproxime a câmera conforme a mudança chega, afaste conforme é usada.
- Uma nova superfície cresce a partir do que a abre: o clique, o item de menu, o atalho. Um atalho vai nas teclas no espaço do título, pressionado na batida em que a superfície responde.
- Uma mudança em destaque, um título, uma interação. O título entra conforme a mudança chega, não antes: o visualizador vê, depois lê o que era.
- Um capítulo pode ter sua própria cor. Com um visual que tem luzes, as
keysdo visual as recolorem conforme cada mudança em destaque chega e trazem as primeiras cores de volta para o cartão de versão, como a demonstração faz. Deixe de fora quando as cores do produto significam algo (uma conta, um estado). - O restante do changelog como uma rolagem curta no espaço do título, um rótulo ("Também em X.Y") e três a cinco linhas verbatim das notas, uma por batida. Apenas quando o restante vale a pena nomear.
- Feche no caminho de atualização, clicado de verdade: a própria rota do produto para a nova versão (um item de menu Verificar Atualizações…, um botão de loja, a URL do site). Então a UI colapsa de volta no ícone. Em um menu, a linha destacada é aquela sob o cursor naquele instante, computada a partir da própria trilha do cursor, então passar sobre uma linha a ilumina como um menu real faz.
- Sem barras de progresso, contadores de capítulo ou badges "NOVO": a mudança em destaque é a quebra de capítulo.
- Mudança no lugar é o formato, não o único. Quando o último filme do kit já fez isso,
varie: as notas se abrindo nas telas que descrevem, a superfície mudada em profundidade 3D, um
wipeantes/depois no mesmo quadro, um tutorial do novo fluxo. site-promo-film §2 tem o catálogo; um release film pega um e diz qual em seu storyboard. - Um release importante pode carregar um filme longo (1–3 min, um capítulo por mudança em destaque, não um loop) na linha do tempo de site-promo-film §2b, ao lado do clipe curto para posts sociais.
3b — Cada clique é visto
Um release film é principalmente cliques, e um clique é uma batida que o visualizador precisa ver chegar. Um corte de 30 s uma vez reproduzido com seus movimentos muito rápidos e alguns cliques faltando. Medido: dois cliques caíram enquanto o quadro se movia a 1255 e 1414 px/s, e a maioria pousou em um cursor parado a 20-45 pt de seu alvo. O corte de 60 s cronometrado pela regra abaixo mediu cada clique abaixo de 2 px/s e 1 pt.
- A câmera chegou antes do clique. Comece um movimento de câmera pelo menos cerca de 1.3 s antes do clique que ele enquadra, e mova-se apenas uma vez que a UI respondeu a ele.
- O cursor descansa antes de pressionar: dê a cada movimento cerca de dois segundos em molas lentas (f 0.85 horizontal, 0.75 vertical; um salto curto pode ser mais rápido), para que ele fique parado por meio segundo.
- Ele permanece durante o pressionamento, mantido tempo suficiente para ser visto (para baixo 0.05 s, para cima 0.14 s depois), com um anel maior; o próximo movimento começa não antes de 0.3 s após o pressionamento.
- O que um clique abre nunca cobre o que foi clicado: um painel cai de baixo de seu item, uma janela cresce ao lado da notificação da qual veio, uma folha fecha 0.15-0.2 s após seu botão ser pressionado. O mestre de 60 s inicial cresceu a shell sobre o item clicado no pressionamento e o escondeu; os stills em horários exatos nunca o mostraram, quadros puxados do mp4 sim.
- Verifique:
node clickcheck.mjs release.htmlantes da autorização (ele mede a câmera no ponto clicado, o trajeto antes do pressionamento e durante ele; ambos os templates passam), e após a renderização puxe um quadro do mp4 em cada horário de clique (site-promo-film §7). - Em um iPhone ou um iPad (o
framedo briefing, site-promo-film §0) um clique é um toque: nenhuma seta é desenhada, e um dedo aparece apenas enquanto toca (um disco macio que pressiona, com a ondulação do visual). A página ainda declaraCLICKS, ecurX(t)/curY(t)são onde o dedo está: eles saltam para o próximo ponto tocado entre toques e descansam nele antes e depois de cada um, entãoclickcheck.mjsmede os toques exatamente como mede cliques, e uma página semCLICKSainda sai com 2. As regras acima se mantêm, a câmera acima de tudo.
4 — Layout: um slot e uma região livre
O template calcula a câmera em vez de ajustá-la manualmente. fit(rect, head) retorna a
câmera que faz um rect mundial preencher a região livre (ao lado do slot do título
em wide, abaixo dele em quadrado, ou todo o quadro sem um título), limitado em zmax. Três
regras, cada uma medida durante a construção da demonstração:
- Com um título ativo, um close-up alcança de volta à borda da própria superfície no lado do
slot (
toEdge). Ajuste apenas o detalhe e o resto da janela desliza sob o título, que então fica metade na tela e metade na janela escura. - Em quadrado, um close-up mantém a largura total da superfície, ou seus rótulos de linha são cortados em ambas as bordas do quadro.
- O título de saída é desenhado abaixo da forma em morphing, então a janela cresce sobre ele. Desenhado por cima, suas letras desaparecendo imprimem-se na janela por meio segundo.
Um segundo aspecto é um segundo layout, nunca um corte do primeiro: a página lê
location.hash, e PAGE='release.html#square' passa o hash através de render.mjs. O
hash também aceita o visual, unido com &: PAGE='release.html#square&look=night'.
5 — O kit: todo filme de um produto parece uma série
O primeiro filme de um produto (ou seu site-promo film) produz um kit: fontes, tokens
de cor, o ícone como vetor, o cartão de versão, o cromo da janela, a linguagem de câmera, o
visual (sua predefinição e substituições: uma linha FX.look). Faça commit com o produto, onde suas
instruções dizem (caso contrário, proponha um lugar, scripts/film/ até agora), antes da pasta de trabalho ser
descartada, para que o próximo release comece a partir do kit em vez do template: um
storyboard, apenas o conteúdo muda, e a série é reconhecível. No cartão de versão, apenas o
número muda.
O que um kit mantém é a página, não o motor. O motor é do skill e é copiado novamente para cada filme. A página é o trabalho: as superfícies do produto como vetor, cada string originada em uma tag, o timing que sobreviveu às rodadas de revisão, e um README do que essas rodadas ensinaram.
6 — Capítulos do YouTube para filmes de 30 s ou mais
(Limitado a 30+ s; YouTube exige capítulos com pelo menos 10 s, o primeiro em 0:00.)