Edicao de video agentica

Workflow Primitive-First

O ScreenKite mantem a edicao agentica simples: a aplicacao expõe primitivas deterministicas de edicao e o agente trata do planeamento, do raciocinio sobre a transcricao e da politica editorial.

Ciclo recomendado

1. Leia getProjectState(scope: "summary"), getProjectState(scope: "layout") e getProjectResources().
2. Exporte uma transcricao quando o timing for importante e planeie os beats antes de alterar a timeline.
3. Execute setCanvas(..., dryRun: true) antes de mudar o aspect ratio e setSceneLayout(..., dryRun: true) antes de trabalho de layout nao trivial.
4. Aplique alteracoes na timeline com editTimeline, alteracoes de composicao com setSceneLayout e passagens de efeitos com manageEffects.
5. Exporte shorts ou outros formatos com exportArtifact(type: "range", settings.canvasOverride) em vez de mutar o projeto long-form.
6. Verifique com getProjectState(scope: "visual") ou com exports de snapshot apos cada lote de alteracoes.

Quando usar cada primitiva

• editTimeline para cortes, trims e limpeza em limites de palavras
• setSceneLayout para alteracoes de composicao limitadas no tempo, incluindo o DSL de layout avancado
• manageEffects para legendas, zoom e outras passagens de efeitos
• vfxExportVideoSegment com vfxOverlayProcessedClip para round-trips de render externos
• exportArtifact para ficheiros finais, snapshots, SRT e exports por intervalo

Guardrails

• Nunca corte a meio de uma palavra. Use os limites de palavras da transcricao quando o timing da fala for importante.
• Releia o estado do projeto antes de repetir uma chamada mutadora apos um timeout.
• Faça corresponder os renders de overlay a largura, altura, fps e duracao em frames de destino antes de os recolocar na timeline.
• Limite os ciclos de autoavaliacao. Se as verificacoes visuais continuarem a falhar apos algumas passagens, inspecione diretamente o layout ou o media de origem.